概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

java.rmi.activation
介面 ActivationSystem

所有父級介面：
Remote
public interface ActivationSystem
extends Remote

ActivationSystem 為註冊組和在那些組中要被啟動的“可啟動”物件提供一種方式。ActivationSystem 與 Activator 緊密協作，通過 ActivationSystem 和 ActivationMonitor 來啟動註冊的物件，ActivationMonitor 獲取有關活動的和不活動的物件以及不活動組的資訊。

從以下版本開始：
1.2
另請參見：
Activator, ActivationMonitor

欄位摘要
static int SYSTEM_PORT
          尋找啟動系統的埠號。
 
方法摘要
 ActivationMonitor activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation)
          通過回調來通知啟動系統該組現在是活動的。
 ActivationDesc getActivationDesc(ActivationID id)
          為具有該啟動標識符 id 的物件返回啟動描述符。
 ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id)
          為具有該啟動組標識符 id 的組返回啟動組描述符。
 ActivationGroupID registerGroup(ActivationGroupDesc desc)
          註冊啟動組。
 ActivationID registerObject(ActivationDesc desc)
          registerObject 方法用於註冊一個啟動描述符 desc，並且為可啟動的遠端物件獲取一個啟動標識符。
 ActivationDesc setActivationDesc(ActivationID id, ActivationDesc desc)
          為具有啟動標識符 id 的物件設置啟動描述符 desc。
 ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc)
          為具有啟動組標識符 id 的物件設置啟動組描述符 desc。
 void shutdown()
          關閉此啟動系統。
 void unregisterGroup(ActivationGroupID id)
          移除啟動組。
 void unregisterObject(ActivationID id)
          移除前面通過 ActivationSystem 註冊的啟動 id 和描述符；該物件無法再通過物件的啟動 id 被啟動。
 

欄位詳細資訊

SYSTEM_PORT

static final int SYSTEM_PORT
尋找啟動系統的埠號。

另請參見：
常數欄位值
方法詳細資訊

registerObject

ActivationID registerObject(ActivationDesc desc)
                            throws ActivationException,
                                   UnknownGroupException,
                                   RemoteException
registerObject 方法用於註冊一個啟動描述符 desc，並且為可啟動的遠端物件獲取一個啟動標識符。ActivationSystem 為描述符 desc 指定的物件創建一個 ActivationID（啟動標識符），並且在穩定的存儲器中記錄啟動描述符及其關聯的標識符，以便將來使用。當 Activator 接收一個針對指定標識符的 activate 請求時，啟動器為指定的標識符尋找啟動描述符（前面已註冊），並且使用該資訊來啟動物件。

參數：
desc - 物件的啟動描述符
返回：
能用於啟動物件的啟動 id
拋出：
ActivationException - 如果註冊失敗（如，資料庫更新失敗等）。
UnknownGroupException - 如果在 desc 中參考的組未通過此系統註冊
RemoteException - 如果遠端調用失敗
從以下版本開始：
1.2

unregisterObject

void unregisterObject(ActivationID id)
                      throws ActivationException,
                             UnknownObjectException,
                             RemoteException
移除前面通過 ActivationSystem 註冊的啟動 id 和描述符；該物件無法再通過物件的啟動 id 被啟動。

參數：
id - 物件的啟動 id（來自前面的註冊）
拋出：
ActivationException - 如果取消註冊失敗（如，資料庫更新失敗等）。
UnknownObjectException - 如果物件未知（未註冊）
RemoteException - 如果遠端調用失敗
從以下版本開始：
1.2

registerGroup

ActivationGroupID registerGroup(ActivationGroupDesc desc)
                                throws ActivationException,
                                       RemoteException
註冊啟動組。一個啟動組必須在物件能在該組中註冊之前通過 ActivationSystem 來註冊。

參數：
desc - 組描述符
返回：
該組的標識符
拋出：
ActivationException - 如果組註冊失敗
RemoteException - 如果遠端調用失敗
從以下版本開始：
1.2

activeGroup

ActivationMonitor activeGroup(ActivationGroupID id,
                              ActivationInstantiator group,
                              long incarnation)
                              throws UnknownGroupException,
                                     ActivationException,
                                     RemoteException
通過回調來通知啟動系統該組現在是活動的。此調用由 ActivationGroup.createGroup 方法在內部進行，以通知 ActivationSystem 該組現在是活動的。

參數：
id - 啟動組的標識符
group - 組的初始化程序
incarnation - 組的代號
返回：
啟動組的監視器
拋出：
UnknownGroupException - 如果組未註冊
ActivationException - 如果該指定 id 的組已經是活動的，並且該組不等於指定 group，或者該組與指定組 group 具有不同的 incarnation
RemoteException - 如果遠端調用失敗
從以下版本開始：
1.2

unregisterGroup

void unregisterGroup(ActivationGroupID id)
                     throws ActivationException,
                            UnknownGroupException,
                            RemoteException
移除啟動組。一個啟動組進行此回調，以通知啟動器該組應當被移除（銷毀）。如果此調用成功完成，則物件無法再在該組中註冊或啟動。該組及其相關物件的所有資訊都將從系統中移除。

參數：
id - 啟動組的標識符
拋出：
ActivationException - 如果取消註冊失敗（如，資料庫更新失敗等）。
UnknownGroupException - 如果組未註冊
RemoteException - 如果遠端過程調用失敗
從以下版本開始：
1.2

shutdown

void shutdown()
              throws RemoteException
關閉此啟動系統。銷毀由此啟動守護程序產生的所有組，並退出啟動守護程序。

拋出：
RemoteException - 如果聯絡/關閉啟動守護程序失敗
從以下版本開始：
1.2

setActivationDesc

ActivationDesc setActivationDesc(ActivationID id,
                                 ActivationDesc desc)
                                 throws ActivationException,
                                        UnknownObjectException,
                                        UnknownGroupException,
                                        RemoteException
為具有啟動標識符 id 的物件設置啟動描述符 desc。此更改將在該物件的後續啟動中生效。

參數：
id - 可啟動物件的啟動標識符
desc - 可啟動物件的啟動描述符
返回：
啟動描述符的前一個值
拋出：
UnknownGroupException - 與 desc 關聯的組不是一個註冊組
UnknownObjectException - 啟動 id 未被註冊
ActivationException - 一般失敗（如，不能更新日誌）
RemoteException - 如果遠端調用失敗
從以下版本開始：
1.2
另請參見：
getActivationDesc(java.rmi.activation.ActivationID)

setActivationGroupDesc

ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id,
                                           ActivationGroupDesc desc)
                                           throws ActivationException,
                                                  UnknownGroupException,
                                                  RemoteException
為具有啟動組標識符 id 的物件設置啟動組描述符 desc。此更改將在該組的後續啟動中生效。

參數：
id - 啟動組的啟動組標識符
desc - 啟動組的啟動組描述符
返回：
啟動組描述符的前一個值
拋出：
UnknownGroupException - 與 id 關聯的組不是一個註冊組
ActivationException - 一般失敗（如，不能更新日誌）
RemoteException - 如果遠端調用失敗
從以下版本開始：
1.2
另請參見：
getActivationGroupDesc(java.rmi.activation.ActivationGroupID)

getActivationDesc

ActivationDesc getActivationDesc(ActivationID id)
                                 throws ActivationException,
                                        UnknownObjectException,
                                        RemoteException
為具有該啟動標識符 id 的物件返回啟動描述符。

參數：
id - 可啟動物件的啟動標識符
返回：
啟動描述符
拋出：
UnknownObjectException - 如果 id 未被註冊
ActivationException - 一般失敗
RemoteException - 如果遠端調用失敗
從以下版本開始：
1.2
另請參見：
setActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc)

getActivationGroupDesc

ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id)
                                           throws ActivationException,
                                                  UnknownGroupException,
                                                  RemoteException
為具有該啟動組標識符 id 的組返回啟動組描述符。

參數：
id - 該組的啟動組標識符
返回：
啟動組描述符
拋出：
UnknownGroupException - 如果 id 未被註冊
ActivationException - 一般失敗
RemoteException - 如果遠端調用失敗
從以下版本開始：
1.2
另請參見：
setActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc)
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。