Implementando Aplicativos SQLJ que Usam CMP (Container-Managed Persistence) com a Ferramenta ejbdeploy

Use instruções SQLJ (Structured Query Language Java™) em seus aplicativos para maximizar a eficiência de transações em seus bancos de dados. Antes que seus aplicativos se beneficiem do SQLJ, você deve implementar o aplicativo e customizar os perfis SQLJ criados. O servidor de aplicativos fornece funcionalidade para usar SQLJ como o mecanismo de persistência para enterprise beans que usam CMP (container-managed persistence). Use a ferramenta ejbdeploy para implementar o aplicativo.

Sobre Esta Tarefa

É possível implementar aplicativos SQLJ com a ferramenta ejbdeploy para implementar o aplicativo corporativo em um ambiente independente.
Como alternativa, o servidor de aplicativos inclui suporte a SQLJ aprimorado para aplicativos que usam CMP (container-managed persistence). Os novos recursos incluem:
  • Implementar beans CMP durante a instalação do aplicativo no servidor de aplicativos.
  • Customizar e ligar perfis SQLJ com o console administrativo e script.
  • Customizar e ligar aplicativos SQLJ novamente sem precisar reinstalar o aplicativo.
Esses aperfeiçoamentos reduzem a complexidade da instalação, implementação e customização de aplicativos SQLJ para o CMP (container-managed persistence) e para o BMP (bean-managed persistence). Leia o tópico sobre como implementar aplicativos SQLJ que usam CMP para obter informações adicionais.

Procedimento

  1. Crie um mapeamento de cima para baixo para um banco de dados DB2.
  2. De sua instalação do DB2, copie o arquivo sqlj.zip para um diretório em sua estação de trabalho.
  3. Modifique o caminho do build Java de seu projeto JAR do enterprise bean para incluir o arquivo sqlj.zip.
  4. Use o Rational Application Developer ou o conversor SQLJ DB2 para converter o SQLJ automaticamente.
    • Use o Rational Application Developer:
      1. No Navegador de Projetos, clique em EJB_JAR_PROJECT_NAME > SOURCE_FOLDER > META-INF > backends > database_version.
      2. Abra Map.mapxmi no editor de Mapeamento.
      3. No painel Visão Geral, ressalte o nome de seu projeto JAR na coluna Enterprise Beans. Você deve ressaltar o nome do projeto JAR, não o nome dos enterprise beans listados.
      4. No painel Propriedades, expanda SQLJ.
      5. Configure Está usando SQLJ? para True.
      6. Configure Módulo Conversor para o caminho completo do arquivo sqlj.zip em sua estação de trabalho.
      7. Salve o arquivo Map.mapxmi.
      8. Exporte o arquivo EAR (enterprise archive).
    • Use o conversor SQLJ DB2. Esta ferramenta cria uma versão .java de seu arquivo .sqlj e um perfil serializado, com uma extensão .ser, que é usada posteriormente no processamento. Consulte a documentação do DB2 para obter mais informações sobre a ferramenta de conversão SQLJ.
  5. Implemente o arquivo EAR com a ferramenta ejbdeploy.
    1. Verifique se o diretório app_server_root/bin está em seu caminho de classe.
    2. Execute o utilitário de comando ejbdeploy com a opção -sqlj. O comando ejbdeploy gerará um arquivo EAR com o nome que você especifica e um script Ant com o nome application_name.ear.xml.
      Por exemplo: :
      ejbdeploy d:\application_name.ear           
                working d:\deployed_application_name.ear 
                -sqlj           
                -dbvendor DB2UDB_V81           
                -cp "C:\PROGRA~1\IBM\SQLLIB\java\sqlj.zip"
      Evitar Problemas Evitar Problemas: Forneça o local do arquivo sqlj.zip do conversor SQLJ com -cp, que é a opção do caminho de classe. O comando ejbdeploy não acessa sqlj.zip de seu caminho de classe do sistema.gotcha
  6. Escolha a opção para customização.
    • Use o suporte SQLJ do servidor de aplicativos. Instale o aplicativo implementado para customizar os perfis SQLJ com o servidor de aplicativos ou script.
      1. Instale o aplicativo corporativo no servidor de aplicativos.
        Evitar Problemas Evitar Problemas: Não selecione Implementar enterprise beans durante o processo de instalação do aplicativo no console administrativo. Se você implementar novamente os enterprise beans do console administrativo, perderá as alterações de customização que você fez.gotcha
      2. Customize os perfis SQLJ.
        • Para o suporte do console administrativo, leia o tópico sobre como customizar e ligar perfis para aplicativos SQLJ (Structured Query Language em Java).
        • Para suporte a script, leia o tópico sobre o grupo de comandos de gerenciamento de aplicativos para o objeto AdminTask.
    • Customize e ligue os perfis SQLJ com a ferramenta db2sqljcustomize. Leia o tópico sobre como customizar e ligar perfis SQLJ com a ferramenta db2sqljcustomize.

Í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=tdat_sqljdeploycmptool
Nome do arquivo: tdat_sqljdeploycmptool.html