|
Message Queue, v4.5.1 API Specification | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.lang.Throwable
java.lang.Exception
javax.jms.JMSException
javax.jms.MessageFormatException
com.sun.messaging.jms.MessageFormatException
public class MessageFormatException
This exception must be thrown when a JMS client
attempts to use a data type not supported by a message or attempts to
read data in a message as the wrong type. It must also be thrown when
equivalent type errors are made with message property values. For
example, this exception must be thrown if
StreamMessage.writeObject
is given an unsupported class or
if StreamMessage.readShort
is used to read a
boolean
value. Note that the special case of a failure
caused by an attempt to read improperly formatted String
data as numeric values must throw the
java.lang.NumberFormatException
.
Constructor Summary | |
---|---|
MessageFormatException(String reason)
Constructs a MessageFormatException with the specified reason and with
the error code defaulting to null. |
|
MessageFormatException(String reason,
String errorCode)
Constructs a MessageFormatException with the specified reason and
error code. |
|
MessageFormatException(String reason,
String errorCode,
Throwable cause)
Constructs a MessageFormatException with the specified reason,
error code, and a specified cause. |
Method Summary | |
---|---|
boolean |
getLogState()
get logging state of this object. |
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 MessageFormatException and obtained via
javax.jms.JMSException.getLinkedException() |
void |
printStackTrace(PrintStream s)
|
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 MessageFormatException 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 MessageFormatException . |
void |
setLogState(boolean state)
set state to true if this object is logged. |
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 |
---|
public MessageFormatException(String reason, String errorCode)
MessageFormatException
with the specified reason and
error code.
reason
- a description of the exceptionerrorCode
- a string specifying the vendor-specific
error codepublic MessageFormatException(String reason)
MessageFormatException
with the specified reason and with
the error code defaulting to null.
reason
- a description of the exceptionpublic MessageFormatException(String reason, String errorCode, Throwable cause)
MessageFormatException
with the specified reason,
error code, and a specified cause.
reason
- a description of the exceptionerrorCode
- a string specifying the vendor-specific
error codecause
- the cause. A null value is permitted,
and indicates that the cause is non-existent
or unknown.Method Detail |
---|
public void setLinkedException(Exception ex)
If running under J2SE1.4 or above, this method will also
set the cause of the MessageFormatException
.
When a backtrace of the MessageFormatException
is printed
using printStackTrace
using printStackTrace
a backtrace of the cause will also get printed.
setLinkedException
in class JMSException
ex
- the linked Exception
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 MessageFormatException
and obtained via
javax.jms.JMSException.getLinkedException()
printStackTrace
in class Throwable
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 MessageFormatException
and obtained via
javax.jms.JMSException.getLinkedException()
printStackTrace
in class Throwable
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 MessageFormatException
and obtained via
JMSException.getLinkedException()
printStackTrace
in class Throwable
public void setLogState(boolean state)
setLogState
in interface com.sun.messaging.jmq.jmsclient.logging.Loggable
state
- booleanpublic boolean getLogState()
getLogState
in interface com.sun.messaging.jmq.jmsclient.logging.Loggable
|
Message Queue, v4.5.1 API Specification | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |