java.rmi.activation
類別 ActivationDesc

java.lang.Object
  java.rmi.activation.ActivationDesc

所有已實作的介面：

Serializable

public final class ActivationDesc
extends Object
implements Serializable

啟動描述符包含啟動物件所必需的資訊：

• 物件的組標識符，
• 物件的完全限定的類別名，
• 物件的程式碼基（類別中的位置），一個程式碼基 URL 路徑，
• 物件的重啟“網要”，以及
• 一個可包含特定於物件的初始化資料的“編組”物件。

一個描述符通過啟動系統註冊，可用於重建/啟動描述符所指定的物件。物件描述符中的 MarshalledObject 被傳入作為遠端物件建構子的第二個參數，供物件在重新初始化/啟動過程中使用。

從以下版本開始：

1.2

另請參見：

Activatable, 序列化表格

建構子摘要

ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data)
為類別名為 className 的物件建構一個物件描述符，這可從程式碼 location 處載入，並且其初始化資訊為 data。

ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data, boolean restart)
為類別名為 className 的物件建構一個物件描述符，這可從程式碼的 location 處載入，並且其初始化資訊為 data。

ActivationDesc(String className, String location, MarshalledObject<?> data)
為類別名為 className 的物件建構一個物件描述符，這可從程式碼 location 處載入，並且其初始化資訊為 data。

ActivationDesc(String className, String location, MarshalledObject<?> data, boolean restart)
為類別名為 className 的物件建構一個物件描述符，這可從程式碼 location 處載入，並且其初始化資訊為 data。

方法摘要

boolean	equals(Object obj) 比較兩個啟動描述符的內容相等性。
String	getClassName() 返回此描述符指定的物件的類別名。
MarshalledObject<?>	getData() 為此描述符指定的物件返回包含初始化/啟動資料的“編組物件”。
ActivationGroupID	getGroupID() 返回由此描述符指定的物件的組標識符。
String	getLocation() 返回此描述符指定的物件的程式碼基。
boolean	getRestartMode() 返回與此啟動描述符關聯的物件的“重啟”網要。
int	hashCode() 為類似的 ActivationDesc 返回相同的雜湊碼

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

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

建構子詳細資訊

ActivationDesc

public ActivationDesc(String className,
                      String location,
                      MarshalledObject<?> data)
               throws ActivationException

為類別名為 className 的物件建構一個物件描述符，這可從程式碼 location 處載入，並且其初始化資訊為 data。如果使用這種形式的建構子，groupID 預設為此 VM 的 ActivationGroup 的當前 id。在同一 VM 中，具有相同 ActivationGroupID 的所有物件都被啟動。

注意，由此建構子所創建的描述符指定的物件將僅僅按需被啟動（預設情況下，重啟網要為 false）。如果一個可啟動的物件需要重啟服務，使用帶有 boolean 參數 restart 的 ActivationDesc 建構子之一。

如果此 VM 當前沒有任何啟動組，則此建構子將拋出 ActivationException。使用 ActivationGroup.createGroup 方法創建一個 ActivationGroup。

參數：

className - 物件的完全限定套件的類別名

location - 物件的程式碼基（類別被載入處）

data - 以編組形式包含的物件初始化（啟動）資料。

拋出：

ActivationException - 如果當前組不存在

從以下版本開始：

1.2

ActivationDesc

public ActivationDesc(String className,
                      String location,
                      MarshalledObject<?> data,
                      boolean restart)
               throws ActivationException

為類別名為 className 的物件建構一個物件描述符，這可從程式碼 location 處載入，並且其初始化資訊為 data。如果使用這種形式的建構子，groupID 預設為此 VM 的 ActivationGroup 的當前 id。在同一 VM 中，具有相同 ActivationGroupID 的所有物件都被啟動。

如果此 VM 當前沒有任何啟動組，則此建構子將拋出 ActivationException。使用 ActivationGroup.createGroup 方法創建一個 ActivationGroup。

參數：

className - 物件的完全限定套件的類別名

location - 物件的程式碼基（類別被載入處）

data - 以編組形式包含的物件初始化（啟動）資料。

restart - 如果為 true，則在一次意外崩潰之後，如果啟動器被重啟或者物件的啟動組被重啟，則該物件也會被重啟（啟動）；如果為 false，物件只能按需啟動。指定 restart 為 true，不強制對新註冊的物件立即進行一次初始啟動操作；初始啟動是延後的。

拋出：

ActivationException - 如果當前組不存在

從以下版本開始：

1.2

ActivationDesc

public ActivationDesc(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data)

為類別名為 className 的物件建構一個物件描述符，這可從程式碼 location 處載入，並且其初始化資訊為 data。在同一 VM 中，具有相同 groupID 的所有物件都被啟動。

注意，由此建構子所創建的描述符指定的物件將僅僅按需啟動（預設情況下，重啟網要為 false）。如果可啟動物件需要重啟服務，使用帶有 boolean 參數 restart 的 ActivationDesc 建構子之一。

參數：

groupID - 組的標識符（從註冊 ActivationSystem.registerGroup 方法處獲得）。該組指示 VM 中的物件應當被啟動。

className - 物件的完全限定套件的類別名

location - 物件的程式碼基（類別被載入處）

data - 以編組形式包含的物件初始化（啟動）資料。

拋出：

IllegalArgumentException - 如果 groupID 為 null

從以下版本開始：

1.2

ActivationDesc

public ActivationDesc(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data,
                      boolean restart)

為類別名為 className 的物件建構一個物件描述符，這可從程式碼的 location 處載入，並且其初始化資訊為 data。在同一 VM 中，具有相同 groupID 的所有物件都被啟動。

參數：

groupID - 組的標識符（從註冊 ActivationSystem.registerGroup 方法中獲得）。該組指示 VM 中的物件應當被啟動。

className - 物件的完全限定套件的類別名

location - 物件的程式碼基（類別被載入處）

data - 以編組形式包含的物件初始化（啟動）資料。

restart - 如果為 true，則在一次意外崩潰之後，如果啟動器被重啟或者物件的啟動組被重啟，該物件將會被重啟（啟動）；如果為 false，物件只能按需啟動。指定 restart 為 true，不強制對新創建的物件立即進行一次初始啟動操作；初始啟動是延後的。

拋出：

IllegalArgumentException - 如果 groupID 為 null

從以下版本開始：

1.2

方法詳細資訊

getGroupID

public ActivationGroupID getGroupID()

返回由此描述符指定的物件的組標識符。組提供一種將物件聚合到單個 Java 虛擬機器中的方法。RMI 在同一虛擬機器中創建/啟動具有相同 groupID 的物件。

返回：

組標識符

從以下版本開始：

1.2

getClassName

public String getClassName()

返回此描述符指定的物件的類別名。

返回：

類別名

從以下版本開始：

1.2

getLocation

public String getLocation()

返回此描述符指定的物件的程式碼基。

返回：

程式碼基

從以下版本開始：

1.2

getData

public MarshalledObject<?> getData()

為此描述符指定的物件返回包含初始化/啟動資料的“編組物件”。

返回：

特定於物件的“初始化”資料

從以下版本開始：

1.2

getRestartMode

public boolean getRestartMode()

返回與此啟動描述符關聯的物件的“重啟”網要。

返回：

當守護程序出現或者物件的組在一次意外崩潰後被重啟時，如果與此啟動描述符關聯的可啟動對象也通過守護程序被重啟，則返回 true；否則返回 false，這意味著該物件僅通過方法調用來按需啟動。注意，如果重啟網要為 true，則啟動器不強制對新註冊的物件立即進行一次初始啟動操作；初始啟動是延後的。

從以下版本開始：

1.2

equals

public boolean equals(Object obj)

比較兩個啟動描述符的內容相等性。

覆寫：

類別 Object 中的 equals

參數：

obj - 要與之比較的 Object

返回：

如果這些 Object 相等，則返回 true；否則返回 false。

從以下版本開始：

1.2

另請參見：

Hashtable

hashCode

public int hashCode()

為類似的 ActivationDesc 返回相同的雜湊碼

覆寫：

類別 Object 中的 hashCode

返回：

一個整數

另請參見：

Hashtable