Java javax.naming 类 CannotProceedException（JDK5）

135 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.naming
类 CannotProceedException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          javax.naming.NamingException
              javax.naming.CannotProceedException

所有已实现的接口：: Serializable

public class CannotProceedException
extends NamingException
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)