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)

建構子詳細資訊

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)

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)