- 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
- 另请参见:
- Serialized Form
-
-
字段汇总
字段 变量和类型 字段 描述 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()
检索此异常的“剩余新名称”字段,该字段在rename()操作期间抛出此异常时使用。void
setAltName(Name altName)
设置此异常的altName
字段。void
setAltNameCtx(Context altNameCtx)
设置此异常的altNameCtx
字段。void
setEnvironment(Hashtable<?,?> environment)
设置调用getEnvironment()时将返回的环境。void
setRemainingNewName(Name newName)
设置此异常的“剩余新名称”字段。-
声明方法的类 javax.naming.NamingException
appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString
-
-
-
-
字段详细信息
-
remainingNewName
protected Name remainingNewName
包含Context.rename()的第二个“name”参数的剩余未解析部分。 此信息是继续Context.rename()操作所必需的。该字段初始化为null。 它不应该直接操作:应该使用getRemainingName()和setRemainingName()来访问和更新它。
-
environment
protected Hashtable<?,?> environment
包含与无法继续的Context或DirContext方法相关的环境。该字段初始化为null。 它不应该直接操作:应该使用getEnvironment()和setEnvironment()来访问和更新它。
-
altName
protected Name altName
包含已解析对象的名称,相对于上下文altNameCtx
。 它是一个复合名称。 如果为null,则不指定名称。 有关如何使用此方法的详细信息,请参阅javax.naming.spi.ObjectFactory.getObjectInstance
方法。该字段初始化为null。 它不应该直接操作:应该使用getAltName()和setAltName()来访问和更新它。
-
altNameCtx
protected Context altNameCtx
包含指定altName
的上下文。 如果为null,则隐含默认的初始上下文。 有关如何使用此方法的详细信息,请参阅javax.naming.spi.ObjectFactory.getObjectInstance
方法。该字段初始化为null。 它不应该直接操作:应该使用getAltNameCtx()和setAltNameCtx()来访问和更新它。
-
-
构造方法详细信息
-
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()
检索此异常的“剩余新名称”字段,该字段在rename()操作期间抛出此异常时使用。- 结果
- 新名称中可能为空的部分尚未解析。 它是一个复合名称。 它可以为null,这意味着尚未设置剩余的新名称字段。
- 另请参见:
-
setRemainingNewName(javax.naming.Name)
-
setRemainingNewName
public void setRemainingNewName(Name newName)
设置此异常的“剩余新名称”字段。 这是getRemainingNewName()
返回的值。newName
是复合名称。 如果目的是使用复合名称或字符串设置此字段,则必须“字符串化”复合名称,并使用字符串创建包含单个组件的复合名称。 然后,您可以使用生成的复合名称调用此方法。制作并存储
newName
的副本。 对name
后续更改不会影响此NamingException中的副本,反之亦然。- 参数
-
newName
- 用于设置“剩余新名称”的可能为空的名称。 如果为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)
-
-