モジュール java.naming

パッケージ javax.naming

クラスLinkException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.naming.NamingException

javax.naming.LinkException

すべての実装されたインタフェース:

Serializable

直系の既知のサブクラス:

LinkLoopException, MalformedLinkException

public class LinkException extends NamingException

この例外は、リンクの解決中に発生した問題を記述するために使用されます。 リンクの問題を特定するために、基本NamingExceptionに追加情報が追加されます。

NamingExceptionが名前解決情報を取得する方法と同様に、LinkExceptionは、リンクの解決中に発生した問題を特定する"link"-name解決情報を取得します。 これらのフィールドをすべてnullにすることもできます。

• リンク解決名。 解決されたリンク名の一部分。
• リンク解決オブジェクト。 リンク名の解決が行われたオブジェクト。
• リンク残存ネーム。 解決されていないリンク名の一部分。
• リンク説明。 リンク解決が失敗した理由の詳細情報。

LinkExceptionインスタンスは、並行マルチスレッド・アクセスに対して同期化されません。 単一のLinkExceptionインスタンスにアクセスして変更しようとする複数のスレッドによって、オブジェクトはロックされます。

導入されたバージョン:

1.3

関連項目:

• Context.lookupLink(javax.naming.Name)
• LinkRef
• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected String	linkExplanation	リンクの解決が失敗した理由の例外を含みます。
protected Name	linkRemainingName	未解決の残りのリンクを含みます。
protected Name	linkResolvedName	正常に解決されたリンクの部分を含みます。
protected Object	linkResolvedObj	リンクの部分が正常に解決されたオブジェクトを含みます。

クラスjavax.naming.NamingExceptionで宣言されたフィールド

remainingName, resolvedName, resolvedObj, rootException

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
LinkException()	LinkExceptionの新しいインスタンスを構築します。
LinkException(String explanation)	説明を使用して、LinkExceptionの新しいインスタンスを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
String	getLinkExplanation()	リンクの解決時に発生した問題に関連する説明を取得します。
Name	getLinkRemainingName()	リンク名の残りの未解決部分を取得します。
Name	getLinkResolvedName()	正常に解決されたリンクの先頭部分を取得します。
Object	getLinkResolvedObj()	正常に解決されたオブジェクトを取得します。
void	setLinkExplanation(String msg)	リンクの解決時に発生した問題に関連する説明を設定します。
void	setLinkRemainingName(Name name)	この例外の「linkRemainingName」フィールドを設定します。
void	setLinkResolvedName(Name name)	この例外の「linkResolvedName」フィールドを設定します。
void	setLinkResolvedObj(Object obj)	この例外の「linkResolvedObj」フィールドを設定します。
String	toString()	この例外の文字列表現が生成されます。
String	toString(boolean detail)	この例外の文字列表現が生成されます。

クラスjavax.naming.NamingExceptionで宣言されたメソッド

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause

クラス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

フィールド詳細

linkResolvedName

protected Name linkResolvedName

正常に解決されたリンクの部分を含みます。 これは合成名で、nullを指定できます。 このフィールドはコンストラクタによって初期化されます。 getメソッドおよびsetメソッドによってこのフィールドにアクセスし、処理します。

関連項目:

• getLinkResolvedName()
• setLinkResolvedName(javax.naming.Name)

linkResolvedObj

protected Object linkResolvedObj

リンクの部分が正常に解決されたオブジェクトを含みます。 nullも可。 このフィールドはコンストラクタによって初期化されます。 getメソッドおよびsetメソッドによってこのフィールドにアクセスし、処理します。

関連項目:

• getLinkResolvedObj()
• setLinkResolvedObj(java.lang.Object)

linkRemainingName

protected Name linkRemainingName

未解決の残りのリンクを含みます。 これは合成名で、nullを指定できます。 このフィールドはコンストラクタによって初期化されます。 getメソッドおよびsetメソッドによってこのフィールドにアクセスし、処理します。

関連項目:

• getLinkRemainingName()
• setLinkRemainingName(javax.naming.Name)

linkExplanation

protected String linkExplanation

リンクの解決が失敗した理由の例外を含みます。 nullも可。 このフィールドはコンストラクタによって初期化されます。 getメソッドおよびsetメソッドによってこのフィールドにアクセスし、処理します。

関連項目:

• getLinkExplanation()
• setLinkExplanation(java.lang.String)

コンストラクタの詳細

LinkException

public LinkException(String explanation)

説明を使用して、LinkExceptionの新しいインスタンスを構築します。 その他のフィールドはすべてnullに初期化されます。

パラメータ:

explanation - この例外に関する追加の詳細情報を含むnullの可能性がある文字列。

関連項目:

• Throwable.getMessage()

LinkException

public LinkException()

LinkExceptionの新しいインスタンスを構築します。 リンクに関連しない、およびリンクに関連するフィールドはすべてnullに初期化されます。

メソッドの詳細

getLinkResolvedName

public Name getLinkResolvedName()

正常に解決されたリンクの先頭部分を取得します。

戻り値:

正常に解決されたリンク名の部分。 合成名である。 nullを指定でき、その場合は「linkResolvedName (リンク解決名)」フィールドが設定されていないことを示す。

関連項目:

• getLinkResolvedObj()
• setLinkResolvedName(javax.naming.Name)

getLinkRemainingName

public Name getLinkRemainingName()

リンク名の残りの未解決部分を取得します。

戻り値:

解決されていないリンク名の部分。 合成名である。 nullの場合は、「linkRemainingName (リンク残存名)」フィールドが設定されていないことを示す。

関連項目:

• setLinkRemainingName(javax.naming.Name)

getLinkResolvedObj

public Object getLinkResolvedObj()

正常に解決されたオブジェクトを取得します。 これは、解決されたリンク名がバインドされているオブジェクトです。

戻り値:

これまでに解決されたnullの可能性があるオブジェクト。 nullの場合、「linkResolvedObj (リンク解決オブジェクト)」フィールドは設定されていないことを示す。

関連項目:

• getLinkResolvedName()
• setLinkResolvedObj(java.lang.Object)

getLinkExplanation

public String getLinkExplanation()

リンクの解決時に発生した問題に関連する説明を取得します。

戻り値:

nullの可能性がある、リンクを解決する問題について説明する詳細文字列。 nullの場合、この例外にはリンク詳細メッセージはない。

関連項目:

• setLinkExplanation(java.lang.String)

setLinkExplanation

public void setLinkExplanation(String msg)

リンクの解決時に発生した問題に関連する説明を設定します。

パラメータ:

msg - nullの可能性がある、リンクを解決する問題について説明する詳細文字列。 nullの場合、詳細メッセージは記録されないことを示す。

関連項目:

• getLinkExplanation()

setLinkResolvedName

public void setLinkResolvedName(Name name)

この例外の「linkResolvedName」フィールドを設定します。

nameはコンポジット名です。 複合名または文字列を使用してこのフィールドを設定する場合は、複合名を文字列化してから、その文字列を使用して単一のコンポーネントを含む合成名を作成する必要があります。 その結果示された合成名を使用して、このメソッドを呼び出すことができます。

nameのコピーが作成され、格納されます。 nameへの後続の変更は、このNamingException内のコピーには影響せず、その逆も同様です。

パラメータ:

name - 解決されたリンク名が設定される名前。 nullを指定できる。 nullの場合、「linkResolvedName」フィールドはnullに設定される。

関連項目:

• getLinkResolvedName()

setLinkRemainingName

public void setLinkRemainingName(Name name)

この例外の「linkRemainingName」フィールドを設定します。

nameはコンポジット名です。 複合名または文字列を使用してこのフィールドを設定する場合は、複合名を文字列化してから、その文字列を使用して単一のコンポーネントを含む合成名を作成する必要があります。 その結果示された合成名を使用して、このメソッドを呼び出すことができます。

nameのコピーが作成され、格納されます。 nameへの後続の変更は、このNamingException内のコピーには影響せず、その逆も同様です。

パラメータ:

name - 残りのリンク名が設定される名前。 nullを指定できる。 nullの場合、残りの名前フィールドはnullに設定される。

関連項目:

• getLinkRemainingName()

setLinkResolvedObj

public void setLinkResolvedObj(Object obj)

この例外の「linkResolvedObj」フィールドを設定します。 これは、リンク名の最後に解決されたオブジェクトを示しています。

パラメータ:

obj - リンクが解決されたオブジェクトが設定される名前。 nullを指定できる。 nullの場合、「linkResolvedObj」フィールドはnullに設定される。

関連項目:

• getLinkResolvedObj()

toString

public String toString()

この例外の文字列表現が生成されます。 この文字列はNamingException情報、およびリンクの残りの名前で構成されます。 この文字列はデバッグに使用され、プログラムによって解釈されることはありません。

オーバーライド:

toString、クラスNamingException

戻り値:

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

toString

public String toString(boolean detail)

この例外の文字列表現が生成されます。 この文字列はNamingException情報、およびリンクを解決する追加情報で構成されます。 「detail」がtrueの場合、文字列にはリンクが解決されたオブジェクトに関する情報も含まれます。 falseの場合、このメソッドはパラメータを受け取らないtoString()形式と同じです。 この文字列はデバッグに使用され、プログラムによって解釈されることはありません。

オーバーライド:

toString、クラスNamingException

パラメータ:

detail - trueの場合、リンクが解決されたオブジェクトに関する情報が追加される。

戻り値:

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