4. Liferay JSP Portlets

customizando o

JSP Portlets
by

http://www.ﬂickr.com/photos/dejay181/460664432/in/set-72157594529615566/ 1
Monday, November 16, 2009

O Liferay possui diversos níveis de
customização

Customização
Liferay

Extension Código
Plugins
Environment Fonte

Portlets Temas Layouts

3

Portlets
revisão

Criação do
portlet

/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-
sdk-5.2.3/portlets/hello-liferay-portlet/docroot/WEB-INF/tld

BUILD SUCCESSFUL
Total time: 6 seconds

5

/liferay/liferay-plugins-sdk-5.2.3/portlets/hello-liferay-portlet $ ant deploy
Buildfile: build.xml

compile:

merge:
Deploy do
[javac] Compiling 1 source file to /Volumes/Data/Documents/sea/edu/liferay/apps/liferay-plugins-
sdk-5.2.3/portlets/hello-liferay-portlet/docroot/WEB-INF/classes portlet
merge:

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
Total time: 24 seconds

6

Utilização do
portlet

7

Importação do
projeto do
portlet

8

um pacote WAR de portlets contém...

my-portlet.war

Classes + Recursos + Descritor
9

Descritores podem ser...

Padrões
web.xml
portlet.xml

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

Portlets têm

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

11

Portlets têm

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

12

Portlet
API

13

O mais comum, entretanto, é
o uso da classe
GenericPortlet, que
‘substitui’ o método render
por outros 3 métódos
doView, doEdit e doHelp

14

o uso da classe
GenericPortlet, que

Invocado para
renderização do
portlet no modo
View
14

o uso da classe
GenericPortlet, que

Invocado para
renderização do
portlet no modo
Edit
14

o uso da classe
GenericPortlet, que

Invocado para
renderização do
portlet no modo
Help
14

JSP Portlets
a forma de portlet mais simples


Nosso portlet...

16

...suporta apenas
o modo View,
através da página
view.jsp

17

Fragmento de
HTML gerado por
view.jsp

18

<portlet>
<portlet-name>hello-liferay</portlet-name>
<display-name>Hello Liferay</display-name>
<portlet-class>com.sample.jsp.portlet.JSPPortlet</portlet-class>
<init-param>
<name>view-jsp</name>
<value>/view.jsp</value>
</init-param>
<init-param>
<name>edit-jsp</name>
<value>/edit.jsp</value>
</init-param>
(...)
<supports> Vamos
<mime-type>text/html</mime-type> acrescentar
<portlet-mode>view</portlet-mode> também o
<portlet-mode>edit</portlet-mode> suporte o modo
</supports>
(...)
Edit
20

<portlet>
<portlet-name>hello-liferay</portlet-name>
<display-name>Hello Liferay</display-name>
<portlet-class>com.sample.jsp.portlet.JSPPortlet</portlet-class>
<init-param>
<name>view-jsp</name>
<value>/view.jsp</value> Quando mais de
</init-param> um modo é
<init-param> suportado pelo
<name>edit-jsp</name> portlet, é preciso
<value>/edit.jsp</value> especiﬁcá-los
</init-param>
(...)
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>view</portlet-mode>
<portlet-mode>edit</portlet-mode>
</supports>
(...)
21

Criamos a página
edit.jsp para o
modo Edit do
portlet

22

Fazemos o
deploy do
portlet...

23

Modo Edit
habilitado...
24

...e
funcionando

25

Geralmente, o modo Edit é utilizado
para se fazer conﬁgurações do portlet.
Logo, façamos algo interessante.

26

Vamos modiﬁcar a página
edit.jsp para simular um
formulário simples de
conﬁguração
27

Nosso formulário
de conﬁgurações

28

Evita o conﬂito de nomes
na página do portal
(lembre-se que este é apenas um
fragmento de HTML)

29

Qual URL deverá ser
chamada no submit do
formulário?

29

De fato, não sabemos.
o portlet é quem tem que nos dizer

30

A classe GenericPortlet
disponibiliza 3 métódos de
renderização de portlet
doView, doEdit, doHelp
...que são chamados antes do
portlet entrar em um modo
especíﬁco

31

Portanto, vamos modiﬁcar o
método doEdit para que a
URL a ser utilizada pelo
formulário de edit.jsp seja
previamente disponibilizada
32

E modiﬁcar a página
edit.jsp para que a action
do formulário seja
corretamente conﬁgurada

33

Visualmente,
nada mudou...

34

<form
id="_helloliferay_WAR_helloliferayportlet_INSTANC
E_S6Et_helloForm"
action="http://localhost:8080/web/guest/home?
p_p_id=helloliferay_WAR_helloliferayportlet_INSTA
NCE_S6Et&p_p_lifecycle=1&p_p_state=normal&p_p_mod
e=edit&p_p_col_id=column-2&p_p_col_pos=1&p_p_col_
count=2”
method="post">

Nome: <input type="text" name="username" />
<input type="submit" value="Salvar" />
...mas a action do
formulário foi
</form>
conﬁgurada
corretamente.
35

Já temos um portlet com
suporte ao modo Edit.
Temos um formulário para
conﬁguração do portlet.
Só nos resta tratar a
submissão do formulário
36

Em portlets,
submit de dados
são tratados pelo
método
processAction()

37

Vamos criar alguma
lógica no
processAction()

38

Captura
parâmetros da
requisição

38

Guarda valor
enviado
38

Redireciona
portlet para seu
modo View
38

No método doView, vamos
recuperar o valor salvo nas
preferências do portlet, e enviá-lo
ao JSP view.jsp
40

No JSP do modo View
(view.jsp), recuperamos o
valor disponibilizado pelo
método doView.
41

Existem técnicas mais avançadas mas,
com isso, 80% das portlets existentes
(cadastros) podem ser desenvolvidos
http://www.ﬂickr.com/photos/dejay181/395737393/in/set-72157594529615566/ 43

It’s up to you!

http://www.ﬂickr.com/photos/shutter/105497713/ 44

Quer ajuda?
o/

sea@seatecnologia.com.br
45

4. Liferay JSP Portlets

Mais conteúdo relacionado

Destaque

Mais de SEA Tecnologia

4. Liferay JSP Portlets