Desenvolvendo políticas customizadas

Para usar a revisão API de política customizada para escrever políticas, você deve primeiro criar um governor de política. Para incluir as políticas customizadas, o governor de política deve incluir uma referência para cada política customizada. Configure uma classe do governor de política e a implementação de política e, em seguida, inclua o governor no repositório.

Antes de Iniciar

Procedimento

  1. Configure o projeto:
    1. Crie um projeto Java para sua política customizada. Você pode usar o governor de política de amostra e as políticas do arquivo SampleGovernor.jar para começar a importá-las em seu projeto e modificá-las para criar políticas customizadas.
    2. Importe o governor de política de amostra no subdiretório /src do projeto, clicando com o botão direito do mouse no projeto e selecionando Importar.
    3. Selecione Archive e clique em Avançar.
    4. Clique em Procurar e selecione o arquivo archive SampleGovernor.
    5. Clique em Concluir. O conteúdo será incluído ao seu novo projeto.
  2. Inclua as dependências no caminho de construção: Você deve especificar cada arquivo JAR incluído na API Java RAM (no arquivo ramclient.zip) individualmente no caminho da classe. O nome do arquivo JAR no caminho da classe deve incluir o nome completo, por exemplo: org.eclipse.emf.ecore.xmi_2.4.1.v200902171115.jar.
    1. Para importar arquivos do archive ramclient, você pode fazer download do archive na página Extensões. Para abrir essa página, clique no ícone Ajuda e, em seguida, clique em Extensões.
    2. Extraia o conteúdo do archive ram.client para incluir os arquivos obrigatório no seu novo projeto.
    3. Clique com o botão direito do mouse no projeto e selecione Caminho de Construção > Incluir Archives Externos.
    4. Navegue para onde você extraiu o arquivo ramclient.zip e selecione todos os arquivos JAR com.ibm.ram.common,ramclient, jaxb e org.eclipse. Você deve incluir os seguintes arquivos JAR:
      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
      Na V 7.5 e anterior, você deve incluir os seguintes arquivos JAR no caminho da classe:
      • A partir da instalação do produto (WebSphere_INSTALL_Directory\profiles\<PROFILE>\installedApps\<APPLICATION>\com.ibm.ram.repository.web.war\WEB-INF\lib):
        com.ibm.ram.common.jar
      • A partir do WebSphere Application Server (WebSphere_INSTALL_Directory\plugins):
        org.eclipse.emf.common.jar
        org.eclipse.emf.commonj.sdo.jar
        org.eclipse.emf.ecore.jar
        org.eclipse.emf.ecore.change.jar
        org.eclipse.emf.ecore.sdo.jar
        org.eclipse.emf.ecore.xmi.jar
  3. Escreva as políticas:
    1. Você pode criar uma política com ou sem estender uma das políticas fornecidas, como MyPolicy. É possível usar os métodos de um arquivo de políticas fornecido e alterar os métodos. Por exemplo, no método test(), você pode aprovar ou reprovar um teste de política de recurso dependendo de um conjunto específico de detalhes de tipo de recurso para seu modelo de controle.

      Para obter informações sobre quais APIs você pode usar para escrever políticas customizadas, consulte APIs a Serem Usadas em Políticas Customizadas

      Nota: Você pode armazenar políticas em um mapa e obter uma política por ID; por exemplo, private Map policies;. Para recuperar uma política a partir do mapa, digite o ID da política no método getPolicies().get(id).
    2. Na classe Governor, inclua uma referência em cada nova política. Sua classe Governor deverá incluir uma referência para cada política customizada no governor de política. Por exemplo, para MyPolicy, estas linhas são incluídas na classe MyGovernor (em MyGovernor.javs):
      	//My XML Policy
      		Policy policy = new MyPolicy(this);
      		policies.put(policy.getID(), policy);

      Você pode usar as APIs Java do Rational Asset Manager para trabalhar com o recurso atual e outros recursos em uma política customizada. Para exemplos de como usar as APIs Java, consulte: Usando a API Java do Rational Asset Manager. Exemplos e informações adicionais sobre as APIs que podem ser usadas estão na página do wiki de políticas customizadas em jazz.net

  4. Instale as políticas. Você compacta suas políticas customizadas exportando o projeto como um arquivo JAR e, em seguida, incluindo-o como uma nova extensão de política.
    1. Exporte o projeto como um arquivo JAR.
      Ao salvar seu pacote como um projeto Eclipse, você deve também incluir esses arquivos JAR, que são obrigatórios para usar as APIs Java do Rational Asset Manager em uma política:
      • No WebSphere Application Server:
        • axis.jar
        • jaxrpc.jar
        • ramclient.jar
        • saaj.jar
        • wsdl47-1.5.1.jar
      • No Tomcat:
        • ramclient.jar
        • org.eclipse.equinox.common (para IProgressMonitor)

      Na versão 7.5.0.1 e mais recente, é possível incluir diversos arquivos JAR (como ramclient.jar e o JAR da política) como um arquivo .zip ao fazer upload de uma política.

    2. Efetue login no produto como um administrador de repositório.
    3. Na página Administração, clique em Extensões Customizadas.
    4. Inclua uma nova extensão de política.
    5. Insira o nome completo de classe (pacote e classe) de seu governor de política.
    6. Navegue para o arquivo JAR que você exportou na etapa 4a. Sua política está disponível para uso em um ciclo de vida ou processo de política.
    Para obter instruções adicionais sobre como incluir o governor, consulte Definindo Governors de Política Externos.

O que Fazer Depois

Teste e depure sua política. Para obter instruções, consulte Testando e depurando políticas.

Feedback