com.telventi.utilidades
Class ConexionFirma

java.lang.Object
  extended bycom.telventi.utilidades.ConexionFirma

public class ConexionFirma
extends java.lang.Object

La clase ConexionFirma se utiliza para establecer una conexión RMI-IIOP con la plataforma de Firma y obtener facilmente referencias a las interfaces disponibles en la misma:

- FirmaWebMCA
- FirmaEnBloqueMCAFacade
- CustodiaDocumentosFacade
- VerificarFirmas

Las propiedades concretas del contexto JNDI son especificadas mediante el recurso "/jndiMigration.properties", el cual debe encontrarse en alguno de los directorios añadidos a la variable de entorno CLASSPATH. En caso de no existir se emplearan las propiedades por defecto:

- java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
- java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces
- jnp.partitionName=AFirma5-Partition

En caso de disponer de una plataforma con Servidor de Firma puesto en cluster, se indicará la lista de nodos separados por comas en el parámetro servidor e indicando como puerto el puerto 1100 (HA-JNDI).

- Normal: 192.168.53.242
- Cluster: 192.168.53.242:1100,192.168.53.243:1100

Antes de utilizar los métodos que proporcionan referencias a las interfaces es necesario inicializar los parámetros de conexión a la plataforma de firma: Servidor de Firma, usuario y password de conexión JAAS, fichero de autenticación JAAS y recurso . properties con propidades de contexto JNDI de conexión.

Ejemplo de utilización que obtiene una referencia a la interfaz VerificarFirmas:

ConexionFirma.setParametrosConexion("192.168.53.19", "usuario", "password");
VerificarFirmas v = ConexionFirma.getInstance().getVerificarFirmas();


Method Summary
 CustodiaDocumentosFacade getCustodiaDocumentos()
          Método que devuelve un objeto de la interfaz CustodiaDocumentosFacade y que permitirá utilizar todos sus métodos.
 FirmaEnBloqueMCAFacade getFirmaEnBloque()
          Método que devuelve un objeto de la interfaz FirmaEnBloqueMCAFacade y que permitirá utilizar todos sus métodos.
 FirmaWebMCA getFirmaFicheros()
          Método que devuelve un objeto de la interfaz FirmaWebMCA y que permitirá utilizar todos sus métodos.
static ConexionFirma getInstance()
          Función que devuelve una instancia del Singlenton ConexionFirma.
static java.lang.String getJNDIPropertiesResource()
          Obtiene el recurso de configuración .properties que contiene las propiedades del contexto JNDI de conexión.
 VerificarFirmas getVerificarFirmas()
          Función que devuelve un objeto de la interfaz VerificarFirmas y que permitirá utilizar todos sus métodos.
static void setFicheroAuth(java.lang.String url)
          Método que permite indicar al Singleton ConexionFirma la ruta del fichero de autenticación JAAS "auth.conf" proporcionado en el CD Desarrollo de la plataforma.
static void setJNDIPropertiesResource(java.lang.String jndiPropertiesResource)
          Establece el recurso de configuración .properties que contiene los parámetros de configuración para el contexto JNDI.
static void setParametrosConexion(java.lang.String servidor, java.lang.String usuario, java.lang.String password)
          Método que permite indicar al Singleton ConexionFirma los parámetros de Conexion al Servidor de Firma de la plataforma de Firma.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getJNDIPropertiesResource

public static java.lang.String getJNDIPropertiesResource()
Obtiene el recurso de configuración .properties que contiene las propiedades del contexto JNDI de conexión.

Returns:
el nombre del recurso que contiene las propiedades de configuración del contexto JNDI que se creará para conectarse al núcleo de @firma.

setParametrosConexion

public static void setParametrosConexion(java.lang.String servidor,
                                         java.lang.String usuario,
                                         java.lang.String password)
Método que permite indicar al Singleton ConexionFirma los parámetros de Conexion al Servidor de Firma de la plataforma de Firma. En caso de disponer de una plataforma con Servidor de Firma puesto en cluster, se indicará la lista de nodos separados por comas en el parámetro servidor.

Parameters:
servidor - Nombre de Host o dirección IP del Servidor de Firma, o lista de ellos separada por comas.
usuario - Usuario para autenticación JAAS.
password - Password para autenticación JAAS.

setFicheroAuth

public static void setFicheroAuth(java.lang.String url)
Método que permite indicar al Singleton ConexionFirma la ruta del fichero de autenticación JAAS "auth.conf" proporcionado en el CD Desarrollo de la plataforma. Si no se utiliza este método se supone que el fichero se encuentra en el directorio actual desde el que se ejecuta la aplicación.

Parameters:
url - Ruta del fichero de autenticación JAAS "auth.conf".

setJNDIPropertiesResource

public static void setJNDIPropertiesResource(java.lang.String jndiPropertiesResource)
Establece el recurso de configuración .properties que contiene los parámetros de configuración para el contexto JNDI.

Parameters:
jndiPropertiesResource - nuevo recurso de propiedades para establecer los parámetros de configuración del contexto JNDI que se creará para conectarse al núcleo de @firma.

getInstance

public static ConexionFirma getInstance()
                                 throws java.lang.Exception
Función que devuelve una instancia del Singlenton ConexionFirma.

Returns:
ConexionFirma Fachada de conexión a las interfaces remotas de firma de ficheros, firma en bloque, verificación de firma de ficheros y bloques y custodia de documentos.
Throws:
java.lang.Exception - Si ocurre algún error.

getFirmaFicheros

public FirmaWebMCA getFirmaFicheros()
                             throws java.lang.Exception
Método que devuelve un objeto de la interfaz FirmaWebMCA y que permitirá utilizar todos sus métodos.

Returns:
FirmaWebMCA interfaz remota de firma de ficheros.
Throws:
java.lang.Exception - si ocurre alguna excepción.

getCustodiaDocumentos

public CustodiaDocumentosFacade getCustodiaDocumentos()
                                               throws java.lang.Exception
Método que devuelve un objeto de la interfaz CustodiaDocumentosFacade y que permitirá utilizar todos sus métodos.

Returns:
CustodiaDocumentosFacade interfaz remota de custodia de documentos.
Throws:
java.lang.Exception - si ocurre alguna excepción.

getFirmaEnBloque

public FirmaEnBloqueMCAFacade getFirmaEnBloque()
                                        throws java.lang.Exception
Método que devuelve un objeto de la interfaz FirmaEnBloqueMCAFacade y que permitirá utilizar todos sus métodos.

Returns:
FirmaEnBloqueMCAFacade interfaz remota de firma en bloque de documentos
Throws:
java.lang.Exception - si ocurre alguna excepción.

getVerificarFirmas

public VerificarFirmas getVerificarFirmas()
                                   throws java.lang.Exception
Función que devuelve un objeto de la interfaz VerificarFirmas y que permitirá utilizar todos sus métodos.

Returns:
VerificarFirmas interfaz de verificación de firmas de ficheros y bloques.
Throws:
java.lang.Exception - si ocurre alguna excepción.