Hitachi

インメモリデータグリッド uCosminexus Elastic Application Data store ユーザーズガイド


20.2.2 FunctionContextインタフェース

〈この項の構成〉

(1) 説明

ユーザファンクションの実行に必要な情報をFunctionインタフェースに渡すインタフェースです。

FunctionContextインタフェースのインスタンスは,1リクエストにつき1つ生成されます。

(2) インタフェース名

com.hitachi.software.xeads.func.FunctionContext

(3) メソッド一覧

FunctionContextインタフェースが提供するメソッド一覧を次の表に示します。

メソッド名

説明

getServerName()

ユーザファンクションを実行するEADsサーバ名(運用ディレクトリ名)を取得します。

getCacheName()

ユーザファンクションが実行されたキャッシュ名を取得します。

getGroupName()

ユーザファンクションの実行時に,EADsクライアントで指定したグループ名を取得します。

getArgument()

ユーザファンクションの実行時に,EADsクライアントで指定した引数を取得します。

getStore()

ユーザファンクションの呼び出しに使用したキャッシュの,データを操作するためのインスタンスを取得します。

getStore()(キャッシュ名指定)

指定したキャッシュ名のキャッシュの,データを操作するためのインスタンスを取得します。

getLogger()

ユーザログを出力するロガーを取得します。

getClientInfo()

ユーザファンクションを実行したEADsクライアントの情報(PRFトレースに出力されるRootAP情報に相当する情報)を取得します。

getInitConfig()

ユーザファンクションの初期化に使用したファンクション定義の情報を取得します。

getServerInfo()

ユーザファンクションを実行したEADsサーバの情報を取得します。

(4) getServerName()

(a) 機能

ユーザファンクションを実行するEADsサーバ名(運用ディレクトリ名)を取得します。

(b) 形式

public String getServerName()

(c) 戻り値

ユーザファンクションを実行するEADsサーバ名(運用ディレクトリ名)が返却されます。

(5) getCacheName()

(a) 機能

ユーザファンクションが実行されたキャッシュ名を取得します。

(b) 形式

public String getCacheName()

(c) 戻り値

ユーザファンクションが実行されたキャッシュ名が返却されます。

Functionインタフェースのinit(),またはdestroy()内でこのメソッドを呼び出した場合は,nullが返却されます。

(6) getGroupName()

(a) 機能

ユーザファンクションの実行時に,EADsクライアントで指定したグループ名を取得します。

(b) 形式

public String getGroupName()

(c) 戻り値

ユーザファンクションの実行時に,EADsクライアントで指定したグループ名が返却されます。

次の場合はnullが返却されます。

  • EADsクライアントでグループを指定しなかった場合

  • Functionインタフェースのinit(),またはdestroy()内でこのメソッドを呼び出した場合

(7) getArgument()

(a) 機能

ユーザファンクションの実行時に,EADsクライアントで指定した引数を取得します。

(b) 形式

public Object getArgument()

(c) 戻り値

ユーザファンクションの実行時に,EADsクライアントで指定した引数が返却されます。

次の場合はnullが返却されます。

  • EADsクライアントで引数にnullを指定した場合

  • Functionインタフェースのinit(),またはdestroy()内でこのメソッドを呼び出した場合

(8) getStore()

(a) 機能

ユーザファンクションの呼び出しに使用したキャッシュの,データを操作するためのインスタンスを取得します。

(b) 形式

public Store getStore()

(c) 戻り値

ユーザファンクションの呼び出しに使用したキャッシュの,データを操作するためのインスタンスが返却されます。

Functionインタフェースのinit(),またはdestroy()内でこのメソッドを呼び出した場合は,nullが返却されます。

(9) getStore()(キャッシュ名指定)

(a) 機能

指定したキャッシュ名のキャッシュの,データを操作するためのインスタンスを取得します。

(b) 形式

public Store getStore(String cacheName)
               throws EADsStoreException

(c) パラメータ

cacheName

操作対象となるキャッシュのキャッシュ名を指定します。

指定できるデータについては,「15.2.2(3) キャッシュ名として指定できるデータ」を参照してください。

なお,作成していないキャッシュのキャッシュ名を指定した場合は不正となります。

(d) 戻り値

指定したキャッシュ名のキャッシュの,データを操作するためのインスタンスが返却されます。

Functionインタフェースのinit(),またはdestroy()内でこのメソッドを呼び出した場合は,nullが返却されます。

(e) 発生する例外

  • UserOperationException(ユーザの操作不正)

  • EADsStoreException(予期しないエラー)

(10) getLogger()

(a) 機能

ユーザログを出力するロガーを取得します。

(b) 形式

public UserLogger getLogger()

(c) 戻り値

ユーザログを出力するロガーが返却されます。

(11) getClientInfo()

(a) 機能

ユーザファンクションを実行したEADsクライアントの情報(PRFトレースに出力されるRootAP情報に相当する情報)を取得します。

(b) 形式

public ClientInfo getClientInfo()

(c) 戻り値

ユーザファンクションを実行したEADsクライアントの情報が返却されます。EADsクライアントの情報については,「20.2.4 ClientInfoインタフェース」を参照してください。

Functionインタフェースのinit(),またはdestroy()内でこのメソッドを呼び出した場合は,nullが返却されます。

(12) getInitConfig()

(a) 機能

ユーザファンクションの初期化に使用したファンクション定義の情報を取得します。

(b) 形式

public InitConfig getInitConfig()

(c) 戻り値

ユーザファンクションの初期化に使用したファンクション定義の情報が返却されます。

ユーザファンクションの初期化に使用したファンクション定義の情報については,「20.2.3 InitConfigインタフェース」を参照してください。

(13) getServerInfo()

(a) 機能

ユーザファンクションを実行したEADsサーバの情報を取得します。

(b) 形式

public ServerInfo getServerInfo()

(c) 戻り値

ユーザファンクションを実行したEADsサーバの情報が返却されます。