JAXRException (Java EE 5 SDK)

Java

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


javax.xml.registry Class JAXRException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by javax.xml.registry.JAXRException
所有已实现的接口:
Serializable, JAXRResponse
直接已知子类:
InvalidRequestException, RegistryException, UnexpectedObjectException, UnsupportedCapabilityException

public class JAXRException
extends Exception
implements JAXRResponse

Signals that a JAXR exception has occurred. It contains no members other than the standard reason String.

作者:
Nicholas Kassem, Mark Hapner, Rajiv Mordani, Farrukh Najmi
另请参见:
JAXRResponse, Serialized Form

字段摘要
protected  Throwable cause
           
 
Fields inherited from interface javax.xml.registry.JAXRResponse
STATUS_FAILURE, STATUS_SUCCESS, STATUS_UNAVAILABLE, STATUS_WARNING
 
构造器摘要
JAXRException()
          Constructs a JAXRException object with no reason or embedded Throwable.
JAXRException(String reason)
          Constructs a JAXRException object with the given String as the reason for the exception being thrown.
JAXRException(String reason, Throwable cause)
          Constructs a JAXRException object with the given String as the reason for the exception being thrown and the given Throwable object as an embedded Throwable.
JAXRException(Throwable cause)
          Constructs a JAXRException object initialized with the given Throwable object.
 
方法摘要
 Throwable getCause()
          Returns the Throwable embedded in this JAXRException if there is one.
 String getMessage()
          Returns the detail message for this JAXRException object.
 String getRequestId()
          Returns the unique id for the request that generated this response.
 int getStatus()
          Returns the status for this response.
 Throwable initCause(Throwable cause)
          Initializes the cause of this throwable to the specified value.
 boolean isAvailable()
          Returns true if a response is available, false otherwise.
 
类方法继承 java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
类方法继承 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

cause

protected Throwable cause
构造器详细信息

JAXRException

public JAXRException()
Constructs a JAXRException object with no reason or embedded Throwable.


JAXRException

public JAXRException(String reason)
Constructs a JAXRException object with the given String as the reason for the exception being thrown.

参数:
reason - a description of what caused the exception


JAXRException

public JAXRException(String reason,
                     Throwable cause)
Constructs a JAXRException object with the given String as the reason for the exception being thrown and the given Throwable object as an embedded Throwable.

参数:
reason - a description of what caused the exception
cause - a Throwable object that is to be embedded in this JAXRException object


JAXRException

public JAXRException(Throwable cause)
Constructs a JAXRException object initialized with the given Throwable object.

参数:
cause - the Throwable that caused this Exception

方法详细信息

getMessage

public String getMessage()
Returns the detail message for this JAXRException object.

If there is an embedded Throwable, and if the JAXRException object has no detail message of its own, this method will return the detail message from the embedded Throwable.

重写:
getMessage in class Throwable
返回:
the error or warning message for this JAXRException or, if it has none, the message of the embedded Throwable, if there is one

getCause

public Throwable getCause()
Returns the Throwable embedded in this JAXRException if there is one. Otherwise, this method returns null.

重写:
getCause in class Throwable
返回:
the embedded Throwable or null if there is none

initCause

public Throwable initCause(Throwable cause)
Initializes the cause of this throwable to the specified value. (The cause is the throwable that caused this throwable to get thrown.)

This method can be called at most once. It is generally called from within the constructor, or immediately after creating the throwable. If this throwable was created with JAXRException(Throwable) or JAXRException(String,Throwable), this method cannot be called even once.

重写:
initCause in class Throwable
参数:
cause - the cause (which is saved for later retrieval by the getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
返回:
a reference to this Throwable instance.
抛出异常:
IllegalArgumentException - if cause is this throwable. (A throwable cannot be its own cause.)
IllegalStateException - if this throwable was created with JAXRException(Throwable) or JAXRException(String,Throwable), or this method has already been called on this throwable.

getRequestId

public String getRequestId()
Description copied from interface: JAXRResponse
Returns the unique id for the request that generated this response.

Capability Level: 0

规范说明:
getRequestId in interface JAXRResponse
返回:
the request id

getStatus

public int getStatus()
Description copied from interface: JAXRResponse
Returns the status for this response.

Capability Level: 0

规范说明:
getStatus in interface JAXRResponse
返回:
the status which is an integer enumerated value
另请参见:
JAXRResponse.STATUS_SUCCESS

isAvailable

public boolean isAvailable()
                    throws JAXRException
Returns true if a response is available, false otherwise. This is a polling method and must not block.

规范说明:
isAvailable in interface JAXRResponse
返回:
true if the response is available; false otherwise
抛出异常:
JAXRException - If the JAXR provider encounters an internal error

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


提交错误或意见

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.