3. Liferay Customization

customizando o

by

http://www.ﬂickr.com/photos/dejay181/461011654/ 1
Monday, December 7, 2009

só lembrando

a moda é customizar
para deixar o portal com a sua cara

3

Interessado?
o/

sea@seatecnologia.com.br
5

Criar páginas, conﬁgurar layouts, distribuir
portlets é apenas a ponta do iceberg...
6

Há inúmeras outras possibilidades para
customização do Liferay.

http://www.ﬂickr.com/photos/stephenpoff/2761284719/in/set-72157594345940394/ 7

O Liferay possui vários níveis de customização.

Customização
Liferay

Extension Código
Plugins
Environment Fonte

Portlets Temas Layouts

8


A primeira Customização
estratégía é através de
Liferay
plugins

Extension Código
Plugins
Environment Fonte

Plugins são componentes WAR, facilmente
Portlets Temas Layouts organizáveis em repositórios.

8


Quando não Customização
resolver com plugins,
Liferay
vá de EXT

Extension Código
Plugins
Environment Fonte

O ambiente de extensão é mais poderoso
Portlets Temas Layouts que plugins, porém, mais instrusivo.

8


Em último caso,
Customização modiﬁque o código fonte
Liferay original

Extension Código
Plugins
Environment Fonte

Modiﬁcações no código fonte, apesar de
Portlets Temas Layouts não imporem limites na customização,
prejudicam a evolução para novas versões.
8

Focaremos na customização por plugins.

Customização
Liferay

Extension Código
Plugins
Environment Fonte

Portlets Temas Layouts

9

Criação de Plugins
temas, layouts e portlets

pré-reqs

Para iniciar o desenvolvimento de plugins,
alguns pré-requisitos são necessários 11

Na página de download
do Liferay, existe um link
‘Additional Files’

12

Baixe o
Liferay Plugins SDK

Text 13

Descompacte o Plugins
SDK e veja a seguinte
estrutura de diretórios.

14

Crie o arquivo
build.${usuario}.properties...

onde ${usuario} é o nome do usuário
logado na máquina

15

Conﬁgure no Plugin SDK o
caminho do servidor Tomcat
sobre o qual seu Liferay está
sendo executado.

16

Portlets primeiros passos...


Acesse a pasta ‘portlets’
do Plugin SDK...

/liferay/liferay-plugins-sdk-5.2.3/portlets $ ./create.sh hello-liferay "Hello Liferay"
Buildﬁle: build.xml

create:
[unzip] Expanding: /Volumes/Data/Documents/sea/edu/liferay/apps/liferay-plugins-sdk-5.2.3/
portlets/portlet.zip into /Volumes/Data/Documents/sea/edu/liferay/apps/liferay-plugins-
sdk-5.2.3/portlets/hello-liferay-portlet
[mkdir] Created dir: /Volumes/Data/Documents/sea/edu/liferay/apps/liferay-plugins-
sdk-5.2.3/portlets/hello-liferay-portlet/docroot/WEB-INF/tld
[copy] Copying 6 ﬁles to /Volumes/Data/Documents/sea/edu/liferay/apps/liferay-plugins-

BUILD SUCCESSFUL
Total time: 6 seconds

18

...e utilize o script para
criação de um novo
portlet...


create:

BUILD SUCCESSFUL

18

...informando o nome do
projeto...


create:

BUILD SUCCESSFUL

18

...e o nome do portlet.


create:

BUILD SUCCESSFUL

18

Analise a estrutura de
diretórios criada.

19

/liferay/liferay-plugins-sdk-5.2.3/portlets/hello-liferay-portlet $ ant deploy

compile:

merge: Faça o deploy automático
[javac] Compiling 1 source file to /Volumes/Data/Documents/sea/edu/liferay/apps/liferay-plugins-
do portlet no Liferay
sdk-5.2.3/portlets/hello-liferay-portlet/docroot/WEB-INF/classes
configurado no arquivo
merge: build.${usuario}.properties

war:
[mkdir] Created dir: /Volumes/Data/Documents/sea/edu/liferay/apps/liferay-plugins-sdk-5.2.3/dist

clean-portal-dependencies:
[zip] Building zip: /Volumes/Data/Documents/sea/edu/liferay/apps/liferay-plugins-sdk-5.2.3/dist/
hello-liferay-portlet-5.2.3.1.war

deploy:
[copy] Copying 1 file to /liferay/liferay-portal-5.2.3/deploy

BUILD SUCCESSFUL

20

13:38:16,945 INFO [AutoDeployDir:183] Processing hello-liferay-portlet-5.2.3.1.war
13:38:19,275 INFO [PortletAutoDeployListener:77] Copying portlets for /Users/alegomes/sea/edu/
liferay/apps/liferay-portal-5.2.3/deploy/hello-liferay-portlet-5.2.3.1.war
(...)
13:39:03,603 INFO [PortletAutoDeployListener:87] Portlets for /Users/alegomes/sea/edu/liferay/apps/
liferay-portal-5.2.3/deploy/hello-liferay-portlet-5.2.3.1.war copied successfully. Deployment will start in a
few seconds.

13:40:40,919 INFO [PortletHotDeployListener:227] Registering portlets for hello-liferay-portlet
13:40:41,587 INFO [PortletHotDeployListener:346] 1 portlet for hello-liferay-portlet is
available for use

Acompanhe o
resultado do
deploy no log do
servidor Liferay.
21

Veriﬁque a presença
do portlet no
diretório de deploy
do Liferay

Portlet
deployado!

22

Nosso
portlet!

Acesse a interface web
do portal e veriﬁque a
presença do portlet na
lista de portlets
disponívéis no servidor.
23

Nosso
portlet!

24

/liferay/liferay-plugins-sdk-5.2.3/portlets/hello-liferay-portlet $ ant setup-eclipse

setup-eclipse:
[java] Loading jar:ﬁle:/Volumes/Data/Documents/sea/edu/liferay/apps/liferay-portal-5.2.3/
tomcat-5.5.27/webapps/ROOT/WEB-INF/lib/portal-impl.jar!/system.properties
tomcat-5.5.27/webapps/ROOT/WEB-INF/lib/portal-impl.jar!/portal.properties
tomcat-5.5.27/webapps/ROOT/WEB-INF/lib/portal-impl.jar!/com/liferay/portal/tools/
dependencies/portal-tools.properties
tomcat-5.5.27/webapps/ROOT/WEB-INF/lib/portal-impl.jar!/captcha.properties
[java] 14:07:11,904 INFO [PortalImpl:252] Portal lib directory /Volumes/Data/Documents/
sea/edu/liferay/apps/liferay-portal-5.2.3/tomcat-5.5.27/webapps/ROOT/WEB-INF/lib/
[java] Updating /Volumes/Data/Documents/sea/edu/liferay/apps/liferay-plugins-sdk-5.2.3/
portlets/hello-liferay-portlet/.project
[java] Updating /Volumes/Data/Documents/sea/edu/liferay/apps/liferay-plugins-sdk-5.2.3/
portlets/hello-liferay-portlet/.classpath
Crie um projeto
BUILD SUCCESSFUL Eclipse a partir do
Total time: 24 seconds código gerado pelo
Plugins SDK
25

Importe o projeto
do portlet no
Eclipse

26

Todo portlet criado
pelo SDK busca as
libs do projeto
‘portal’

27

Baixar código
fonte do
Liferay

28

Descompacte o
código fonte do
Liferay
29

Conﬁra a estrutura
de diretórios
criada.

30

Crie um novo
projeto no Eclipse
para o código
fonte do Liferay

31

Ainda existem
erros

32

Remover libs
problemáticas

34

Adicionar
diretório de
classes

35

Diretório de
classes
adicionado às
libs do projeto
de portlet

36

Acabaram os
problemas.

37

Código Java
do portlet

38

Código JSP
do portlet

39

Não se iluda
achando que já sabe tudo

http://www.ﬂickr.com/photos/purplemattﬁsh/3404482191/ 40

Invista alguns
tomates* para
dominar a teoria
dos portlets
* The Pomodoro Technique


e por falar em tomates...

Suponha que
portlets sejam

tomates
http://www.ﬂickr.com/photos/darwinbell/387755335/ 42

Tomates são guardados
em caixas.
http://www.ﬂickr.com/photos/chrismar/3631784233/ 43

Tomates têm um
ciclo de vida
muito bem
deﬁnido.

eles
nascem...
http://www.ﬂickr.com/photos/urbanislands/3876172828/ 44

...crescem...

http://www.ﬂickr.com/photos/deborahnaomi/1820652016/ 45

...reproduzem-se...

http://www.ﬂickr.com/photos/jp_math54/3819627661/ 46

...são colhidos...

http://www.ﬂickr.com/photos/the_ewan/2962762666/ 47

...comidos...
http://www.ﬂickr.com/photos/gezellig-girl/3784584015/ 48

...ou morrem.

http://www.ﬂickr.com/photos/another007/2885665653/ 49

Entenda a lógica da programação orientada a
componentes do mundo Java

http://www.ﬂickr.com/photos/jp_math54/3819628579/ 50

http://www.ﬂickr.com/photos/19684903@N00/346425180/ 51

componente é uma peça
independente de software



todo componente tem um
ciclo de vida bem deﬁnido




o ciclo de vida de um
componente é gerenciado
por um container




o ciclo de vida de um
componente é gerenciado
por um container
a cada transição entre
fases do ciclo de vida,
um método do
http://www.ﬂickr.com/photos/19684903@N00/346425180/
componente é chamado 51

componente são empacotados



cada tipo de componente possui seu
próprio tipo de pacote
WAR, JAR, EAR, SAR, RAR...




num pacote de componentes há
classes + recursos + descritor




num pacote de componentes há
classes + recursos + descritor

cada tipo de pacote possui
seu próprio descritor
web.xml, ejb-jar.xml, enterprise.xml, -service.xml

Para fazer uma Applet, uma Servlet ou um Midlet...
53

...precisamos estender classes da respectiva API.
54

Geralmente, essas classes declaram métodos abstratos (ou não)...
55

...que precisam ser sobrescritos.
56

Mas, pra quê serve essa
sobrescrita?

57

Para sabermos quando o componente mudou de estado
58

O container, responsável pelo ciclo de vida dos
componentes, notiﬁca-os por meio de métodos de callback
sempre que houver uma transição de estado.
59

No fundo, é tudo a mesma coisa.
60

Inclusive
portlets

61

Inclusive
portlets
Invocado pelo container
quando alguma submissão
de dados é feita ao
componente.

61

Inclusive
portlets

Invocado pelo container quando
há a necessidade de reconstruir
a visualização do componente
61

Dessa forma,
temos...
63

portlet
componente de software que gera
fragmentos HTML
em um portal
http://www.ﬂickr.com/photos/spisharam/2742433355/ 64

portlet container
ambiente gerenciador de
portlets e seus ciclos de vida

http://www.ﬂickr.com/photos/fensterbme/241478156/ 65

Portlets
geram fragmentos de
HTML

portlets são agrupados
em pacotes
WAR
pacotes WAR são deployados em
Portlet Containers 66

um pacote WAR de portlets contém...

my-portlet.war

Classes + Recursos + Descritor
67

Descritores podem ser...

Padrões
web.xml
portlet.xml

my-portlet.war Proprietários
liferay-portlet.xml
liferay-display.xml
68

O mais importante é se lembrar que
portlets ≠ servlets

69

Portlets têm

modos
deﬁnem a função do portlet no instante


View

Edit

? Help
71

Liferay
Extension

conﬁguration
mode

72

Liferay
Extension

look and feel
mode

73

Portlets têm

estados
deﬁnem o tamanho da tela que estão ocupando


normal

75

maximizado

76

minimizado

77

Portlet 2.0
Eventos
AJAX
Filtros
IPC
http://jcp.org/en/jsr/detail?id=286 78

Interessado?
o/

sea@seatecnologia.com.br
79

3. Liferay Customization

Recommandé

Recommandé

Contenu connexe

En vedette

En vedette (8)

Similaire à 3. Liferay Customization

Similaire à 3. Liferay Customization (20)

Plus de SEA Tecnologia

Plus de SEA Tecnologia (20)

Dernier

Dernier (6)

3. Liferay Customization