É possível gravar um manipulador de mediação, incluir uma função de mediação a ele e prepará-lo para ser instalado em um servidor de aplicativos.
Antes de Iniciar
É necessário ter acesso a um ambiente de programação Java™ e possuir uma ferramenta de montagem, como
IBM® Rational Application Developer.
Sobre Esta Tarefa
É possível implementar manipuladores de mediação. Cada manipulador de mediação executa um processamento de mensagens específico no tempo de execução, por exemplo, converter o formato de uma mensagem ou rotear uma mensagem para determinado destino. Um manipulador de mediação é uma estrutura de programa Java, à qual é incluído o código que executa a função de mediação.
É possível definir uma classe manipuladora de mediação em um projeto Java ou em um projeto EJB (necessários para o artefato de implementação). Os artefatos de programação e de implementação podem ser separados em projeto diferentes. As etapas a seguir são para um projeto EJB, mas as etapas são muito semelhantes se você quiser criar um projeto Java, porque você define um servidor de destino tanto para um projeto Java quanto para um projeto EJB e o plug-in de tempo de execução do servidor configura o caminho de classe corretamente.
Procedimento
- Crie um novo projeto EJB:
- Alterne para a perspectiva Java EE para trabalhar com projetos Java EE. Clique em Janela > Abrir Perspectiva > Outro > Java
EE.
- No menu Arquivo, selecione Novo > Projeto.
- Expanda a pasta Java EE e selecione Projeto do Aplicativo Corporativo. Clique em Avançar.
- Opcional: Se você criou um projeto Java em vez de um projeto EJB, clique com o botão direito no ícone da pasta do projeto Java para obter o menu de contexto e selecione Propriedades. Quando o painel Propriedades for exibido, selecione as propriedades do Servidor e destine o projeto a um servidor adequado para seu sistema, conforme descrito na etapa seguinte.
- Insira um nome para o projeto e destine esse projeto para um servidor adequado para o sistema. (Se essa for a primeira vez que esse servidor é destinado, clique em Novo....) Clique em Avançar para ir para Projetos de Módulo EAR.
- Clique em Novo Módulo....
- Crie um novo projeto de módulo, marcando a caixa de seleção do projeto EJB e inserindo o nome do manipulador de mediação.
- Clique em Concluir. Você retornará para a janela Projetos de Módulo EAR.
- Clique em Concluir para criar o novo projeto.
- Crie uma classe manipuladora de mediação, implementando a interface com.ibm.websphere.sib.mediation.handler.MediationHandler.
- No menu Arquivo, selecione Novo > Classe Java.
- Especifique a pasta de origem do projeto EAR de mediação.
- Especifique um nome para o manipulador de mediação.
- Selecione a Superclasse java.lang.Object.
- Selecione a Interface com.ibm.websphere.sib.mediation.handler.MediationHandler.
- Marque a caixa de seleção Métodos Abstratos Herdados.
- Clique em Concluir para criar a nova classe manipuladora de mediação.
- Inclua o código funcional que converte ou roteia mensagens para o manipulador de mediação, usando o IBM Rational Application Developer. Para obter informações adicionais, consulte o Incluindo a Função de Mediação no Código do Manipulador. Fique atento, pois o valor de retorno padrão do método de manipulação criado pelo kit de ferramentas é false, o que faz com que a mensagem seja descartada. Para preservar a mensagem, altere o valor de retorno para true.
- Gere um arquivo EAR a partir da classe manipuladora de mediação.
Siga as instruções da documentação do IBM Rational Application Developer.
O que Fazer Depois
Em seguida, você estará pronto para instalar o arquivo EAR, que contém o manipulador de mediação, no servidor de aplicativos.