AbstractException (emma 2.1.1 API)

java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - com.vladium.util.exception.AbstractException

所有已实现的接口:

ICodedException, java.io.Serializable

直接已知子类:

EMMAException, IFileLock.FileLockException
```
public abstract class AbstractException
extends java.lang.Exception
implements ICodedException
```
Based on code published by me in JavaPro, 2002.
This checked exception class is designed as a base/expansion point for the entire hierarchy of checked exceptions in a project.
It provides the following features:
- ability to take in compact error codes that map to full text messages in a resource bundle loaded at this class' instantiation time. This avoids hardcoding the error messages in product code and allows for easy localization of such text if required. Additionally, these messages can be parametrized in the java.text.MessageFormat style;
- exception chaining in J2SE versions prior to 1.4
See AbstractRuntimeException for an unchecked version of the same class.
TODO: javadoc Each constructor that accepts a String 'message' parameter accepts an error code as well. You are then responsible for ensuring that either the root com.vladium.exception.exceptions resource bundle or your project/exception class-specific resource bundle [see below for details] contains a mapping for this error code. When this lookup fails the passed String value itself will be used as the error message.
All constructors taking an 'arguments' parameter supply parameters to the error message used as a java.text.MessageFormat pattern.
Example:
```
  File file = ...
  try
  ...
  catch (Exception e)
  {
      throw new AbstractException ("FILE_NOT_FOUND", new Object[] {file, e}, e);
  }
 
```
where com.vladium.util.exception.exceptions contains:
```
 FILE_NOT_FOUND: file {0} could not be opened: {1}
 
```
To log exception data use getMessage() or printStackTrace family of methods. You should never have to use toString().
It is also possible to use project- or exception subhierarchy-specific message resource bundles without maintaining all error codes in com.vladium.exception.exceptions. To do so, create a custom resource bundle and add the following static initializer code to your base exception class:
```
  static
  {
      addExceptionResource (MyException.class, "my_custom_resource_bundle");
  }
 
```
The bundle name is relative to MyException package. This step can omitted if the bundle name is "exceptions". Note that the implementation correctly resolves error code name collisions across independently developed exception families, as long as resource bundles use unique names. Specifically, error codes follow inheritance and hiding rules similar to Java class static methods. See ExceptionCommon.addExceptionResource(java.lang.Class, java.lang.String) for further details.
作者:

Vlad Roubtsov, (C) 2002

另请参阅:

序列化表格

构造器概要

构造器
构造器和说明
`AbstractException()` Constructs an exception with null message and null cause.
`AbstractException(java.lang.String message)` Constructs an exception with given error message/code and null cause.
`AbstractException(java.lang.String message, java.lang.Object[] arguments)` Constructs an exception with given error message/code and null cause.
`AbstractException(java.lang.String message, java.lang.Object[] arguments, java.lang.Throwable cause)` Constructs an exception with given error message/code and given cause.
`AbstractException(java.lang.String message, java.lang.Throwable cause)` Constructs an exception with given error message/code and given cause.
`AbstractException(java.lang.Throwable cause)` Constructs an exception with null error message/code and given cause.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`__printStackTrace(java.io.PrintStream ps)` Every exception hierarchy implementing this interface must ensure that this method delegates to super.printStackTrace(ps) where 'super' is the first superclass not implementing IThrowableWrapper.
`void`	`__printStackTrace(java.io.PrintWriter pw)` Every exception hierarchy implementing this interface must ensure that this method delegates to super.printStackTrace(pw) where 'super' is the first superclass not implementing IThrowableWrapper.
`static void`	`addExceptionResource(java.lang.Class namespace, java.lang.String messageResourceBundleName)` Equivalent to `ExceptionCommon.addExceptionResource(java.lang.Class, java.lang.String)`, repeated here for convenience.
`java.lang.Throwable`	`getCause()` This implements `IThrowableWrapper` and also overrides the base method in JDK 1.4+.
`java.lang.String`	`getErrorCode()` Returns the String that was passed as 'message' constructor argument.
`java.lang.String`	`getLocalizedMessage()` Overrides base method for the sole purpose of making it final.
`java.lang.String`	`getMessage()` Overrides base method to support error code lookup and avoid returning nulls.
`void`	`printStackTrace()` Overrides Exception.printStackTrace() to (a) force the output to go to System.out and (b) handle nested exceptions in JDKs prior to 1.4.
`void`	`printStackTrace(java.io.PrintStream s)` Overrides Exception.printStackTrace() to handle nested exceptions in JDKs prior to 1.4.
`void`	`printStackTrace(java.io.PrintWriter s)` Overrides Exception.printStackTrace() to handle nested exceptions in JDKs prior to 1.4.

从类继承的方法 java.lang.Throwable
addSuppressed, fillInStackTrace, getStackTrace, getSuppressed, initCause, setStackTrace, toString

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - AbstractException
```
public AbstractException()
```
    Constructs an exception with null message and null cause.
  - AbstractException
```
public AbstractException(java.lang.String message)
```
    Constructs an exception with given error message/code and null cause.
    
    参数:
    
    message - the detail message [can be null]
  - AbstractException
```
public AbstractException(java.lang.String message,
                         java.lang.Object[] arguments)
```
    Constructs an exception with given error message/code and null cause.
    
    参数:
    
    message - the detail message [can be null]
    
    arguments - message format parameters [can be null or empty]
    
    另请参阅:
    
    MessageFormat
  - AbstractException
```
public AbstractException(java.lang.Throwable cause)
```
    Constructs an exception with null error message/code and given cause.
    
    参数:
    
    cause - the cause [nested exception] [can be null]
  - AbstractException
```
public AbstractException(java.lang.String message,
                         java.lang.Throwable cause)
```
    Constructs an exception with given error message/code and given cause.
    
    参数:
    
    message - the detail message [can be null]
    
    cause - the cause [nested exception] [can be null]
  - AbstractException
```
public AbstractException(java.lang.String message,
                         java.lang.Object[] arguments,
                         java.lang.Throwable cause)
```
    Constructs an exception with given error message/code and given cause.
    
    参数:
    
    message - the detail message [can be null]
    
    arguments - message format parameters [can be null or empty]
    
    cause - the cause [nested exception] [can be null]
    
    另请参阅:
    
    MessageFormat
- 方法详细资料
  - getMessage
```
public final java.lang.String getMessage()
```
    Overrides base method to support error code lookup and avoid returning nulls. Note that this does not recurse into any 'cause' for message lookup, it only uses the data passed into the constructor. Subclasses cannot override.
    Equivalent to getLocalizedMessage().
    
    覆盖:
    
    getMessage 在类中 java.lang.Throwable
    
    返回:
    
    String error message provided at construction time or the result of toString() if no/null message was provided [never null].
  - getLocalizedMessage
```
public final java.lang.String getLocalizedMessage()
```
    Overrides base method for the sole purpose of making it final.
    Equivalent to getMessage().
    
    覆盖:
    
    getLocalizedMessage 在类中 java.lang.Throwable
  - printStackTrace
```
public final void printStackTrace()
```
    Overrides Exception.printStackTrace() to (a) force the output to go to System.out and (b) handle nested exceptions in JDKs prior to 1.4.
    Subclasses cannot override.
    
    覆盖:
    
    printStackTrace 在类中 java.lang.Throwable
  - printStackTrace
```
public final void printStackTrace(java.io.PrintStream s)
```
    Overrides Exception.printStackTrace() to handle nested exceptions in JDKs prior to 1.4.
    Subclasses cannot override.
    
    覆盖:
    
    printStackTrace 在类中 java.lang.Throwable
  - printStackTrace
```
public final void printStackTrace(java.io.PrintWriter s)
```
    Overrides Exception.printStackTrace() to handle nested exceptions in JDKs prior to 1.4.
    Subclasses cannot override.
    
    覆盖:
    
    printStackTrace 在类中 java.lang.Throwable
  - getErrorCode
```
public final java.lang.String getErrorCode()
```
    Returns the String that was passed as 'message' constructor argument. Can be null.
    
    指定者:
    
    getErrorCode 在接口中 ICodedException
    
    返回:
    
    message code string [can be null]
  - getCause
```
public final java.lang.Throwable getCause()
```
    This implements IThrowableWrapper and also overrides the base method in JDK 1.4+.
    
    覆盖:
    
    getCause 在类中 java.lang.Throwable
    
    返回:
    
    Throwable being wrapped by this object [can be null].
  - __printStackTrace
```
public void __printStackTrace(java.io.PrintStream ps)
```
    Every exception hierarchy implementing this interface must ensure that this method delegates to super.printStackTrace(ps) where 'super' is the first superclass not implementing IThrowableWrapper. This is used by ExceptionCommon to avoid infinite recursion and is not meant to be called by other classes.
  - __printStackTrace
```
public void __printStackTrace(java.io.PrintWriter pw)
```
    Every exception hierarchy implementing this interface must ensure that this method delegates to super.printStackTrace(pw) where 'super' is the first superclass not implementing IThrowableWrapper. This is used by ExceptionCommon to avoid infinite recursion and is not meant to be called by other classes.
  - addExceptionResource
```
public static void addExceptionResource(java.lang.Class namespace,
                                        java.lang.String messageResourceBundleName)
```
    Equivalent to ExceptionCommon.addExceptionResource(java.lang.Class, java.lang.String), repeated here for convenience. Subclasses should invoke from static initializers only. 'namespace' should be YourException.class.

类 AbstractException

构造器概要

方法概要

从类继承的方法 java.lang.Throwable

从类继承的方法 java.lang.Object

构造器详细资料

AbstractException

AbstractException

AbstractException

AbstractException

AbstractException

AbstractException

方法详细资料

getMessage

getLocalizedMessage

printStackTrace

printStackTrace

printStackTrace

getErrorCode

getCause

__printStackTrace

__printStackTrace

addExceptionResource