Connect

Liest die Eigenschaften, um zu bestimmen, welche Gateway-Verbindung verwendet werden soll, und stellt eine Verbindung zum Server her. Sie können über HTTP, HTTPS oder SOCKET eine Verbindung herstellen. Über HTTP und HTTPS wird eigentlich erst dann eine Verbindung zum Server hergestellt, wenn die Methode „GetService“ oder „Process“ aufgerufen wird. Bei dem Verbindungstyp SOCKET ist die Methode Connect voll funktionsfähig.

Syntax

public void connect() 

Parameter

Keine.

Ergebnisse

Auslösungen:

• ConfigurationException: Wenn durch eine ungültige Konfiguration keine Verbindung zum Server hergestellt werden kann. Ein unbekanntes Protokoll verursacht beispielsweise eine ConfigurationException. Bei dem Versuch, die Methode „connect()“ erneut auszuführen, ist bei Auftreten dieses Fehlers kein Wert vorhanden.
• ConnectionException: Wenn keine Verbindung zum Server hergestellt werden kann. Abhängig von der zugrunde liegenden Ursache für die Ausnahme kann die Verbindung eventuell wiederhergestellt werden.
• MessageProcessingException: Wenn auf dem Server ein Fehler auftritt, der nicht durch Konfigurations- oder Verbindungsprobleme verursacht wurde.

Beispiel

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 
}

Verbindungspooling

Verbindungspooling für den Verbindungstyp SOCKET ist für den Java-Client verfügbar. In diesem Abschnitt wird beschrieben, wie Verbindungspooling aktiviert und deaktiviert wird. Verbindungspooling ist standardmäßig deaktiviert.

So aktivieren Sie das Verbindungspooling:

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

So deaktivieren Sie das Verbindungspooling:

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

Wenn Verbindungspooling aktiviert ist, leiht sich die Methode „connect()“ eine Verbindung aus dem Pool und die Methode „disconnect()“ gibt die Verbindung wieder an den Pool zurück. Beim Pooling muss der Client die Methode „disconnect()“ jedes Mal aufrufen, um die Verbindung an den Pool zurückzugeben.

Jeder Thread sollte seinen eigenen Server enthalten, wie im folgenden Beispiel dargestellt:

{ 
	...	
	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(); 
	...	
}

In der folgenden Tabelle werden die Konstanten aufgeführt, die Sie für Verbindungspooling verwenden können.

* Gilt nur, wenn der Verbindungstyp SOCKET verwendet wird und das Verbindungspooling aktiviert ist.