JavaTM Platform
Standard Ed. 6

javax.naming
类 CannotProceedException

java.lang.Object
  继承者 java.lang.Throwable
      继承者 java.lang.Exception
          继承者 javax.naming.NamingException
              继承者 javax.naming.CannotProceedException
所有已实现的接口:
Serializable

public class CannotProceedException
extends NamingException

抛出此异常指示操作到达了名称中的某一点,在该点上操作无法继续进行。在某一复合名称上执行操作时,命名服务提供者可以到达不属于其名称空间的名称部分。在该点上,它可以构造一个 CannotProceedException,然后调用 javax.naming.spi.NamingManager 提供的方法(比如 getContinuationContext())来查找另一个提供者,以继续该操作。如果不能完成该过程,则向该上下文操作的调用者引发此异常。

如果程序想要单独处理此异常,它应该在试图捕获 NamingException 之前显式捕获 CannotProceedException。

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

从以下版本开始:
1.3
另请参见:
序列化表格

字段摘要
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" 字段。
 
从类 javax.naming.NamingException 继承的方法
appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString
 
从类 java.lang.Throwable 继承的方法
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
从类 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。该名称是一个复合名称。如果为 null,则不指定任何名称。有关如何使用此方法的详细信息,请参见 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 是相对于该上下文指定的。如果为 null,则暗指默认初始上下文。有关如何使用此方法的详细信息,请参见 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 - 一个可能为 null 的字符串,包含有关此异常的附加详细信息。如果为 null,则此异常没有详细消息。
另请参见:
Throwable.getMessage()

CannotProceedException

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

方法详细信息

getEnvironment

public Hashtable<?,?> getEnvironment()
检索创建此异常时受影响的环境。

返回:
可能为 null 的环境属性设置。null 表示没有为此异常记录任何环境。
另请参见:
setEnvironment(java.util.Hashtable)

setEnvironment

public void setEnvironment(Hashtable<?,?> environment)
设置调用 getEnvironment() 时将返回的环境。

参数:
environment - 可能为 null 的环境属性设置。null 表示不会为此异常记录任何环境。
另请参见:
getEnvironment()

getRemainingNewName

public Name getRemainingNewName()
检索此异常的 "remaining new name" 字段,当执行 rename() 操作期间抛出此异常时,将使用该字段。

返回:
尚未解析的可能为 null 的新名称部分。该名称是一个复合名称。它可以为 null,表示剩余的新名称字段尚未设置。
另请参见:
setRemainingNewName(javax.naming.Name)

setRemainingNewName

public void setRemainingNewName(Name newName)
设置此异常的 "remaining new name" 字段。该设置值由 getRemainingNewName() 返回。

newName 是一个复合名称。如果打算使用复合名称或字符串设置此字段,则必须将该复合名称“字符串化”,并用使用该字符串的单个组件创建一个复合名称。然后可以使用得到的复合名称调用此方法。

创建并存储 newName 的副本。对 name 进行的后续更改不会影响此 NamingException 中的副本,反之亦然。

参数:
newName - 可能为 null 的名称,"remaining new name" 将被设置成该名称。如果其为 null,则将剩余的名称字段设置为 null。
另请参见:
getRemainingNewName()

getAltName

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)

setAltName

public void setAltName(Name altName)
设置此异常的 altName 字段。

参数:
altName - 已解析对象的名称,该名称相对于 altNameCtx。该名称是一个复合名称。如果为 null,则不指定任何名称。
另请参见:
getAltName(), setAltNameCtx(javax.naming.Context)

getAltNameCtx

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)

setAltNameCtx

public void setAltNameCtx(Context altNameCtx)
设置此异常的 altNameCtx 字段。

参数:
altNameCtx - 上下文,altName 是相对于该上下文指定的。如果为 null,则暗指默认初始上下文。
另请参见:
getAltNameCtx(), setAltName(javax.naming.Name)

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策