com.JRcServer.client
クラス JRcClientDriver

java.lang.Object
  上位を拡張 com.JRcServer.client.JRcClientDriver

public class JRcClientDriver
extends java.lang.Object

JRcClientドライバ.

JRcServerに接続するためのドライバ.

基本的にJRcServerに接続するには、JRcClientDriver経由で アクセスする必要があります.
まず初めに、JRcClientDriverを使い、※アプリケーション名と
接続先のIPアドレス+ポート番号(デフォルトポート番号は32109を利用)
を指定します。

  ※アプリケーション名は接続先のセッション情報を識別するときの名前なので、
   ユニーク名である必要があります.

 
 JRcConnection conn = JRcClientDriver.getConnection( "hoge","127.0.0.1" ) ;

 
上記のようにしてJRcServerに接続します.
この処理が成功することで、JRcServerとコネクションを確立することができます.
また、前回に接続している場合にセッションを利用している場合は、セッションも確立されます.
そのとき、前回の接続先+アプリケーション名でセッションを再定義されます.

次に、上記の[JRcConnection]を利用して、JRcServerに定義されているサービス名(コマンド名)を
呼び出す例を示します.
 
 BufferedReader r = null ;
 String s = null ;
 JRcResult result = null ;
 
 // サービス名 list を呼び出す.
 conn.createService( "list" ) ;
 result = conn.execution() ;
 
 r = new BufferedReader(
  new InputStreamReader(
   result.getInputStream(),result.getCharset()
  )
 ) ;
 
 for( ;; ) {
  if( ( s = r.readLine() ) == null ) { break ; }
  System.out.println( s ) ;
 }
 r.close() ;
 r = null ;
 result = null ;
 
 // サービス名 help [hoge] を呼び出す.
 conn.createService( "help" ) ;
 conn.setParameterToString( "command","hoge" ) ;
 result = conn.execution() ;

 r = new BufferedReader(
  new InputStreamReader(
   result.getInputStream(),result.getCharset()
  )
 ) ;
 
 for( ;; ) {
  if( ( s = r.readLine() ) == null ) { break ; }
  System.out.println( s ) ;
 }
 r.close() ;
 r = null ;
 result = null ;
 
 
予約語である[list],[help]を用いた例です.
予約語[list]は、利用可能なサービス名一覧をリストアップする処理で、
予約語[help]は、利用可能なサービスの使い方を表示するための機能です.
予約語[help]の場合には、パラメータ名を[command]として、その内容に調べたい
サービス名(ここでは[hoge]を指定している)を設定することで、ヘルプ情報を取得する
ことができます.

そして、executionでサービスを呼び出した結果は、[JRcResult]を使って、取得できます.
またここでは、予約語を例題に説明していますが、登録されているサービスも同様の手順で
呼び出すことができます.

上記のような呼び方が、通常のプログラム内で呼び出す方法ですが、もう1つの実行方法として、
以下のような方法もあります.
 
 result = conn.execution( "help -command hoge" ) ;
 r = new BufferedReader(
  new InputStreamReader(
   result.getInputStream(),result.getCharset()
  )
 ) ;
 
 for( ;; ) {
  if( ( s = r.readLine() ) == null ) { break ; }
  System.out.println( s ) ;
 }
 r.close() ;
 r = null ;
 result = null ;
 
 
このように、コマンドとして呼び出すことができます.
詳しくは、[com.JRcServer.client.JRcConnection]オブジェクトの[execution]メソッドを
参照してください.

導入されたバージョン:
JRcClient 1.00
バージョン:
2006/09/10
作成者:
masahito suzuki

フィールドの概要
static java.lang.String CACHE_DIR
          JRcClientキャッシュディレクトリ名.
static java.lang.String JRC_CLIENT_DIR
          JRcClientディレクトリ名.
static java.lang.Object SYNC
          ドライバ同期.
static java.lang.String VERSION
          JRcClientバージョン.
static java.lang.String WORK_DIR
          JRcClientワークディレクトリ名.
 
メソッドの概要
static JRcConnection getConnection(boolean cacheMode, java.lang.String applicationName, java.net.InetAddress addr)
          コネクション処理.
static JRcConnection getConnection(boolean cacheMode, java.lang.String applicationName, java.net.InetAddress addr, int port)
          コネクション処理.
static JRcConnection getConnection(boolean cacheMode, java.lang.String applicationName, java.net.InetAddress addr, int port, int timeout)
          コネクション処理.
static JRcConnection getConnection(boolean cacheMode, java.lang.String applicationName, java.lang.String addr)
          コネクション処理.
static JRcConnection getConnection(boolean cacheMode, java.lang.String applicationName, java.lang.String addr, int port)
          コネクション処理.
static JRcConnection getConnection(boolean cacheMode, java.lang.String applicationName, java.lang.String addr, int port, int timeout)
          コネクション処理.
static JRcConnection getConnection(java.lang.String applicationName, java.net.InetAddress addr)
          コネクション処理.
static JRcConnection getConnection(java.lang.String applicationName, java.net.InetAddress addr, int port)
          コネクション処理.
static JRcConnection getConnection(java.lang.String applicationName, java.net.InetAddress addr, int port, int timeout)
          コネクション処理.
static JRcConnection getConnection(java.lang.String applicationName, java.lang.String addr)
          コネクション処理.
static JRcConnection getConnection(java.lang.String applicationName, java.lang.String addr, int port)
          コネクション処理.
static JRcConnection getConnection(java.lang.String applicationName, java.lang.String addr, int port, int timeout)
          コネクション処理.
 
クラス java.lang.Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

JRC_CLIENT_DIR

public static final java.lang.String JRC_CLIENT_DIR
JRcClientディレクトリ名.


CACHE_DIR

public static final java.lang.String CACHE_DIR
JRcClientキャッシュディレクトリ名.


WORK_DIR

public static final java.lang.String WORK_DIR
JRcClientワークディレクトリ名.


VERSION

public static final java.lang.String VERSION
JRcClientバージョン.

関連項目:
定数フィールド値

SYNC

public static final java.lang.Object SYNC
ドライバ同期.

メソッドの詳細

getConnection

public static final JRcConnection getConnection(java.lang.String applicationName,
                                                java.lang.String addr)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.
このメソッドでは、JRcServerのデフォルトポート番号(32109)でアクセスします.

パラメータ:
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、なるべくUniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(java.lang.String applicationName,
                                                java.lang.String addr,
                                                int port)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.

パラメータ:
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、なるべくUniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
port - コネクション先のポート番号を設定します.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(java.lang.String applicationName,
                                                java.lang.String addr,
                                                int port,
                                                int timeout)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.

パラメータ:
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、Uniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
port - コネクション先のポート番号を設定します.
timeout - コネクションタイムアウトを設定します.
[0]以下を設定した場合、無限待機となります.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(java.lang.String applicationName,
                                                java.net.InetAddress addr)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.
このメソッドでは、JRcServerのデフォルトポート番号(32109)でアクセスします.

パラメータ:
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、なるべくUniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(java.lang.String applicationName,
                                                java.net.InetAddress addr,
                                                int port)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.

パラメータ:
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、なるべくUniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
port - コネクション先のポート番号を設定します.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(java.lang.String applicationName,
                                                java.net.InetAddress addr,
                                                int port,
                                                int timeout)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.

パラメータ:
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、Uniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
port - コネクション先のポート番号を設定します.
timeout - コネクションタイムアウトを設定します.
[0]以下を設定した場合、無限待機となります.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(boolean cacheMode,
                                                java.lang.String applicationName,
                                                java.lang.String addr)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.
このメソッドでは、JRcServerのデフォルトポート番号(32109)でアクセスします.

パラメータ:
cacheMode - キャッシュモードを設定します.
[true]を設定した場合、ファイルキャッシュをONにします.
[false]を設定した場合、メモリキャッシュをONにします.
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、なるべくUniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(boolean cacheMode,
                                                java.lang.String applicationName,
                                                java.lang.String addr,
                                                int port)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.

パラメータ:
cacheMode - キャッシュモードを設定します.
[true]を設定した場合、ファイルキャッシュをONにします.
[false]を設定した場合、メモリキャッシュをONにします.
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、なるべくUniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
port - コネクション先のポート番号を設定します.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(boolean cacheMode,
                                                java.lang.String applicationName,
                                                java.lang.String addr,
                                                int port,
                                                int timeout)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.

パラメータ:
cacheMode - キャッシュモードを設定します.
[true]を設定した場合、ファイルキャッシュをONにします.
[false]を設定した場合、メモリキャッシュをONにします.
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、Uniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
port - コネクション先のポート番号を設定します.
timeout - コネクションタイムアウトを設定します.
[0]以下を設定した場合、無限待機となります.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(boolean cacheMode,
                                                java.lang.String applicationName,
                                                java.net.InetAddress addr)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.
このメソッドでは、JRcServerのデフォルトポート番号(32109)でアクセスします.

パラメータ:
cacheMode - キャッシュモードを設定します.
[true]を設定した場合、ファイルキャッシュをONにします.
[false]を設定した場合、メモリキャッシュをONにします.
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、なるべくUniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(boolean cacheMode,
                                                java.lang.String applicationName,
                                                java.net.InetAddress addr,
                                                int port)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.

パラメータ:
cacheMode - キャッシュモードを設定します.
[true]を設定した場合、ファイルキャッシュをONにします.
[false]を設定した場合、メモリキャッシュをONにします.
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、なるべくUniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
port - コネクション先のポート番号を設定します.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.

getConnection

public static final JRcConnection getConnection(boolean cacheMode,
                                                java.lang.String applicationName,
                                                java.net.InetAddress addr,
                                                int port,
                                                int timeout)
                                         throws InputException,
                                                AccessException
コネクション処理.

JRcServerにコネクションします.

パラメータ:
cacheMode - キャッシュモードを設定します.
[true]を設定した場合、ファイルキャッシュをONにします.
[false]を設定した場合、メモリキャッシュをONにします.
applicationName - 対象のアプリケーション名を設定します.
この内容は、セッション条件に影響します.
そのため、Uniqueな条件で設定してください.
addr - コネクション先のアドレスを設定します.
port - コネクション先のポート番号を設定します.
timeout - コネクションタイムアウトを設定します.
[0]以下を設定した場合、無限待機となります.
戻り値:
JRcConnection コネクションオブジェクトが返されます.
例外:
InputException - 入力例外.
AccessException - アクセス例外.