JCAT
v0.3.1

javax.csapi.cc.jcc
Class ProviderUnavailableException

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byjava.lang.RuntimeException
              extended byjavax.csapi.cc.jcc.ProviderUnavailableException
All Implemented Interfaces:
java.io.Serializable

public class ProviderUnavailableException
extends java.lang.RuntimeException

This exception indicates that the JccProvider is currently not available to the application. This exception is typically thrown in two cases: when JccPeer.getProvider(String) is called or on any method when the JccProvider is in a JccProvider.SHUTDOWN state.

The exception stores the reason for the failure which may be obtained via the getReason() method on this interface.

Since:
1.0b
See Also:
Serialized Form

Field Summary
static int CAUSE_INVALID_ARGUMENT
          Constant definition for an invalid optional argument given to JccPeer.getProvider(String).
static int CAUSE_INVALID_SERVICE
          Constant definition for an invalid service string given to JccPeer.getProvider(String).
static int CAUSE_NOT_IN_SERVICE
          Constant definition for the JccProvider not in the JccProvider.IN_SERVICE state.
static int CAUSE_UNKNOWN
          Constant definition for an unknown cause.
 
Constructor Summary
ProviderUnavailableException()
          Constructor with no cause and string.
ProviderUnavailableException(int cause)
          Constructor which takes a cause string.
ProviderUnavailableException(int cause, java.lang.String s)
          Constructor which takes both a string and a cause.
ProviderUnavailableException(java.lang.String s)
          Constructor which takes a string description.
 
Method Summary
 int getReason()
          Returns the cause for this exception.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

CAUSE_UNKNOWN

public static final int CAUSE_UNKNOWN
Constant definition for an unknown cause.

See Also:
Constant Field Values

CAUSE_NOT_IN_SERVICE

public static final int CAUSE_NOT_IN_SERVICE
Constant definition for the JccProvider not in the JccProvider.IN_SERVICE state.

See Also:
Constant Field Values

CAUSE_INVALID_SERVICE

public static final int CAUSE_INVALID_SERVICE
Constant definition for an invalid service string given to JccPeer.getProvider(String).

See Also:
Constant Field Values

CAUSE_INVALID_ARGUMENT

public static final int CAUSE_INVALID_ARGUMENT
Constant definition for an invalid optional argument given to JccPeer.getProvider(String).

See Also:
Constant Field Values
Constructor Detail

ProviderUnavailableException

public ProviderUnavailableException()
Constructor with no cause and string.


ProviderUnavailableException

public ProviderUnavailableException(int cause)
Constructor which takes a cause string.

Parameters:
cause - reason code for this fault

ProviderUnavailableException

public ProviderUnavailableException(java.lang.String s)
Constructor which takes a string description.

Parameters:
s - description of the fault

ProviderUnavailableException

public ProviderUnavailableException(int cause,
                                    java.lang.String s)
Constructor which takes both a string and a cause.

Parameters:
cause - reason code for the fault
s - description of the fault
Method Detail

getReason

public int getReason()
Returns the cause for this exception. This methods was originally called getCause(). However, this signature conflicted with J2SDKv1.4.0 Beta 3.

Returns:
The cause of this exception.

JCAT
v0.3.1

August, 2003
If you have any comments or queries, please mail them to JSR-122-EG@JCP.ORG

Copyright - 2001, 2003 Sun Microsystems