Message Queue, v4.4 API Specification

## com.sun.messaging.jms
Class MessageNotReadableException

    java.lang.Object
      java.lang.Throwable
          java.lang.Exception
              javax.jms.JMSException
                  javax.jms.MessageNotReadableException
                      com.sun.messaging.jms.MessageNotReadableException

All Implemented Interfaces:
  com.sun.messaging.jmq.jmsclient.logging.Loggable, java.io.Serializable

    public class MessageNotReadableException

extends MessageNotReadableException
implements com.sun.messaging.jmq.jmsclient.logging.Loggable

This exception must be thrown when a JMS client attempts to read a write-only message.

See Also:
  Serialized Form

Constructor Summary
`MessageNotReadableException(java.lang.String reason)` Constructs a `MessageNotReadableException` with the specified reason and with the error code defaulting to null.
`MessageNotReadableException(java.lang.String reason, java.lang.String errorCode)` Constructs a `MessageNotReadableException` with the specified reason and error code.
`MessageNotReadableException(java.lang.String reason, java.lang.String errorCode, java.lang.Throwable cause)` Constructs a `MessageNotReadableException` 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 `MessageNotReadableException` and obtained via `javax.jms.JMSException.getLinkedException()`
`void` `printStackTrace(java.io.PrintStream s)`
`void` `printStackTrace(java.io.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 `MessageNotReadableException` and obtained via `JMSException.getLinkedException()`
`void` `setLinkedException(java.lang.Exception ex)` If running under J2SE1.4 or above, this method will also set the cause of the `MessageNotReadableException`.
`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

### MessageNotReadableException

    public MessageNotReadableException(java.lang.String reason,
                                       java.lang.String errorCode)

  Constructs a `MessageNotReadableException` with the specified reason and error code.

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

### MessageNotReadableException

    public MessageNotReadableException(java.lang.String reason)

  Constructs a `MessageNotReadableException` with the specified reason and with the error code defaulting to null.

  Parameters:
    `reason` - a description of the exception

### MessageNotReadableException

    public MessageNotReadableException(java.lang.String reason,
                                       java.lang.String errorCode,
                                       java.lang.Throwable cause)

  Constructs a `MessageNotReadableException` 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(java.lang.Exception ex)

  If running under J2SE1.4 or above, this method will also set the cause of the `MessageNotReadableException`. When a backtrace of the `MessageNotReadableException` 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 `MessageNotReadableException` and obtained via `javax.jms.JMSException.getLinkedException()`

  Overrides:
    `printStackTrace` in class `java.lang.Throwable`

### printStackTrace

    public void printStackTrace(java.io.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 `MessageNotReadableException` and obtained via `javax.jms.JMSException.getLinkedException()`

  Overrides:
    `printStackTrace` in class `java.lang.Throwable`

### printStackTrace

    public void printStackTrace(java.io.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 `MessageNotReadableException` and obtained via `JMSException.getLinkedException()`

  Overrides:
    `printStackTrace` in class `java.lang.Throwable`

### setLogState

    public void setLogState(boolean state)

  set state to true if this object is logged.

  Specified by:
    `setLogState` in interface `com.sun.messaging.jmq.jmsclient.logging.Loggable`
  Parameters:
    `state` - boolean

### getLogState

    public boolean getLogState()

  get logging state of this object.

  Specified by:
    `getLogState` in interface `com.sun.messaging.jmq.jmsclient.logging.Loggable`
  Returns:
    boolean true if this object is logged.

Message Queue, v4.4 API Specification

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