Após você criar ligação de dados IMS
Java™, é necessário criar um
Java bean que se comunique com o
IMS através de J2EE Connector Architecture.
Sobre Esta Tarefa
Esse Java bean inclui um método que envia
uma solicitação para o IMS executar a transação do
IMS.
Esse método usa ligações de dados Java para
construir as mensagens de entrada e de saída para a transação.
Um bean J2C pode incluir mais de um método que executa uma transação do
IMS, bem como diversas ligações de dados para
diferentes mensagens de entrada e de saída. O código que é gerado para o bean J2C usa o
CCI fornecido pelo IMS TM Resource Adapter para se
comunicar com o IMS.
Procedimento
- Para iniciar o assistente dinâmico J2C, na barra de menus, selecione
Arquivo > Novo > Outro > J2C.
- Expanda a pasta J2C, selecione Bean J2C e clique em
Avançar.
- Na página Seleção de Adaptadores de Recursos, selecione a versão do
IMS TM Resource Adapter que deseja usar. É possível selecionar IMS Connector for Java (IBM: 10.5.x)
ou IMS Connector for Java (IBM: 11.3.0) e clicar em
Avançar.
- Na página Propriedades da Conexão, selecione Gerenciado.
Nota: Há duas opções para a maneira na qual as conexões são criadas entre o
IMS TM Resource Adapter, conforme usado pelo
Java bean, e o
IMS Connect. Este exemplo não é um aplicativo de
duas camadas, portanto, apenas uma conexão gerenciada é aplicável.
- Conexões gerenciadas são criadas por uma construção do J2EE Connector Architecture
chamada connection factory e são gerenciadas pelo servidor de aplicativos. Seu
Java bean acessa um connection factory usando JNDI
(Java Naming and Directory Interface). As conexões
gerenciadas são recomendadas. O IMS TM Resource
Adapter e o gerenciador de conexões do servidor de aplicativos trabalham juntos para
gerenciar as conexões com eficiência, fornecendo definição do conjunto de conexões,
reutilização e persistência.
- Conexões não gerenciadas são obtidas diretamente por meio do
IMS Resource Adapter, sem colaboração do servidor de
aplicativos. Conexões não gerenciadas normalmente são usadas por aplicativos de duas
camadas, sem definição do conjunto de conexões ou reutilização. Além disso, conexões do
soquete não gerenciadas entre o IMS TM Resource
Adapter e o IMS Connect não são persistentes,
incorrendo a sobrecarga adicional de abertura e fechamento do soquete para cada uso pelo
aplicativo.
- Na página Propriedades da Conexão, próximo do campo Nome da Consulta do JNDI, clique
em Novo. Isso define uma nova instância de servidor. Para definir uma nova instância de
servidor, o adaptador de recursos selecionado na etapa 3 é implementado na instância de
servidor.
Para criar uma instância de servidor na área de trabalho, conclua as seguintes etapas:
- No assistente Consulta do JNDI, na página Seleção de Instância de Servidor,
selecione Novo.
- Na página Definir um Novo Servidor, selecione o tipo de servidor que deseja criar;
por exemplo, WebSphere 7.0 Server. Em seguida, clique em
Avançar.
- Na página Configurações do Servidor
WebSphere, aceite os padrões.
- Clique em Concluir. O adaptador de recursos selecionado na
etapa 3 é implementado na instância de servidor.
- Na página Seleção de Instância do Servidor, clique em Avançar.
- Crie e configure um connection factory J2C para a instância de servidor criada. O assistente Connection Factories J2C permite selecionar um connection factory J2C
a partir daqueles que foram definidos para o adaptador de recursos selecionado na etapa
3. Também é possível fornecer um nome de consulta do JNDI de um connection factory que
ainda não existe e defini-lo posteriormente. Para criar e configurar um connection
factory J2C para a instância de servidor, conclua as seguintes etapas:
- Na página Connection Factory J2C, insira um nome JNDI para o novo connection
factory. Por exemplo, imsCFac.
- Configure o connection factory. Para conexões TCP/IP com o
IMS Connect, forneça valores para pelo menos os
campos a seguir:
- No campo Nome do Host, insira o nome do host TCP/IP do
IMS Connect que seu aplicativo usará. Por exemplo:
MYHOST.MYCOMPANY.COM
- No campo Número da Porta, insira um número da porta. Por
exemplo, 9999.
- No campo Nome do Armazenamento de Dados, insira o
armazenamento de dados IMS de destino. Por exemplo,
IMSA.
- Clique em Concluir. A instância de servidor é iniciada e inicializada.
- Após você ter configurado uma instância de servidor e seu servidor ter sido
iniciado, o nome JNDI do connection factory aparece no campo Nome da Consulta do JNDI. Clique em
Avançar.
- Na página Propriedades de Saída do Bean J2C, conclua as seguintes etapas:
- Para o Nome do Projeto Java, clique em
Novo.
- Selecione Projeto Java como tipo de projeto e clique em
Avançar.
- Na página Projeto Java, digite
PhoneBookJ2CBean para o nome do novo projeto
Java, aceite todos os outros padrões e clique em
Concluir.
- Próximo ao Nome do Pacote Java, clique em
Novo.
- Na página Pacote Java, digite
sample.ims para o novo pacote
Java e clique em Concluir.
- Para o Nome da Interface, especifique PB.
- Para o Nome da Ligação, aceite o padrão de PBImpl.
- Clique em
Avançar.
- Para criar um método que execute a transação, use o assistente Métodos
Java e conclua as seguintes etapas:
- Clique em Incluir para incluir um método
Java no bean J2C.
- Na página Incluir Método Java, digite
runPB para o nome do método
Java e clique em Avançar.
- Na página Método Java, clique em
Navegar próximo do campo Tipo de Entrada.
- Na janela Selecionar um Tipo de Dados, inicie o campo de entrada com um asterisco
(*) para visualizar os tipos de dados disponíveis.
- No campo Tipos Correspondentes, selecione INPUTMSG e clique
em OK para usar a ligação de dados INPUTMSG para o método
runPB.
- Próximo do campo Tipo de Saída, clique em Navegar.
- Na janela Selecionar um Tipo de Dados, inicie o campo de entrada com um asterisco
(*) para visualizar os tipos de dados disponíveis.
- No campo Tipos Correspondentes, selecione OUTPUTMSG e clique
em OK para usar a ligação de dados OUTPUTMSG para o método
runPB.
- Clique em Concluir.
- O assistente Métodos Java exibe o novo método,
runPB (INPUTMSG: OUTPUTMSG), na lista de métodos para o
Java bean. Assegure-se de que esse método seja
selecionado.
- Nas propriedades InteractionSpec para 'runPB', especifique os valores
IMSInteractionSpec. Para esse exemplo, aceite todos os padrões e clique em
Concluir.
Resultados
Agora você tem um bean J2C no projeto, PhoneBookJ2CBean, que pode ser
implementado em um ou mais aplicativos Java EE
usando diferentes recursos Java EE.