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)