 |
|
난이도 : 초급 Lakshmi Priya, Systems Software Engineer, IBM
원문 게재일 : 2009 년 7 월 23 일
번역 게재일 : 2009 년 9 월 22 일 Java 포틀릿 스펙 2.0에 새로 도입된 JSR 286 기반의 기능은 포틀릿 간의 조정을
지원하며 이벤트 및 공용 렌더링 매개변수라는 두 메커니즘을 통해 포틀릿 간의 통신을 지원합니다. 이
기사에서는 먼저 주요 개념을 간략히 살펴본 후 IBM® Rational® Application Developer 버전
7.5의 Portal Toolkit을 사용하여 기본적인 샘플 JSR 286 포틀릿 애플리케이션을 만드는 과정을 보여
줍니다. 이 과정에서는 Portal Toolkit의
다양한 기능을 활용하여 전체 과정을 빠르게 진행할 수 있습니다. 새 이벤트 마법사와 향상된 Portlet Deployment Descriptor 시각적 편집기를 사용하여 이벤트 및 공용 렌더링 매개변수를 활성화하는 방법에 대해 자세히
설명합니다. 이 기사에서 개발한 샘플 애플리케이션은 IBM® WebSphere® Portal 버전 6.1에 전개할
수 있습니다.
주요 개념
이 기사의 주요 개념을 먼저 간단히 설명한 다음 샘플 포틀릿 애플리케이션을 사용하여 자세히 설명한다.
이벤트
버전 2의 JSR(Java™ Specification Request) 286 스펙에는 포틀릿에서 이벤트를 보내고 받는 데 필요한 기능이
정의되어 있다. 그리고 이 이벤트를 사용하면 포틀릿 간에 통신을 수행할 수 있다. IBM® Rational® Application
Developer Version 7.5에서는 이벤트를 정의하고, 포틀릿을 활성화하고, 이벤트를 사용하여 포틀릿 간에 데이터를 전달하는
데 필요한 도구 세트를 제공한다. 포틀릿은 다음과 같은 통신 기능을 처리할 수 있다.
- 다른 포틀릿에 이벤트를 보낸다.
- 다른 포틀릿의 이벤트를 받아서 처리한다.
이벤트의 속성
각 이벤트에는 다음과 같은 이름 및 기타 속성이 있어야 한다.
- 이름: 이벤트의 고유 이름이다. 이벤트 이름은 XML 스펙에 정의된 대로 네임스페이스(예: http://www.ibm.com)와
로컬 부분(예: sampleEvent)으로 구성된 완전한 이름인 전체 QName일 수 있다. 또는 기본 네임스페이스를 선언한 후 각 이벤트에
대한 로컬 부분만 지정하는 방식으로 많은 이벤트에 동일한 네임스페이스를 사용할 수도 있다.
- 설명: (선택 사항) 이벤트에 대한 설명이다.
- 값 유형: (선택 사항) 이벤트를 사용하여 전송할 값의 완전한 Java 클래스 이름이다.
- 별명: (선택 사항) 네임스페이스에 한정된 이벤트의 이름이다.
포틀릿 간의 통신을 위해 이벤트 및 공용 렌더링 매개변수를 통합하는 포틀릿 애플리케이션을 작성하려면 다음과 같은 작업을 수행해야 한다.
- JSR 286 포틀릿 프로젝트 및 포틀릿 작성하기
- PDD(Portlet Deployment Descriptor)에서 이벤트 정의 작성하기
- 이벤트를 포틀릿에서 지원되는 게시 또는 처리 이벤트로 추가하기
- 이벤트를 게시 또는 처리하도록 포틀릿 클래스의 프로세스 동작 또는 이벤트 코드 수정하기
- 공용 렌더링 매개변수 추가하기
- 서버에 포틀릿 프로젝트 게시하기
- 포틀릿 연결하기
이러한 작업은 Rational Application Developer V7.5에서 제공하는 도구를 사용하면 매우 쉽게 수행할 수 있다.
공용 렌더링 매개변수
JSR 286 스펙에는 포틀릿 간의 조정에 사용되는 또 다른 메커니즘인 공용 렌더링 매개변수(자세한 설명은
참고자료 참조)가 있다. 이러한 매개변수를 사용하면 포틀릿 간에 요청 매개변수를 공유할 수 있다.
공용 렌더링 매개변수의 속성
각 매개변수에는 다음과 같은 이름 및 기타 속성이 있어야 한다.
- 이름: (필수) 매개변수의 고유 이름으로 문자열 또는 네임스페이스에 한정된 이름이다. 기본 네임스페이스를
선택하거나 다른 네임스페이스를 지정한다. 이벤트 이름으로 입력한 지역화된 문자열이 네임스페이스에 추가된다.
- ID: (필수) 포틀릿 코드에서 렌더링 매개변수를 참조하는 데 사용되는 문자열이다.
- 설명: (선택 사항) 렌더링 매개변수에 대한 설명이다.
- 별명: (선택 사항) 네임스페이스에 한정된 매개변수의 이름이다.
이 기사의 샘플 애플리케이션
이 기사의 샘플 포틀릿 애플리케이션에서는 JSR 286의 이벤트 및 공용 렌더링 매개변수 기능을 사용하여 얻을 수 있는
장점을 보여 준다. 이 샘플 애플리케이션은 배송 회사에서 주문 및 고객의 세부 사항을 관리하는 데 사용되며 다음과 같은 세 포틀릿으로
구성되어 있다.
- Orders 포틀릿은 회사의 주문에 대한 월간 세부 사항을 관리한다.
- OrderDetails 포틀릿은 한 주문의 세부 사항을 보여 준다.
- TrackingDetails 포틀릿은 한 주문에 대한 추적 세부 사항을 보여 준다.
이 기사에서는 이벤트 및 공용 렌더링 매개변수를 작성하여 샘플에서 사용하는 방법을 보여 준다. 다운로드에서
전체 샘플을 다운로드할 수 있다.
샘플의 사용 사례
사용자가 월간 주문 목록에서 하나의 주문 ID를 선택하여 해당 주문 및 추적 세부 사항을 볼 수
있다. 이는 이벤트 및 공용 렌더링 매개변수를 사용하여 구현된다. Orders 포틀릿에서는 한 달 동안의
모든 주문에 대한 요약 정보를 볼 수 있다. 사용자가 Orders 포틀릿에 있는 주문의 ID를 클릭하면
포틀릿에서 이벤트가 트리거된다. 이 이벤트는 선택한 주문 ID에 대한 주문 세부 사항을 보여 주는
OrderDetails 포틀릿에서 처리된다. 그런 다음 OrderDetails 포틀릿에서 주문 세부 사항에 있는 주문의
추적 ID를 가져온 후 세부 사항을 TrackingDetails 포틀릿에 렌더링 매개변수로 전달한다. 그런 다음
TrackingDetails 포틀릿에서 해당 주문의 추적 세부 사항을 보여 준다.
- 이 사용 사례를 실제로 구현하기 위해 Rational Application Developer 7.5의 Portal Toolkit에서
먼저
OrderIDType이라는 이벤트를 선언한다. 이 이벤트는 Orders 포틀릿에
대한 지원되는 게시 이벤트와 OrderDetails 포틀릿에 대한 지원되는 처리 이벤트로 추가된다.
- 그런 다음
TrackingIDType 공용 렌더링 매개변수를 작성하고 OrderDetails
및 TrackingDetails 포틀릿에서 이들 매개변수를 지원하도록 설정한다.
JSR 286 포틀릿 프로젝트 및 포틀릿 작성하기
Rational Application Developer의 Portlet Project 마법사를 사용하여 JSR 286 호환 포틀릿 프로젝트를 작성할 수 있다.
포틀릿 프로젝트를 작성하려면 다음을 수행한다.
- File > New > Portlet Project를 클릭하여 마법사를 연다.
- 그림 1과 같이 세부 사항을 지정한다.
- Target Runtime으로 WebSphere Portal v6.1을 선택한다.
- Portlet API로 JSR 286 Portlet을 선택한다.
- Portlet type으로 Basic Portlet을 선택한다.
그림 1. JSR 286 포틀릿 프로젝트 작성 마법사
이제 작성한 포틀릿 애플리케이션에 필요한 포틀릿을 추가할 차례이다. 이 기사에서는 샘플 애플리케이션의
세 포틀릿에 대해 설명하고 있으므로 다음과 같이 포틀릿 프로젝트에 이들 포틀릿을 추가할 수 있다(그림 2 참조).
- Portlet Deployment Descriptor를 마우스 오른쪽 단추로 클릭하고 New > Portlet을 선택한다.
- 포틀릿 이름을
OrderDetail로 입력하고 Finish를 클릭한다.
- 이러한 단계를 반복하여 나머지 OrdersPortlet 및 TrackingPortlet 포틀릿도 추가한다.
그림 2. 포틀릿 작성 마법사
참고:
이 기사에서 다루는 주제는 이벤트 및 공용 렌더링 매개변수를 작성하는 방법이므로
JSP™(Java™Server Pages) 파일을 수정하여 원하는 함수를 포틀릿에 추가하는 방법에 대해서는
설명하지 않는다. 이 기사에서는 이러한 포틀릿을 수정한 것으로 간주한다. 즉, Orders 포틀릿은 월간
주문을 보여 주고, OrderDetail 포틀릿은 주문 세부 사항을 보여 주고, Tracking 포틀릿은 주문에 대한
추적 세부 사항을 보여 주도록 수정된 것으로 간주한다.
그림 3에서는 WebSphere Application Server V6.1에 게시된 OrdersPortlet을 보여 준다.
그림 3. Orders 포틀릿
Portlet Deployment Descriptor에서 이벤트 정의 작성하기
Rational Application Developer의 이벤트 마법사를 사용하면 이벤트를 쉽게 작성할 수 있다. 다음을 수행하여 세 가지 이벤트를 작성한다.
- Project Explorer에서 포틀릿 프로젝트를 펼친다.
- Portlet Deployment Descriptor를 마우스 오른쪽 단추로 클릭하고 Event를 선택한다.
그림 4와 같이 Event에는 다음 두 가지 옵션이 있다.
- Enable this Portlet to Publish Event
- Enable this Portlet to Process Event
그림 4. Event 옵션
확대하려면 클릭한다.
포틀릿 게시 이벤트로 이벤트 추가하기
첫 번째 옵션인 "Enable this Portlet to Publish Event"를 선택한 경우 수행할 동작은 다음과 같다.
- 이벤트 정의를 포틀릿 애플리케이션에 추가한다.
- 이벤트를 포틀릿의 지원되는 게시 이벤트로 추가한다.
processAction() 또는 processEvent()
메소드를 수정하여 이벤트를 게시한다.
두 번째 옵션인 "Enable this Portlet to Process Event"를 선택한 경우 수행할 동작은 다음과 같다.
- 이 이벤트 정의가 아직 없으면 이벤트 정의를 포틀릿 애플리케이션에 추가한다.
- 이벤트를 포틀릿의 지원되는 처리 이벤트로 추가한다.
- processEvent() 메소드를 수정하여 이벤트를 처리한다.
이제 마법사를 사용하여 이벤트를 작성할 차례이다. Orders 포틀릿을 사용하여 OrderIDType 이벤트를 게시하려면 다음을 수행한다.
- Portlet Deployment Descriptor 아래에 있는 Orders 포틀릿을 마우스 오른쪽 단추로 클릭한다.
- Event > Enable this Portlet to Publish events를 선택한다. 그러면 마법사가 열린다.
- 그림 5와 같이 세부 사항을 지정한다.
- Event Name으로 OrderIDType을 선택한다.
- Value Type으로 String을 지정한다.
그림 5. 포틀릿을 사용하여 이벤트를 게시하기 위한 마법사
- Finish를 클릭한다.
이 마법사에서는 Portlet Deployment Descriptor에 다음과 같은 두 가지 변경 사항을 적용한다.
- 이벤트 정의를 포틀릿 애플리케이션에 추가한다.
- 이벤트를 포틀릿의 지원되는 게시된 이벤트로 추가한다.
Listing 1에서 굵게 표시된 코드는 Portlet Deployment Descriptor 코드에서 이벤트 마법사에 의해 수정된 부분을 보여 준다.
Listing 1. Deployment Descriptor 코드 수정 사항
<?xml version="1.0" encoding="UTF-8"?>
<portlet-app xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd"
version="2.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd
http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd"
id="com.ibm.jsr286eventrenderparam.JSR286EventRenderParamPortlet.19a07d46c1">
<portlet>
<portlet-name>OrderDetail</portlet-name>
<?xml version="1.0" encoding="UTF-8"?>
<portlet-app xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd"
version="2.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd
http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd"
id="com.ibm.jsr286eventrenderparam.JSR286EventRenderParamPortlet.19a07d46c1">
<portlet>
<portlet-name>OrderDetail</portlet-name>
<display-name xml:lang="en">OrderDetail</display-name>
<display-name>OrderDetail</display-name>
<portlet-class>
com.ibm.jsr286eventrenderparam.OrderDetailPortlet
</portlet-class>
<init-param>
<name>wps.markup</name>
<value>html</value>
</init-param>
<expiration-cache>0</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>view</portlet-mode>
</supports>
<supported-locale>en</supported-locale>
<resource-bundle>
com.ibm.jsr286eventrenderparam.nl.OrderDetailPortletResoure
</resource-bundle>
<portlet-info>
<title>OrderDetail</title>
<short-title>OrderDetail</short-title>
<keywords>OrderDetail</keywords>
</portlet-info>
</portlet>
<portlet>
<portlet-name>OrdersPortlet</portlet-name>
<display-name xml:lang="en">OrdersPortlet</display-name>
<display-name>OrdersPortlet</display-name>
<portlet-class>
com.ibm.jsr286eventrenderparam.OrdersPortlet
</portlet-class>
<init-param>
<name>wps.markup</name>
<value>html</value>
</init-param>
<expiration-cache>0</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>view</portlet-mode>
</supports>
<supported-locale>en</supported-locale>
<resource-bundle>
com.ibm.jsr286eventrenderparam.nl.OrdersPortletResource
</resource-bundle>
<portlet-info>
<title>OrdersPortlet</title>
<short-title>OrdersPortlet</short-title>
<keywords>OrdersPortlet</keywords>
</portlet-info>
<supported-publishing-event>
<name>OrderIDType</name>
</supported-publishing-event>
</portlet>
<portlet>
<portlet-name>TrackingPortlet</portlet-name>
<display-name xml:lang="en">TrackingPortlet</display-name>
<display-name>TrackingPortlet</display-name>
<portlet-class>
com.ibm.jsr286eventrenderparam.TrackingPortlet
</portlet-class>
<init-param>
<name>wps.markup</name>
<value>html</value>
</init-param>
<expiration-cache>0</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>view</portlet-mode>
</supports>
<supported-locale>en</supported-locale>
<resource-bundle>
com.ibm.jsr286eventrenderparam.nl.TrackingPortletResource
</resource-bundle>
<portlet-info>
<title>TrackingPortlet</title>
<short-title>TrackingPortlet</short-title>
<keywords>TrackingPortlet</keywords>
</portlet-info>
</portlet>
<default-namespace>http://JSR286EventRenderParam/</default-namespace>
<event-definition>
<name>OrderIDType</name>
<value-type>java.lang.String</value-type>
</event-definition>
</portlet-app>
|
 |
|
이벤트를 게시하는 포틀릿 클래스의 프로세스 동작 코드 수정하기
이제 이벤트를 게시하도록 processAction() 메소드를 수정한다(Listing 2 참조).
Listing 2. processAction() 이벤트 수정 사항
public void processAction(ActionRequest request, ActionResponse response)
throws PortletException, java.io.IOException {
if( request.getParameter(FORM_SUBMIT) != null ) {
// Set form text in the session bean
OrdersPortletSessionBean sessionBean = getSessionBean(request);
if( sessionBean != null )
sessionBean.setFormText(request.getParameter(FORM_TEXT));
}
//Initialize the fields in the class as per your requirement
java.lang.String sampleObject = new java.lang.String();
response.setEvent("OrderIDType", sampleObject);
}
|
이벤트 마법사에 의해 생성된 코드를 사용자의 요구 사항에 맞게 사용자 정의해야 한다. OrderIDType을
보내야 하기 때문에 주문 ID가 선택되면 동작 요청 매개변수에서 주문 ID를 가져온다(Listing 3 참조).
Listing 3. OrderIDType을 보내는 코드
String order_id = request.getParameter(ORDER_ID);
if (order_id!=null)
response.setEvent("OrderIDType", order_id);
|
그림 6의 Project Explorer와 같이 마법사가 Portlet Deployment Descriptor 아래의 포틀릿을 수정한다. OrdersPortlet 노드 아래에 OrderIDType 이벤트가 표시된다.
그림 6. Project Explorer
이벤트를 포틀릿에서 지원되는 처리 이벤트로 추가하기
다음으로, OrderDetail 포틀릿에서 주문 ID를 받아야 한다. 즉, 게시된 이벤트를 OrderDetail 포틀릿에서 처리해야 한다.
포틀릿을 사용하여 이벤트를 처리하려면 다음을 수행한다.
- Portlet Deployment Descriptor 노드를 펼친다.
- OrderDetail 포틀릿을 마우스 오른쪽 단추로 클릭하고 Event > Enable this Portlet to Process Event를 선택한다.
그림 7. 프로세스 이벤트 옵션
확대하려면 클릭한다.
그림 8과 같이 "Enable this portlet to process events" 마법사가 열린다.
그림 8. Enable this Portlet to Process Events 창
- 앞에서 이벤트 게시 마법사를 사용하여 선언한 OrderIDType을 Event Name으로 선택한다. 여기에서는
이벤트 정의를 수정할 수 없지만 Portlet Deployment Descriptor에서 수동으로 편집할 수 있다.
- Finish를 클릭하여 이 처리를 완료한다.
- OrderDetail 포틀릿에 대한
supported-processing-event 요소를
추가한다. (이 이벤트를 게시할 때 이벤트 정의를 이미 추가했다.)
processEvent() 메소드를 수정하여 이벤트를 처리한다.
Listing 4와 같이 OrderDetail 포틀릿의 portlet 섹션이 수정되었다.
Listing 4. OrderDetail 포틀릿 수정 사항
<portlet>
<portlet-name>OrderDetail</portlet-name>
<display-name xml:lang="en">OrderDetail</display-name>
<display-name>OrderDetail</display-name>
<portlet-class>
com.ibm.jsr286eventrenderparam.OrderDetailPortlet
</portlet-class>
<init-param>
<name>wps.markup</name>
<value>html</value>
</init-param>
<expiration-cache>0</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>view</portlet-mode>
</supports>
<supported-locale>en</supported-locale>
<resource-bundle>
com.ibm.jsr286eventrenderparam.nl.OrderDetailPortletResoure
</resource-bundle>
<portlet-info>
<title>OrderDetail</title>
<short-title>OrderDetail</short-title>
<keywords>OrderDetail</keywords>
</portlet-info>
<supported-processing-event>
<name>OrderIDType</name>
</supported-processing-event>
</portlet>
|
이벤트를 처리하는 포틀릿 클래스의 이벤트 코드 수정하기
Listing 5와 같이 수신된 이벤트를 처리하는 processEvent() 메소드를 변경한다.
Listing 5. processEvent() 메소드 수정 사항
public void processEvent(EventRequest request, EventResponse response)
throws PortletException, java.io.IOException {
Event sampleEvent = request.getEvent();
if(sampleEvent.getName().toString().equals("OrderIDType")) {
Object sampleProcessObject = sampleEvent.getValue();
}
|
TrackingID를 OrderDetail 포틀릿에서 Tracking 포틀릿으로 보내야 하므로 processEvent()
메소드를 수정해야 한다(Listing 6의 굵게 표시된 코드 참조).
Listing 6. processEvent() 메소드 수정 사항
public void processEvent(EventRequest request, EventResponse response)
throws IOException, PortletException {
Event sampleEvent = request.getEvent();
if(sampleEvent .getName().equals("OrderIDType")) {
Object sampleProcessObject = sampleEvent.getValue();
response.setRenderParameter(ORDER_ID, sampleProcessObject.toString());
//set the order id as a render parameter
OrderDetail od = ShippingDB.getOrderDetail(ev.getValue().toString());
if (od != null) {
request.getPortletSession().setAttribute(ORDER_DETAIL, od);
response.setRenderParameter("TrackingID", od.getTrackingId());
//fetch the tracking id from the order details, and set it as a
render parameter.
}
}
}
|
OrderDetails 포틀릿에서 주문 세부 사항을 표시하려면 doView() 메소드를 수정하여
Listing 7에 굵게 표시된 코드를 추가해야 한다.
Listing 7. doView() 메소드 수정 사항
String orderId = (String) request.getParameter(ORDER_ID);//get the order set
in the processAction()
OrderDetail od = ShippingDB.getOrderDetail(orderId);
PortletURL actionURL = ShippingUtils.createSimpleActionURL(ORDER_DETAILS, response);
odb.setActionURL(actionURL);
if (od != null)
odb.setOrderDetail(od);
getPortletContext().getRequestDispatcher(getJspFilePath(request, VIEW_JSP))
.include(request, response);
|
공용 렌더링 매개변수 추가하기
다음으로 수행할 단계는 다음과 같이 공용 렌더링 매개변수 메커니즘을 사용하여 OrderDetail 포틀릿과 Tracking 포틀릿 간에 추적 ID를 공유하는 것이다.
- EventSample 프로젝트에 대한 Portlet Deployment Descriptor를 연다.
- Render Params 탭을 선택한 다음 Add를 클릭하여 NewPublicRenderParam이라는 기본 이름을 사용하는 공용 렌더링 매개변수를 작성한다.
- 그림 9와 같이 Name 및 Identifier 필드의 값을
TrackingID로 변경한다.
그림 9. Portlet Deployment Descriptor 편집기의 Render Params 탭
확대하려면 클릭한다.
이 동작은 Listing 8의 섹션을 Portlet Deployment Descriptor의 포틀릿 애플리케이션 정의에 추가한다.
Listing 8. Portlet Deployment Descriptor에 추가된 코드
<public-render-parameter>
<identifier>TrackingID</identifier>
<name>TrackingID</name>
</public-render-parameter>
|
- 이 매개변수는 Tracking 및 OrderDetail 포틀릿에서 공유해야 하므로 각각의 해당 포틀릿에 대해 지원되는 공용 렌더링 매개변수로 추가해야 한다.
- Portlets 탭에서 Tracking 포틀릿을 선택한다.
- 오른쪽 분할창에서 Supported Public Render Parameters 섹션을 찾아서 선택한 후 Select를 클릭한다.
- 편집기의 Render Params 탭에서 작성했던 TrackingID를 이름으로 선택한다(그림 10 참조).
- OK를 클릭한다.
- 단계 4 및 5를 반복하여
TrackingID를 OrdersPortlet의 지원되는 공용 렌더링 매개변수로 추가한다.
그림 10에서는 포틀릿에 추가된 공용 렌더링 매개변수를 보여 준다.
그림 10. 추가된 지원되는 공용 렌더링 매개변수
확대하려면 클릭한다.
Listing 9에서 굵게 표시된 변경 사항이 Portlet Deployment Descriptor에 적용된다.
Listing 9. Portlet Deployment Descriptor 수정 사항
<portlet>
<portlet-name>OrdersPortlet</portlet-name>
<display-name xml:lang="en">OrdersPortlet</display-name>
<display-name>OrdersPortlet</display-name>
<portlet-class>
com.ibm.jsr286eventrenderparam.OrdersPortlet
</portlet-class>
<init-param>
<name>wps.markup</name>
<value>html</value>
</init-param>
<expiration-cache>0</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>view</portlet-mode>
</supports>
<supported-locale>en</supported-locale>
<resource-bundle>
com.ibm.jsr286eventrenderparam.nl.OrdersPortletResource
</resource-bundle>
<portlet-info>
<title>OrdersPortlet</title>
<short-title>OrdersPortlet</short-title>
<keywords>OrdersPortlet</keywords>
</portlet-info>
<supported-publishing-event>
<name>OrderIDType</name>
</supported-publishing-event>
<supported-public-render-parameter>
TrackingID
</supported-public-render-parameter>
</portlet>
<portlet>
<portlet-name>TrackingPortlet</portlet-name>
<display-name xml:lang="en">TrackingPortlet</display-name>
<display-name>TrackingPortlet</display-name>
<portlet-class>
com.ibm.jsr286eventrenderparam.TrackingPortlet
</portlet-class>
<init-param>
<name>wps.markup</name>
<value>html</value>
</init-param>
<expiration-cache>0</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>view</portlet-mode>
</supports>
<supported-locale>en</supported-locale>
<resource-bundle>
com.ibm.jsr286eventrenderparam.nl.TrackingPortletResource
</resource-bundle>
<portlet-info>
<title>TrackingPortlet</title>
<short-title>TrackingPortlet</short-title>
<keywords>TrackingPortlet</keywords>
</portlet-info>
<supported-public-render-parameter>TrackingID
</supported-public-render-parameter>
</portlet>
|
- 주문의 TrackingID를 기반으로 추적 세부 사항을 표시하려면 Tracking 포틀릿의
doView() 메소드를 수정해야 한다(Listing 10 참조).
Listing 10. doView() 메소드의 수정 사항
String renderParam = request.getParameter("TrackingID");
//fetch the tracking id render param which was set in the OrderDetails Portlet
TrackingDetailBean tdb = new TrackingDetailBean();
request.setAttribute(TRACKING_DETAIL_BEAN, tdb);
if (renderParam!=null && renderParam.length()>0) {
PortletURL actionURL =
ShippingUtils.createSimpleActionURL(TRACKING_DETAILS, response);
tdb.setActionURL(actionURL);
PortletURL rdActionURL =
ShippingUtils.createSimpleActionURL(ROUTING_DETAILS, response);
tdb.setRoutingDetailActionURL(rdActionURL);
TrackingDetail td = ShippingDB.getTrackingDetail(renderParam);
if (td != null) {
tdb.setTrackingDetail(td);
getPortletContext().getRequestDispatcher(getJspFilePath
(request, VIEW_JSP)).include(request, response);
} else {
//Tracking id not found; print error page
tdb.setErrorMessage("Tracking Id " + renderParam + " not found.");
getPortletContext().getRequestDispatcher(getJspFilePath
(request, ERROR_JSP)).include(request, response);
}
}
|
포틀릿 프로젝트 게시하기
이제 다음을 수행하여 WebSphere Application Server V6.1에 포틀릿 애플리케이션을 게시할 수 있다.
- 포틀릿 프로젝트를 마우스 오른쪽 단추로 클릭하고(그림 11 참조) Run As > Run on Server를 선택한다.
그림 11. 포틀릿 프로젝트 게시하기
확대하려면 클릭한다.
- 그림 12와 같이 WebSphere Portal V6.1 Server를 선택한다.
- Next를 클릭하고 Finish를 클릭한다.
그림 12. 포틀릿 애플리케이션을 실행할 서버 선택하기
포틀릿 연결하기
포털 서버에서 사용할 수 있는 연결 도구를 사용하여 이벤트를 공유하는 포틀릿 간의 관계를 연결할 수 있다.
연결 도구에 액세스하려면 다음을 수행한다.
- 포틀릿이 배치된 페이지에 대한 Edit Page Layout을 선택한다.
- Wires 탭을 선택한다.
- 드롭다운 메뉴에서 OrdersPortlet을 소스 포틀릿으로 선택하고 OrderDetail 포틀릿을
대상 포틀릿으로 선택한다(그림 13). Sending 및 Receiving 필드의 드롭다운 화살표를
클릭하여 이벤트 이름을 선택한다.
그림 13. 포틀릿 애플리케이션의 관계를 정의하는 연결 추가하기
확대하려면 클릭한다.
- 더하기 기호를 클릭하고 Done을 클릭한다.
- 주문 ID(예: OrdersPortlet의 첫 번째 ID)를 선택한다.
주문 ID를 클릭하면 Orders 포틀릿에서 이벤트가 트리거되면서 Order_ID 값이 OrderDetails 포틀릿에
전달된다. 주문 ID를 받은 OrderDetails 포틀릿이 이벤트를 처리한다. 이 포틀릿은 주문 ID의 세부 사항을
가져와서 사용자에게 표시한다. 또한 OrderDetails 포틀릿은 주문의 추적 ID를 검색하여 TrackingDetails
포틀릿에 전달한다. 이는 TrackingID가 OrderDetails 및 Tracking 포틀릿의 공유 렌더링 매개변수로 추가되었기
때문이다. 이제 사용자가 주문 ID를 클릭하면 주문 세부 사항과 추적 세부 사항이 사용자에게 표시된다(그림 14 참조).
그림 14. Orders 포틀릿
이제 그림 15와 같은 주문 및 추적 세부 사항을 사용자가 볼 수 있다. 이는 이벤트 및 공용 렌더링 매개변수를
통해 OrderID 및 TrackingID가 해당 포틀릿에 성공적으로 전송되었음을 보여 주는 결과이다.
그림 15. Order 및 Tracking 세부 사항 포틀릿
확대하려면 클릭한다.
지금까지 살펴본 것처럼 Rational Application Developer 7.5의 도구를 사용하면 이벤트 및 공용 렌더링 매개변수를
매우 쉽게 작성할 수 있다. 애플리케이션의 요구 사항에 맞게 생성된 코드를 사용자 정의하기만 하면 된다.
다운로드 하십시오 | 설명 | 이름 | 크기 | 다운로드 방식 |
|---|
| How to create events and public render parameters | JSR286EventRenderParam.zip | 63KB | HTTP |
|---|
참고자료 교육
제품 및 기술 얻기
필자소개 | 
| | Lakshmi Priya는 인도의 델리에 있는 IBM India Software Labs 소속으로 Rational Application Developer의
포털 도구 구성 요소와 관련된 업무를 맡고 있는 소프트웨어 개발자이며 Portlet Tooling 하위 구성 요소 팀의
팀장이다. 첫 부서는 방갈로르의 퍼베이시브 컴퓨팅 팀이었으며 포틀릿 및 Eclipse 기반 기술 관련 업무를 수행했다. |
기사에 대한 평가
|
| 이 문서 북마킹 하기
|
| 
