JAXRException (Java EE 5)

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

Author:

Nicholas Kassem, Mark Hapner, Rajiv Mordani, Farrukh Najmi

See Also:

JAXRResponse, Serialized Form

英文文档：

cause

protected Throwable cause

public JAXRException()
构造不带原因或嵌入 Throwable 的 JAXRException 对象。

英文文档：

JAXRException

public JAXRException()

Constructs a JAXRException object with no reason or embedded Throwable.

public JAXRException(String reason)
构造一个 JAXRException 对象，使用给定 String 作为抛出异常的原因。

reason

对导致异常的原因的描述

英文文档：

JAXRException

public JAXRException(String reason)

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

Parameters:

reason - a description of what caused the exception

public JAXRException(String reason, Throwable cause)
构造一个 JAXRException 对象，使用给定 String 作为抛出异常的原因，使用给定 Throwable 对象作为嵌入的 Throwable。

reason	对导致异常的原因的描述
cause	将嵌入此 JAXRException 对象的 Throwable 对象

英文文档：

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.

Parameters:

reason - a description of what caused the exception

cause - a Throwable object that is to be embedded in this JAXRException object

public JAXRException(Throwable cause)
构造使用给定 Throwable 对象初始化的 JAXRException 对象。

cause

导致此 Exception 的 Throwable

英文文档：

JAXRException

public JAXRException(Throwable cause)

Constructs a JAXRException object initialized with the given Throwable object.

Parameters:

cause - the Throwable that caused this Exception

public String getMessage()
返回此 JAXRException 对象的详细消息。

如果有嵌入的 Throwable，并且 JAXRException 对象没有自己的详细消息，则此方法将返回嵌入 Throwable 中的详细消息。

return

此 JAXRException 的错误或警告消息；如果没有此类消息，则返回嵌入 Throwable（如果有）的消息

英文文档：

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.

Overrides:

getMessage in class Throwable

Returns:

the error or warning message for this JAXRException or, if it has none, the message of the embedded Throwable, if there is one

public Throwable getCause()
返回此 JAXRException 中嵌入的 Throwable（如果有）。否则，此方法返回 null。

return

嵌入的 Throwable；如果不存在嵌入的 Throwable，则返回 null

英文文档：

getCause

public Throwable getCause()

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

Overrides:

getCause in class Throwable

Returns:

the embedded Throwable or null if there is none

public Throwable initCause(Throwable cause)
将此 throwable 的cause（原因） 初始化为指定值。（cause 是导致抛出此 throwable 的 throwable。）

此方法最多可以调用一次。此方法通常从构造方法中调用，或者在创建 throwable 后立即调用。如果此 throwable 是通过 #JAXRException(Throwable) 或 #JAXRException(String,Throwable) 创建的，则此方法一次也不能调用。

cause	原因（保存此原因，以便以后通过 #getCause() 方法获取它）。 （允许该参数为 null 值，指出原因是不存在的或是未知的。）
return	对此 Throwable 实例的引用。
Throws	IllegalArgumentException: 如果 cause 是此抛出对象。（抛出对象不能是它自己的原因。）
Throws	IllegalStateException: 如果此 throwable 是通过 #JAXRException(Throwable) 或 #JAXRException(String,Throwable) 创建的，或者已经对此 throwable 调用了此方法。

英文文档：

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.

Overrides:

initCause in class Throwable

Parameters:

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.)

Returns:

a reference to this Throwable instance.

Throws:

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.

public String getRequestId()

英文文档：

getRequestId

public String getRequestId()

Description copied from interface: JAXRResponse

Returns the unique id for the request that generated this response.

Capability Level: 0

Specified by:

getRequestId in interface JAXRResponse

Returns:

the request id

public int getStatus()

英文文档：

getStatus

public int getStatus()

Description copied from interface: JAXRResponse

Returns the status for this response.

Capability Level: 0

Specified by:

getStatus in interface JAXRResponse

Returns:

the status which is an integer enumerated value

See Also:

JAXRResponse.STATUS_SUCCESS

public boolean isAvailable() throws JAXRException
如果响应是可用的，则返回 true，否则返回 false。这是一个轮询方法，不得阻塞。

英文文档：

isAvailable

public boolean isAvailable()
                    throws JAXRException

Returns true if a response is available, false otherwise. This is a polling method and must not block.

Specified by:

isAvailable in interface JAXRResponse

Returns:

true if the response is available; false otherwise

Throws:

JAXRException - If the JAXR provider encounters an internal error

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.