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
- Configure a área de trabalho.
- Certifique-se de que a versão de Java™
de sua área de trabalho corresponda à versão de Java
no servidor. Por exemplo, o IBM® WebSphere Application Server versão 8.0 usa Java 6. Se a política for compilada
com Java 7 ou 5, ele não
funcionará.
- Extraia o arquivo ramclient.zip em uma pasta.
O arquivo ramclient.zip contém um conjunto de arquivos .jar necessários
para a API Java do Rational Asset Manager
e está disponível na página Extensões
de qualquer instância de servidor implementada do Rational Asset Manager. Também é possível acessá-lo diretamente daqui: http://<hostname>:<port>/ram/ramclient.zip
(como http://<localhost>:<9080>/ram/ramclient.zip).
Procedimento
- Configure o projeto:
- 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.
- 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.
- Selecione Archive e clique em Avançar.
- Clique em Procurar e selecione o arquivo archive
SampleGovernor.
- Clique em Concluir. O conteúdo será incluído ao seu novo projeto.
- Inclua a dependência para o arquivo ramclient.jar
no caminho de construção.
- Clique com o botão direito do mouse no projeto e selecione
.
- Navegue para onde você extraiu o arquivo ramclient.zip
e selecione o arquivo ramclient.jar.
- Escreva as políticas:
- 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).
- 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
- 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.
- 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.
- Efetue login no produto como um administrador de repositório.
- Na página Administração, clique em Extensões
Customizadas.
- Inclua uma nova extensão de política.
- Insira o nome completo de classe (pacote e classe)
de seu governor de política.
- 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.