模块  java.naming
软件包  javax.naming

Class CannotProceedException

  • 实现的所有接口
    Serializable 
    public class CannotProceedException
extends NamingException
    抛出此异常表示操作已到达操作无法继续操作的名称中的某个点。 在对复合名称执行操作时，命名服务提供程序可能会到达不属于其名称空间的名称的一部分。 此时，它可以构造一个CannotProceedException，然后调用javax.naming.spi.NamingManager提供的方法（例如getContinuationContext（））来定位另一个提供程序以继续操作。 如果无法做到这一点，则会将此异常引发给上下文操作的调用者。

    如果程序特别希望处理此异常，则应在尝试捕获NamingException之前显式捕获CannotProceedException。

    对于并发多线程访问，不会同步CannotProceedException实例。 尝试访问和修改CannotProceedException的多个线程应锁定该对象。

    从以下版本开始：
    1.3
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • CannotProceedException

        public CannotProceedException​(String explanation)
        使用解释构造一个新的CannotProceedException实例。 所有未指定的字段默认为null。
        参数
        explanation - 可能为null的字符串，包含有关此异常的其他详细信息。 如果为null，则此异常没有详细消息。
        另请参见：
        Throwable.getMessage()

      • CannotProceedException

        public CannotProceedException()
        构造一个新的CannotProceedException实例。 所有字段默认为null。

    • 方法详细信息

      • setEnvironment

        public void setEnvironment​(Hashtable<?,​?> environment)
        设置调用getEnvironment（）时将返回的环境。
        参数
        environment - 可能为null的环境属性集。 null表示没有为此异常记录环境。
        另请参见：
        getEnvironment()

      • getRemainingNewName

        public Name getRemainingNewName()
        检索此异常的“剩余新名称”字段，该字段在rename（）操作期间抛出此异常时使用。
        结果
        新名称中可能为空的部分尚未解析。 它是一个复合名称。 它可以为null，这意味着尚未设置剩余的新名称字段。
        另请参见：
        setRemainingNewName(javax.naming.Name)

      • setRemainingNewName

        public void setRemainingNewName​(Name newName)
        设置此异常的“剩余新名称”字段。 这是getRemainingNewName()返回的值。

        newName是复合名称。 如果目的是使用复合名称或字符串设置此字段，则必须“字符串化”复合名称，并使用字符串创建包含单个组件的复合名称。 然后，您可以使用生成的复合名称调用此方法。

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

        参数
        newName - 用于设置“剩余新名称”的可能为空的名称。 如果为null，则将剩余名称字段设置为null。
        另请参见：
        getRemainingNewName()

      • setAltName

        public void setAltName​(Name altName)
        设置此异常的 altName字段。
        参数
        altName - 已解析对象的名称，相对于altNameCtx 。 它是一个复合名称。 如果为null，则不指定名称。
        另请参见：
        getAltName() ， setAltNameCtx(javax.naming.Context)

      • setAltNameCtx

        public void setAltNameCtx​(Context altNameCtx)
        设置此异常的 altNameCtx字段。
        参数
        altNameCtx - 相对于altName命名的上下文。 如果为null，则隐含默认的初始上下文。
        另请参见：
        getAltNameCtx() ， setAltName(javax.naming.Name)