モジュール java.naming
パッケージ javax.naming

クラスNamingException

    • フィールドの詳細

      • resolvedName

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

      • resolvedObj

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

      • rootException

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

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

        関連項目:
        getRootCause(), setRootCause(Throwable), initCause(Throwable), getCause()

    • コンストラクタの詳細

      • NamingException

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

      • NamingException

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

    • メソッドの詳細

      • getResolvedName

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

      • getResolvedObj

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

      • getExplanation

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

      • setResolvedName

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

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

        nameのコピーが作成され、格納されます。 その後のnameの変更は、このNamingException内のコピーに影響しません。

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

      • setRemainingName

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

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

        nameのコピーが作成され、格納されます。 その後のnameの変更は、このNamingException内のコピーに影響しません。

        パラメータ:
        name - nullの可能性がある、残存名に設定する名前。 nullの場合、残りの名前フィールドはnullに設定される。
        関連項目:
        getRemainingName(), appendRemainingName(javax.naming.Name), appendRemainingComponent(java.lang.String)

      • setResolvedObj

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

      • appendRemainingName

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

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

        その後のnameの変更は、このNamingExceptionの残りの名前フィールドに影響しません。

        パラメータ:
        name - nullの可能性がある、追加する順序付きコンポーネントを含んだ文字列。 名前がnullの場合、このメソッドは機能しない。
        関連項目:
        setRemainingName(javax.naming.Name), getRemainingName(), appendRemainingComponent(java.lang.String)

      • getRootCause

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

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

        戻り値:
        nullの可能性がある、このネーミング例外の原因となった例外。 nullの場合は、このネーミング例外に対して根本原因が設定されていないことを示す。
        関連項目:
        setRootCause(java.lang.Throwable), rootException, getCause()

      • setRootCause

        public void setRootCause​(Throwable e)
        このNamingExceptionの根本原因を記録します。 eがthisの場合、このメソッドは機能しません。

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

        パラメータ:
        e - nullの可能性がある、失敗するネーミング操作の原因となった例外。 nullの場合は、このネーミング例外に対して根本原因がないことを示す。
        関連項目:
        getRootCause(), rootException, initCause(java.lang.Throwable)

      • getCause

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

      • initCause

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

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

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

      • toString

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

      • toString

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