クラスNamingException

java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.naming.NamingException
すべての実装されたインタフェース:
Serializable
直系の既知のサブクラス:
AttributeInUseException, AttributeModificationException, CannotProceedException, CommunicationException, ConfigurationException, ContextNotEmptyException, InsufficientResourcesException, InterruptedNamingException, InvalidAttributeIdentifierException, InvalidAttributesException, InvalidAttributeValueException, InvalidNameException, InvalidSearchControlsException, InvalidSearchFilterException, LimitExceededException, LinkException, NameAlreadyBoundException, NameNotFoundException, NamingSecurityException, NoInitialContextException, NoSuchAttributeException, NotContextException, OperationNotSupportedException, PartialResultException, ReferralException, SchemaViolationException, ServiceUnavailableException
public class NamingException extends Exception
ContextおよびDirContextインタフェースでの操作によってスローされるすべての例外のスーパー・クラスです。 失敗の種類は、サブクラスの名前で示されます。 この例外は、操作が失敗した位置、解決が最後に行われた位置を正確に示す情 を取得します。
  • 解決名。 解決された名前の一部分。
  • 解決オブジェクト。 名前の解決が行われたオブジェクト。
  • 残存ネー 。 解決されていない名前の一部分。
  • 説明 名前解決が失敗した理由の詳細情 。
  • ルート例外。 このネーミング例外のスローの原 となった例外。
nullはこれらのどのフィールドにも受け入れられます。 nullは、上記のような情 がフィールドに対して記録されないことを意味します。

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

この例外は汎用的な例外チェーン・メカニズ に適合するように改良されています。 ルート例外 (または 本原 )はThrowable.getCause()メソッドによって返される原 と同じオブジェクトです。

導入されたバージョン:
1.3
関連 目:

  • フィールド詳細

    • resolvedName

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

    • resolvedObj

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

    • remainingName

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

    • rootException

      protected Throwable rootException
      このNamingExceptionがスローされる原 となった元の例外を含みます。 このフィールドは、元の例外から取得可能な追 情 がある 合や、NamingExceptionのサブクラスにマップできない元の例外がある 合に設定されます。 nullも可。

      このフィールドは、汎用的な例外チェーン機能以前から使用されています。 initCause(Throwable)およびgetCause()メソッドが、この情 にアクセスするために現在推奨されている方法です。

      関連 目:

  • コンストラクタの詳細

    • NamingException

      public NamingException(String explanation)
      NamingExceptionを説明付きで新しく構築します。 指定されていないフィールドはすべてnullに設定されます。
      パラメータ:
      explanation - この例外に関する追 の詳細情 を含むnullの可能性がある文字列。
      関連 目:

    • NamingException

      public NamingException()
      NamingExceptionを新しく構築します。 フィールドはすべてnullに設定されます。

  • メソッドの詳細

    • getResolvedName

      public Name getResolvedName()
      正常に解決された名前の先 部分を取得します。
      戻り値:
      正常に解決された名前の部分。 合成名である。 nullの 合はresolvedNameフィールドが設定されていないことを示す。
      関連 目:

    • getRemainingName

      public Name getRemainingName()
      名前の残りの未解決部分を取得します。
      戻り値:
      解決されていない名前の部分。 合成名である。 nullの 合は、残りの名前フィールドが設定されていないことを示す。
      関連 目:

    • getResolvedObj

      public Object getResolvedObj()
      正常に解決されたオブジェクトを取得します。 これは、解決された名前がバインドされているオブジェクトです。
      戻り値:
      これまでに解決されたnullの可能性があるオブジェクト。nullは、解決されたオブジェクト・フィールドが設定されていないことを示す。
      関連 目:

    • getExplanation

      public String getExplanation()
      この例外に関連した説明を取得します。
      戻り値:
      nullの可能性がある、この例外について説明する詳細文字列。 nullの 合、この例外には詳細メッセージはない。
      関連 目:

    • setResolvedName

      public void setResolvedName(Name name)
      この例外の「resolvedName」フィールドを設定します。

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

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

      パラメータ:
      name - nullの可能性がある、解決名を設定する名前。 nullの 合、resolvedNameフィールドはnullに設定される。
      関連 目:

    • setRemainingName

      public void setRemainingName(Name name)
      この例外の残りの名前フィールドを設定します。

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

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

      パラメータ:
      name - nullの可能性がある、残存名に設定する名前。 nullの 合、残りの名前フィールドはnullに設定される。
      関連 目:

    • setResolvedObj

      public void setResolvedObj(Object obj)
      この例外の「解決されたオブジェクト」フィールドを設定します。
      パラメータ:
      obj - nullの可能性がある、解決オブジェクトに設定するオブジェクト。 nullの 合、解決されたオブジェクト・フィールドはnullに設定される。
      関連 目:

    • appendRemainingComponent

      public void appendRemainingComponent(String name)
      残りの名前の最後のコンポーネントとして名前を追 します。
      パラメータ:
      name - 追 するコンポーネント。 名前がnullの 合、このメソッドは機能しない。
      関連 目:

    • appendRemainingName

      public void appendRemainingName(Name name)
      残りの名前の最後のコンポーネントとして「名前」からコンポーネントを追 します。

      nameはコンポジット名です。 複合名を追 する 合は、複合名を文字列化してから、Stringパラメータを受け入れるオーバーロードされた形式を呼び出します。

      後続のnameの変更は、このNamingExceptionの残りの名前フィールドには影響せず、その逆も同様です。

      パラメータ:
      name - nullの可能性がある、追 する 序付きコンポーネントを含ん 文字列。 名前がnullの 合、このメソッドは機能しない。
      関連 目:

    • getRootCause

      public Throwable getRootCause()
      このNamingExceptionの 本原 がある 合は、その 本原 を取得します。 ネーミング例外の 本原 は、サービス・プロバイダが呼出し側に対して名前以外に関連する例外を示すときに使用されますが、同時にNamingException構 を使用してネーミング操作処理の完了状況を示す 合にも使用されます。

      このメソッドは汎用的な例外チェーン機能に先行します。 getCause()メソッドが、この情 を取得するために現在推奨されている手段です。

      戻り値:
      nullの可能性がある、このネーミング例外の原 となった例外。 nullの 合は、このネーミング例外に対して 本原 が設定されていないことを示す。
      関連 目:

    • setRootCause

      public void setRootCause(Throwable e)
      このNamingExceptionの 本原 を記録します。 eがthisの 合、このメソッドは何も行いません。

      このメソッドは汎用的な例外チェーン機能に先行します。 initCause(Throwable)メソッドが、この情 を記録するために現在推奨されている手段です。

      パラメータ:
      e - nullの可能性がある、失敗するネーミング操作の原 となった例外。 nullの 合は、このネーミング例外に対して 本原 がないことを示す。
      関連 目:

    • getCause

      public Throwable getCause()
      この例外の原 を返します。 原 は、このネーミング例外がスローされる原 となったThrowableです。 原 が存在しない 合や不明な 合は、nullを返します。
      オーバーライド:
      getCause、クラスThrowable
      戻り値:
      この例外の原 。原 が存在しないか不明な 合はnull。
      導入されたバージョン:
      1.4
      関連 目:

    • initCause

      public Throwable initCause(Throwable cause)
      この例外の原 を、指定された値に初期化します。 原 は、このネーミング例外がスローされる原 となったThrowableです。

      このメソッドは最大で1回呼び出すことができます。

      オーバーライド:
      initCause、クラスThrowable
      パラメータ:
      cause - 原 (あとでgetCause()メソッドで取得できるように保存される)。 null値は、原 が存在しないか不明であることを示します。
      戻り値:
      このNamingExceptionインスタンスへの参照。
      スロー:
      IllegalArgumentException - causeがこの例外の 合。 (Throwableはそれ自身の原 にはなれない)
      IllegalStateException - このメソッドが、この例外に対してすでに呼び出されていた 合。
      導入されたバージョン:
      1.4
      関連 目:

    • toString

      public String toString()
      この例外の文字列表現が生成されます。 文字列表現は、この例外のクラス名、その詳細メッセージで構成されます。 本原 がある 合は、 本原 を持つ例外の文字列表現と、その後に続く残りの名前(nullでない 合)で構成されます。 この文字列はデバッグに使用され、プログラ によって解釈されることはありません。
      オーバーライド:
      toString、クラスThrowable
      戻り値:
      この例外の文字列表現が 納されるnull以外の文字列。

    • toString

      public String toString(boolean detail)
      より詳細な文字列表現が生成されます。 この文字列表現は、パラメータをとらないtoString()によって返される情 と、解決されたオブジェクトの文字列表現(nullでない 合)で構成されます。 この文字列はデバッグに使用され、プログラ によって解釈されることはありません。
      パラメータ:
      detail - trueの 合、ほかの情 以外に解決されたオブジェクトに関する詳細を含む。
      戻り値:
      文字列表現が 納されるnull以外の文字列。