compact3

javax.security.sasl

Class SaslException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

javax.security.sasl.SaslException

All Implemented Interfaces:

Serializable

已知直接子类：

AuthenticationException

public class SaslException
extends IOException

此类表示使用SASL时发生的错误。

从以下版本开始：

1.5

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
SaslException() 构造一个新的实例 SaslException 。
SaslException(String detail) 构造一个新的实例 SaslException与详细的消息。
SaslException(String detail, Throwable ex) 构造的新实例 SaslException带详细消息和根异常。

方法摘要

Modifier and Type	Method and Description
Throwable	getCause() 如果原因不存在或未知，则返回此throwable的原因或 null 。
Throwable	initCause(Throwable cause) 将此throwable的 原因初始化为指定值。
String	toString() 返回此异常的字符串表示形式。

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

SaslException

public SaslException()

构造一个新的实例SaslException 。 根异常和详细消息为null。

SaslException

public SaslException(String detail)

构造一个新的实例SaslException与详细的消息。 根异常为null。

参数

detail - 包含异常详细信息的可能为空的字符串。

另请参见：

Throwable.getMessage()

SaslException

public SaslException(String detail,
                     Throwable ex)

构造的新实例SaslException带详细消息和根异常。 例如，SaslException可能是由于回调处理程序的问题引起的，如果它不支持请求的回调，则可能会抛出NoSuchCallbackException，如果在获取回调数据时遇到问题，则抛出IOException。 SaslException的根异常将是回调处理程序抛出的异常。

参数

detail - 包含异常详细信息的可能为空的字符串。

ex - 导致此异常的可能的空根异常。

另请参见：

Throwable.getMessage() ， getCause()

方法详细信息

getCause

public Throwable getCause()

描述从类别： Throwable复制

如果原因不存在或未知，则返回此throwable的原因或null 。 （原因是引发这个可抛掷物的抛掷物）

此实现返回通过需要Throwable的Throwable函数之一提供的Throwable ，或者使用Throwable.initCause(Throwable)方法创建后设置的原因 。 虽然通常不必重写此方法，但是子类可以覆盖它以返回通过其他方法设置的原因。 这适用于“传统链接可抛出”，它将链接异常添加到Throwable 。 请注意， 没有必要覆盖任何PrintStackTrace方法，所有这些方法都调用getCause方法来确定可抛出的原因。

重写：

getCause在类别 Throwable

结果

如果原因不存在或未知，则该 null的原因或 null 。

initCause

public Throwable initCause(Throwable cause)

描述从类别： Throwable复制

将此throwable的原因初始化为指定值。 （原因是引发这个可抛掷物的抛掷物）

这个方法最多可以调用一次。 它通常从构造函数中调用，或者在创建throwable之后立即调用。 如果这个throwable是使用Throwable.Throwable(Throwable)或Throwable.Throwable(String,Throwable)创建的，则该方法不能被调用一次。

在没有其他支持设置原因的情况下，以传统可抛弃类型使用此方法的示例是：

  try {
     lowLevelOp();
 } catch (LowLevelException le) {
     throw (HighLevelException)
           new HighLevelException().initCause(le); // Legacy constructor
 } 

重写：

initCause在类别 Throwable

参数

cause - 原因（由Throwable.getCause()方法保存供以后检索）。 （ null A null值，并表示原因不存在或未知。）

结果

引用这个 Throwable实例。

toString

public String toString()

返回此异常的字符串表示形式。 字符串表示法包含此异常的类名称，其详细消息，如果它具有根异常，则是根异常的字符串表示形式。 此字符串表示用于调试，而不是以编程方式解释。

重写：

toString在 Throwable

结果

此异常的非空字符串表示形式。

另请参见：

Throwable.getMessage()