com.sun.cldc.isolate
Class IsolateStartupException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          com.sun.cldc.isolate.IsolateStartupException

public class IsolateStartupException
extends Exception

An exception thrown when the implementation is unable to start execution of a new isolate due to an error or exceptional condition in the bootstrap code for the new isolate (i.e., before the application starts). Generally, this exception implies the new isolate was misconfigured, and the misconfiguration was detected when the isolate was initializing (either during the constructor call or Isolate.start invocation). If the underlying misconfiguration resulted in an exception in the new isolate, the accessors for the remote exception information will provide the details. If not, those methods will all return null.

Any errors or exceptions thrown by application code in the new isolate will be handled by the default ThreadGroup.uncaughtException and will not manifest as an IsolateStartupException in the creating isolate.

Because any nested exception occurred in a remote isolate, the exception cannot be directly chained (for example, the exception type may be available in the creator). However, the information about the remote exception is available from the getRemoteName(), getRemoteMessage() methods.

The detail message in an IsolateStartupException will be the toString string of the original exception in the remote isolate, if available. The backtrace associated with an IsolateStartupException will be from the current thread's stack.

See Also:

Isolate.Isolate(java.lang.String, java.lang.String[], java.lang.String[], java.lang.String[]), Isolate.start()

Constructor Summary

IsolateStartupException()
Constructs an IsolateStartupException with no specified detail message and null remote exception information.

IsolateStartupException(String detail)
Constructs an IsolateStartupException with specified detail message and null remote exception information.

Method Summary

String	getRemoteMessage() Returns the detail message string for the remote exception (which may be null even if a remote exception occured).
String	getRemoteName() Returns either the name of the exception type of the remote exception or null if there was no reportable remote Java exception.
void	printRemoteStackTrace()
void	printRemoteStackTrace(PrintStream ps) Prints the remote exception like printRemoteStackTrace() to the given PrintStream.

Methods inherited from class java.lang.Throwable

getMessage, printStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

IsolateStartupException

public IsolateStartupException()

Constructs an IsolateStartupException with no specified detail message and null remote exception information.

IsolateStartupException

public IsolateStartupException(String detail)

Constructs an IsolateStartupException with specified detail message and null remote exception information.

Method Detail

getRemoteName

public String getRemoteName()

Returns either the name of the exception type of the remote exception or null if there was no reportable remote Java exception.

Returns:

the name of the exception type of the remote exception

getRemoteMessage

public String getRemoteMessage()

Returns the detail message string for the remote exception (which may be null even if a remote exception occured).

Returns:

the detail message string for the remote exception.

See Also:

getRemoteName()

printRemoteStackTrace

public void printRemoteStackTrace()

printRemoteStackTrace

public void printRemoteStackTrace(PrintStream ps)

Prints the remote exception like printRemoteStackTrace() to the given PrintStream. If no exception information is available, nothing will be printed.