Connect

Lee las propiedades para determinar la conexión de punto de acceso a utilizar y establece la conexión con el servidor. Puede conectarse a través de HTTP, HTTPS o SOCKET. No obstante, HTTP y HTTPS en realidad no establecen conexión con el servidor hasta que se invoca un método GetService o de proceso (Process). Con una conexión de tipo SOCKET, el método Connect ofrece funciones completas.

Sintaxis

public void connect() 

El json en el POST es opcional; solo se requiere si la consulta SQL utiliza parámetros vinculados.

Ninguno.

Resultados

Arroja:

• ConfigurationException: cuando una configuración no válida causa una incapacidad para conectarse con el servidor. Por ejemplo, un protocolo desconocido puede causar un error ConfigurationException. Si se produce este error, será inútil intentar usar nuevamente el método connect().
• ConnectionException: cuando no es posible establecer conexión con el servidor. Puede ser posible volver a conectarse, de acuerdo con la causa subyacente de la excepción.
• MessageProcessingException: cuando ocurre un error en el servidor que no se debe a problemas de configuración o conexión.

Ejemplo

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 
}

Agrupación de conexiones

La agrupación de conexiones para el tipo de conexión SOCKET se encuentra disponible para el cliente Java. En esta sección se explica cómo activar y deshabilitar la agrupación de conexiones. De forma predeterminada, la agrupación de conexiones está deshabilitada.

Para activar la agrupación de conexiones:

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

Para deshabilitar la agrupación de conexiones:

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

Cuando se activa la agrupación de conexiones, el método connect() toma prestada una conexión del grupo y el método disconnect() devuelve la conexión al grupo. Al utilizar la agrupación, el cliente debe invocar disconnect() todas las veces para devolver la conexión al grupo.

Cada subproceso debe contener su propio servidor, tal como se muestra en el siguiente ejemplo:

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

La siguiente tabla enumera las constantes que pueden utilizarse para la agrupación de conexiones.

* Esto solo corresponde si se usa el tipo de conexión SOCKET y se activa la agrupación de conexiones.