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
7.0 usa o
Java 5. Se a política for compilada com o Java
6, ela não poderá funcionar.
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 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.
- 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.
- Extraia o conteúdo do archive ram.client para incluir os
arquivos obrigatório no seu novo projeto.
- Clique com o botão direito do mouse no projeto e selecione
.
- 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:
- 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.
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.
- 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 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.