模块  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)