CannotProceedException

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 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, ?>)

构造方法详细信息

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)

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

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

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

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

javax.naming 类 CannotProceedException

remainingNewName

environment

altName

altNameCtx

CannotProceedException

CannotProceedException

getEnvironment

setEnvironment

getRemainingNewName

setRemainingNewName

getAltName

setAltName

getAltNameCtx

setAltNameCtx

javax.naming
类 CannotProceedException