- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- javax.naming.NamingException
-
- javax.naming.LinkException
-
- すべての実装されたインタフェース:
Serializable
- 直系の既知のサブクラス:
LinkLoopException
,MalformedLinkException
public class LinkException extends NamingException
この例外は、リンクの解決中に発生した問題を記述するために使用されます。 リンクに関する問題を突き止めるための追加情報がベースNamingExceptionに追加されます。LinkExceptionは、NamingExceptionが名前解決情報を取得する方法と同様に、リンクを解決する際に発生した問題を特定する"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
-
-
-
-
フィールドの詳細
-
linkResolvedName
protected Name linkResolvedName
正常に解決されたリンクの部分を含みます。 これは合成名で、nullを指定できます。 このフィールドはコンストラクタによって初期化されます。 getメソッドおよびsetメソッドによってこのフィールドにアクセスし、処理します。
-
linkResolvedObj
protected Object linkResolvedObj
リンクの部分が正常に解決されたオブジェクトを含みます。 nullも可。 このフィールドはコンストラクタによって初期化されます。 getメソッドおよびsetメソッドによってこのフィールドにアクセスし、処理します。
-
linkRemainingName
protected Name linkRemainingName
未解決の残りのリンクを含みます。 これは合成名で、nullを指定できます。 このフィールドはコンストラクタによって初期化されます。 getメソッドおよびsetメソッドによってこのフィールドにアクセスし、処理します。
-
linkExplanation
protected String linkExplanation
リンクの解決が失敗した理由の例外を含みます。 nullも可。 このフィールドはコンストラクタによって初期化されます。 getメソッドおよびsetメソッドによってこのフィールドにアクセスし、処理します。
-
-
コンストラクタの詳細
-
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以外の文字列表現。
-
-