FileDocCategorySizeDatePackage
ServerCloneException.javaAPI DocJava SE 5 API2827Fri Aug 26 14:57:12 BST 2005java.rmi.server

ServerCloneException

public class ServerCloneException extends CloneNotSupportedException
A ServerCloneException is thrown if a remote exception occurs during the cloning of a UnicastRemoteObject.

As of release 1.4, this exception has been retrofitted to conform to the general purpose exception-chaining mechanism. The "nested 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 ServerCloneException always throws {@link IllegalStateException}.

version
1.20, 12/19/03
author
Ann Wollrath
since
JDK1.1
see
java.rmi.server.UnicastRemoteObject#clone()

Fields Summary
public Exception
detail
The cause of the 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
Constructors Summary
public ServerCloneException(String s)
Constructs a ServerCloneException with the specified detail message.

param
s the detail message.


                      
       
	super(s);
        initCause(null);  // Disallow subsequent initCause
public ServerCloneException(String s, Exception cause)
Constructs a ServerCloneException with the specified detail message and cause.

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();