Criando Orientadores Customizados para o Servidor Proxy

Utilize as etapas a seguir para criar e implementar um orientador customizado para um servidor proxy. As políticas do orientador customizado permitem uma determinação mais específica da disponibilidade do servidor de aplicativos de destino. Orientadores customizados são módulos de código Java™ gravados que funcionam no servidor proxy para fornecer informações sobre a disponibilidade de servidores de aplicativos para o código de seleção de servidor proxy.

Sobre Esta Tarefa

Conclua estas etapas para criar e implementar um orientador customizado para o servidor proxy.

Procedimento

  1. Crie o código de orientador customizado.
    Os orientadores customizados são gravados na linguagem Java. Um orientador customizado estende a classe com.ibm.wsspi.advisor.AbstractCustomAdvisor no arquivo proxy.jar que está incluído no WebSphere Application Server. Os orientadores customizados utilizam os métodos definidos da classe AbstractCustomAdvisor para obter as informações sobre o orientador. Um orientador customizado deve também implementar os seguintes elementos:
    • Um método de construtor que obtém um objeto CustomAdvisorConfigObject e chama o método super(caConfigObject), por exemplo,
      public AbstractHttpProxyCustomAdvisor(CustomAdvisorConfigObject caConfigObject) {
      		super(caConfigObject);
      	}
    • Um método isUsable() que obtém um objeto AdvisableServer; por exemplo,
      public boolean isUsable(AdvisableServer aServer) throws CustomAdvisorException;
    O método initialize é chamado após a construção de AbstractCustomAdvisor, mas antes da chamada do método isUsable. Esse processo permite ao orientador customizado executar qualquer etapa adicional após a classe-base concluir a inicialização, mas antes da chamada do método isUsable, assegurando que o método initialize seja chamado apenas uma vez. Se substituído, o método initialize() deverá chamar o método super.intitialize, por exemplo:
    protected void initialize() {
        	super.initialize();
        }
    Para obter mais informações sobre as rotinas necessárias e os demais métodos disponíveis a um orientador customizado, consulte a seção de referência de API (interface de programação de aplicativo) do centro de informações. Na navegação do centro de informações, vá para a seção Referência e clique em APIs - Interface de Programação de Aplicativo. Uma lista das especificações de API do produto é exibida em ordem alfabética.
    Há duas classes de exceção que precisam ser consideradas ao criar o orientador customizado:
    • A exceção CustomAdvisorException pode ser criada pelo método isUsable do orientador customizado para indicar ao AbstractCustomAdvisor que o orientador customizado não deve chamar o método isUsable novamente até o próximo ciclo do orientador.
    • A NoLogConfiguredException será criada pelo AbstractCustomAdvisor se nenhum arquivo de criação de log tiver sido configurado para o orientador customizado, mas a criação de log estiver ativada.

    O arquivo httpcustomadvisor.jar pode ser utilizado como uma amostra de um orientador customizado. Esse arquivo contém uma classe AbstractHttpProxycustomAdvisor.java que estende o com.ibm.wsspi.advisor.AbstractCustomAdvisor e implementa os métodos isUsable() e initialize().

    Arquivo httpcustomadvisor.jar de amostra:
    <advisor-context>                                                      
    <description>Webbsphere Proxy Demo HTTP Advisor Context</description>  
    <display-name>Webbsphere Proxy Demo HTTP Advisor Context</display-name>
    ?                                                                      
    <advisor>                                                              
    <advisor-name>WebsphereProxyDemoHttpAdvisor</advisor-name>             
    ?                                                                      
    <advisor-class>                                                        
    com.ibm.ws.proxy.demo.customadvisor.http.HttpProxyCustomAdvisor        
    </advisor-class>                                                       
    <description>Demo Websphere Proxy Http Advisor                         
    Implementation</description>                                           
    <display-name>Demo Websphere Proxy Http Advisor</display-name>         
    </advisor>                                                             
    </advisor-context>  
  2. Compile seu código de orientador customizado. Depois de criar o código-fonte Java para seu orientador customizado, você deverá compilá-lo utilizando o código AbstractCustomAdvisor que está incluído no WebSphere Application Server. Para acessar as classes abstratas do orientador customizado no pacote com.ibm.wsspi.advisor, inclua o arquivo proxy.jar no caminho de classe Java. O arquivo proxy.jar está localizado no diretório ${WAS_INSTALL_ROOT|/plugins.
  3. Crie o arquivo advisor-context.xml.

    Depois de compilar o código de orientador customizado, você precisará criar o arquivo advisor-context.xml. Esse arquivo é utilizado para identificar o código como um arquivo JAR (Java Archive) do orientador customizado quando ele é importado como um recurso e depois incluído como uma unidade de compilação em um BLA (Business-Level Application). Quando o recurso JAR do orientador customizado for incluído em um BLA e depois destinado a um servidor proxy, o suporte de CDF (Content DistributionFramework) distribuirá e copiará todos os artefatos BLA do orientador customizado para as informações de configuração apropriadas nos destinos especificados.

    O advisor-context.xml contém o nome da classe para o orientador customizado a ser executado e o nome do orientador customizado. O formato do arquivo advisor-context.xml deve seguir o esquema advisor-contex.xsd no arquivo proxy.jar. Você pode utilizar uma ferramenta de esquema XML para auxiliar na criação e definição das informações apropriadas. As informações de configuração requeridas são definidas como se seguem:
      <advisor-name> SomeCustomAdvisor </advisor-name>
      <advisor-class> com.ibm.wlm.test.customadvisor.SomeCustomAdvisor </advisor-class>
      <description> Some Custom Advisor Description </description> 
      <display-name> Some display name </display-name>
  4. Crie o BLA do orientador customizado. Compacte os arquivos de classe compilados do orientador customizado e o advisor-context.xml em um arquivo JAR. Esse arquivo JAR então é utilizado ao criar o BLA do orientador customizado a ser instalado e implementado no servidor proxy. O exemplo a seguir mostra os comandos a serem usados para instalar um orientador customizado como um BLA.
    $AdminTask importAsset {-source C:/proxy/testadvisor.jar -storageType FULL}
    $AdminTask createEmptyBLA {-name myBLA}
    $AdminTask addCompUnit {-blaID myBLA -cuSourceID assetname=testadvisor.jar,assetversion=1.0 -MapTargets {{.* ProxyServer}} -CustomAdvisorCUOptions 
    {{"type=Cluster,cellName=yourCellName,clusterName=yourClusterName
    ,applicationName=myBLA" default default default 1000}}}
    $AdminConfig save
  5. Configure seu orientador customizado implementado. Consulte Administrando Orientadores Customizados para o Servidor Proxy para obter detalhes adicionais.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjpx_custadv_create
Nome do arquivo: tjpx_custadv_create.html