Module java.naming
Package javax.naming

Class 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
另请参阅:

  • Field Details

  • Constructor Details

    • CannotProceedException

      public CannotProceedException(String explanation)
      使用解释构造一个新的CannotProceedException实例。所有未指定的字段默认为null。
      参数:
      explanation - 可能为null的字符串，包含有关此异常的附加详细信息。如果为null，则此异常没有详细消息。
      另请参阅:

    • CannotProceedException

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

  • Method Details

    • getEnvironment

      public Hashtable<?,?> getEnvironment()
      检索创建此异常时生效的环境。
      返回:
      可能为null的环境属性集。null表示未记录此异常的环境。
      另请参阅:

    • setEnvironment

      public void setEnvironment(Hashtable<?,?> environment)
      设置调用getEnvironment()时将返回的环境。
      参数:
      environment - 可能为null的环境属性集。null表示未记录此异常的环境。
      另请参阅:

    • getRemainingNewName

      public Name getRemainingNewName()
      检索此异常的“剩余新名称”字段，在重命名()操作期间抛出此异常时使用。
      返回:
      未解析的新名称的可能为null的部分。它是一个复合名称。它可以为null，这意味着未设置剩余新名称字段。
      另请参阅:

    • setRemainingNewName

      public void setRemainingNewName(Name newName)
      设置此异常的“剩余新名称”字段。这是由getRemainingNewName()返回的值。

      newName是一个复合名称。如果意图是使用复合名称或字符串设置此字段，则必须“字符串化”复合名称，并使用该字符串创建一个具有单个组件的复合名称。然后，可以使用生成的复合名称调用此方法。

      将制作并存储newName的副本。对name的后续更改不会影响此NamingException中的副本，反之亦然。

      参数:
      newName - 可能为null的名称，用于设置“剩余新名称”。如果为null，则将剩余名称字段设置为null。
      另请参阅:

    • getAltName

      public Name getAltName()
      检索此异常的altName字段。这是已解析对象的名称，相对于上下文altNameCtx。在随后调用javax.naming.spi.ObjectFactory.getObjectInstance方法时将使用它。
      返回:
      已解析对象的名称，相对于altNameCtx。它是一个复合名称。如果为null，则未指定名称。
      另请参阅:

    • setAltName

      public void setAltName(Name altName)
      设置此异常的altName字段。
      参数:
      altName - 已解析对象的名称，相对于altNameCtx。它是一个复合名称。如果为null，则未指定名称。
      另请参阅:

    • getAltNameCtx

      public Context getAltNameCtx()
      检索此异常的altNameCtx字段。这是altName命名的上下文。在随后调用javax.naming.spi.ObjectFactory.getObjectInstance方法时将使用它。
      返回:
      altName命名的上下文。如果为null，则暗示使用默认初始上下文。
      另请参阅:

    • setAltNameCtx

      public void setAltNameCtx(Context altNameCtx)
      设置此异常的altNameCtx字段。
      参数:
      altNameCtx - 相对于其命名altName的上下文。如果为null，则意味着默认的初始上下文。
      参见: