Module  java.naming
软件包  javax.naming

Class CannotProceedException

  • All Implemented Interfaces:
    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 - 包含有关此异常的其他详细信息的可能为空的字符串。 如果为空，则此异常没有详细消息。
        另请参见：
        Throwable.getMessage()

      • CannotProceedException

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

    • 方法详细信息

      • setEnvironment

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

      • getRemainingNewName

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

      • setRemainingNewName

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

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

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

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

      • setAltName

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

      • setAltNameCtx

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