Connect

Lit les propriétés pour déterminer quelle connexion de passerelle utiliser et établit une connexion au serveur. Vous pouvez vous connecter via HTTP, HTTPS ou SOCKET. Cependant, HTTP et HTTPS ne se connectent pas vraiment au serveur tant qu'une méthode GetService ou Process n'est pas invoquée. Avec un type de connexion SOCKET, la méthode Connect est complètement fonctionnelle.

Syntaxe

public void connect() 

Paramètres

Aucun(e)

Résultats

Throws :

• ConfigurationException : lorsqu'une configuration invalide entraîne une connexion impossible au serveur. Par exemple, un protocole inconnu causerait une ConfigurationException. Il n'y a pas de valeur dans la tentative de réessayer connect() lorsque cette erreur survient.
• ConfigurationException : lorsque la connexion au serveur est impossible. Il se peut que la reconnexion soit possible en fonction de la cause sous-jacente à l'exception.
• MessageProcessingException : lorsqu'une erreur se produit sur le serveur qui n'est pas liée aux problèmes de Configuration ou de Connexion.

Exemple

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 
}

Pool de connexion

Pool de connexion pour le type de connexion SOCKET est disponible sur le client Java. Cette section décrit comment activer et désactiver le pool de connexion. Par défaut, le pool de connexion est désactivé.

Pour activer le pool de connexion :

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

Pour désactiver le pool de connexion :

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

Lorsque le pool de connexion est activé, la méthode connect() emprunte une connexion à partir du pool et la méthode disconnect() renvoie la connexion vers le pool. Lors de l'utilisation du pool, le client doit appeler la méthode disconnect() chaque fois pour renvoyer la connexion au pool.

Chaque thread doit contenir son propre serveur, comme indiqué dans l'exemple suivant :

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

Le tableau suivant répertorie les constantes que vous pouvez utiliser pour le pool de connexion.

* Applicable uniquement si on utilise un type de connexion SOCKET et si la mise en réserve de connexions est activée.