java.lang.Object java.lang.Throwable java.lang.Exception javax.naming.NamingException javax.naming.CannotProceedException
public class CannotProceedException
抛出此异常指示操作到达了名称中的某一点,在该点上操作无法继续进行。在某一复合名称上执行操作时,命名服务提供者可以到达不属于其名称空间的名称部分。在该点上,它可以构造一个 CannotProceedException,然后调用 javax.naming.spi.NamingManager 提供的方法(比如 getContinuationContext())来查找另一个提供者,以继续该操作。如果不能完成该过程,则向该上下文操作的调用者引发此异常。
如果程序想要单独处理此异常,它应该在试图捕获 NamingException 之前显式捕获 CannotProceedException。
CannotProceedException 实例与并发多线程访问不同步。尝试访问并修改 CannotProceedException 的多个线程应该锁定对象。
字段摘要 | |
---|---|
protected Name |
altName 包含已解析对象的名称,该名称相对于上下文 altNameCtx 。 |
protected Context |
altNameCtx 包含上下文, altName 是相对于该上下文指定的。 |
protected Hashtable<?,?> |
environment 包含与无法继续进行的 Context 或 DirContext 方法有关的环境。 |
protected Name |
remainingNewName 包含 Context.rename() 第二个 "name" 参数的剩余未解析部分。 |
从类 javax.naming.NamingException 继承的字段 |
---|
remainingName, resolvedName, resolvedObj, rootException |
构造方法摘要 | |
---|---|
CannotProceedException() 构造一个新的 CannotProceedException 实例。 |
|
CannotProceedException(String explanation) 使用解释构造一个新的 CannotProceedException 实例。 |
方法摘要 | |
---|---|
Name |
getAltName() 检索此异常的 altName 字段。 |
Context |
getAltNameCtx() 检索此异常的 altNameCtx 字段。 |
Hashtable<?,?> |
getEnvironment() 检索创建此异常时受影响的环境。 |
Name |
getRemainingNewName() 检索此异常的 "remaining new name" 字段,当执行 rename() 操作期间抛出此异常时,将使用该字段。 |
void |
setAltName(Name altName) 设置此异常的 altName 字段。 |
void |
setAltNameCtx(Context altNameCtx) 设置此异常的 altNameCtx 字段。 |
void |
setEnvironment(Hashtable<?,?> environment) 设置调用 getEnvironment() 时将返回的环境。 |
void |
setRemainingNewName(Name newName) 设置此异常的 "remaining new name" 字段。 |
从类 java.lang.Throwable 继承的方法 |
---|
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
protected Name remainingNewName
此字段被初始化为 null。不应该直接操作它:应该使用 getRemainingName() 和 setRemainingName() 访问和更新。
protected Hashtable<?,?> environment
此字段被初始化为 null。不应该直接操作它:应该使用 getEnvironment() 和 setEnvironment() 访问和更新。
protected Name altName
altNameCtx
。该名称是一个复合名称。如果为 null,则不指定任何名称。有关如何使用此方法的详细信息,请参见
javax.naming.spi.ObjectFactory.getObjectInstance
方法。
此字段被初始化为 null。不应该直接操作它:应该使用 getAltName() 和 setAltName() 访问和更新。
protected Context altNameCtx
altName
是相对于该上下文指定的。如果为 null,则暗指默认初始上下文。有关如何使用此方法的详细信息,请参见
javax.naming.spi.ObjectFactory.getObjectInstance
方法。
此字段被初始化为 null。不应该直接操作它:应该使用 getAltNameCtx() 和 setAltNameCtx() 访问和更新。
构造方法详细信息 |
---|
public CannotProceedException(String explanation)
explanation
- 一个可能为 null 的字符串,包含有关此异常的附加详细信息。如果为 null,则此异常没有详细消息。
Throwable.getMessage()
public CannotProceedException()
方法详细信息 |
---|
public Hashtable<?,?> getEnvironment()
setEnvironment(java.util.Hashtable
)
public void setEnvironment(Hashtable<?,?> environment)
environment
- 可能为 null 的环境属性设置。null 表示不会为此异常记录任何环境。
getEnvironment()
public Name getRemainingNewName()
setRemainingNewName(javax.naming.Name)
public void setRemainingNewName(Name newName)
getRemainingNewName()
返回。
newName 是一个复合名称。如果打算使用复合名称或字符串设置此字段,则必须将该复合名称“字符串化”,并用使用该字符串的单个组件创建一个复合名称。然后可以使用得到的复合名称调用此方法。
创建并存储 newName
的副本。对 name
进行的后续更改不会影响此 NamingException 中的副本,反之亦然。
newName
- 可能为 null 的名称,"remaining new name" 将被设置成该名称。如果其为 null,则将剩余的名称字段设置为 null。
getRemainingNewName()
public Name getAltName()
altName
字段。它是已解析对象的名称,该名称相对于上下文
altNameCtx
。在后续调用
javax.naming.spi.ObjectFactory.getObjectInstance
方法期间,将使用该名称。
altNameCtx
。该名称是一个复合名称。如果为 null,则不指定任何名称。
setAltName(javax.naming.Name)
,
getAltNameCtx()
,
ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable
)
public void setAltName(Name altName)
altName
字段。
altName
- 已解析对象的名称,该名称相对于
altNameCtx
。该名称是一个复合名称。如果为 null,则不指定任何名称。
getAltName()
,
setAltNameCtx(javax.naming.Context)
public Context getAltNameCtx()
altNameCtx
字段。它是一个上下文,
altName
就是相对于该上下文指定的。在后续调用
javax.naming.spi.ObjectFactory.getObjectInstance
方法期间,将使用该名称。
altName
是相对于该上下文指定的。如果为 null,则暗指默认初始上下文。
setAltNameCtx(javax.naming.Context)
,
getAltName()
,
ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable
)
public void setAltNameCtx(Context altNameCtx)
altNameCtx
字段。
altNameCtx
- 上下文,
altName
是相对于该上下文指定的。如果为 null,则暗指默认初始上下文。
getAltNameCtx()
,
setAltName(javax.naming.Name)