JAXRException (Java EE 5)

Java EE API


javax.xml.registry Class JAXRException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by javax.xml.registry.JAXRException
All Implemented Interfaces:
Serializable, JAXRResponse
Direct Known Subclasses:
InvalidRequestException, RegistryException, UnexpectedObjectException, UnsupportedCapabilityException

public class JAXRException
extends Exception
implements JAXRResponse

Extends: Throwable > Exception
Implements: JAXRResponse

表示发生了 JAXR 异常。除了标准原因 String 之外,该异常不包含其他成员。
英文文档:

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

Field Summary
protected  Throwable
 
Fields inherited from interface javax.xml.registry.JAXRResponse
 
Constructor Summary
 
Method Summary
 Throwable
 String
 String
 int
 Throwable
 boolean
 
Methods inherited from class java.lang.Throwable
 
Methods inherited from class java.lang.Object
 

Field Detail

英文文档:

cause

protected Throwable cause
Constructor Detail

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

Method Detail

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

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

returnJAXRException 的错误或警告消息;如果没有此类消息,则返回嵌入 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 实例的引用。
ThrowsIllegalArgumentException: 如果 cause 是此抛出对象。(抛出对象不能是它自己的原因。)
ThrowsIllegalStateException: 如果此 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


Submit a bug or feature

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

一看就知道只有菜鸟才干这么无知的事啦。

PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正;若因此而造成任何损失请直接找人民主席,请勿与本人联系。谢谢!