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 a dependência para o arquivo ramclient.jar no caminho de construção.
    1. Clique com o botão direito do mouse no projeto e selecione Caminho de Construção > Incluir Archives Externos.
    2. Navegue para onde você extraiu o arquivo ramclient.zip e selecione o arquivo ramclient.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.

      É possível incluir vários arquivos .jar (como qualquer outro arquivo .jar necessário, e o arquivo de política .jar) como um arquivo .zip quando você faz 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 exportado 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