es.mityc.javasign.xml.xades.policy
Class PoliciesManager

java.lang.Object
  es.mityc.javasign.xml.xades.policy.PoliciesManager

public class PoliciesManager
extends java.lang.Object

Manager que gestiona las instancias de validadores de policies.

Obtiene los managers disponibles para la validación de políticas a través de los ficheros de configuración disponibles en "META-INF/xades/policy.properties".

Los ficheros de propiedades han de cumplir el formato:

 # En este fichero se indica qué clases son las encargadas de validar policies
 # específicas
 # Formato:
 #   <clave>=<clase>
 # donde clave puede ser cualquier string que no contenga un código especial
 # (por ejemplo un hash en hexadecimal de la policy), y clase es la clase
 # que implementa el interfaz es.mityc.firmaJava.policy.IValidacionPolicy en
 # el caso de un validador de políticas y el interfaz 
 # es.mityc.firmaJava.policy.IFirmaPolicy en el caso de un escritor de
 # políticas

Version:

0.9 beta TODO: implementar mecanismo para la búsqueda de los managers mediante el identificador y no únicamente por la clave textual.

Author:

Ministerio de Industria, Energía y Turismo

Nested Class Summary

class

PoliciesManager.PolicyKey Clave para buscar el manager asociado a esa política.

Method Summary

IFirmaPolicy	getEscritorPolicy(java.lang.String clave) Devuelve el escritor de policy asociado a la clave indicada.
static PoliciesManager	getInstance() Devuelve una instancia del manager de policies.
IValidacionPolicy	getValidadorPolicy(PoliciesManager.PolicyKey clave) Devuelve el validador de policy asociado a la clave indicada.
IValidacionPolicy	getValidadorPolicy(PoliciesManager.PolicyKey clave, boolean defaultManager) Devuelve el validador de policy asociado a la clave indicada.
PoliciesManager.PolicyKey	newPolicyKey(java.net.URI uri, java.lang.String hash) Crea una nueva instancia de una clave identificadora de política.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

newPolicyKey

public PoliciesManager.PolicyKey newPolicyKey(java.net.URI uri,
                                              java.lang.String hash)

Crea una nueva instancia de una clave identificadora de política.

Parameters:

uri - Uri que identifica la política

hash - Clave textual que identifica la política

Returns:

Clave identificadora para buscar una política

getInstance

public static PoliciesManager getInstance()

Devuelve una instancia del manager de policies.

Returns:

getValidadorPolicy

public IValidacionPolicy getValidadorPolicy(PoliciesManager.PolicyKey clave)

Devuelve el validador de policy asociado a la clave indicada. Funciona como una factory que instancia un nuevo validador en cada llamada.

Parameters:

clave - Clave que tiene asociada un validador

Returns:

Una instancia del validador de policy asociado o null si no hay ninguno asociado o no se puede instanciar. TODO: permitir funcionar a la factory en varios modos de trabajo (instanciador, cache, singleton, instanciador propio del validador)

getValidadorPolicy

public IValidacionPolicy getValidadorPolicy(PoliciesManager.PolicyKey clave,
                                            boolean defaultManager)

Devuelve el validador de policy asociado a la clave indicada. Funciona como una factory que instancia un nuevo validador en cada llamada.

Parameters:

clave - Clave que tiene asociada un validador

defaultManager - indica si se debe devolver un PolicyManager que informe sobre la política aunque sea desconocida

Returns:

Una instancia del validador de policy asociado o null si no hay ninguno asociado o no se puede instanciar. TODO: permitir funcionar a la factory en varios modos de trabajo (instanciador, cache, singleton, instanciador propio del validador)

getEscritorPolicy

public IFirmaPolicy getEscritorPolicy(java.lang.String clave)

Devuelve el escritor de policy asociado a la clave indicada. Funciona como una factory que instancia un nuevo escritor en cada llamada.

Parameters:

clave - Clave que tiene asociada un escritor

Returns:

Una instancia del escritor de policy asociado o null si no hay ninguno asociado o no se puede instanciar. TODO: permitir funcionar a la factory en varios modos de trabajo (instanciador, cache, singleton, instanciador propio del escritor)