intra-mart 6.1.14

jp.co.intra_mart.foundation.service.client
クラス NetworkConnector

java.lang.Object
  拡張jp.co.intra_mart.foundation.service.client.NetworkConnector
すべての実装インタフェース:
Serializable
直系の既知のサブクラス:
NetworkAgent, ServerConnector

public abstract class NetworkConnector
extends Object
implements Serializable

このクラスは、他のサーバで実行されるロジックを転送する ためのスケルトンを提供します。

サーバがネットワーク型構成で動作している場合は、ネットワーク通信を行い 目的のサーバにロジックを転送します。サーバがスタンドアロン型構成で動作 している場合は、そのサーバ内で直接ロジックを実行します。
このクラスを継承したサブクラスでは、他のサーバでロジックを実行するための ネットワークコネクションを定義する必要があります。
また、サブクラスは直列化可能なクラスである必要があります。 サブクラスが直列化できない場合、ロジックの呼び出し時に例外がスローされます。

導入されたバージョン:
version 4.0
関連項目:
直列化された形式

フィールドの概要
protected static int GET
           
protected static int GET_ENTIRETY
           
protected static int GET_ENTIRETY_KEY
           
protected static int GET_ITEM
           
protected static int GET_ITEM_KEY
           
protected static int GET_SUBSET
           
protected static int MOVE
           
protected static int MOVE_ENTIRETY
           
protected static int MOVE_ITEM
           
protected static int REMOVE
           
protected static int REMOVE_ENTIRETY
           
protected static int REMOVE_ITEM
           
protected static int SET
           
protected static int SET_ENTIRETY
           
protected static int SET_ITEM
           
 
コンストラクタの概要
protected NetworkConnector()
          唯一のコンストラクタ。
 
メソッドの概要
 void close()
          ネットワークを切断します。
protected abstract  SocketConnection connection()
          サーバに接続するためのコネクションを取得します。
 Object execute(ActionListener target, Object arg)
          サーバに対して実行要求をします。
 long freeMemory()
          サーバシステムの空きメモリの量を返します。
 boolean isConnected()
          サーバとの接続状態をチェックします。
 long serverTime()
          サーバのミリ秒で表される現在の時間を返します。
 long totalMemory()
          サーバプロセスの Java Virtual Machine のメモリの総容量を返します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

SET

protected static final int SET
関連項目:
定数フィールド値

SET_ITEM

protected static final int SET_ITEM
関連項目:
定数フィールド値

SET_ENTIRETY

protected static final int SET_ENTIRETY
関連項目:
定数フィールド値

GET

protected static final int GET
関連項目:
定数フィールド値

GET_ITEM

protected static final int GET_ITEM
関連項目:
定数フィールド値

GET_ENTIRETY

protected static final int GET_ENTIRETY
関連項目:
定数フィールド値

GET_SUBSET

protected static final int GET_SUBSET
導入されたバージョン:
version 5.0
関連項目:
定数フィールド値

GET_ITEM_KEY

protected static final int GET_ITEM_KEY
関連項目:
定数フィールド値

GET_ENTIRETY_KEY

protected static final int GET_ENTIRETY_KEY
関連項目:
定数フィールド値

REMOVE

protected static final int REMOVE
関連項目:
定数フィールド値

REMOVE_ITEM

protected static final int REMOVE_ITEM
関連項目:
定数フィールド値

REMOVE_ENTIRETY

protected static final int REMOVE_ENTIRETY
関連項目:
定数フィールド値

MOVE

protected static final int MOVE
関連項目:
定数フィールド値

MOVE_ITEM

protected static final int MOVE_ITEM
関連項目:
定数フィールド値

MOVE_ENTIRETY

protected static final int MOVE_ENTIRETY
関連項目:
定数フィールド値
コンストラクタの詳細

NetworkConnector

protected NetworkConnector()
唯一のコンストラクタ。

メソッドの詳細

connection

protected abstract SocketConnection connection()
                                        throws UnsupportedNetworkConnectException,
                                               IOException
サーバに接続するためのコネクションを取得します。
ネットワーク接続が必要ではない場合は、 UnsupportedNetworkConnectException をスローします。

このメソッドは、サブクラスでオーバーライドする必要があります。

戻り値:
コネクション
例外:
UnsupportedNetworkConnectException - ネットワーク接続が許可されていない場合
IOException - 入出力エラーが発生した場合

execute

public Object execute(ActionListener target,
                      Object arg)
               throws IOException,
                      RuntimeException,
                      Error
サーバに対して実行要求をします。

サーバがスタンドアロン型で運用されている場合、 現在動作しているサーバ内で リスナー ActionListener.action(Object) を 実行し、その結果を返します。
サーバがネットワーク型で運用されている場合、connection() メソッドにより取得したコネクションを利用してサーバに接続し、 リスナーオブジェクトを直列化して転送します。 接続先サーバでは、転送したリスナーオブジェクトを復元して リスナーオブジェクトの ActionListener.action(Object) を 実行します。実行結果はネットワークにより転送され、復元した後に、 このメソッドの実行結果として返します。

このメソッドに渡す引数は、直列化可能なオブジェクトに限ります。 引数を直列化できない場合、このメソッドは例外をスローします。

パラメータ:
target - サーバで実行するリスナーオブジェクト
arg - action() に渡す引数
戻り値:
action() の実行結果
例外:
InvalidClassException - 直列化で使用されるクラスになんらかの不具合があった場合
StreamCorruptedException - ストリームの制御情報に一貫性がない場合
OptionalDataException - プリミティブデータが、オブジェクトではなくストリームに見つかった場合
NotSerializableException - 直列化の対象が java.io.Serializable インタフェースを実装していない場合
IOException - 入出力エラーが発生した場合
RuntimeException - 実行時エラー
Error - 致命的なエラー
関連項目:
NetworkAgent.action(Object)

isConnected

public boolean isConnected()
サーバとの接続状態をチェックします。

このメソッド実行時に取得したネットワークコネクションについて接続確認を します。他のコネクションに関してはチェックしないため、このメソッドの 結果接続を確認できたとしても次のリクエストで取得したコネクションで 接続エラーが発生する場合があります。

戻り値:
接続に成功した場合は true、そうでない場合は false。

serverTime

public long serverTime()
                throws IOException
サーバのミリ秒で表される現在の時間を返します。

戻り値:
ミリ秒で測定した、現在時刻と UTC 1970 年 1 月 1 日午前 0 時との差
例外:
IOException - 入出力エラーが発生した場合
関連項目:
System.currentTimeMillis()

totalMemory

public long totalMemory()
                 throws IOException
サーバプロセスの Java Virtual Machine のメモリの総容量を返します。

戻り値:
現在および将来のオブジェクトに利用可能なメモリの総容量 (バイト単位)
例外:
IOException - 入出力エラーが発生した場合
関連項目:
Runtime.totalMemory()

freeMemory

public long freeMemory()
                throws IOException
サーバシステムの空きメモリの量を返します。

戻り値:
将来のオブジェクトに利用可能なメモリの推定総容量 (バイト単位)
例外:
IOException - 入出力エラーが発生した場合
関連項目:
Runtime.freeMemory()

close

public void close()
           throws IOException
ネットワークを切断します。

切断されるネットワークコネクションは、このメソッドを実行した時に、 このメソッド内でこのオブジェクトの connection() メソッドから 取得したコネクションに関してのみです。

例外:
IOException - 入出力エラーが発生した場合

intra-mart 6.1.14

Copyright © 2000-2010 NTT DATA INTRAMART CO.,LTD.. All Rights Reserved.