FileDocCategorySizeDatePackage
ActivationException.javaAPI DocJava SE 5 API2958Fri Aug 26 14:57:12 BST 2005java.rmi.activation

ActivationException

public class ActivationException extends Exception
General exception used by the activation interfaces.

As of release 1.4, this exception has been retrofitted to conform to the general purpose exception-chaining mechanism. The "detail exception" that may be provided at construction time and accessed via the public {@link #detail} field is now known as the cause, and may be accessed via the {@link Throwable#getCause()} method, as well as the aforementioned "legacy field."

Invoking the method {@link Throwable#initCause(Throwable)} on an instance of ActivationException always throws {@link IllegalStateException}.

author
Ann Wollrath
version
1.24, 12/19/03
since
1.2

Fields Summary
public Throwable
detail
The cause of the activation exception.

This field predates the general-purpose exception chaining facility. The {@link Throwable#getCause()} method is now the preferred means of obtaining this information.

private static final long
serialVersionUID
indicate compatibility with the Java 2 SDK v1.2 version of class
Constructors Summary
public ActivationException()
Constructs an ActivationException.


            
      
        initCause(null);  // Disallow subsequent initCause
public ActivationException(String s)
Constructs an ActivationException with the specified detail message.

param
s the detail message

	super(s);
        initCause(null);  // Disallow subsequent initCause
public ActivationException(String s, Throwable cause)
Constructs an ActivationException with the specified detail message and cause. This constructor sets the {@link #detail} field to the specified Throwable.

param
s the detail message
param
cause the cause

	super(s);
        initCause(null);  // Disallow subsequent initCause
	detail = cause;
Methods Summary
public java.lang.ThrowablegetCause()
Returns the cause of this exception. This method returns the value of the {@link #detail} field.

return
the cause, which may be null.
since
1.4

        return detail;
public java.lang.StringgetMessage()
Returns the detail message, including the message from the cause, if any, of this exception.

return
the detail message

	if (detail == null) 
	    return super.getMessage();
	else
	    return super.getMessage() + 
		"; nested exception is: \n\t" +
		detail.toString();