Criando um Bean J2C para Conectar ao IMS

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

  1. Para iniciar o assistente dinâmico J2C, na barra de menus, selecione Arquivo > Novo > Outro > J2C.
  2. Expanda a pasta J2C, selecione Bean J2C e clique em Avançar.
  3. 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.
  4. 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.
  5. 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:
    1. No assistente Consulta do JNDI, na página Seleção de Instância de Servidor, selecione Novo.
    2. 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.
    3. Na página Configurações do Servidor WebSphere, aceite os padrões.
    4. Clique em Concluir. O adaptador de recursos selecionado na etapa 3 é implementado na instância de servidor.
    5. Na página Seleção de Instância do Servidor, clique em Avançar.
  6. 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:
    1. Na página Connection Factory J2C, insira um nome JNDI para o novo connection factory. Por exemplo, imsCFac.
    2. 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.
    3. Clique em Concluir. A instância de servidor é iniciada e inicializada.
  7. 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.
  8. Na página Propriedades de Saída do Bean J2C, conclua as seguintes etapas:
    1. Para o Nome do Projeto Java, clique em Novo.
    2. Selecione Projeto Java como tipo de projeto e clique em Avançar.
    3. Na página Projeto Java, digite PhoneBookJ2CBean para o nome do novo projeto Java, aceite todos os outros padrões e clique em Concluir.
    4. Próximo ao Nome do Pacote Java, clique em Novo.
    5. Na página Pacote Java, digite sample.ims para o novo pacote Java e clique em Concluir.
    6. Para o Nome da Interface, especifique PB.
    7. Para o Nome da Ligação, aceite o padrão de PBImpl.
    8. Clique em Avançar.
  9. Para criar um método que execute a transação, use o assistente Métodos Java e conclua as seguintes etapas:
    1. Clique em Incluir para incluir um método Java no bean J2C.
    2. Na página Incluir Método Java, digite runPB para o nome do método Java e clique em Avançar.
    3. Na página Método Java, clique em Navegar próximo do campo Tipo de Entrada.
    4. Na janela Selecionar um Tipo de Dados, inicie o campo de entrada com um asterisco (*) para visualizar os tipos de dados disponíveis.
    5. No campo Tipos Correspondentes, selecione INPUTMSG e clique em OK para usar a ligação de dados INPUTMSG para o método runPB.
    6. Próximo do campo Tipo de Saída, clique em Navegar.
    7. Na janela Selecionar um Tipo de Dados, inicie o campo de entrada com um asterisco (*) para visualizar os tipos de dados disponíveis.
    8. No campo Tipos Correspondentes, selecione OUTPUTMSG e clique em OK para usar a ligação de dados OUTPUTMSG para o método runPB.
    9. Clique em Concluir.
  10. 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.
  11. 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.

Feedback