7.5.6. EJB クライアントプロパティー

概要

以下の表は、プログラムまたは jboss-ejb-client.properties ファイルで設定できるプロパティーを示しています。

EJB クライアントグローバルプロパティー

以下の表は、同じスコープ内のライブラリー全体で有効なプロパティーを示しています。

表7.1 グローバルプロパティー

プロパティー名 説明
endpoint.name
クライアントエンドポイントの名前。設定されない場合、デフォルト値は client-endpoint です。
スレッド名にはこのプロパティーが含まれるため、異なるエンドポイント設定を区別するのに役に立つことがあります。
remote.connectionprovider.create.options.org.xnio.Options.SSL_ENABLED
すべての接続に対して SSL プロトコルが有効であるかどうかを指定するブール値。
deployment.node.selector
org.jboss.ejb.client.DeploymentNodeSelector の実装の完全修飾名。
これは、EJB の呼び出しを負荷分散するために使用されます。
invocation.timeout
EJB ハンドシェイクまたはメソッド呼び出し要求/応答サイクルのタイムアウト。この値はミリ秒単位です。
実行にタイムアウト時間よりも長い時間がかかった場合は、任意のメソッドの呼び出しで java.util.concurrent.TimeoutException がスローされます。実行が完了し、サーバーは中断されません。
reconnect.tasks.timeout
バックグラウンド再接続タスクのタイムアウト。この値はミリ秒単位です。
複数の接続がダウンしている場合は、次のクライアント EJB 呼び出しで、適切なノードを見つけるために再接続が必要かどうかを決定するアルゴリズムが使用されます。
org.jboss.ejb.client.scoped.context
スコープ EJB クライアントコンテキストを有効にするかどうかを指定するブール値。デフォルトは、false です。
true に設定された場合、EJB クライアントは JNDI コンテキストに割り当てられたスコープコンテキストを使用します。その他の場合、EJB クライアントコンテキストは JVM でグローバルセレクターを使用して、リモート EJB およびホストを呼び出すために使用されるプロパティーを決定します。
EJB クライアント接続プロパティー

接続プロパティーは、プレフィックス remote.connection.CONNECTION_NAME で始まります。CONNECTION_NAME は、接続を一意に識別するためにのみ使用されるローカル ID です。

表7.2 接続プロパティー

プロパティー名 説明
remote.connections
アクティブな connection-names のカンマ区切りのリスト。各接続はこの名前を使用して設定されます。
remote.connection.CONNECTION_NAME.host
接続のホスト名または IP。
remote.connection.CONNECTION_NAME.port
接続のポート。デフォルト値は 4447 です。
remote.connection.CONNECTION_NAME.username
接続セキュリティーを認証するために使用されるユーザー名。
remote.connection.CONNECTION_NAME.password
ユーザーを認証するために使用されるパスワード
remote.connection.CONNECTION_NAME.connect.timeout
初期接続のタイムアウト時間。この時間が経過すると、再接続タスクにより、接続を確立できるかどうかが定期的に確認されます。値はミリ秒単位です。
remote.connection.CONNECTION_NAME.callback.handler.class
CallbackHandler クラスの完全修飾名。これは、接続を確立するために使用され、接続がオープンである限り変更できません。
remote.connection.CONNECTION_NAME.
channel.options.org.jboss.remoting3.RemotingOptions.MAX_OUTBOUND_MESSAGES
アウトバウンド要求の最大数を指定する整数値。デフォルト値は 80 です。
すべての呼び出しを処理するために、サーバーに対してクライアント (JVM) からの接続が 1 つだけあります。
remote.connection.CONNECTION_NAME.
connect.options.org.xnio.Options.SASL_POLICY_NOANONYMOUS
正常に接続するためにクライアントがクレデンシャルを提供する必要があるかどうかを決定するブール値。デフォルト値は true です。
true に設定された場合、クライアントはクレデンシャルを提供する必要があります。false に設定された場合は、リモートコネクターがセキュリティーレルムを要求しない限り、呼び出しが許可されます。
remote.connection.CONNECTION_NAME.
connect.options.org.xnio.Options.SASL_DISALLOWED_MECHANISMS
接続作成中に認証に使用される特定の SASL メカニズムを無効にします。
JBOSS_LOCAL_USER の場合は、サイレント認証メカニズム (クライアントとサーバーが同じマシンにあるときに使用されます) が無効になります。
remote.connection.CONNECTION_NAME.
connect.options.org.xnio.Options.SASL_POLICY_NOPLAINTEXT
認証中のプレーンテキストメッセージの使用を有効または無効にするブール値。JAAS を使用する場合は、プレーンテキストパスワードを許可するために false に設定する必要があります。
remote.connection.CONNECTION_NAME.
connect.options.org.xnio.Options.SSL_ENABLED
この接続に対して SSL プロトコルが有効であるかどうかを指定するブール値。
remote.connection.CONNECTION_NAME.
connect.options.org.jboss.remoting3.RemotingOptions.HEARTBEAT_INTERVAL
自動的なクローズ (ファイアウォールの場合など) を回避するためにクライアントとサーバー間でハートビートを送信する間隔。値はミリ秒単位です。
EJB クライアントクラスタープロパティー

初期接続でクラスター環境に接続する場合は、クラスターのトポロジーが自動的に非同期で受信されます。これらのプロパティーは、受信された各メンバーに接続するために使用されます。各プロパティーは、プレフィックス remote.cluster.CLUSTER_NAME で始まります。CLUSTER_NAME は、関連するサーバーの Infinispan サブシステム設定を参照します。

表7.3 クラスタープロパティ

プロパティー名 説明
remote.cluster.CLUSTER_NAME.
clusternode.selector
org.jboss.ejb.client.ClusterNodeSelector の実装の完全修飾名。
このクラス (org.jboss.ejb.clientDeploymentNodeSelector ではない) は、クラスター環境で EJB 呼び出しを負荷分散するために使用されます。クラスターが完全にダウンしている場合、呼び出しは No ejb receiver available で失敗します。
remote.cluster.CLUSTER_NAME.
channel.options.org.jboss.remoting3.RemotingOptions.MAX_OUTBOUND_MESSAGES
クラスター全体に対して実行できるアウトバウンド要求の最大数を指定する整数値。
remote.cluster.CLUSTER_NAME.
node.NODE_NAME. channel.options.org.jboss.remoting3.RemotingOptions.MAX_OUTBOUND_MESSAGES
この特定のクラスターノードに対して実行できるアウトバウンド要求の最大数を指定する整数値。
バグを報告する