Finalidade

Este mentor de ferramentas descreve como produzir archives J2EE (arquivos WAR, EJB JAR, Client Application JAR, RAR e EAR) utilizando o RAD 6.0.

Ele está relacionado às seguintes informações do RUP:

Visão Geral

Montagem é o processo de combinação dos componentes de um aplicativo J2EE em pacotes (file:///C:/Documents%20and%20Settings/gschneem/Local%20Settings/process/artifact/ar_j2ee_module.htm -- This hyperlink in not present in this generated websiteMódulo J2EE ou file:///C:/Documents%20and%20Settings/gschneem/Local%20Settings/process/artifact/ar_j2ee_app.htm -- This hyperlink in not present in this generated websiteAplicativo J2EE) que podem ser implementados em um servidor de aplicativos. Esses pacotes são formatados como arquivos archive e devem estar em conformidade com uma estrutura de diretórios e regras de conteúdo definidas pelo modelo de Montagem e Implementação do Aplicativo J2EE.

O RAD 6.0 facilita enormemente o processo de montagem, aplicando o desenvolvimento de componentes de aplicativos em um Projeto, que representa um módulo ou um aplicativo J2EE. Quando você cria um projeto, a ferramenta cria automaticamente uma estrutura de diretórios de arquivos nele que está em conformidade com o modelo de Montagem e Implementação do Aplicativo J2EE. Conforme os componentes são criados subseqüentemente por meio dos assistentes do produto, eles são salvos por padrão na pasta apropriada dentro do projeto. Por exemplo, ao criar um novo arquivo JSP utilizando o assistente Novo Arquivo JSP, a ferramenta o armazena por padrão na pasta WebContent do projeto da Web, que é o local padrão para os arquivos de origem de conteúdo da Web. Além disso, o RAD 6.0 também gera automaticamente todos os artefatos de montagem e implementação requeridos do J2EE, como o arquivo de Manifesto e os Descritores de Implementação apropriados. A montagem de um módulo ou aplicativo J2EE, portanto, consiste simplesmente na edição do(s) descritor(es) de implementação correspondente, conforme necessário, e na exportação do projeto para um arquivo archive. As etapas a seguir são executadas neste mentor de ferramentas:

Editar o Descritor de Implementação do Projeto Para o início da página

  1. Para editar um descritor de implementação (EAR) do projeto do Aplicativo Corporativo:
    1. Na visualização do Explorador de Projeto da perspectiva J2EE, expanda Aplicativos Corporativos > nome_do_projeto.
    2. Dê um clique duplo em Descritor de Implementação: nome_do_projeto para abrir o editor do Descritor de Implementação do Aplicativo.
    3. Selecione a guia apropriada na parte inferior do visualizador do editor para editar os valores do descritor de implementação específicos.
    4. Salve o arquivo descritor de implementação selecionando Arquivo > Salvar na barra de menu principal.
  2. Para editar um descritor de implementação (WAR) do projeto da Web:
    1. Na visualização do Explorador de Projeto da perspectiva J2EE, expanda Módulos da Web > nome_do_projeto.
    2. Dê um clique duplo em Descritor de Implementação: nome_do_projeto para abrir o editor do Descritor de Implementação da Web.
    3. Selecione a guia apropriada na parte inferior do visualizador do editor para editar os valores do descritor de implementação específicos.
    4. Salve o arquivo descritor de implementação selecionando Arquivo > Salvar na barra de menu principal.
  3. Para editar um descritor de implementação (EJB JAR) do projeto EJB:
    1. Na visualização do Explorador de Projeto da perspectiva J2EE, expanda Módulos EJB > nome_do_projeto.
    2. Dê um clique duplo em Descritor de Implementação: nome_do_projeto para abrir o editor do Descritor de Implementação EJB.
    3. Selecione a guia apropriada na parte inferior do visualizador do editor para editar os valores do descritor de implementação específicos.
    4. Salve o arquivo descritor de implementação selecionando Arquivo > Salvar na barra de menu principal.
  4. Para editar um descritor de implementação (Application Client JAR) do projeto do Cliente Aplicativo:
    1. Na visualização do Explorador de Projeto da perspectiva J2EE, expanda Módulos do Cliente aplicativo > nome_do_projeto.
    2. Dê um clique duplo em Descritor de Implementação: nome_do_projeto para abrir o editor do Descritor de Implementação do Cliente.
    3. Selecione a guia apropriada na parte inferior do visualizador do editor para editar os valores do descritor de implementação específicos.
    4. Salve o arquivo descritor de implementação selecionando Arquivo > Salvar na barra de menu principal.
  5. Para editar um descritor de implementação (RAR) do projeto do Conector:
    1. Na visualização do Explorador de Projeto da perspectiva J2EE, expanda Módulos do Conector > nome_do_projeto.
    2. Dê um clique duplo em Descritor de Implementação: nome_do_projeto para abrir o editor XML no arquivo ra.xml.
    3. Edite o arquivo XML para alterar valores específicos do descritor de implementação.
    4. Salve o arquivo descritor de implementação selecionando Arquivo > Salvar na barra de menu principal.

Validar o projeto Para o início da página

Embora a ferramenta seja configurada por padrão para validar automaticamente os recursos ao serem salvos, é interessante validar o projeto inteiro manualmente antes de exportá-lo para um arquivo archive (observe que é possível substituir e alterar os validadores que serão executados em seu projeto, dando um clique duplo nele e selecionando Propriedades > Validação).

  1. Na visualização do Explorador de Projeto da perspectiva J2EE, clique com o botão direito no nome_do_projeto.
  2. Selecione Executar Validação.
  3. Após a conclusão da validação, marque a visualização Problemas. Se houver uma listagem de erros, resolva-os antes de continuar com a etapa seguinte.

Exportar o Projeto para um Arquivo Archive Para o início da página

  1. Para exportar um projeto de Aplicativo Corporativo para um arquivo EAR:
    1. Na visualização do Explorador de Projeto da perspectiva J2EE, clique com o botão direito no nome_do_projeto.
    2. Selecione Exportar > Arquivo EAR.
    3. No assistente Exportar, especifique o nome e o local desejados do arquivo EAR.
    4. Opcionalmente, selecione para:
      • Exportar arquivos de origem
      • Sobrescrever arquivo existente, se você estiver exportando para um arquivo EAR existente e não desejar ser avisado sobre sua sobrescrição
      • Incluir caminhos de construção do projeto e arquivos de metadados para preservar os nomes originais dos projetos incluídos ou referenciados pelo projeto de aplicativo e manter as dependências do caminho de classe. Isso permite a importação posterior do EAR para outro espaço de trabalho e a importação de seus módulos como projetos binários.
    5. Clique em Concluir. O assistente exporta o conteúdo do projeto de aplicativo para o arquivo EAR especificado.
  2. Para exportar um projeto da Web para um arquivo WAR:
    1. Na visualização do Explorador de Projeto da perspectiva J2EE, clique com o botão direito no nome_do_projeto.
    2. Selecione Exportar > Arquivo WAR.
    3. No assistente Exportar, especifique o nome e o local desejados do arquivo WAR.
    4. Opcionalmente, selecione para:
      • Exportar arquivos de origem
      • Sobrescrever arquivo existente, se você estiver exportando para um arquivo WAR existente e não desejar ser avisado sobre sua sobrescrição
    5. Clique em Concluir. O assistente exporta o conteúdo do projeto da Web para o arquivo WAR especificado.
  3. Para exportar um projeto EJB para um arquivo EJB JAR:
    1. Na visualização do Explorador de Projeto da perspectiva J2EE, clique com o botão direito no nome_do_projeto.
    2. Selecione Exportar > Arquivo EJB JAR.
    3. No assistente Exportar, especifique o nome e o local desejados do arquivo JAR.
    4. Opcionalmente, selecione para:
      • Exportar arquivos de origem
      • Sobrescrever arquivo existente, se você estiver exportando para um arquivo JAR existente e não desejar ser avisado sobre sua sobrescrição
    5. Clique em Concluir. O assistente exporta o conteúdo do projeto EJB para o arquivo JAR especificado.
  4. Para exportar um projeto de Cliente Aplicativo para um arquivo Application Client JAR:
    1. Na visualização do Explorador de Projeto da perspectiva J2EE, clique com o botão direito no nome_do_projeto.
    2. Selecione Exportar > Arquivo App Client JAR.
    3. No assistente Exportar, especifique o nome e o local desejados do arquivo JAR.
    4. Opcionalmente, selecione para:
      • Exportar arquivos de origem
      • Sobrescrever arquivo existente, se você estiver exportando para um arquivo JAR existente e não desejar ser avisado sobre sua sobrescrição
    5. Clique em Concluir. O assistente exporta o conteúdo do projeto de Cliente Aplicativo para o arquivo JAR especificado.
  5. Para exportar um projeto de Conector para um arquivo RAR:
    1. Na visualização do Explorador de Projeto da perspectiva J2EE, clique com o botão direito no nome_do_projeto.
    2. Selecione Exportar > Arquivo RAR.
    3. No assistente Exportar, especifique o nome e o local desejados do arquivo RAR.
    4. Opcionalmente, selecione para:
      • Exportar arquivos de origem
      • Sobrescrever arquivo existente, se você estiver exportando para um arquivo RAR existente e não desejar ser avisado sobre sua sobrescrição
    5. Clique em Concluir. O assistente exporta o conteúdo do projeto de Conector para o arquivo RAR especificado.

Rational Unified Process   2003.06.15