Desenvolvendo no ambiente de extensão do Liferay usando o Eclipse

Desenvolvendo no ambiente de extensão.

Agora iremos explicar como é o processo para desenvolver tarefas no ambinete de desenvolvimento de extensões.
O Desenvolvimento é feito no diretório /ext. Quando uma nova verão do liferay é liberada, o diretório/portal é substituido com a nova versão e o diretório /ext será atualizado após a reutilização do comando build-ext.
Qualquer novo arquivo jar que suas extensões precisem devem ser colocados em /ext/ext-lib

Processo padrão para o Desenvolvimento

  1. Tenha certeza que o ambiente de execução está configurado, como mostrado anteriormente.
  2. Altere as propriedades do portal editando o arquivo /ext/ext-imp/src/portal-ext.properties
  3. Altere as configurações em web.xml adicionando entradas em /ext/ext-web/docroot/WEB-INF/web.xml (apenas faça as alterações que você precisa, pois as alterações serão mescladas com o arquivo web.xml no final do desenvolvimento.
  4. Escolha os portlets que deseja implementar editando o arquivo /ext/ext-web/docroot/WEB-INF/liferay-portlet-ext.xml
  5. Edite a linguagem e as informações visuais do portal editando os arquivos /ext/ext-impl/src/content/Language-ext.properties ou /ext/ext-impl/src/content/Language-ext_en.properties
  6. Para que novas classes façam parte do núcleo do portal elas devem ser criadas no diretório: /ext/ext-impl/src.
  7. Para criar um portlet totalmente novo, siga as instruções desse artigo: http://content.liferay.com/4.0.0/docs/quickstart/ch04s02.html
  8. Execute o comando deploy no caminho /ext/build.xml. Isso irá mesclar  as alterações, construir o sistema e implementar a configuração no servidor (configurado no arquivo /ext/app.server.<nome_usuário>.properties)
Se está desenvolvendo uma instancia do portal e uma customização é alterada/criada/atualizada modifique os arquivos colocando eles no diretorio /ext/ext-web/docroot. Quando estiver preparado para implementar, execute o comando “deploy” em /ext/ext-web/build.xml. Esse procedimento irá unjar a configuração original web de /ext/ext-ear/modules/portal-war para um diretório temporário, sobrescrevendo o diretório temporario com esses arquivos em /ext/ext-web/docroot, em seguida, implemente no servidor da aplicação.

Modificando o Core do Liferay

O ciclo para o desenvolvimento de modificações no core do liferay é:
  1. Fazer as modificações necessarias no arquivo apropriado dentro de /portal (a parte mais interessante fica em /portal/portal-impl/src
    -> Se estiver adicionando uma coluna a uma  entidade, não modifique o arquivo XXXModel.java, mas adicione isso ao service.xml
    ->  Se estiver adicionando um novo metodo de serviços, modifique XXXServiceImpl.javaou XXXLocalServiceImpl.java. Não modifique nenhum outro arquivo da interface de serviços.
    -> Se alguma modificação for feita em algum dos dois acima, execute  ”build-service-portal” e/ou “build-service-portlets” em /portal/portal-impl/build.xml Para que o código seja gerado novamente.
  2. Execute o comando “start” em /portal/build.xml (para reconstruir o portal)
  3. Execute o comando “build-ext” em /portal/build.xml (para recriar o ambiente de execução, re-implemente as novas alterações do passo 2 acima.
Isso irá recriar o ambiente de desenvolvimento, mas irá preservar todas as suas modificações nos arquivos “-ext”. Você pode implementar essas modificações reutilizando o comando “deploy” em /ext/build.xml
Nota: Na teoria, multiplos web sites podem ser desenvolvidos concorrentemente criando varios diretórios para cada site, em /ext/web-sites/<nomeDominio>-web.

Sobrescrevendo arquivos JSP’s do core do Liferay

JSP’s que estão no núcleo do liferay podem ser facilmente customizados/sobrescritos simplesmente utilizando uma mudança paralela no ambiente EXT.
Por exemplo, se deseja modificar o arquivo view.jsp do portlet de login, os passos são:
  1. Localize o código JSP no núcleo do portal (portal/portal-web/docroot/html/portlet/login/view.jsp)
  2. Copie o arquivo para a localização correspondente no diretório do ambiente EXT (crie as pastas necessárias.
    -> Crie a pasta ext/ext-web/docroot/html/portlet/login/
    -> Copie o JSP do portal para o ext (view.jsp)
  3. Faça as alterações que deseja no JSP contido no ambiente de desenvolvimento.
  4. Implemente as alterações.
    -> Desde que nós realizamos alguma alteração no JSP, poderemos utilizar o comando “deploy-fast” no diretório ext/ext-web/build.xml, que somente deverá modificar os JSP’s

Configurando o Log4J

  1. Copie /portal/portal-impl/classes/META-INF/portal-log4j.xml para /ext/ext-impl/classes/META-INF/portal-log4j-ext.xml (i.e. copie de /portal/portal-impl para /ext/ext-impl, renomei para  portal-log4j-ext.xml)
  2. Copie /portal/portal-impl/classes/META-INF/log4j.dtd para o mesmo /ext/ext-impl/classes/META-INF diretorio acima.
  3. Modifique nosso novo portal-log4j-ext.xml com quaisquer parametros do log4j que desejar.
  4. Para a versão 5.2.x voce não precisa copiar o arquivo todo, apenas cie um arquivo novo log4j e adicione sua propria <category> e seus elementos. Após isso substitua em portal-log4j-ext.xml com diferentes niveis de log ou crie novos.
  5. Implemente seu ambiente de execução.

OBS: O texto acima se baseia no artigo.

Veja Também:

Categorias: Geral, Liferay, portal | Nenhum Comentário »

Deixe um comentário

Observação: O seu comentário pode demorar algumas horas para aparecer.