Iremos abordar como utilizar a IDE do Eclipse com o portal Liferay

Primeiramente baixe e instale a Eclipse IDE. Posteriormente configure o ambiente de desenvolvimento citado acima.

Obs: crie <diretorio_projeto>/liferay/portal e descompacte o código fonte no diretório. Utilize <diretorio_projeto>/liferay como o “workspace” dentro do Eclipse. O diretório do ambiente de desenvolvimento deve ser <project>/liferay/ext. Tenha certeza de criar o arquivo app.server.${user.name}.properties no seu código liferay e utilizar o apropriado diretório para app.server.type and app.server.${app.server.type}.dir antes de executar o comando “ant start”.

Posteriormente execute “build-ext”, o script para o mysql estará em /ext/sql/create/create-mysql.sql.

1. Execute o script create-mysql.sql através da linha de comando do mysql.
2. Mude no Tomcat a configuração para que ele utilize o MySQL como banco de dados padrão.

Eclipse Debugger

1. Abra o menu “Run” e posteriormente “Run Configurations…”
2. Abaixo de Java Applications, acesse “New”
3. Na aba “Main” selecione o codigo fonte do portal ou o projeto EXT
4. Em “Main class” coloque org.apache.catalina.startup.Bootstrap e não tique nenhum checkbox
5. Vá para a aba “Arguments” e em “Program arguments” escreva: start
6. Em “VM arguments” coloque:

   -Xmx512m
   -XX:PermSize=32m
   -XX:MaxPermSize=160m
   -Dfile.encoding=UTF8
   -Duser.timezone=GMT
   -Djava.security.auth.login.config=${tomcat-root-folder}/conf/jaas.config
   -Dcatalina.base=${tomcat-root-folder}
   -Dcatalina.home=${tomcat-root-folder}
   -Djava.io.tmpdir=${tomcat-root-folder}/temp 

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.

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.

Nota: Na teoria, multiplos web sites podem ser desenvolvidos concorrentemente criando varios diretórios para cada site, em /ext/web-sites/<nomeDominio>-web.

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

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:

• Configurando o ambiente de extensao do Liferay.
• Configurando o Eclipse como ambiente de desenvolvimento para o Liferay