Портлет-контейнер JSR-168, JSR-286, WSRP Alexey Zavizionov

Servlet/JSP HTML страницы Интегрирование веб-сервисов Эволюция сайтов. 1 3 2

Пользователю нужна иформация от разных источников. Представленная в едином и настраиваемом интерфейсе.

От простого сайта...

до WebOS портала.

...и разных систем управления сайтами*? СКОЛЬКО ссылок в интернете ...? * CMS – content management system Многообразие.

Тысячи разных CMS систем Один триллион уникальных ссылок в индексе Google* Десятки Java порталов Результат эволюции. * 25.07.2008 1 3 2

Основная проблема ? Выбираем портал.

1998 – 2002 У каждого портала свой API. Что же дальше?

JSR-168 JCP cтандарт первой портлетной спецификации. Jan. 2002 – 27 Oct. 2003

Expert group of JSR-168 * * сокращенный список

Определения Портлет контейнер - содержит портлеты и управляет их жизненным циклом Портлет - приложение, которое предоставляет определенную часть контента Портал - веб приложение для предоставления персонализации, аутентификации и контент агрегации 1 3 2

Аутентификация Агрегация Персонализация Описание Portlet 1. 1 3 2 Кастомизация 4

Динамические ресурсы AJAX Взаимодействие портлетов Q: Что ещё не хватает? 1 2

JSR-286 JCP cтандарт второй портлетной спецификации. Nov. 2005 – 12 Jun. 2008

Expert group of JSR-286 * * сокращенный список

События Взаимодействие портлетов * Публичные параметры Описание Portlet 2. 1 3 2 Сессии 4 Ресурсы 5 * IPC - inter portlet communication Фильтры 6

eXo Portlet Container

Концепция

Портлеты и сервлеты Отличия Сходства Экстра функциональность 1 3 2 P&S : Portlets and Servlets

P&S: Сходства Портлеты - java технология, базирующаяся на веб компонентах. Портлетами и их жизненным циклом управляет специальный контейнер. Портлеты производят динамический контент. Взаимодействуют с веб клиентами через парадигму запрос/ответ.

P&S: Отличия Только часть разметки. Вызываются через URLs сконструированные portlet API. Взаимодействие через портал. Обработка: action, event, render и resource. Предопределенные portlet mode и window state. Несколько на одной странице.

P&S: Экстра функциональность Портлеты могут сохрнять persistent configuration. Портлеты имеют доступ к user profile. Могут сохранять временную информацию в двух областях видимости: application-wide scope и portlet private scope. Могут отправлять и получать события (events).

Архитектура

Архитектура

Конфигурация: portlet.xml Минимальная конфигурация портлетного приложения. <?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?> < portlet-app xmlns=&quot; http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd &quot; xmlns:xsi=&quot; http://www.w3.org/2001/XMLSchema-instance &quot; xsi:schemaLocation=&quot;http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd&quot; version=&quot;1.0&quot;> < portlet > < portlet-name >HelloWorldPortlet</portlet-name> < portlet-class > org.exoplatform.HelloWorldPortlet </portlet-class> < supports > < mime-type >text/html</mime-type> </supports> </portlet> </portlet-app>

Конфигурация: web.xml <listener> <listener-class> org.exoplatform.services.portletcontainer.impl.servlet. PortletApplicationListener </listener-class> </listener> <servlet> <servlet-name>PortletWrapper</servlet-name> <servlet-class> org.exoplatform.services.portletcontainer.impl.servlet . ServletWrapper </servlet-class> </servlet> <servlet-mapping> <servlet-name>PortletWrapper</servlet-name> <url-pattern> /PortletWrapper </url-pattern> </servlet-mapping>

Жизненный цикл processAction()‏ init()‏ processEvent() * 1 3 2 render()‏ 4 serveResource() * 5 destroy()‏ 6 * в JSR-286

Портлет API PortletRequest GenericPortlet PortletResponse 1 3 2

API: GenericPortlet

API: PortletRequest

API: PortletResponse

Архитектура взаимодействия Event Action Resource 1 3 2

Process ACTION

Process EVENT

Serve RESOURCE

Попробуем в действии Event пример. Action пример. Render пример.

Пример: Render public class HelloWorldPortlet extends GenericPortlet { public void doView (RenderRequest renderRequest, RenderResponse renderResponse)‏ throws PortletException, IOException { renderResponse.setContentType(&quot;text/html; charset=UTF-8&quot;); PrintWriter w = renderResponse.getWriter(); w.println(&quot;Hello, World!&quot;); } }

Пример: Action public class HelloWorldPortlet extends GenericPortlet { public void processAction (ActionRequest actionRequest, ActionResponse actionResponse)‏ throws PortletException, IOException { actionRequest.setAttribute(&quot;test_attribute&quot;, &quot;test&quot;); actionResponse.setRenderParameter(&quot;test_render_param&quot;, &quot;168&quot;); } }

Пример: Event public void processAction (ActionRequest actionRequest, ActionResponse actionResponse)‏ throws PortletException, IOException { MyEventPub sampleAddress = new MyEventPub(); sampleAddress.setStreet(&quot;myStreet&quot;); sampleAddress.setCity(&quot;myCity&quot;); actionResponse.setEvent (new QName(&quot;MyEventPub&quot;), sampleAddress); } public void processEvent (EventRequest req, EventResponse resp)‏ throws PortletException, IOException { Event event = req.getEvent() ; MyEventPub sampleAddress = (MyEventPub) event.getValue(); resp.setPortletMode(PortletMode.EDIT); } }

Пример: Resource public void serveResource (ResourceRequest request, ResourceResponse response) throws PortletException, IOException { String goal = request.getParameter(&quot;goal&quot;); if (goal != null && goal.equals(&quot;image&quot;)) { response.setContentType(&quot; image/jpeg &quot;); Graphics2D graphics; OutputStream stream = response.getPortletOutputStream() ; JPEGImageEncoder encoder = JPEGCodec.createJPEGEncoder(stream); BufferedImage bi = new BufferedImage(...); ... encoder.encode(bi); } else { response.setContentType(&quot; text/html ; charset=utf-8&quot;); PrintWriter w = response.getWriter() ; w.println(&quot;Here's the markup in serveResource&quot;); } }

Пример: Dispatcher private static final String VIEW_PAGE = &quot;/WEB-INF/jsp/view.jsp&quot;; public void doView (RenderRequest request, RenderResponse response)‏ throws PortletException, IOException { response.setContentType(&quot;text/html&quot;); getPortletContext (). getRequestDispatcher (VIEW_PAGE). include (request, response); }

Пример: Taglib <%@taglib uri=&quot;http://java.sun.com/portlet_2_0&quot; prefix=&quot;portlet&quot;%> < portlet:defineObjects /> <br/> < portlet:renderURL var=&quot;renderURL&quot;/> <br/> Link to render: <a href=&quot;<%=renderURL %>&quot;>here</a> WindowState is <br/> <%= renderRequest.getWindowState() .toString()%> <br/> PortletMode is <br/> <%= renderRequest.getPortletMode() .toString()%> <br/>

Пример: Preferences ---portlet.xml------------------------------------------------------------------------------- < portlet-preferences > <preference> <name>message</name> <value>Defaut message</value> <read-only>false</read-only> </preference> </portlet-preferences> ---PreferencesPortlet.java--------------------------------------------------------------- PortletPreferences prefs = actionRequest.getPreferences() ; prefs.setValue(&quot;message&quot;, &quot;My New Message&quot;); prefs.store(); ... String message = prefs.getValue(&quot;message&quot;, “&quot;); -------------------------------------------------------------------------------------------------

Пример: Session portletRequest.getPortletSession(); setAttribute(name, value, PortletSession.APPLICATION_SCOPE); setAttribute(name, value, PortletSession.PORTLET_SCOPE);

Пример: Public parameters <portlet-app ... version=&quot;2.0&quot;> <portlet> <description xml:lang=&quot;EN&quot;>PublicParameterPortlet</description> <portlet-name>PublicParamterPortlet</portlet-name> ... < supported-public-render-parameter > country </supported-public-render-parameter> </portlet> < public-render-parameter > <identifier>country</identifier> <name>country</name> </public-render-parameter> </portlet-app>

Пример: Cache Expiration ... <expiration-cache>10</expiration-cache> ... Validation response.getCacheControl().setETag(someID);

WSRP WSRP - удаленные портлеты

Итог

Ресурсы www.exoplatform.com Документация wiki.exoplatform.org Просмотр исходников fisheye.exoplatform.org Блог blog.exoplatform.org jira.exoplatform.org builder.exoplatform.org