java.rmi.server
類別 UID

java.lang.Object
  java.rmi.server.UID

所有已實作的介面：

Serializable

public final class UID
extends Object
implements Serializable

UID 表示一個和產生它的主機的時間有關的唯一標識符，或者是 2¹⁶ 個“熟知”標識符之一。

UID() 建構子可以用來產生一個和產生此標識符的主機的時間有關的唯一標識符。UID(short) 建構子可以用來創建 2¹⁶ 個熟知標識符之一。

UID 實例包含以下三個基本值：

• unique，它是一個 int 值，唯一標識在其中產生此 UID 的 VM，並和主機和由 time 值表示的時間有關，（unique 值的範例實作是一個進程標識符），對於熟知 UID 此值為 0。
• time，它是一個 long 值，其等於此 UID 在其中產生的 VM 處於活動狀態時的時間（由 System.currentTimeMillis() 返回），對於熟知 UID 為 0。
• count，它是一個 short值，以區分用同一 time 值在同一個 VM 中產生的 UID。

單獨產生的 UID 實例具有唯一性並和產生它的主機的時間有關，條件是主機啟動所需時間超過一毫秒，並且系統時鐘從不向後調。可以通過將唯一主機標識符（如 IP 位址）和 UID 實例配對來建構全體唯一標識符。

從以下版本開始：

JDK1.1

另請參見：

序列化表格

建構子摘要

UID()
產生一個 UID，它和產生它的主機的時間有關且具有唯一性。

UID(short num)
創建一個“熟知”UID。

方法摘要

boolean	equals(Object obj) 比較給定對象與此 UID 的相等性。
int	hashCode() 返回此 UID 的雜湊碼值。
static UID	read(DataInput in) 通過從 DataInput 實例解組二進製表示形式建構並返回一個新的 UID。
String	toString() 返回此 UID 的字元串表示形式。
void	write(DataOutput out) 將此 UID 的二進製表示形式編組為一個 DataOutput 實例。

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

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

建構子詳細資訊

UID

public UID()

產生一個 UID，它和產生它的主機的時間有關且具有唯一性。

UID

public UID(short num)

創建一個“熟知”UID。 可能有 2¹⁶ 個這樣的熟知 ID。

通過此建構子創建的 UID 將不與通過無參數建構子產生的所有 UID 衝突。

參數：

num - 表示熟知 UID 的數字

方法詳細資訊

hashCode

public int hashCode()

返回此 UID 的雜湊碼值。

覆寫：

類別 Object 中的 hashCode

返回：

此 UID 的雜湊碼值

另請參見：

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

比較給定對象與此 UID 的相等性。 當且僅當指定物件為具有與此物件相同的 unique、time 和 count 值的 UID 實例時，此方法返回 true。

覆寫：

類別 Object 中的 equals

參數：

obj - 要與此 UID 比較的物件

返回：

如果給定對象與此物件等效，則返回 true；否則返回 false

另請參見：

Object.hashCode(), Hashtable

toString

public String toString()

返回此 UID 的字元串表示形式。

覆寫：

類別 Object 中的 toString

返回：

此 UID 的字元串表示形式

write

public void write(DataOutput out)
           throws IOException

將此 UID 的二進製表示形式編組為一個 DataOutput 實例。

需要特別說明的是，此方法首先要用此 UID 的 unique 值調用給定串流的 DataOutput.writeInt(int) 方法，然後用 UID 的 time 值調用該串流的 DataOutput.writeLong(long) 方法，接著用此 UID 的 count 值調用該串流的 DataOutput.writeShort(int) 方法。

參數：

out - 要將此 UID 寫入其中的 DataOutput 實例

拋出：

IOException - 如果在執行此操作時發生 I/O 錯誤

read

public static UID read(DataInput in)
                throws IOException

通過從 DataInput 實例解組二進製表示形式建構並返回一個新的 UID。

需要特別說明的是，此方法首先要調用給定串流的 DataInput.readInt() 方法來讀取 unique 值，然後調用該串流的 DataInput.readLong() 方法來讀取 time 值，接著調用該串流的 DataInput.readShort() 方法來讀取 count 值，接下來創建並返回一個套件含從該串流中讀取的 unique、time 和 count 值的 UID 實例。

參數：

in - 要從中讀取 UID 的 DataInput 實例

返回：

已解組的 UID 實例

拋出：

IOException - 如果在執行此操作時發生 I/O 錯誤