モジュール 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に追加されます。

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

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

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

導入されたバージョン:
1.3
関連項目:
Context.lookupLink(javax.naming.Name), LinkRef, 直列化された形式

  • フィールド詳細

    • 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以外の文字列表現。