javax.naming
類別 LinkRef

java.lang.Object
  javax.naming.Reference
      javax.naming.LinkRef

所有已實作的介面：

Serializable, Cloneable

public class LinkRef
extends Reference

此類別表示一個 Reference，其內容是綁定到上下文中的原子名稱的一個名稱，稱為連接名稱 (link name)。

該名稱是一個 URL，或者是一個將被相對於初始上下文解析的名稱，如果該名稱的第一個字元是 "."，則它相對於綁定該連接的上下文。

在上下文操作中，普通的名稱解析總是根據連接進行的。解析連接名稱本身可能導致該解析通過其他連接。這可能導致連接循環，該循環中的解析通常無法終止。有一個避免這類別無法終止的解析的簡單方法，即服務提供者可以定義一個關於調用者調用的任何單獨操作中可以涉及的連接數的限制。

LinkRef 套件含單個 StringRefAddr，其型別為 "LinkAddress"，其內容則是一個連接名稱。Reference 的類別名稱欄位是此 (LinkRef) 類別的類別名稱欄位。

可使用標準的 Context.bind()/rebind() 和 DirContext.bind()/rebind() 將 LinkRef 綁定到一個名稱。如果最終原子名稱被綁定到某一連接，則使用 Context.lookupLink() 來檢索該連接本身。

許多命名系統支持可在該命名系統本身中使用的本機連接概念。JNDI 不指定這類別本機連接與 JNDI 連接之間是否存在任何關係。

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

從以下版本開始：

1.3

另請參見：

LinkException, LinkLoopException, MalformedLinkException, Context.lookupLink(javax.naming.Name), 序列化表格

欄位摘要

從類別 javax.naming.Reference 繼承的欄位

addrs, classFactory, classFactoryLocation, className

建構子摘要

LinkRef(Name linkName)
為某一名稱建構一個 LinkRef。

LinkRef(String linkName)
為某一字元串名稱建構一個 LinkRef。

方法摘要

String

getLinkName() 檢索此連接的名稱。

從類別 javax.naming.Reference 繼承的方法

add, add, clear, clone, equals, get, get, getAll, getClassName, getFactoryClassLocation, getFactoryClassName, hashCode, remove, size, toString

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

finalize, getClass, notify, notifyAll, wait, wait, wait

建構子詳細資訊

LinkRef

public LinkRef(Name linkName)

為某一名稱建構一個 LinkRef。

參數：

linkName - 將為其創建此連接的非 null 名稱。

LinkRef

public LinkRef(String linkName)

為某一字元串名稱建構一個 LinkRef。

參數：

linkName - 將為其創建此連接的非 null 名稱。

方法詳細資訊

getLinkName

public String getLinkName()
                   throws NamingException

檢索此連接的名稱。

返回：

此連接的非 null 名稱。

拋出：

MalformedLinkException - 如果無法提取連接名稱

NamingException - 如果遇到命名異常。