Gestión de sesiones

Los métodos de sesión establecen conexiones y sesiones con el servidor. Puede utilizar los métodos de la sesión para abrir y cerrar sesiones con el servidor de TADDM y recuperar la conexión actual.

La Tabla 1 describe los métodos de sesión que puede utilizar.

Tabla 1. Métodos de sesión
Método	Descripción
close()	Cierre una sesión.
ApiFactory.getInstance().getApiConnection (String host, int port, String trustStoreLocation, boolean useSSL)	Cree una conexión utilizando el host y el puerto especificados. Si el valor de puerto especificado es `-1`, se utiliza el puerto predeterminado especificado en el archivo collation.properties. El parámetro trustStoreLocation especifica la ubicación del archivo de certificado que se va a utilizar con las conexiones SSL.
ApiFactory.getInstance().getSession (ApiConnection conn, String user, String password, long version)	Devuelva un objeto de sesión, que se utiliza para ejecutar métodos de la API de TADDM.
ApiFactory.getInstance().getSession (ApiConnection conn, long sessionId, long version)	Devuelva un objeto de sesión, que se utiliza para ejecutar métodos de la API de TADDM.
release()	Este método no se admite, utilice el método `close()`

Ejemplos

La conexión con el servidor de TADDM implica el establecimiento de una conexión con el servidor y el inicio de sesión con una cuenta de usuario y una contraseña para establecer una sesión. En el ejemplo siguiente, se muestra cómo establecer una conexión con el servidor:

private ApiConnection conn_;
   try {
      conn_ = ApiFactory.getInstance().getConnection( 
         "host.abcxyz.com",            //host name
 		     9433,                        //port number
         null,                        //Location of jssecacerts.cert file for SSL
         false);                      //true for SSL, false for non SSL
   } catch (Throwable th) {
        th.printStackTrace();
}

También puede establecer una conexión SSL, como se muestra a continuación:

private ApiConnection conn_;
   try {
      conn_ = ApiFactory.getInstance().getConnection( 
         "host.abcxyz.com",            //host name
 		     9433,                        //port number
         “c:\\temp\\jssecacerts.cert”, //Location of jssecacerts.cert file for SSL
         true);                        //true for SSL, false for non SSL
   } catch (Throwable th) {
        th.printStackTrace();
}

El servidor de TADDM utiliza el puerto 9433 de forma predeterminada, aunque se puede especificar un puerto alternativo si se especifica el valor adecuado en el archivo $COLLATION_HOME/etc/collation.properties.

Al establecer una conexión SSL, debe especificar la ubicación del archivo jssecacerts.cert. Descargue este archivo desde el portal web Java™ del servidor de TADDM, accesible en http://nombre_servidor:puerto_servidor_web, por ejemplo http://localhost:9430.

Una vez establecida ApiConnection, inicie la sesión en el servidor para establecer una sesión, como se muestra en el ejemplo siguiente:

   String user = "smartoperator";     // login user name
   String password = "foobar";        // user password
   long version = 0;                  // version
   ApiSession session_ = ApiFactory.getInstance().getSession(conn_, user, password, 
     version);
   CMDBApi api = session_.createCMDBApi();

CMDBApi es la referencia remota para realizar todas las operaciones relacionadas con la API en el servidor de TADDM.