Portlet JSR168/286 Sassari, 21 Maggio 2011

Transcript

1 Portlet JSR168/286 Sassari, 21 Maggio 2011

2 Agenda 1. JSR JSR Spring MVC Portlet 4. Esempio pra?co 2

3 Portale Porta di accesso unica a un insieme di applicazioni, da5 e servizi. Portale Applicazioni facilmente inseribili nella pagina unità indipenden5 configurabili riusabili anche in altri contes5 e portali 3

4 Portlet - evoluzione Soluzioni proprietarie Standard : JSR168 4

5 JSR 168 (Java Portlet Specifica?on 1.0) La specifica JSR 168 è stata rilasciata nel 2003 al gruppo di lavoro hanno partecipato Apache, BEA, Broadvision, IBM, Oracle, SAP, SUN, Sybase, TIBCO il ruolo e le funzionalità del Portlet Container il contrato tra il Container e i Portlet la ges5one del ciclo di vita dei Portlet il packaging per la distribuzione dei Portlet l'interazione con Web Services for Remote Portlets (WSRP) di OASIS Definisce 5

6 Portlet Portlet container Portlet Componen5 web Java, ges55 da un portlet container, che processano le richieste ricevute e generano contenu5 dinamici. con5ene i portlet e ges5sce il loro ciclo di vita. si occupa di immagazzinare le preference e le configurazioni di ogni portlet riceve le request dal portale e le indirizza alle portlet che ges5sce Portlet container 6

7 Ciclo di vita di un portlet Il ciclo di vita è ges5to dai 4 metodi espos5 dall interfaccia portlet: init: il metodo viene chiamato dal container quando il portlet viene instanziato destroy: viene chiamato dal container quando il portlet viene distruto processac?on: viene chiamato dopo che l utente ha effetuato una richiesta; serve a processare i da5 avu5 in input render: va in esecuzione ogni volta che il portlet si visualizza nella pagina web 7

8 javax.portlet.portlet 8

9 Caricamento pagina 9

10 Process di una ac?on 10

11 Ac?onRequest RenderRequest Derivano dall oggeto PortletRequest Sono so#oinsiemi dell HTpRequest è compito del portlet container dividere i parametri tra i vari portlet della pagina I parametri in ac5onrequest sono in generale diversi da quelli in renderrequest a meno che il portlet non li inserisca in ac5onresponse String value=request.getparameter( test ); response.setrenderparameter( test, value); Esempio Il parametro test è preso dalla ac5onrequest e passato in ac5onresponse 11

12 PortletSession Ogni portlet ha il proprio PortletSession i parametri inseri5 nel PortletSession con lo scope APPLICATION sono visibili anche in HTpSession ATributo visibile con stesso nome anche in HTpSession Esempio PortletSession session = request.getsession(true); session.setatribute( home.url,url,portletsession.application_scope); session.setatribute( bkg.color, RED,PortletSession.PORTLET_SCOPE); ATributo visibile solo al portlet 12

13 Modalità di un portlet La specifica definisce 3 modalità standard: VIEW: la modalità standard che ogni portlet deve implementare EDIT: consente di modificare le impostazioni dell utente HELP: tale modalità presenta informazioni di help rela5ve alla portlet I vari vendor possono comunque aggiungere modalità differen5. 13

14 Portlet taglib URI: htp://java.sun.com/portlet PermeTono alle JSP incluse nel portlet di avere accesso ad elemen5 specifici del portlet (render, request, id del portlet) di creare i link per l interazione con il portlet L implementazione delle taglib è responsabilità del portlet container 14

15 <portlet:namespace/> Ritorna l iden5fica5vo univoco del portlet all interno della pagina web Definizione U5le per l assegnazione di id univoci agli elemen5 della pagina web, sopratuto se sono presen5 più istanze dello stesso portlet nella stessa pagina var <portlet:namespace/>_restab=new ResultsTable(..); <portlet:namespace/>_populatetable(output); </script> <table id="<portlet:namespace/>_results"> <th><td>nome</td><td>cognome</td></th> </table> Esempio 15

16 <portlet:defineobjects/> Definizione definisce le seguen5 variabili all interno della JSP: renderrequest renderresponse portletconfig <portlet:defineobjects/> <%=renderresponse.settitle("my portlet 5tle")%> Esempio 16

17 <portlet:ac?onurl/> crea un URL che punta al portlet corrente ed invia un ac5on request con i parametri specifica5 Definizione portletmode: la modalità del portlet var: il nome della variabile nella JSP Parametri <portlet:ac5onurl var="searchac5on"> <portlet:param name="ac5on" value="search" /> </portlet:ac5onurl> <form ac5on="${searchac5on}" method="post"> Esempio 17

18 <portlet:renderurl/> crea un URL che punta al portlet corrente ed invia un render request con i parametri specifica5 Definizione portletmode: la modalità del portlet var: il nome della variabile nella JSP Parametri <portlet:renderurl var= helpurl portletmode= HELP > </portlet:renderurl> <a href= ${helpurl} >Help</a> Esempio 18

19 Portlet library I portlet possono essere inserite in un opportuno file war il file deve contenere le classi e tute le resources rela5ve ad essi nel folder WEB- INF deve essere presente il file portlet.xml 19

20 portlet.xml <portlet> <descrip5on xml:lang="it">portlet di test A</descrip5on> <portlet- name>testaportlet</portlet- name> <display- name xml:lang="it">portlet di test A</display- name> <portlet- class>org.springframework.web.portlet.dispatcherportlet</portlet- class> <init- param> <name>contextconfigloca5on</name> <value>/web- INF/context/TestPortletA- context.xml</value> </init- param> <expira5on- cache>0</expira5on- cache> <supports> <mime- type>text/html</mime- type> <portlet- mode>view</portlet- mode> <portlet- mode>help</portlet- mode> </supports> <supported- locale>en</supported- locale> </portlet> 20

21 Limi? di JSR168 La specifica presenta alcune limitazioni: manca un meccanismo standard per fare interagire tra loro i portlet (Inter Portlet Communica?on) non è possibile otenere una risorsa diretamente da un portlet bisogna passare dal portlet containet integrazione con AJAX non supportata internamente a meno che non sia offerta dal portlet container in modo non standard 21

22 Integrazione con AJAX JSP caricamento iniziale render aggiornamento AJAX Web container Portlet container Portlet Servlet container PortletSession JSP JavaScript AJAX request Servlet HTpSession Le due session condividono i parametri con scope APPLICATION_SCOPE 22

23 Agenda 1. JSR JSR Spring MVC Portlet 4. Esempio pra?co 23

24 JSR286 (Java Portlet Specifica?on 2.0) La specifica JSR 286 è stata rilasciata nel 2008 a febbraio 2006 fu cos5tuito il JSR 286 Expert Group al fine di arrivare alla Java Portlet Specifica5on 2.0 Novità introdoee Even5: ogni portlet può lanciare e ricevere determina5 even5 Public render parameter: possibilità per i portlet di condividere parametri tra loro Possibilità per un portlet di res5tuire una risorsa. 24

25 GenericPortlet 25

26 Even?- dichiarazione dell evento portlet.xml <event- defini5on> <qname xmlns:x="htp://com.alex/test/portlets/ns">x:event</qname> <value- type>java.lang.string</value- type> </event- defini5on> Il parametro value- type indica la classe dell evento 26

27 Even? - lancio dell evento portlet.xml <portlet> <descrip5on xml:lang="it">portlet di test A</descrip5on> <supported- publishing- event> <qname xmlns:x="hep://com.alex/test/portlets/ns">x:event</ qname> </supported- publishing- event> codice String event="test Event"; QName name=new QName("hTp://com.alex/test/portlets/ns", "event"); response.setevent(name, event); //Ac?onResponse 27

28 Even? - process dell evento portlet.xml <portlet> <descrip5on xml:lang="it">portlet di test B</descrip5on> <supported- processing- event> <qname xmlns:x="hep://com.alex/test/portlets/ns">x:event</ qname> </supported- processing- event> public void processevent(eventrequest request, EventResponse response){ Event event=request.getevent(); String qname= event.getqname(); } codice 28

29 Even? - flusso 29

30 Parametri pubblici - dichiarazione I parametri pubblici vengono dichiara5 in portlet.xml in una opportuna sezione vengono dis5n5 tra loro u5lizzando opportuni iden5fier portlet.xml <public- render- parameter> <iden?fier>foo</iden?fier> <qname xmlns:x= htp://com.alex/test/portlets/ns >x:foo2</qname> </public- render- parameter> 30

31 Parametri pubblici - u?lizzo I portlet dichiarano in portlet.xml i parametri pubblici che u5lizzeranno i parametri sono iden5fica5 con il loro iden5fier portlet.xml <portlet> <portlet- name>portleta</portlet- name> <supported- public- render- parameter>foo</supported- public- render- parameter> </portlet> 31

32 Parametri pubblici flusso A B Portlet A public void processac5on(ac5onrequest request, Ac5onResponse response){ response.setrenderparameter( foo", foo);} Portlet B C public void render(renderrequest request, RenderResponse response){ String value = response.getparameter( foo");} 32

33 Resource - <portlet:resourceurl/> crea l url per una risorsa, iden5ficata da un id, fornita dal portlet Definizione var: il nome della variabile all interno della JSP. id: l iden5fica5vo della risorsa richiesta Parametri Esempio <portlet:resourceurl var="changepage" id="changepage"> <portlet:param name= par1 value= val1 /> </portlet:resourceurl> 33

34 Resource - flusso A risorsa B public class TestAPortlet extends GenericPortlet{ public void serveresource (ResourceRequest request, ResourceResponse response){ C } } 34

35 Integrazione con AJAX caricamento iniziale JSP render Web container Portlet container aggiornamento AJAX serveresource Portlet PortletSession JSP JavaScript response: contenttype: applica5on/json 35

36 Agenda 1. JSR JSR Spring MVC Portlet 4. Esempio 36

37 Spring MCV Portlet modello flessibile e leggero Implementa il classico patern MVC analogo al modello Spring MVC Caraeeris?che DispatcherPortlet HandlerMapping Controller ViewResolver Componen? 37

38 DispatcherPortlet portlet.xml <portlet- class>org.springframework.web.portlet.dispatcherportlet</portlet- class> <init- param> <name>contextconfigloca5on</name> <value>/web- INF/context/TestPortletA- context.xml</value> </init- param> 38

39 HandlerMapping Mappa le PortletRequest verso gli opportuni controllers Responsabilità <bean class="org.springframework.web.portlet.mvc.annota5on.defaultannota5o nhandlermapping"> <property name="interceptors"> <bean class="org.springframework.web.portlet.handler.parametermappinginterc eptor" /> </property> </bean> context.xml 39

40 ViewResolver Responsabilità Sceglie la view opportuna a seconda del contesto context.xml <bean id="viewresolver" class="org.springframework.web.servlet.view.internalresourceview Resolver"> <property name="cache" value="true" /> <property name="viewclass value="org.springframework.web.servlet.view.jstlview" /> </bean> <property name="prefix" value="/web- INF/jsp/testA/" /> <property name="suffix" value=".jsp" /> 40

41 Interazione tra i componen? HandlerMapping select Controller request lookup DispatcherPortlet return generate ModelAndView render lookup View select ViewResolver 41

42 Controller annota? Nuovi in Spring 2.5 Caraeeris?che Rendono più snelle le configurazioni PermeTono di riunire la logica nella stessa classe di controller Possibilità di u5lizzare segnature libere nei metodi. 42

43 Controller annota? metodi Possono essere in qualsiasi ordine: Request/response Model o ogge~ del model Errors java.u5l.locale Parametri metodi oggeto ModelAndView Model o ogge~ del model oggeto View string che iden5fica l oggeto view Output metodi esempio public void searchac5on(@modelatribute("search") SearchUserForm search,model model,ac5onrequest request){ 43

44 Controller annota? component- scan Il tag component- scan indica al framework dove cercare i controller annota5 da usare per il portlet <context:component- scan base- package= "com.alex.springportlet.testa" /> <context:annota5on- config /> context.xml 44

45 @Controller La classe marcata con l viene u5lizzata come controller il parametro value indica l id del bean nel file di public class TestAPortletController extends GeneralController{ codice context.xml <bean id="testacontroller" class="com.alex.springportlet.testa.controller.testaportletco ntroller"> <property name="service" ref="serviceimpl"/> 45

46 @RequestMapping - 1 A livello di classe,viene usata per dis5nguere I vari controller in base alle modalità VIEW ) public class TestAPortletController extends GeneralController{ codice In questo caso il controller è u5lizzato per ges5re la modalità VIEW 46

47 @RequestMapping - 2 A livello di metodo, indica il metodo del controller da richiamare a par5re da una certa ac5on/render request public void launcheventac5on(ac5onrequest request,ac5onresponse public String launcheventrender(renderrequest request,renderresponse response){ return "index"; } 47

48 @RequestMapping

49 @SessionAeributes A livello di classe, iden5fica gli atribu5 del model da inserire in public class TestAPortletController { public String begin(model model,portletsession session){ SearchUserForm search=new SearchUserForm(); model.addatribute("search", search); Il framework colloca automa5camente search in sessione 49

50 @ModelAeribute A livello di parametro, indica che il parametro di un determinato metodo va preso dal model public void jsonchangepage(@modelatribute("search") SearchUserForm search,model model ) codice Il parametro search viene preso dal model 50

51 @EventMapping JSR 286 A livello di metodo, iden5fica il metodo che deve tratare un par5colare public void handleevent(event event,eventrequest request) throws Excep5on { } codice 51

52 @ResourceMapping JSR 286 A livello di metodo, iden5fica il metodo che deve res5tuire una determinata public void jsonchangepage(, codice <portlet:resourceurl var="changepage" id="changepage"> <portlet:param name= par1 value= val1 /> </portlet:resourceurl> 52

53 Agenda 1. JSR JSR Spring MVC Portlet 4. Esempio 53

54 Esempio IDE: Netbeans Spring v Maven Portlet Container: Apache Pluto JQuery 54