Configurando o Eclipse como Ambiente de desenvolvimento para o Liferay

Configurando o Eclipse

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

Configuração Básica

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.

Configurando o MySQL

  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 
    
    

Modifique ${tomcat-root-folder} com o local onde está o diretório raiz do seu Tomcat.

Continuando a configuração:

  1. Ainda na aba “Arguments”, na opção “Working directory” coloque ${tomcat-root-folder}/bin em “Other”. modifique o diretório raiz do Tomcat novamente.
  2. Na aba Classpath, remova TODOS as Entradas de usuários, apenas não remova JRE System library
  3. Selecione “User Entries” e clique em “Add External JARs”, encontre o bootstrap.jar no caminho ${tomcat-root-folder}/bin e adicione ele.
  4. Na aba “Source”, selecione algum projeto relacionado, mas tambem escolha o projeto principal. Por exemplo, se deseja debugar um plugin, adicione tambem o código do portal.
  5. Na aba  ”Common” selecione RUN and DEBUG
  6. A partir de agora, quando quiser debugar voce apenas deve clicar no botão “debug”.

Dicas e Truques

  • Enquanto estiver em qualquer editor do Eclipse, pressione Shift+Ctrl+T. Irá abrir a tela de “find-tipe” do Eclipse. Escreva o nome da classe que deseja olhar. Duplo clique e o Eclipse irá abrir o fonte para voce.
  • Voce tem um código fonte aberto mas ainda não sabe onde ele está na arvore? Clique no editor do codigo fonte e selecione “Show in” no menu da direita. Selecione “NAVEGATOR” ou “PACKAGE EXPLORER” para ter a visualização adaptada para o arquivo que está editando.
  • Com qualquer nome de classe ou metodo sublinhado no código fonte, precione F3 e a interface de “open declaration” será aberta. O mesmo resultado pode ser obtido segurando a tecla “WIN” e clicando sobre a classe/metodo.
  • Para localizar onde a variavel, método ou classe são é usada no código, posicione o cursor no nome, em qualquer arquivo java, clique com o botao direito e selecione “References -> Workspace”
  • Para visualizar o código atraz de uma interface você deve posicionar o cursor sobre uma interface e pressionar o F4. A tela de “Type Hierarchy” será aberta.
  • Se você ver uma propriedade em portal.properties e quer saber mais informações sobre ela, você pode combinar as dicas acima e conseguir essas informações rapidamente. Quase todas as propriedades definidas nesse arquivo tem uma string correspondente na classecom.liferay.portal.util.PropsUtil. Então a primeira coisa que deve fazer é usar o Ctrl+Shift+t e abrir o editor de tipos, em PropsUtil, e abrir o código fonte.

Esse artigo se baseia nesse texto.

Veja também:

Deixe um comentário

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