java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.naming.NamingException
javax.naming.CannotProceedException
- 所有已实现的接口:
Serializable
抛出此异常表示操作已到达名称中的某个点,在此操作无法继续进行。在对复合名称执行操作时,命名服务提供者可能会到达不属于其名称空间的部分名称。此时,它可以构造一个 CannotProceedException,然后调用 javax.naming.spi.NamingManager 提供的方法(例如 getContinuationContext())来定位另一个提供者以继续操作。如果这不可能,则向上下文操作的调用者引发此异常。
如果程序想要特别处理这个异常,它应该在尝试捕获 NamingException 之前显式捕获 CannotProceedException。
CannotProceedException 实例与并发多线程访问不同步。尝试访问和修改 CannotProceedException 的多个线程应该锁定该对象。
- 自从:
- 1.3
- 参见:
-
字段摘要
字段修饰符和类型Field描述protected Name包含已解析对象的名称,相对于上下文altNameCtx。protected Context包含指定altName的相关上下文。protected Hashtable<?,?> 包含与无法继续的 Context 或 DirContext 方法相关的环境。protected Name包含 Context.rename() 的第二个“名称”参数的剩余未解决部分。在类 javax.naming.NamingException 中声明的字段
remainingName, resolvedName, resolvedObj, rootException -
构造方法总结
构造方法构造方法描述构造 CannotProceedException 的新实例。CannotProceedException(String explanation) 使用解释构造 CannotProceedException 的新实例。 -
方法总结
修饰符和类型方法描述检索此异常的altName字段。检索此异常的altNameCtx字段。Hashtable<?,?> 检索创建此异常时有效的环境。检索此异常的“剩余新名称”字段,当在 rename() 操作期间抛出此异常时使用该字段。voidsetAltName(Name altName) 设置此异常的altName字段。voidsetAltNameCtx(Context altNameCtx) 设置此异常的altNameCtx字段。voidsetEnvironment(Hashtable<?, ?> environment) 设置调用 getEnvironment() 时将返回的环境。voidsetRemainingNewName(Name newName) 设置此异常的“剩余新名称”字段。在类 javax.naming.NamingException 中声明的方法
appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString在类 java.lang.Throwable 中声明的方法
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace
-
字段详细信息
-
remainingNewName
包含 Context.rename() 的第二个“名称”参数的剩余未解决部分。此信息是继续 Context.rename() 操作所必需的。该字段初始化为空。不应直接操作它:应使用 getRemainingName() 和 setRemainingName() 访问和更新它。
- 参见:
-
environment
包含与无法继续的 Context 或 DirContext 方法相关的环境。该字段初始化为空。不应直接操作它:应使用 getEnvironment() 和 setEnvironment() 访问和更新它。
- 参见:
-
altName
包含已解析对象的名称,相对于上下文altNameCtx。它是一个复合名称。如果为空,则不指定名称。有关如何使用它的详细信息,请参阅javax.naming.spi.ObjectFactory.getObjectInstance方法。该字段初始化为空。不应直接操作它:应使用 getAltName() 和 setAltName() 访问和更新它。
- 参见:
-
altNameCtx
包含指定altName的相关上下文。如果为空,则隐含默认初始上下文。有关如何使用它的详细信息,请参阅javax.naming.spi.ObjectFactory.getObjectInstance方法。该字段初始化为空。不应直接操作它:应使用 getAltNameCtx() 和 setAltNameCtx() 访问和更新它。
- 参见:
-
-
构造方法详细信息
-
CannotProceedException
使用解释构造 CannotProceedException 的新实例。所有未指定的字段默认为空。- 参数:
explanation- 一个可能为空的字符串,其中包含有关此异常的其他详细信息。如果为 null,则此异常没有详细消息。- 参见:
-
CannotProceedException
public CannotProceedException()构造 CannotProceedException 的新实例。所有字段默认为空。
-
-
方法详情
-
getEnvironment
检索创建此异常时有效的环境。- 返回:
- 可能为 null 环境属性集。 null 表示没有为此异常记录环境。
- 参见:
-
setEnvironment
设置调用 getEnvironment() 时将返回的环境。- 参数:
environment- 一个可能为空的环境属性集。 null 表示没有为此异常记录环境。- 参见:
-
getRemainingNewName
检索此异常的“剩余新名称”字段,当在 rename() 操作期间抛出此异常时使用该字段。- 返回:
- 尚未解析的新名称的可能为空的部分。它是一个复合名称。可以为null,表示还没有设置剩余的新名称字段。
- 参见:
-
setRemainingNewName
设置此异常的“剩余新名称”字段。这是getRemainingNewName()返回的值。newName是复合名称。如果打算使用复合名称或字符串设置此字段,则必须“字符串化”复合名称,并使用字符串创建具有单个组件的复合名称。然后您可以使用生成的复合名称调用此方法。制作并存储了
newName的副本。对name的后续更改不会影响此 NamingException 中的副本,反之亦然。- 参数:
newName- 将“剩余的新名称”设置为的可能为空的名称。如果为空,它将剩余的名称字段设置为空。- 参见:
-
getAltName
检索此异常的altName字段。这是已解析对象的名称,相对于上下文altNameCtx。它将在后续调用javax.naming.spi.ObjectFactory.getObjectInstance方法时使用。- 返回:
-
已解析对象的名称,相对于
altNameCtx。它是一个复合名称。如果为空,则不指定名称。 - 参见:
-
setAltName
设置此异常的altName字段。- 参数:
altName- 已解析对象的名称,相对于altNameCtx。它是一个复合名称。如果为空,则不指定名称。- 参见:
-
getAltNameCtx
检索此异常的altNameCtx字段。这是命名altName的上下文。它将在后续调用javax.naming.spi.ObjectFactory.getObjectInstance方法时使用。- 返回:
-
命名
altName的相关上下文。如果为空,则隐含默认初始上下文。 - 参见:
-
setAltNameCtx
设置此异常的altNameCtx字段。- 参数:
altNameCtx- 命名altName的上下文。如果为空,则隐含默认初始上下文。- 参见:
-