- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- javax.naming.NamingException
-
- javax.naming.CannotProceedException
-
- All Implemented Interfaces:
-
Serializable
public class CannotProceedException extends NamingException
抛出此异常以指示操作达到操作无法继续进行的名称中的一个点。 当对组合名称执行操作时,命名服务提供者可能会到达不属于其命名空间的名称的一部分。 在这一点上,它可以构造一个CannotProceedException,然后调用由javax.naming.spi.NamingManager(如getContinuationContext())提供的方法来定位另一个提供者来继续操作。 如果这是不可能的,这种异常被提到上下文操作的调用者。如果程序特别要处理这个异常,那么在尝试捕获NamingException之前,它应该明确地捕获CannotProceedException。
CannotProceedException实例与并发多线程访问不同步。 尝试访问和修改CannotProceedException的多个线程应锁定该对象。
- 从以下版本开始:
- 1.3
- 另请参见:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field 描述 protected Name
altName
包含解析对象的名称,相对于上下文altNameCtx
。protected Context
altNameCtx
包含指定altName
的上下文。protected Hashtable<?,?>
environment
包含与Context或DirContext方法无关的环境。protected Name
remainingNewName
包含Context.rename()的第二个“name”参数的剩余未解决部分。-
Fields inherited from class javax.naming.NamingException
remainingName, resolvedName, resolvedObj, rootException
-
-
构造方法摘要
构造方法 Constructor 描述 CannotProceedException()
构造一个新的CannotProceedException实例。CannotProceedException(String explanation)
使用说明构造一个新的CannotProceedException实例。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 Name
getAltName()
检索此异常的altName
字段。Context
getAltNameCtx()
检索此异常的altNameCtx
字段。Hashtable<?,?>
getEnvironment()
检索创建此异常时生效的环境。Name
getRemainingNewName()
检索此异常的“剩余新名称”字段,该字段在重命名()操作期间抛出此异常时使用。void
setAltName(Name altName)
设置此异常的altName
字段。void
setAltNameCtx(Context altNameCtx)
设置此异常的altNameCtx
字段。void
setEnvironment(Hashtable<?,?> environment)
设置调用getEnvironment()时将返回的环境。void
setRemainingNewName(Name newName)
设置此异常的“剩余新名称”字段。-
Methods inherited from class javax.naming.NamingException
appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace
-
-
-
-
字段详细信息
-
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
。 它是一个复合名称。 如果为空,则不指定名称。 有关如何使用此方法的详细信息,请参阅javax.naming.spi.ObjectFactory.getObjectInstance
方法。该字段初始化为null。 不应该直接操作:应该使用getAltName()和setAltName()来访问和更新它。
-
altNameCtx
protected Context altNameCtx
包含指定altName
的上下文。 如果为空,那么默认的初始上下文是隐含的。 有关如何使用此方法的详细信息,请参阅javax.naming.spi.ObjectFactory.getObjectInstance
方法。该字段初始化为null。 它不应该直接操作:它应该使用getAltNameCtx()和setAltNameCtx()进行访问和更新。
-
-
构造方法详细信息
-
CannotProceedException
public CannotProceedException(String explanation)
使用说明构造一个新的CannotProceedException实例。 所有未指定的字段默认为null。- 参数
-
explanation
- 包含有关此异常的其他详细信息的可能为空的字符串。 如果为空,则此异常没有详细消息。 - 另请参见:
-
Throwable.getMessage()
-
CannotProceedException
public CannotProceedException()
构造一个新的CannotProceedException实例。 所有字段默认为null。
-
-
方法详细信息
-
getEnvironment
public Hashtable<?,?> getEnvironment()
检索创建此异常时生效的环境。- 结果
- 可能为空环境属性设置。 null表示没有记录此异常的环境。
- 另请参见:
-
setEnvironment(java.util.Hashtable<?, ?>)
-
setEnvironment
public void setEnvironment(Hashtable<?,?> environment)
设置调用getEnvironment()时将返回的环境。- 参数
-
environment
- 可能为null的环境属性集。 null表示没有为此异常记录环境。 - 另请参见:
-
getEnvironment()
-
getRemainingNewName
public Name getRemainingNewName()
检索此异常的“剩余新名称”字段,该字段在重命名()操作期间抛出此异常时使用。- 结果
- 新名称的可能空白部分尚未解决。 它是一个复合名称。 它可以为null,这意味着尚未设置剩余的新名称字段。
- 另请参见:
-
setRemainingNewName(javax.naming.Name)
-
setRemainingNewName
public void setRemainingNewName(Name newName)
设置此异常的“剩余新名称”字段。 这是getRemainingNewName()
返回的值。newName
是一个复合名称。 如果要使用复合名称或字符串设置此字段,则必须“复制”复合名称,并使用字符串创建具有单个组件的组合名称。 然后可以使用生成的组合名称来调用此方法。制作并存储
newName
的副本。name
后续更改不会影响此NamingException中的副本,反之亦然。- 参数
-
newName
- 将“剩余新名称”设置为可能为空的名称。 如果为空,则将其余名称字段设置为null。 - 另请参见:
-
getRemainingNewName()
-
getAltName
public Name getAltName()
检索此异常的altName
字段。 这是解析对象的名称,相对于上下文altNameCtx
。 它将在以后调用javax.naming.spi.ObjectFactory.getObjectInstance
方法时使用。- 结果
-
解析对象的名称,相对于
altNameCtx
。 它是一个复合名称。 如果为空,则不指定名称。 - 另请参见:
-
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
。 它是一个复合名称。 如果为空,则不指定名称。 - 另请参见:
-
getAltName()
,setAltNameCtx(javax.naming.Context)
-
getAltNameCtx
public Context getAltNameCtx()
检索此异常的altNameCtx
字段。 这是altName
命名的上下文。 它将在以后调用javax.naming.spi.ObjectFactory.getObjectInstance
方法时使用。- 结果
-
相对
altName
命名的上下文altName
。 如果为空,那么默认的初始上下文是隐含的。 - 另请参见:
-
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
而得名。 如果为空,那么默认的初始上下文是隐含的。 - 另请参见:
-
getAltNameCtx()
,setAltName(javax.naming.Name)
-
-