Convertendo projetos existentes em Maven

É possível converter projetos Java™ EE existentes em Maven

Antes de Iniciar

Importante: Aplicável ao Liberty, WebSphere Application Server tradicional

Faça backup da área de trabalho para que seja possível retornar para o estado original do projeto, se necessário.

Configurando as preferências recomendadas

Sobre Esta Tarefa

Para usar a área de trabalho para projetos Maven, primeiro configure as preferências recomendadas. Para obter mais informações sobre preferências, consulte Configurando preferências do Maven.

Procedimento

  1. Acesse as preferências de configuração de projeto Maven. Clique em Windows > Preferências > Java EE > Maven > Configurações de Projeto Maven.
  2. Clique em Configurar todos os valores do Maven. As preferências que representam as melhores práticas para a configuração do Maven são definidas.
  3. Clique em OK para concluir a configuração das preferências.

Convertendo projetos da web, EJB, conector, aplicativo cliente, utilitário, fragmento da web e de cliente EJB

Sobre Esta Tarefa

Ao converter um projeto, tenha em mente as dependências que existem com outros artefatos e como os artefatos são acessados pelo projeto. Em projetos não Maven, essas informações são especificadas nos metadados do projeto e nos arquivos MANIFEST.MF diretamente. No entanto, em projetos Maven, as dependências são especificadas no arquivo pom.xml. Por exemplo, os artefatos podem ser acessados por meio do arquivo MANIFEST.MF ou implementados no diretório da biblioteca do EAR que contém o projeto. Para projetos da web, os artefatos podem ser implementados no diretório WEB-INF/lib.

Primeiro, use a página de conjunto de implementação para reunir as informações de dependência.
  1. Clique com o botão direito do mouse no projeto.
  2. Selecione Propriedades > Conjunto de implementação.
  3. Clique na guia Entradas manifest. Anote todas as entradas que são referenciadas pelo projeto.
  4. Para projetos da web, clique também na guia Conjunto de implementação. Anote todos os projetos e arquivos JAR cujos caminhos de implementação começam com WEB-INF/lib.
Nota: Se o projeto EAR que contém seus projetos tiver o aspecto EAR da versão 5 ou 6, o projeto pode estar fazendo referência a classes de projetos ou arquivos JAR no diretório da biblioteca do arquivo EAR. Anote essas referências também.

Depois de reunir as informações necessárias, é possível converter o projeto em Maven.

Procedimento

  1. Clique com o botão direito no projeto e selecione Configurar > Converter em projeto Maven.
  2. Preencha o diálogo de POM do Maven. Insira um ID do grupo, um ID do artefato e uma Versão ou aceite os padrões. Opcionalmente, insira um Nome e uma Descrição. Para Empacotamento, escolha de acordo com os seguintes tipos de projetos:
    Projetos da web
    war
    Projetos EJB
    ejb
    Projetos de conector, utilitário, fragmento da web e de cliente EJB
    jar
    Projetos de cliente aplicativo
    app-client
  3. Clique em Concluir para concluir o diálogo. O editor POM é aberto. Se houver referências a outros projetos que foram perdidos, é possível ver erros de compilação.
  4. Limpe os erros de compilação. Converta os projetos que você deseja que façam referência ao Maven e, em seguida, inclua dependências do Maven para esses projetos. Consulte Incluindo dependências em outros módulos.
  5. Atualize o projeto. Depois de mudar o projeto, clique nele com o botão direito e selecione Maven > Atualizar projeto.

Convertendo projetos EAR

Sobre Esta Tarefa

A conversão de projetos EAR envolve várias tarefas:
  1. Criar uma pasta de conteúdo.
  2. Converter o projeto EAR.
  3. Incluir módulos em um EAR.
  4. Incluir dependências em outros módulos.
  5. Incluir bibliotecas no diretório de biblioteca EAR.
Execute as etapas a seguir para concluir essas tarefas.

Criando uma pasta de conteúdo

Sobre Esta Tarefa

Quando um projeto EAR é criado no WebSphere® Application Server Developer Tools utilizando as preferências padrão da área de trabalho, o diretório de conteúdo do EAR fica vazio, o que significa que todo o conteúdo da pasta raiz do projeto é incluído no arquivo EAR. Caso o projeto não tenha uma pasta de conteúdo, deve-se criar um diretório de conteúdo.

Procedimento

  1. Verifique se o EAR possui uma pasta de conteúdo.
    1. Clique com o botão direito do mouse no projeto e selecione Propriedades > Conjunto de Implementação.
    2. Se você vir uma pasta de conteúdo mapeada para / (raiz), o EAR possui uma pasta de conteúdo diferente da raiz do projeto.
      Pasta de conteúdo não raiz
    3. Se você vir que a raiz do projeto está mapeada para a raiz, como na imagem a seguir, o projeto não tem um diretório de conteúdo:
      A pasta de conteúdo é raiz
  2. Caso o projeto não tenha uma pasta de conteúdo, clique em Cancelar, na página Conjunto de implementação e siga estas etapas para criar uma:
    1. Clique com o botão direito no projeto EAR e selecione Novo > Pasta. Em Nome da pasta, insira o nome da estrutura de pasta. Para projetos Maven, a estrutura de pasta recomendada é src/main/application. Clique em Concluir.
      Criar estrutura de pasta
    2. Acesse a página do conjunto de implementação. Clique com o botão direito do mouse no projeto e selecione Propriedades > Conjunto de Implementação.
    3. Selecione a entrada que mapeia a raiz do projeto para a raiz do EAR e clique em Remover.
    4. Clique em Incluir, selecione Pasta e clique em Avançar.
    5. Selecione a pasta que foi criada e clique em Concluir. Por exemplo, se você criou a estrutura de pasta recomendada, selecione a pasta aplicativo, que está em src/main.
      Selecionar pasta
    6. Verifique a estrutura. Na seção de conjunto de implementação, agora existe a pasta que foi criada, mapeada para a raiz do projeto. A imagem a seguir mostra o exemplo, caso você tenha criado uma pasta src/main/application.
      Pasta mapeada para a raiz
    7. Clique em OK para concluir o mapeamento do conjunto de implementação.
    8. Mova todos os recursos a serem incluídos no EAR da raiz do projeto para a pasta que foi criada. Por exemplo, caso você tenha usado a estrutura de pasta recomendada src/main/application e o EAR possua um descritor de implementação, mova a pasta META-INF da raiz do arquivo EAR para a pasta application.

Convertendo o projeto EAR

Sobre Esta Tarefa

Ao converter um projeto, tenha em mente as dependências que existem com outros artefatos e como os artefatos são acessados pelo projeto. Em projetos não Maven, essas informações são especificadas nos metadados do projeto e nos arquivos MANIFEST.MF diretamente. No entanto, em projetos Maven, as dependências são especificadas no arquivo pom.xml. Anote os módulos que fazem parte do EAR, as bibliotecas que são compartilhadas com outros módulos utilizando o diretório da biblioteca (para EARs de versão 5 ou mais recentes) ou outras dependências.

Primeiro, use a página de conjunto de implementação para reunir as informações de dependência:
  1. Clique com o botão direito do mouse no projeto.
  2. Selecione Propriedades > Conjunto de implementação.
  3. Anote os módulos que fazem parte do EAR.
  4. Anote o valor do diretório da biblioteca EAR, se o EAR for de versão 5 ou posterior.
  5. Anote os arquivos JAR e projetos contidos no diretório da biblioteca. Para identificar esses arquivos, procure arquivos JAR e projetos cujos caminhos de implementação começam com o valor do diretório da biblioteca.
Nota: Antes de converter o projeto, salve uma cópia do arquivo descritor de implementação do EAR, META-INF/application.xml, se ele existir. É necessário salvar uma cópia porque durante a conversão o descritor de implementação existente é substituído por um descritor de implementação vazio.

Procedimento

  1. Clique com o botão direito no projeto e selecione Configurar > Converter em projeto Maven.
  2. Preencha o diálogo de POM do Maven. Insira um ID do grupo, um ID do artefato e uma Versão ou aceite os padrões. Opcionalmente, insira um Nome e uma Descrição. Para Empacotamento, insira ear.
  3. Clique em Concluir. O editor POM é aberto.
    Nota: Se o EAR tinha um descritor de implementação, um descritor de implementação novo e vazio será gerado. Se o descritor de implementação original continha elementos como funções de segurança, configure os elementos no arquivo pom.xml. Para obter mais informações, consulte: Plug-in EAR do Maven
  4. Atualize o projeto. Depois de mudar o projeto, clique nele com o botão direito e selecione Maven > Atualizar projeto.
  5. Para concluir a conversão do EAR, execute as três tarefas a seguir:
    1. Incluindo módulos em um projeto EAR
    2. Incluindo dependências em outros módulos
    3. Incluindo bibliotecas no diretório da biblioteca EAR
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: convert.html