8.3.6 一方通知受信機能
TP1Accessクラスで提供する一方通知受信機能メソッドの一覧を以下に記載します。
項番 |
メソッド名 |
機能 |
---|---|---|
1 |
acceptNotification |
サーバからクライアントへの一方通知メッセージの受信 |
2 |
cancelNotification |
一方通知待ち状態のキャンセル |
3 |
chainedAcceptNotification |
一方通知受信 |
4 |
closeNotification |
一方通知連続受信の終了 |
5 |
openNotification |
一方通知連続受信の開始 |
- 〈この項の構成〉
(1) サーバからクライアントへの一方通知メッセージの受信
[ acceptNotificationメソッド ] public void acceptNotification(java.lang.String defpath, java.lang.String[] inf, int[] infLen, int port, int timeout, java.lang.String[] hostname, java.lang.String[] nodeid, int flags) throws J2CBException
- パラメタ:
-
defpath - クライアント環境を定義した定義ファイルのパス名
- inf - サーバからの通知メッセージ
-
要素数1以上のString配列を指定する。配列[0]に値が設定される。
- InfLen - サーバからの通知メッセージを格納する領域長
-
要素数1以上のint配列を指定する。配列[0]に値が設定される。
port - クライアントのポート番号
timeout -タイムアウト値(秒)
- hostname - 通知したサーバのホスト名
-
要素数1以上のString配列を指定する。配列[0]に値が設定される。
- nodeid - 通知したサーバのノード識別子
-
要素数1以上のString配列を指定する。配列[0]に値が設定される。
flags - TP1Const.DCNOFLAGSを指定
- 戻り値:
-
なし
- 例外:J2CBException - 例外情報の取得
-
詳細は「8.8 J2CBExceptionユーザインタフェースAPI」をご覧ください。
(2) 一方通知待ち状態のキャンセル
[ cancelNotificationメソッド ] public void cancelNotification(java.lang.String defpath, java.lang.String inf, int infLen, int port, java.lang.String hostname, int flags) throws J2CBException
- パラメタ:
-
defpath - クライアント環境を定義した定義ファイルのパス名
inf - CUP(Client User Program)に通知するメッセージ
infLen - メッセージ長(infの長さ)
port - 一方通知受信要求時に指定したポート番号
hostname - 一方通知受信待ち状態のCUPが存在するホスト名
flags - TP1Const.DCNOFLAGSを指定
- 戻り値:
-
なし
- 例外:J2CBException - 例外情報の取得
-
詳細は「8.8 J2CBExceptionユーザインタフェースAPI」をご覧ください。
(3) 一方通知受信
[ chainedAcceptNotificationメソッド ] public void chainedAcceptNotification(int ntfid, java.lang.String[] inf, int[] infLen, int timeout, java.lang.String[] hostname, java.lang.String[] nodeid, int flags) throws J2CBException
- パラメタ:
-
ntfid - openNotificationメソッドで受け取った一方通知受信ID
- inf - サーバからの通知メッセージ
-
要素数が1以上のString配列を指定します。配列[0]に値が設定されます。
- infLen - サーバからの通知メッセージ長
-
要素数が1以上のint配列を指定します。配列[0]に値が設定されます。
timeout - タイムアウト値(秒)
- hostname - 通知したサーバのホスト名
-
要素数が1以上のString配列を指定します。配列[0]に値が設定されます。
- nodeid - 通知したサーバのノード識別子
-
要素数が1以上のString配列を指定します。配列[0]に値が設定されます。
flags - TP1Const.DCNOFLAGSを指定
- 戻り値:
-
なし
- 例外:J2CBException - 例外情報の取得
-
詳細は「8.8 J2CBExceptionユーザインタフェースAPI」をご覧ください。
(4) 一方通知連続受信の終了
[ closeNotificationメソッド ] public void closeNotification(int ntfid, int flags) throws J2CBException
- パラメタ:
-
ntfid - openNotificationメソッドで受け取った一方通知受信ID
flags - TP1Const.DCNOFLAGSを指定
- 戻り値:
-
なし
- 例外:J2CBException - 例外情報の取得
-
詳細は「8.8 J2CBExceptionユーザインタフェースAPI」をご覧ください。
(5) 一方通知連続受信の開始
[ openNotificationメソッド ] public void openNotification(int[] ntfid, java.lang.String defpath, int port, int flags) throws J2CBException
- パラメタ:
-
- ntfid - 一方通知受信ID
-
要素数が1以上のint配列を指定します。配列[0]に値が設定されます。
defpath - クライアント環境を定義した定義ファイルのパス名
port - クライアントのポート番号
flags - TP1Const.DCNOFLAGSを指定
- 戻り値:
-
なし
- 例外:J2CBException - 例外情報の取得
-
詳細は「8.8 J2CBExceptionユーザインタフェースAPI」をご覧ください。