Para utilizar la API de revisión de política personalizada
para escribir políticas, primero debe crear un administrador de políticas. Para añadir las políticas personalizadas, el
administrador de la política debe incluir una referencia a cada política personalizada.
Puede configurar una clase de
administrador de políticas y una implementación de política y después añadir el administrador de políticas a su
repositorio.
Antes de empezar
- Configure el espacio de trabajo.
- Compruebe que la versión de Java de su
espacio de trabajo se corresponde con la versión de Java del servidor. Por ejemplo, IBM® WebSphere Application Server versión 7.0 utiliza Java 5. Si
la política se compila con Java 6, no puede funcionar.
Procedimiento
- Configure el proyecto:
- Cree un proyecto Java para su política
personalizada. Puede utilizar el administrador de políticas y las políticas de SampleGovernor.jar
a modo de iniciación importándolas en su proyecto y modificándolas para crear políticas personalizadas.
- Importe el administrador de políticas de ejemplo en el subdirectorio /src del proyecto,
pulsando con el botón derecho sobre el proyecto y seleccionando Importar.
- Seleccione Archivo de archivado y pulse Siguiente.
- Pulse Examinar y seleccione el archivo de archivado SampleGovernor.
- Pulse Finalizar. El contenido se añade a su proyecto nuevo.
- Añada las dependencias a su vía de acceso de construcción: Debe especificar cada archivo JAR que está incluido en la API Java RAM (en el archivo
/ram/ramclient.zip ) individualmente en la vía de acceso de clases. El nombre del archivo JAR en
la vía de acceso de clases debe incluir el nombre completo, por ejemplo:
org.eclipse.emf.ecore.xmi_2.4.1.v200902171115.. jar.
- Para importar archivos desde el archivador ramclient, puede descargar el archivador de la
página Ampliaciones. Para abrir dicha página, pulse el icono Ayuda y, a
continuación, pulse Ampliaciones.
- Extraiga el contenido del archivo ram.client para añadir los archivos necesarios al proyecto
nuevo.
- Pulse con el botón derecho del ratón y seleccione .
- Navegue hasta donde ha extraído el archivo ramclient.zip y seleccione todos los
archivos JAR com.ibm.ram.common,ramclient, jaxb
y org.eclipse. Debe incluir los archivos JAR siguientes:
com.ibm.ram.common
ramclient
jaxb-api
jaxb-impl
org.eclipse.emf.common
org.eclipse.emf.ecore.xmi
org.eclipse.emf.ecore
org.eclipse.equinox.common
org.eclipse.osgi
En la versión 7.5 y versiones anteriores, debe añadir los archivos JAR siguientes a la vía de acceso de clases:
- Escriba las políticas:
- Puede crear una política ampliando o no una de las políticas suministradas, como por ejemplo MyPolicy. Puede
utilizar métodos de un archivo de política suministrada y cambiar los métodos. Por ejemplo, en el método test(), puede
aprobar o fallar una prueba de política de activos en función de un conjunto específico de detalles de tipo de activo
para su modelo de administración.
Para obtener más información sobre las API que puede utilizar al escribir las políticas personalizadas, consulte
APIs a utilizar en políticas personalizadas
Nota: Puede almacenar políticas en una correlación y obtener una política por ID; por ejemplo, private Map
policies;. Para recuperar una política de la correlación, especifique el ID de política en el método getPolicies().get(id).
- En la clase Governor, agregue una referencia a cada política nueva.
Su clase de
administrador debe incluir una referencia a cada política personalizada del administrador de políticas. Por ejemplo, para MyPolicy, estas líneas se añaden a la clase MyGovernor (en MyGovernor.java):
//My XML Policy
Policy policy = new MyPolicy(this);
policies.put(policy.getID(), policy);
Puede utilizar las API Java de Rational Asset Manager para trabajar con el activo actual y otros activos dentro de
una política personalizada. Para obtener ejemplos de cómo utilizar las APIs Java, consulte:
Utilización de la API Java de Rational Asset Manager. Encontrará ejemplos e información
adicional sobre las API que puede utilizar en
la página wiki de
políticas personalizadas en jazz.net
- Instale las políticas. Puede empaquetar las políticas personalizadas exportando el proyecto como archivo JAR y añadiéndolo como
ampliación de política nueva.
- Exporte el proyecto como archivo JAR.
Cuando guarde el paquete como un proyecto de Eclipse, también debe incluir estos archivos JAR, que son necesarios
para utilizar la API Java de Rational Asset Manager en una política:
- En WebSphere Application Server:
- axis.jar
- jaxrpc.jar
- ramclient.jar
- saaj.jar
- wsdl47-1.5.1.jar
- En Tomcat:
- ramclient.jar
- org.eclipse.equinox.common (para IProgressMonitor)
En la versión 7.5.0.1 y posteriores, puede incluir varios archivos
JAR (como ramclient.jar y el JAR de política) como un archivo .zip al cargar
una política.
- Inicie sesión en el producto como administrador de repositorio.
- En la página Administración, pulse Ampliaciones personalizadas.
- Añada una ampliación de política nueva.
- Escriba el nombre de nombre de clase totalmente cualificado (paquete y clase) del
administrador de políticas.
- Vaya hasta el archivo JAR que exportó en el paso 4a.
Su política se puede utilizar en un proceso de ciclo de vida o de política.
Para obtener instrucciones adicionales sobre cómo añadir su administrador, consulte
Definir administradores de
políticas externas.
Qué hacer a continuación
Probar y depurar la política. Para obtener instrucciones, consulte
Probar y depurar políticas.