pascal.taie.analysis.exception.package-info Maven / Gradle / Ivy
Show all versions of tai-e Show documentation
/*
* Tai-e: A Static Analysis Framework for Java
*
* Copyright (C) 2022 Tian Tan
* Copyright (C) 2022 Yue Li
*
* This file is part of Tai-e.
*
* Tai-e is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License
* as published by the Free Software Foundation, either version 3
* of the License, or (at your option) any later version.
*
* Tai-e is distributed in the hope that it will be useful,but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
* Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with Tai-e. If not, see .
*/
/**
* This package provides functionality to analyze exceptions.
*
* Here we use the term "exception" by convention, actually, we handle
* all subclasses of {@link java.lang.Throwable}, including both
* {@link java.lang.Exception} and {@link java.lang.Error}.
*
* We classify exceptions into four categories:
*
* (1) VM errors, i.e., subclasses of {@link java.lang.VirtualMachineError}
* defined below:
* {@link java.lang.InternalError}
* {@link java.lang.OutOfMemoryError}
* {@link java.lang.StackOverflowError}
* {@link java.lang.UnknownError}
* According to JVM Spec., Chapter 6.3, the above errors may be thrown
* at any time during the operation of the Java Virtual Machine.
*
* (2) Exceptions that may be implicitly thrown by JVM when executing
* each instruction. See JVM Spec., Chapter 6.5 for more details.
*
* (3) Exceptions that are explicitly thrown by throw statements.
*
* (4) Exceptions that are explicitly thrown by method invocations.
*
* Generally, Tai-e ignores (1), and provides different strategies
* to handle exceptions in (2)-(4).
*/
package pascal.taie.analysis.exception;