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
Procedimento
- 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;
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.protected void initialize() { super.initialize(); }
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>
- Um método de construtor que obtém um objeto CustomAdvisorConfigObject e chama o
método super(caConfigObject), por exemplo,
- 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.
- 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>
- 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
- Configure seu orientador customizado implementado. Consulte Administrando Orientadores Customizados para o Servidor Proxy para obter detalhes adicionais.


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