compact3

javax.naming

Class CannotProceedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.naming.NamingException

javax.naming.CannotProceedException

All Implemented Interfaces:

Serializable

public class CannotProceedException
extends NamingException

抛出此异常以指示操作达到操作无法继续进行的名称中的一个点。 当对组合名称执行操作时，命名服务提供者可能会到达不属于其命名空间的名称的一部分。 在这一点上，它可以构造一个CannotProceedException，然后调用由javax.naming.spi.NamingManager（如getContinuationContext（））提供的方法来定位另一个提供者来继续操作。 如果这是不可能的，这种异常被提到上下文操作的调用者。

如果程序特别要处理这个异常，那么在尝试捕获NamingException之前，它应该明确地捕获CannotProceedException。

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

从以下版本开始：

1.3

另请参见：

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Name	altName 包含解析对象的名称，相对于上下文 altNameCtx 。
protected Context	altNameCtx 包含指定 altName的上下文。
protected Hashtable<?,?>	environment 包含与Context或DirContext方法无关的环境。
protected Name	remainingNewName 包含Context.rename（）的第二个“name”参数的剩余未解决部分。

Fields inherited from class javax.naming.NamingException

remainingName, resolvedName, resolvedObj, rootException

构造方法摘要

构造方法

Constructor and Description
CannotProceedException() 构造一个新的CannotProceedException实例。
CannotProceedException(String explanation) 使用说明构造一个新的CannotProceedException实例。

方法摘要

Modifier and Type	Method and Description
Name	getAltName() 检索此 altName字段。
Context	getAltNameCtx() 检索此 altNameCtx字段。
Hashtable<?,?>	getEnvironment() 检索创建此异常时生效的环境。
Name	getRemainingNewName() 检索此异常的“剩余新名称”字段，该字段在重命名（）操作期间抛出此异常时使用。
void	setAltName(Name altName) 设置此 altName字段。
void	setAltNameCtx(Context altNameCtx) 设置此 altNameCtx字段。
void	setEnvironment(Hashtable<?,?> environment) 设置调用getEnvironment（）时将返回的环境。
void	setRemainingNewName(Name newName) 设置此异常的“剩余新名称”字段。

Methods inherited from class javax.naming.NamingException

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

remainingNewName

protected Name remainingNewName

包含Context.rename（）的第二个“name”参数的剩余未解决部分。 此信息用于继续Context.rename（）操作。

该字段初始化为null。 不应该直接操作：它应该使用getRemainingName（）和setRemainingName（）进行访问和更新。

另请参见：

getRemainingNewName() ， setRemainingNewName(javax.naming.Name)

environment

protected Hashtable<?,?> environment

包含与Context或DirContext方法无关的环境。

该字段初始化为null。 不应该直接操作：它应该使用getEnvironment（）和setEnvironment（）进行访问和更新。

另请参见：

getEnvironment() ， setEnvironment(java.util.Hashtable<?, ?>)

altName

protected Name altName

包含解析对象的名称，相对于上下文altNameCtx 。 它是一个复合名称。 如果为空，则不指定名称。 有关如何使用此方法的详细信息，请参阅javax.naming.spi.ObjectFactory.getObjectInstance方法。

该字段初始化为null。 不应该直接操作：应该使用getAltName（）和setAltName（）来访问和更新它。

另请参见：

getAltName() ， setAltName(javax.naming.Name) ， altNameCtx ， ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)

altNameCtx

protected Context altNameCtx

包含指定altName的上下文。 如果为空，那么默认的初始上下文是隐含的。 有关如何使用此方法的详细信息，请参阅javax.naming.spi.ObjectFactory.getObjectInstance方法。

该字段初始化为null。 它不应该直接操作：它应该使用getAltNameCtx（）和setAltNameCtx（）进行访问和更新。

另请参见：

getAltNameCtx() ， setAltNameCtx(javax.naming.Context) ， altName ， ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)

构造方法详细信息

CannotProceedException

public CannotProceedException(String explanation)

使用说明构造一个新的CannotProceedException实例。 所有未指定的字段默认为null。

参数

explanation - 可能为空字符串，其中包含有关此异常的其他详细信息。 如果为空，则此异常没有详细消息。

另请参见：

Throwable.getMessage()

CannotProceedException

public CannotProceedException()

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

方法详细信息

getEnvironment

public Hashtable<?,?> getEnvironment()

检索创建此异常时生效的环境。

结果

可能为空环境属性设置。 null表示没有记录此异常的环境。

另请参见：

setEnvironment(java.util.Hashtable<?, ?>)

setEnvironment

public void setEnvironment(Hashtable<?,?> environment)

设置调用getEnvironment（）时将返回的环境。

参数

environment - 一个可能为空的环境属性集。 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()

getAltName

public Name getAltName()

检索此altName字段。 这是解析对象的名称，相对于上下文altNameCtx 。 将在以后调用javax.naming.spi.ObjectFactory.getObjectInstance方法中使用它。

结果

解析对象的名称，相对于altNameCtx 。 它是一个复合名称。 如果为空，则不指定名称。

另请参见：

setAltName(javax.naming.Name) ， getAltNameCtx() ， ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)

setAltName

public void setAltName(Name altName)

设置此 altName字段。

参数

altName - 解析对象的名称，相对于altNameCtx 。 它是一个复合名称。 如果为空，则不指定名称。

另请参见：

getAltName() ， setAltNameCtx(javax.naming.Context)

getAltNameCtx

public Context getAltNameCtx()

检索此altNameCtx字段。 这是altName被命名的上下文。 它将在随后调用javax.naming.spi.ObjectFactory.getObjectInstance方法时使用。

结果

命名为altName的上下文。 如果为空，那么默认的初始上下文是隐含的。

另请参见：

setAltNameCtx(javax.naming.Context) ， getAltName() ， ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)

setAltNameCtx

public void setAltNameCtx(Context altNameCtx)

设置此 altNameCtx字段。

参数

altNameCtx -上下文相对于其altName而得名。 如果为空，那么默认的初始上下文是隐含的。

另请参见：

getAltNameCtx() ， setAltName(javax.naming.Name)