jp.go.nict.langrid.p2pgridbasis.controller
インタフェース P2PGridController

既知の実装クラスの一覧:

JXTAController

public interface P2PGridController

言語グリッドで規定するP2Pグリッドコントローラのインタフェース.

 コントローラの起動/停止，P2Pグリッド上での公開/削除/検索操作を提供する.
 

バージョン:

$Revision: 11398 $

作成者:

$Author: Takao Nakaguchi $

メソッドの概要

void	addSeedUri(URI uri) seedURIを追加する。
void	baseSummaryAdd(Data data) baseSummaryにデータを追加する.
Data[]	collect(ControllerSearchCondition con) P2Pグリッド上からデータを検索する.
void	createFederation() 連邦関係の構築
String	getSerlfGridId() グリッドIDを取得する。
boolean	hostSummaryCreate(String gridId) 連携時のデータ作成
void	logDataPublish(Data data) P2Pグリッド上にデータを公開する.
void	logSummaryAdd(Data data) logSummaryにデータを追加する.
void	publish(Data data) P2Pグリッド上にデータを公開する.
void	revoke(DataID id) P2Pグリッド上からデータを削除する.
void	showStatus(PrintStream stream) P2PGridControllerのPeerID取得
void	shutdown() P2Pグリッドコントローラを停止する.
void	start() P2Pグリッドコントローラを起動する.
void	stateDataPublish(Data data) P2Pグリッド上にデータを公開する.
void	stateSummaryAdd(Data data) stateSummaryにデータを追加する.
void	summaryPublish(String tag) P2Pグリッド上にデータを公開する.

メソッドの詳細

addSeedUri

void addSeedUri(URI uri)

seedURIを追加する。

start

void start()
           throws ControllerException

P2Pグリッドコントローラを起動する. コントローラを起動して，P2Pグリッド上の他のピアと情報共有を行う．

例外:

ControllerException - 起動中にController内部で発生した例外

shutdown

void shutdown()
              throws ControllerException

P2Pグリッドコントローラを停止する. コントローラを停止することで， P2Pグリッド上の他のピアとの情報共有を停止する．

例外:

ControllerException - 停止中にController内部で発生した例外

publish

void publish(Data data)
             throws ControllerException

P2Pグリッド上にデータを公開する. 公開されたデータは他のピアからアクセス可能になり，必要に応じて共有される． DataIDが同じデータが存在する場合，公開データは上書きされる．

パラメータ:

data - 公開するデータ

例外:

ControllerException - 公開中にController内部で発生した例外

stateDataPublish

void stateDataPublish(Data data)
                      throws ControllerException

P2Pグリッド上にデータを公開する. 公開されたデータは他のピアからアクセス可能になり，必要に応じて共有される． DataIDが同じデータが存在する場合，公開データは上書きされる． AccessStateのDataAdvのみを公開.

パラメータ:

data - 公開するデータ

例外:

ControllerException - 公開中にController内部で発生した例外

baseSummaryAdd

void baseSummaryAdd(Data data)
                    throws ControllerException

baseSummaryにデータを追加する.

パラメータ:

data - 追加するデータ

例外:

ControllerException - 公開中にController内部で発生した例外

logSummaryAdd

void logSummaryAdd(Data data)
                   throws ControllerException

logSummaryにデータを追加する.

パラメータ:

data - 追加するデータ

例外:

ControllerException - 公開中にController内部で発生した例外

stateSummaryAdd

void stateSummaryAdd(Data data)
                     throws ControllerException

stateSummaryにデータを追加する.

パラメータ:

data - 追加するデータ

例外:

ControllerException - 公開中にController内部で発生した例外

summaryPublish

void summaryPublish(String tag)
                    throws ControllerException

P2Pグリッド上にデータを公開する.

例外:

ControllerException - 公開中にController内部で発生した例外

logDataPublish

void logDataPublish(Data data)
                    throws ControllerException

P2Pグリッド上にデータを公開する.(AccessLogのみ) データ部分を即時公開し、サマリ部分は1分間待機したのちに公開. 複数回更新のあったログサマリを1度で公開する.

パラメータ:

Data -

例外:

ControllerException - 公開中にController内部で発生した例外

revoke

void revoke(DataID id)
            throws DataNotFoundException,
                   ControllerException

P2Pグリッド上からデータを削除する. 削除されたデータは，他のピアからも削除され，一定期間後にネットワーク上から削除される． データがネットワーク上から削除されるまでは一般に遅延が発生するため， 削除操作を行った直後は，他のピアに情報が残っている場合もある． 正常に動作しているピアのみのとき，一定時間後に情報は完全に削除される． 削除までにかかる時間は，Controllerの実装とシステムの規模に応じて変化する.

パラメータ:

id - 削除するデータのID

例外:

DataNotFoundException - 指定されたデータIDを持つデータが存在しない

ControllerException - 削除中に例外が発生した

collect

Data[] collect(ControllerSearchCondition con)
               throws ControllerException

P2Pグリッド上からデータを検索する. データの検索方法は実装に依存し， 検索結果がシステム全体の完全な情報を検索した結果とは限らない．

パラメータ:

con - データ検索時の検索条件

戻り値:

検索結果

例外:

ControllerException - 検索中に例外が発生した

showStatus

void showStatus(PrintStream stream)

P2PGridControllerのPeerID取得

パラメータ:

stream - 出力先のストリーム

createFederation

void createFederation()

連邦関係の構築

hostSummaryCreate

boolean hostSummaryCreate(String gridId)
                          throws ControllerException

連携時のデータ作成

パラメータ:

gridID - 作成するGridのID

戻り値:

成否

例外:

ControllerException

getSerlfGridId

String getSerlfGridId()

グリッドIDを取得する。 startメソッドに渡されるServiceContextから値を取得する。

戻り値:

グリッドID