javax.naming
類別 NameClassPair

java.lang.Object
  javax.naming.NameClassPair

所有已實作的介面：

Serializable

直接已知子類別：

Binding

public class NameClassPair
extends Object
implements Serializable

此類別表示存在於上下文中的某一綁定的物件名稱和類別名稱對。

上下文由名稱到物件的綁定組成。NameClassPair 類別表示所綁定物件的名稱和類別。它由一個名稱和表示包限定類別名稱的字元串組成。

對於動態產生名稱/類別對內容的命名系統，要創建子類別。

NameClassPair 實例與多個執行緒的共時存取不同步。需要共時地存取 NameClassPair 的執行緒應該在它們之間實作同步並提供所需的鎖定。

從以下版本開始：

1.3

另請參見：

Context.list(javax.naming.Name), 序列化表格

建構子摘要

NameClassPair(String name, String className)
在給定名稱和類別名稱的情況下建構一個 NameClassPair 實例。

NameClassPair(String name, String className, boolean isRelative)
在給定其名稱、類別名稱以及該名稱是否相對於列表上下文的情況下建構一個 NameClassPair 實例。

方法摘要

String	getClassName() 檢索綁定到此綁定名稱的物件的類別名稱。
String	getName() 檢索此綁定的名稱。
String	getNameInNamespace() 檢索此綁定的完全名稱。
boolean	isRelative() 確定此綁定的名稱是否相對於目標上下文（由 list() 方法的第一個參數命名）。
void	setClassName(String name) 設置此綁定的類別名稱。
void	setName(String name) 設置此綁定的名稱。
void	setNameInNamespace(String fullName) 設置此綁定的完全名稱。
void	setRelative(boolean r) 設置此綁定的名稱是否相對於目標上下文（由 list() 方法的第一個參數命名）。
String	toString() 產生此名稱/類別對的字元串表示形式。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

建構子詳細資訊

NameClassPair

public NameClassPair(String name,
                     String className)

在給定名稱和類別名稱的情況下建構一個 NameClassPair 實例。

參數：

name - 物件的非 null 名稱。它是相對於目標上下文（由 list() 方法的第一個參數指定）的名稱

className - 綁定到 name 的物件的類別名稱（可能為 null）。如果所綁定的物件為 null，則該參數為 null。

另請參見：

getClassName(), setClassName(java.lang.String), getName(), setName(java.lang.String)

NameClassPair

public NameClassPair(String name,
                     String className,
                     boolean isRelative)

在給定其名稱、類別名稱以及該名稱是否相對於列表上下文的情況下建構一個 NameClassPair 實例。

參數：

name - 物件的非 null 名稱。

className - 綁定到 name 的物件的類別名稱（可能為 null）。如果所綁定的物件為 null，則該參數為 null。

isRelative - 如果 name 是一個相對於目標上下文（由 list() 方法的第一個參數命名）的名稱，則該參數為 true；如果 name 是一個 URL 字元串，則該參數為 false。

另請參見：

getClassName(), setClassName(java.lang.String), getName(), setName(java.lang.String), isRelative(), setRelative(boolean)

方法詳細資訊

getClassName

public String getClassName()

檢索綁定到此綁定名稱的物件的類別名稱。如果綁定了某一參考或其他一些間接資訊，則檢索將由 Binding.getObject() 返回的最終物件的類別名稱。

返回：

所綁定物件的可能為 null 的類別名稱。如果所綁定的物件為 null，則該參數為 null。

另請參見：

Binding.getObject(), Binding.getClassName(), setClassName(java.lang.String)

getName

public String getName()

檢索此綁定的名稱。如果 isRelative() 為 true，則此名稱相對於目標上下文（由 list() 的第一個參數命名）。如果 isRelative() 為 false，則此名稱是一個 URL 字元串。

返回：

此綁定的非 null 名稱。

另請參見：

isRelative(), setName(java.lang.String)

setName

public void setName(String name)

設置此綁定的名稱。

參數：

name - 將用作該名稱的非 null 字元串。

另請參見：

getName(), setRelative(boolean)

setClassName

public void setClassName(String name)

設置此綁定的類別名稱。

參數：

name - 將用作類別名稱的可能為 null 的字元串。如果為 null，則 Binding.getClassName() 將返回該綁定中物件的實際類別名稱。如果所綁定物件為 null，則類別名稱也將為 null。

另請參見：

getClassName(), Binding.getClassName()

isRelative

public boolean isRelative()

確定此綁定的名稱是否相對於目標上下文（由 list() 方法的第一個參數命名）。

返回：

如果此綁定的名稱相對於目標上下文，則返回 true；如果此綁定的名稱是一個 URL 字元串，則返回 false。

另請參見：

setRelative(boolean), getName()

setRelative

public void setRelative(boolean r)

設置此綁定的名稱是否相對於目標上下文（由 list() 方法的第一個參數命名）。

參數：

r - 如果為 true，則綁定的名稱相對於目標上下文；如果為 false，則綁定的名稱是一個 URL 字元串。

另請參見：

isRelative(), setName(java.lang.String)

getNameInNamespace

public String getNameInNamespace()

檢索此綁定的完全名稱。該完全名稱是此綁定在其自己的名稱空間中的絕對名稱。請參見 Context.getNameInNamespace()。

在沒有將完全名稱的概念應用於此綁定的命名系統中，將拋出 UnsupportedOperationException。使用引入該方法之前編寫的服務提供者時也會拋出此異常。

此方法返回的字元串不是一個 JNDI 復合名稱，不應將它直接傳遞給上下文方法。

返回：

此綁定的完全名稱。

拋出：

UnsupportedOperationException - 如果完全名稱的概念沒有應用於命名系統中的此綁定。

從以下版本開始：

1.5

另請參見：

setNameInNamespace(java.lang.String), getName()

setNameInNamespace

public void setNameInNamespace(String fullName)

設置此綁定的完全名稱。只要創建 NameClassPair 並且一個完全名稱可應用於此綁定，就必須調用此方法設置完全名稱。

將完全名稱設置為 null（或者根本不設置它）將導致 getNameInNamespace() 拋出異常。

參數：

fullName - 要使用的完全名稱。

從以下版本開始：

1.5

另請參見：

getNameInNamespace(), setName(java.lang.String)

toString

public String toString()

產生此名稱/類別對的字元串表示形式。該字元串表示形式由以冒號 (':') 分隔的名稱和類別名稱組成。此字元串的內容用於除錯目的，不以程式方式對其進行解釋。

覆寫：

類別 Object 中的 toString

返回：

此名稱/類別對的字元串表示形式。