Module  java.naming
软件包  javax.naming

Class NamingException

    • 构造方法详细信息

      • NamingException

        public NamingException​(String explanation)
        构造一个新的NamingException和解释。 所有未指定的字段都设置为null。
        参数
        explanation - 包含有关此异常的其他详细信息的可能为空的字符串。
        另请参见：
        Throwable.getMessage()

      • NamingException

        public NamingException​()
        构造一个新的NamingException。 所有字段都设置为null。

    • 方法详细信息

      • getResolvedName

        public Name getResolvedName​()
        检索已成功解决的名称的主要部分。
        结果
        已成功解决的部分名称。 它是一个复合名称。 它可以为null，这意味着已解析的名称字段尚未设置。
        另请参见：
        getResolvedObj() ， setResolvedName(javax.naming.Name)

      • getResolvedObj

        public Object getResolvedObj​()
        检索分辨率成功的对象。 这是解析名称绑定到的对象。
        结果
        到目前为止已解决的可能为null的对象。 null表示已解析的对象字段尚未设置。
        另请参见：
        getResolvedName() ， setResolvedObj(java.lang.Object)

      • getExplanation

        public String getExplanation​()
        检索与此异常相关的说明。
        结果
        可能为null的详细字符串，解释更多关于此异常。 如果为空，则表示没有此异常的详细消息。
        另请参见：
        Throwable.getMessage()

      • setResolvedName

        public void setResolvedName​(Name name)
        设置此异常的已解析名称字段。

        name是一个复合名称。 如果要使用复合名称或字符串设置此字段，则必须“复制”复合名称，并使用字符串创建具有单个组件的组合名称。 然后可以使用生成的组合名称来调用此方法。

        制作并存储name的副本。 name后续更改不会影响此NamingException中的副本，反之亦然。

        参数
        name - 将解析后的名称设置为可能为空的名称。 如果为空，则将已解析的名称字段设置为null。
        另请参见：
        getResolvedName()

      • setRemainingName

        public void setRemainingName​(Name name)
        设置此异常的剩余名称字段。

        name是一个复合名称。 如果要使用复合名称或字符串设置此字段，则必须“复制”复合名称，并使用字符串创建具有单个组件的组合名称。 然后可以使用生成的组合名称来调用此方法。

        制作并存储name的副本。 name后续更改不会影响此NamingException中的副本，反之亦然。

        参数
        name - 将剩余名称设置为可能为空的名称。 如果为空，则将其余名称字段设置为null。
        另请参见：
        getRemainingName() ， appendRemainingName(javax.naming.Name) ， appendRemainingComponent(java.lang.String)

      • setResolvedObj

        public void setResolvedObj​(Object obj)
        设置此异常的已解析对象字段。
        参数
        obj - 将可解析对象设置为可能为空的对象。 如果为空，则将已解析的对象字段设置为null。
        另请参见：
        getResolvedObj()

      • appendRemainingName

        public void appendRemainingName​(Name name)
        从“name”添加组件作为剩余名称中的最后一个组件。

        name是一个复合名称。 如果意图附加复合名称，则应该“复制”复合名称，然后调用接受String参数的重载表单。

        name后续更改不会影响此NamingException中的剩余名称字段，反之亦然。

        参数
        name - 包含要添加的有序组件的可能为空的名称。 如果name为null，则此方法不执行任何操作。
        另请参见：
        setRemainingName(javax.naming.Name) ， getRemainingName() ， appendRemainingComponent(java.lang.String)

      • getRootCause

        public Throwable getRootCause​()
        检索此NamingException的根本原因（如果有）。 当服务提供商想要向调用者指示非命名相关的异常时，使用命名异常的根本原因，但同时要使用NamingException结构来指示命名操作进行的距离。

        这种方法早于通用异常链接工具。 getCause()方法现在是获取此信息的首选方法。

        结果
        引起此命名异常的可能为空的异常。 如果为null，则表示没有为此命名异常设置根本原因。
        另请参见：
        setRootCause(java.lang.Throwable) ， rootException ， getCause()

      • setRootCause

        public void setRootCause​(Throwable e)
        记录此NamingException的根本原因。 如果e为this ，则此方法不执行任何操作。

        这种方法早于通用异常链接工具。 initCause(Throwable)方法现在是记录此信息的首选方法。

        参数
        e - 导致命名操作失败的可能为空的异常。 如果为空，则表示此命名异常没有根本原因。
        另请参见：
        getRootCause() ， rootException ， initCause(java.lang.Throwable)

      • getCause

        public Throwable getCause​()
        返回此异常的原因。 原因是引发这个命名异常的可抛出。 如果原因不存在或未知，则返回null 。
        重写：
        getCause在 Throwable
        结果
        这个例外的原因，或 null如果原因不存在或未知。
        从以下版本开始：
        1.4
        另请参见：
        initCause(Throwable)

      • initCause

        public Throwable initCause​(Throwable cause)
        将此异常的原因初始化为指定的值。 原因是引发这个命名异常的可抛出。

        最多可以调用此方法一次。

        重写：
        initCause在 Throwable
        参数
        cause - 原因，保存以供getCause()方法稍后检索。 A null值表示原因不存在或未知。
        结果
        参考这个 NamingException例子。
        异常
        IllegalArgumentException - 如果cause是这个例外。 （一个可以不是自己的事业）
        IllegalStateException - 如果此方法已被调用此异常。
        从以下版本开始：
        1.4
        另请参见：
        getCause()

      • toString

        public String toString​()
        生成此异常的字符串表示形式。 字符串表示由此异常的类名称，其详细消息以及如果它有根本原因，根本原因异常的字符串表示形式，后跟剩余的名称（如果它不为空）。 此字符串用于调试，而不是以编程方式解释。
        重写：
        toString在 Throwable
        结果
        包含此异常的字符串表示形式的非空字符串。

      • toString

        public String toString​(boolean detail)
        更详细地生成字符串表示。 此字符串表示由不受参数的toString（）返回的信息，以及解析对象的字符串表示（如果不为空）组成。 此字符串用于调试，而不是以编程方式解释。
        参数
        detail - 如果为true，除了其他信息之外，还包括有关已解析对象的详细信息。
        结果
        包含字符串表示形式的非空字符串。