JavaTM 2 Platform
Standard Ed. 5.0

javax.security.sasl
类 SaslException

java.lang.Object
  继承者 java.lang.Throwable
      继承者 java.lang.Exception
          继承者 java.io.IOException
              继承者 javax.security.sasl.SaslException
所有已实现的接口:
Serializable
直接已知子类:
AuthenticationException

public class SaslException
extends IOException

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

从以下版本开始:
1.5
另请参见:
序列化表格

构造方法摘要
SaslException()
          构造一个新的 SaslException 实例。
SaslException(String detail)
          构造带详细消息的新 SaslException 实例。
SaslException(String detail, Throwable ex)
          构造带详细消息和根异常的新 SaslException 实例。
 
方法摘要
 Throwable getCause()
          返回此 throwable 的 cause;如果 cause 不存在或未知,则返回 null
 Throwable initCause(Throwable cause)
          将此 throwable 的 cause 初始化为指定值。
 String toString()
          返回此异常的字符串表示形式。
 
从类 java.lang.Throwable 继承的方法
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
从类 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 - 包含异常细节的字符串,可以为 null。
另请参见:
Throwable.getMessage()

SaslException

public SaslException(String detail,
                     Throwable ex)
构造带详细消息和根异常的新 SaslException 实例。例如,可能由于回调处理程序的问题而导致的 SaslException,如果该处理程序不支持请求的回调,则抛出 NoSuchCallbackException,如果该处理程序获取回调数据时有问题,则抛出 IOException。因此,SaslException 的根异常就是该回调处理程序所抛出的异常。

参数:
detail - 包含异常细节的字符串,可以为 null。
ex - 导致此异常的根异常,可以为 null。
另请参见:
Throwable.getMessage(), getCause()
方法详细信息

getCause

public Throwable getCause()
从类 Throwable 复制的描述
返回此 throwable 的 cause;如果 cause 不存在或未知,则返回 null。(该 Cause 是导致抛出此 throwable 的throwable。)

此实现返回由一个需要 Throwable 的构造方法提供的 cause,或者在创建之后通过 Throwable.initCause(Throwable) 方法进行设置的 cause。虽然通常不需要重写此方法,但子类可以重写它,以返回一个通过某些其他方式设置的 cause。这适用于在异常链(异常嵌套)机制被加入到 Throwable 之前存在“遗留 Throwable 链机制”的情况。注意,不必 重写任何 PrintStackTrace 方法,所有方法都调用 getCause 方法来确定 throwable 的 cause。

覆盖:
Throwable 中的 getCause
返回:
此 throwable 的 cause,如果 cause 不存在或是未知的,则返回 null

initCause

public Throwable initCause(Throwable cause)
从类 Throwable 复制的描述
将此 throwable 的 cause 初始化为指定值。(该 Cause 是导致抛出此 throwable 的throwable。)

此方法至多可以调用一次。此方法通常从构造方法中调用,或者在创建 throwable 后立即调用。如果此 throwable 通过 Throwable.Throwable(Throwable)Throwable.Throwable(String,Throwable) 创建,此方法甚至一次也不能调用。

覆盖:
Throwable 中的 initCause
参数:
cause - 原因(保存此 cause,以便以后通过 Throwable.getCause() 方法检索它)。(允许 null 值,指出 cause 是不存在的或是未知的。)
返回:
对此 Throwable 实例的引用。

toString

public String toString()
返回此异常的字符串表示形式。该字符串表示形式包含此异常的类名、其详细消息,并且如果有根异常,还包含该根异常的字符串表示形式。此字符串表示形式用于调试,意味着不以编程方式解释它。

覆盖:
Throwable 中的 toString
返回:
此异常的非 null 字符串表示形式。
另请参见:
Throwable.getMessage()

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策