Connect

プロパティを読み取って、使用するゲートウェイ接続を決定し、サーバーへの接続を確立します。HTTP、HTTPS、またはソケットを介して接続できます。ただし、HTTP と HTTPS は GetService メソッドまたは Process メソッドが呼び出されるまで実際にはサーバーに接続しません。ソケット接続タイプの使用時は、Connectメソッドは完全に機能します。

構文

public void connect() 

パラメータ

なし

結果

例外:

• ConfigurationException: 無効な設定が原因で、サーバーに接続できません。例えば、不明なプロトコルは ConfigurationException を発生させます。このエラーが発生した場合は connect() を再実行しても無意味です。
• ConnectionException: サーバーに接続できないときに発生します。例外の根本的な原因によっては、再実行で接続に成功する可能性があります。
• MessageProcessingException: 設定や接続の問題ではない原因でサーバー側にエラーが発生したことを意味します。

例

Server server = new Server(); 

server.setConnectionProperty(Server.HOST, "localhost"); 
server.setConnectionProperty(Server.PORT, "10119"); 
server.setConnectionProperty(Server.CONNECTION_TYPE, "SOCKET"); 
server.setConnectionProperty(Server.ACCOUNT_ID, "guest"); 
server.setConnectionProperty(Server.ACCOUNT_PASSWORD, ""); 

try 
{ 
	//Connect to server 
	server.connect(); 
} 
catch (ConfgurationException e) 
{ 
	// indicate an error with configuration 
} 
catch (ConnectionException e) 
{ 
	// handle connection issue (retry, report error, etc.) 
} 
catch (MessageProcessingException e) 
{ 
	// report error 
}

コネクション プーリング

ソケット接続タイプのコネクション プーリングが、Java クライアントで利用できます。ここでは、コネクション プーリングを有効または無効にする手順を説明します。デフォルトで、コネクション プーリングは無効です。

コネクション プーリングを有効にする:

Server server = new Server(); Server.setConnectionProperty(Connection.SOCKET_POOL, "true"); 

コネクション プーリングを無効にする:

Server server = new Server(); Server.setConnectionProperty(Connection.SOCKET_POOL, "false"); 

コネクション プーリングを有効にすると、connect() メソッドはプールから接続を借用し、disconnect() メソッドは接続をプールに返却します。プーリングの使用時は、接続をプールに返すたびに必ず disconnect() を呼び出します。

各スレッドは、独自のサーバーを保持する必要があります。次に、使用例を示します。

{ 
	...	
	Server server = new Server(); 
	server.setConnectionProperty(Server.HOST, "localhost"); 
	server.setConnectionProperty(Server.PORT, "10119"); 
	server.setConnectionProperty(Server.CONNECTION_TYPE, "SOCKET"); 
	server.setConnectionProperty(Server.ACCOUNT_ID, "yourID"); 
	server.setConnectionProperty(Server.ACCOUNT_PASSWORD, "pwd"); 
	server.setConnectionProperty(Connection.SOCKET_POOL, "true"); 
	server.setConnectionProperty(Connection.SOCKET_POOL_MAX_ACTIVE, "20"); 
	server.setConnectionProperty(Connection.SOCKET_POOL_MIN_IDLE, "10"); 
	server.setConnectionProperty(Connection.SOCKET_POOL_MAX_TOTAL, "25"); 
	server.connect(); 
	...	
	service = server.getService(serviceName); 
	reply = service.process(requestMessage); 
	server.disconnect(); 
	...	
}

以下の表に、コネクション プーリングに使用できる定数を示します。

* ソケット接続タイプを使用し、コネクション プーリングが有効な場合のみ適用できます。