Sun Java(tm) System Message Queue
v3.6

com.sun.messaging.jms
Class InvalidClientIDException

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byjavax.jms.JMSException
              extended byjavax.jms.InvalidClientIDException
                  extended bycom.sun.messaging.jms.InvalidClientIDException
All Implemented Interfaces:
Serializable

public class InvalidClientIDException
extends InvalidClientIDException

This exception must be thrown when a client attempts to set a connection's client ID to a value that is rejected by a provider.

See Also:
Serialized Form

Constructor Summary
InvalidClientIDException(String reason)
          Constructs a InvalidClientIDException with the specified reason and with the error code defaulting to null.
InvalidClientIDException(String reason, String errorCode)
          Constructs a InvalidClientIDException with the specified reason and error code.
InvalidClientIDException(String reason, String errorCode, Throwable cause)
          Constructs a InvalidClientIDException with the specified reason, error code, and a specified cause.
 
Method Summary
 void printStackTrace()
           If running under versions of the Java platform prior to J2SE1.4, this method will also print the backtrace of the exception linked to this InvalidClientIDException and obtained via javax.jms.JMSException.getLinkedException()
 void printStackTrace(PrintStream s)
           If running under versions of the Java platform prior to J2SE1.4, this method will also print the backtrace of the exception linked to this InvalidClientIDException and obtained via javax.jms.JMSException.getLinkedException()
 void printStackTrace(PrintWriter s)
           If running under versions of the Java platform prior to J2SE1.4, this method will also print the backtrace of the exception linked to this InvalidClientIDException and obtained via JMSException.getLinkedException()
 void setLinkedException(Exception ex)
           If running under J2SE1.4 or above, this method will also set the cause of the InvalidClientIDException.
 
Methods inherited from class javax.jms.JMSException
getErrorCode, getLinkedException
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

InvalidClientIDException

public InvalidClientIDException(String reason,
                                String errorCode)
Constructs a InvalidClientIDException with the specified reason and error code.

Parameters:
reason - a description of the exception
errorCode - a string specifying the vendor-specific error code

InvalidClientIDException

public InvalidClientIDException(String reason)
Constructs a InvalidClientIDException with the specified reason and with the error code defaulting to null.

Parameters:
reason - a description of the exception

InvalidClientIDException

public InvalidClientIDException(String reason,
                                String errorCode,
                                Throwable cause)
Constructs a InvalidClientIDException with the specified reason, error code, and a specified cause.

Parameters:
reason - a description of the exception
errorCode - a string specifying the vendor-specific error code
cause - the cause. A null value is permitted, and indicates that the cause is non-existent or unknown.
Method Detail

setLinkedException

public void setLinkedException(Exception ex)

If running under J2SE1.4 or above, this method will also set the cause of the InvalidClientIDException. When a backtrace of the InvalidClientIDException is printed using printStackTrace using printStackTrace a backtrace of the cause will also get printed.

Overrides:
setLinkedException in class JMSException
Parameters:
ex - the linked Exception

printStackTrace

public void printStackTrace()

If running under versions of the Java platform prior to J2SE1.4, this method will also print the backtrace of the exception linked to this InvalidClientIDException and obtained via javax.jms.JMSException.getLinkedException()


printStackTrace

public void printStackTrace(PrintStream s)

If running under versions of the Java platform prior to J2SE1.4, this method will also print the backtrace of the exception linked to this InvalidClientIDException and obtained via javax.jms.JMSException.getLinkedException()


printStackTrace

public void printStackTrace(PrintWriter s)

If running under versions of the Java platform prior to J2SE1.4, this method will also print the backtrace of the exception linked to this InvalidClientIDException and obtained via JMSException.getLinkedException()


Sun Java(tm) System Message Queue
v3.6

Copyright 2004 Sun Microsystems, Inc. 4150 Network Circle,
Santa Clara, California, 95054, U.S.A. All Rights Reserved.