jp.ac.tokushima_u.edb.client

Class EdbIPC

java.lang.Object

jp.ac.tokushima_u.edb.client.EdbIPC

public class EdbIPC
extends Object

EDBクライアントプログラム間(PC内)のメッセージ通信を行うためのユーティリティクラスです．

メッセージの受信を行うには，createIPCServer メソッドを使用しIPCサーバを作成します． サーバ作成に成功すると，空いているポート上でサーバソケットを作成し，メッセージの受信待ちを開始します． 作成されたソケットのポート番号は，メソッドの引数に指定された識別名をキーに Java User Preference の次の場所に登録されます．

 /jp/ac/tokushima_u/edb/client/識別名/PORT
 

メッセージの送信を行うには，sendMessage メソッドを使用します． 指定された識別名をキーに Java User Preference から登録されているポートを取得し，メッセージを送ります．

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	EdbIPC.IPCListener IPCサーバに送られたメッセージの受け取るためのリスナインタフェースです．
static class	EdbIPC.IPCServer EDBクライアントプログラムから送られてくるメッセージを受信するサーバです． このオブジェクトを作成する場合は，EdbIPC.createIPCServer メソッドを使用します．

Field Summary

Fields

Modifier and Type	Field and Description
(package private) static Preferences	ipcPrefs
(package private) static String	STATUS_PREFIX

Constructor Summary

Constructors

Constructor and Description
EdbIPC()

Method Summary

Modifier and Type	Method and Description
static EdbIPC.IPCServer	createIPCServer(String cn, EdbIPC.IPCListener lis) メッセージを受信するサーバを作成します． サーバー作成に成功すると，空いているポート上でサーバソケットを作成し，メッセージの受信待ちを開始します． また，作成されたソケットのポート番号は，引数に指定された識別名をキーに Java User Preference に登録されます．
(package private) static int	getClientPort(String nn)
(package private) static void	putClientPort(String nn, int p)
static int	sendMessage(String nn, String[] args) IPCサーバへメッセージを送ります．送られるメッセージに対する動作は，IPCサーバ側の実装に依存します．

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ipcPrefs

static Preferences ipcPrefs

STATUS_PREFIX

static final String STATUS_PREFIX

See Also:

Constant Field Values

Constructor Detail

EdbIPC

public EdbIPC()

Method Detail

getClientPort

static int getClientPort(String nn)

putClientPort

static void putClientPort(String nn,
                          int p)

sendMessage

public static int sendMessage(String nn,
                              String[] args)

IPCサーバへメッセージを送ります．送られるメッセージに対する動作は，IPCサーバ側の実装に依存します．

Parameters:

nn - 識別名

args - メッセージ

Returns:

送信メッセージに対しての処理結果を数値で返します．失敗した場合は -1 を返します．

createIPCServer

public static EdbIPC.IPCServer createIPCServer(String cn,
                                               EdbIPC.IPCListener lis)

メッセージを受信するサーバを作成します． サーバー作成に成功すると，空いているポート上でサーバソケットを作成し，メッセージの受信待ちを開始します． また，作成されたソケットのポート番号は，引数に指定された識別名をキーに Java User Preference に登録されます．

Parameters:

cn - 任意の識別名

lis - 受け取ったメッセージを処理するリスナーオブジェクト

Returns:

成功した場合は IPCServer オブジェクトを返します．失敗した場合は null を返します．