compact3

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() このスロー可能オブジェクトの原因を返しますが、原因が存在しないか不明な場合はnullを返します。
Throwable	initCause(Throwable cause) このスロー可能オブジェクトの原因を、指定された値に初期化します。
String	toString() この例外の文字列表現を返します。

クラス java.lang.Throwableから継承されたメソッド

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, 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

このスロー可能オブジェクトの原因を返しますが、原因が存在しないか不明な場合はnullを返します。原因はこのThrowableをスローさせたThrowableです。

この実装は、Throwableを要求するいずれかのコンストラクタ経由で提供された原因、またはThrowable.initCause(Throwable)メソッドを使用して作成後に設定された原因を返します。通常、このメソッドをオーバーライドする必要はありませんが、サブクラスはこのメソッドをオーバーライドして、他のなんらかの方法で設定された原因を返すことができます。これは、チェーンされた例外をThrowableに追加する前に実行される「レガシー連鎖スロー可能オブジェクト」の場合に適切な動作です。PrintStackTraceメソッドは、いずれもオーバーライドする必要はありません。これらのメソッドはすべてgetCauseメソッドを呼び出して、スロー可能オブジェクトの原因を判別します。

オーバーライド:

getCause、クラス: Throwable

戻り値:

このスロー可能オブジェクトの原因。原因が存在しないか不明の場合はnull。

initCause

public Throwable initCause(Throwable cause)

次のクラスからコピーされた説明: Throwable

このスロー可能オブジェクトの原因を、指定された値に初期化します。原因はこのThrowableをスローさせたThrowableです。

このメソッドは最大で1回しか呼び出すことができません。通常は、コンストラクタ内から、またはThrowableの作成直後に呼び出されます。このスロー可能オブジェクトがThrowable.Throwable(Throwable)またはThrowable.Throwable(String,Throwable)を使用して作成された場合、このメソッドは1回も呼び出すことができません。

原因を設定するためのその他のサポートを含まないレガシー・スロー可能型でこのメソッドを使用する例を、次に示します。

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

オーバーライド:

initCause、クラス: Throwable

パラメータ:

cause - 原因(あとでThrowable.getCause()メソッドで取得できるように保存される)。(null値が許可されており、原因が存在しないか不明であることを示す)

戻り値:

このThrowableインスタンスへの参照。

toString

public String toString()

この例外の文字列表現を返します。文字列表現には、この例外のクラス名、詳細メッセージ、およびルート例外の文字列表現(ルート例外がある場合)が含まれています。この文字列表現は、デバッグ専用であり、プログラムによって解釈されるものではありません。

オーバーライド:

toString、クラス: Throwable

戻り値:

この例外のnull以外の文字列表現。

関連項目:

Throwable.getMessage()