| Enterprise Java Technologies Tech Tips에 오신 여러분을
환영합니다. Java 2 Platform, Enterprise Edition (J2EE)에 기반한
enterprise Java technologies 와 APIs의 사용에 관한 최신 정보를 얻어
가시기 바랍니다. 이 글에서는 Java 2 Java 2, Enterprise Edition,
v 1.4 를 사용합니다. 다운로드
이번 호에서는,
 J2EE 커넥터 아키텍처 1.5
엔터프라이즈 빈의 타이머 인터페이스 사용하기
를 다루게 됩니다.
저자 Robert Eckstein
J2EE 커넥터 아키텍처 1.5
기존 시스템과 J2EE 애플리케이션 서버를 통합하는 작업을 해본 경험이 있다면 그 작업이 결코 쉽지 않다는 것을 알고 있을 것이다. 커넥션을 관리하고 상이한 데이터 타입들을 변환시켜주는 작업, 애플리케이션 서버와 기업 정보 시스템(EIS) 사이의 단순한 메시지 전송조차 자바 프로그래머의 머리를 아프게 만들 수 있다. 하지만 고맙게도 이제 J2EE 커넥터 아키텍처 1.5가 J2EE 1.4 버전에 포함되어 J2EE 플랫폼을 이종 EIS들과 접속시키기 위한 표준 아키텍처를 제공한다.
J2EE 커넥터 아키텍처를 사용하면 EIS 벤더들이 여러 애플리케이션 서버들을 위한 커넥션 소프트웨어를 직접 제작할 필요가 없다. 또한 애플리케이션 서버 벤더들도 다양한 EIS 패키지들을 위해 자신들의 코드를 다시 작성할 필요가 없다. 이제 벤더들은 단순히 J2EE 커넥터 아키텍처 기준에 맞는 "중간" 코드만 패키지 시켜주면 된다. 이 코드는 애플리케이션 서버와 EIS 자원 간의 통신에 필요한 데이터와 메시지를 위해 표준화된 인터페이스와 클래스를 구현하거나 확장 시켜 준다. 이 중간 코드는 애플리케이션 서버에 직접 연결되며 자원 어댑터라 불린다.
자원 어댑터 모듈은 흔히 자원 어댑터 아카이브 (RAR)이라는 명칭을 가지고 있으며 단순한 JAR 파일이다. 보통 RAR은 다음과 같은 사항들을 포함하고 있다.
- 자원 어댑터 컨트렉트와 클라이언트 API를 구현하는 자바 클래스 및 인터페이스
- EIS와의 통신을 위해 필요한 모든 고유 라이브러리
- 애플리케이션 서버가 자원 어댑터를 설정하기 위해 필요한 설치 정의 파일인
ra.xml. 이 파일은 META-INF 디렉토리에 위치
다음 그림은 애플리케이션 서버와 EIS에서 사용되는 자원 어댑터를 도표로 설명한 것이다.
각각의 구성원들이 다른 요소들과 통신하는 방식을 살펴보기 바란다.
J2EE 커넥터 아키텍처를 구성하는 데는 세 가지의 중요한 통신 브릿지가 있다. 각각에 대해 살펴보도록 하자.
클라이언트 API와 공통 클라이언트 인터페이스
애플리케이션 서버에 연결되는 애플리케이션 컴포넌트들은 반드시 자원 어댑터와의 통신 방식을 가지고 있어야 하며, 공통 클라이언트 인터페이스 (CCI)는 이런 통신 방식을 위해 권장되는 API이다. CCI는 javax.resource.cci 패키지에 구현된 API이다. 이 API를 권장하는 이유는 사용하기가 쉬우면서 필수적이지는 않다는 점 때문이다. 만약 CCI가 제공하는 기능이 부족하다면 자원 어댑터 구현자들은 자유롭게 자신만의 클라이언트 API를 제작하여 애플리케이션 컴포넌트와 통신을 할 수도 있다.
컨테이너-컴포넌트 컨트렉트
컨테이너-컴포넌트 컨트렉트는 애플리케이션 서버와 애플리케이션 컴포넌트들 간의 표준 통신 방식이다. JCA에 관련된 내용은 거의 없는데 예를 들어, 만약 웹 애플리케이션이 Enterprise JavaBeans(EJB) 컴포넌트들을 사용한다면 EJB specification은 곧 각각의 EJB 컴포넌트가 애플리케이션과 통신하는 방법을 정의하는 컨테이너-컴포넌트 컨트렉트가 된다.
시스템 컨트렉트
시스템 컨트렉트는 J2EE 커넥터 아키텍처의 주요 부분이다. 이 아키텍처는 자원 어댑터가 애플리케이션 서버와 적절히 통신하기 위해 따라야 하는 몇 가지의 시스템 컨트렉트를 정의하고 있다. 시스템 컨트렉트를 위한 API는 javax.resource.spi 패키지에 구현되어 있다. J2EE 커넥터 아키텍처의 1.0 버전에서는 세 가지의 컨트렉트를 제시하고 있다.
- 접속 관리 컨트렉트: EIS와 애플리케이션 서버 간의 접속을 가능하게 하는 인터페이스와 클래스 제공하며 애플리케이션 서버가 필요에 따라 이러한 커넥션들을 풀링할 수 있도록 해준다.
- 트랜젝션 관리 컨트렉트: EIS에 트랜젝션의 모든 부분을 관리할 수 있는 기능을 제공한다. 이 컨트렉트를 이용하여 EIS를 자원 어댑터 혹은 트랜젝션 관리자로 관리할 수 있다. 그러나 두 가지 방법 중 한 가지 방법으로만 사용할 수 있다. 트랜젝션은 반드시 EIS 외부에서 이루어져야 하며 이를 EIS로 전달해야 한다. 그 반대는 성립되지 않는다.
- 보안 컨트렉트: 애플리케이션 서버와 EIS 간의 적절한 인증이 이루어져 있는지 확인한다.
아키텍처의 1.5 버전은 자원 어댑터의 기능을 확장 시켜 줄 수 있는 4 가지의 새로운 컨트렉트를 제공한다. 이 새로운 컨트렉트들은 다음과 같다.
- 생명 주기 관리 컨트렉트: 애플리케이션 서버가 깨끗하게 자원 어댑터를 시작 혹은 종료 시킬 수 있는 방법 제공
- 작업 관리 컨트렉트: 자원 어댑터가 애플리케이션 서버에서 작업을 실행시킬 수 있도록 인터페이스와 클래스 제공
- 트랜젝션 유입 컨트렉트: EIS에서 애플리케이션 서버로 트랜젝션 전달 가능 (트랜젝션 관리 컨트렉트의 반대 기능) 또한 EIS가 오작동할 경우를 대비하여 트랜젝션 복구 보조
- 메시지 유입 컨트렉트: 자원 어댑터가 애플리케이션 서버 내에서 동기 혹은 비동기 메시지를 엔드포인트로 전달 가능
이 4 가지의 새로운 기능들을 좀더 자세히 살펴보도록 하자.
생명 주기 관리 및 작업 관리 컨트렉트
javax.resource.spi 패키지 안의 ResourceAdapter 인터페이스가 바로 자원 어댑터이다. ResourceAdapter 인터페이스에서 생명 주기 관리를 하는 메소드는 start(), stop()의 두 가지가 있다. start() 메소드는 애플리케이션 서버가 자원 어댑터를 시작하려 할 때(예:자원 어댑터를 배치할 때) 호출되며, stop() 메소드는 애플리케이션 서버가 자원 어댑터를 해제할 때 (예:자원 어댑터를 배치 해제할 때) 호출된다.
작업 관리 컨트렉트는 javax.resource.spi.work 패키지의 Work 인터페이스를 확장하는 객체를 생성함으로써 자원 어댑터가 애플리케이션 서버에 작업을 전달할 수 있도록 해준다. Work 인터페이스는 Runnable 인터페이스의 확장이다. Work 인터페이스에는 Runnable 인터페이스에서 상속받고 자신의 쓰레드에서 실행시키는 run() 메소드뿐만 아니라 release() 메소드도 포함되어 있다. 애플리케이션 서버는 release() 메소드를 사용하여 쓰레드가 완료되면 그 자원을 가능하면 빨리 해제할 수 있도록 해준다.
다음은 ResourceAdapter 인터페이스를 사용하여 생명 주기 관리 및 작업 관리 컨트렉트를 사용하는 예시이다.
public class NexesResourceAdapterImpl implements
ResourceAdapter {
// Ten seconds
public static final long WORK_START_TIMEOUT = 10000L;
public NexesResourceAdapterImpl() { }
public void start(BootstrapContext ctx)
throws ResourceAdapterInternalException
{
WorkManager workManager = ctx.getWorkManager();
Work nexesWorkJob = new NexesWorkImpl();
WorkListener workListener =
new NexesWorkListenerImpl();
try {
// Unlike scheduleWork() or doWork(), this call
// blocks until the work has started. If it takes
// longer than 10 seconds for the work to start,
// the call throws a WorkRejectedException.
workManager.startWork
(nexesWorkJob, WORK_START_TIMEOUT,
new ExecutionContext(), workListener);
} catch (WorkException e) {
// Handle the exception
}
}
public void stop()
{
// Do whatever you need to do here to close down the
// resource adapter.
}
// Transaction Inflow contract methods omitted.
// See the section "Message Inflow and Transaction
// Inflow Contracts"
}
BootstrapContext 인터페이스를 구현하는 start() 메소드로 객체가 전달되는 것을 볼 수 있다. 이 객체는 EIS가 트랜젝션 정보와 작업을 애플리케이션 서버에 전달할 수 있도록 해주는 매우 중요한 객체이다. BootstrapContext 인터페이스에 관련된 상세한 정보는 "메시지 유입 및 트랜젝션 유입 컨트렉트" 섹션을 참조하시기 바란다.
또한 WorkListener 인터페이스에 대한 참조도 확인하기 바란다.
WorkListener workListener =
new NexesWorkListenerImpl();
and the startWork method:
workManager.startWork
(nexesWorkJob, WORK_START_TIMEOUT,
new ExecutionContext(), workListener);
만약 애플리케이션 서버가 처리 중인 작업에 대한 진행 상황을 보고 받고 싶다면 javax.resource.spi.WorkListener 인터페이스를 구현하는 객체를 생성하면 된다. 그 다음 이 객체를 애플리케이션 서버 상의 WorkManager 객체의 startWork() 메소드를 사용하여 등록하면 된다. WorkManager 인터페이스는 Work 인스턴스를 실행 시킬 수 있는 기능을 제공한다. 객체를 등록함으로써 작업이 거절 혹은 수락되었는지, 수락되었다면 언제 작업이 시작되었고 종료되었는지를 서버가 자원 어댑터에게 알려줄 수 있다. 또한 WorkAdapter 클래스를 확장시킬 수 있는데, 이 클래스는 WorkListener 인터페이스를 구현하고 각각에 대해 빈 메소드를 제공한다. 다음은 WorkListener를 구현하는 간략한 코드이다.
public class NexesWorkListenerImpl implements WorkListener {
public void workAccepted(WorkEvent e) {
// myAppServerLog.log("Work instance " + e +
// " has been accepted.");
}
public void workRejected(WorkEvent e) {
// myAppServerLog.log("Work instance " + e +
// " has been rejected.");
}
public void workStarted(WorkEvent e) {
// myAppServerLog.log("Work instance " + e +
// " has been started.");
}
public void workCompleted(WorkEvent e) {
// myAppServerLog.log("Work instance " + e +
// " has been completed.");
}
}
메시지 유입 및 트랜잭션 유입 컨트렉트
메시지 유입 컨트렉트는 애플리케이션 서버가 메시지 엔드포인트를 활성화/비활성화 시키는 호출에 대해 자원 어댑터가 반응할 수 있도록 해준다. ResourceAdapter 인터페이스의 endpointActivation() 메소드가 엔드포인트 활성화시 호출되며, 이는 자원 어댑터가 메시지 엔드포인트에 메시지를 전달할 때 필요한 설정을 하도록 한다. ResourceAdapter의 endpointDeactivation() 메소드는 메시지 엔드포인트가 비활성화될 때 호출되며, 이는 리소스 어댑터가 메시지 엔드포인트에게 메시지를 전달하는 것을 멈추게 한다. javax.resource.spi.endpoint 패키지의 MessageEndpointFactory 객체가 endpointActivation 메소드에 전달된다. 자원 어댑터는 이 객체를 사용하여 메시지 엔드포인트를 생성하게 되며, 이러한 엔드포인트들에 대한 모든 정보는 endpointDeactivation() 메소드가 호출되면 자원 어댑터에서 제거되야 한다. 마지막으로 ResourceAdapter의 getXAResources() 메소드는 시스템에 오류가 생길 경우에 트랜잭션 자원을 복구하는데 사용된다. endpointActivation(), endpointDeactivation(), getXAResources()메소드들은 ResourceAdapter 인터페이스에 위임된다.
public class NexesResourceAdapterImpl implements
ResourceAdapter {
// Lifecycle Contract methods from earlier omitted.
public XAResource[] getXAResources(ActivationSpec[] specs)
throws ResourceException
{
// This method should either return an array of
// XAResource objects that uniquely correspond to the
// resource manager given the ActivationSpecs passed
// in, or null if it does not support this par
// of the Message Inflow contract.
return null;
}
public void endpointActivation(MessageEndpointFactory mef,
ActivationSpec as)
throws NotSupportedException
{
// This is also part of the Message Inflow contract.
// The idea here is to create a message endpoint
// using the MEF's createEndpoint() method, which is
// then stored in the ActivationSpec class. This binds
// the EIS and the application server together so that
// the two can communicate independently of the
// messaging style of the EIS.
}
public void endpointDeactivation(MessageEndpointFactory mef,
ActivationSpec as)
{
// This removes any resources that were created by the
// endpointActivation() method above for the specified
// messaging endpoint. The resource adapter must notify
// any message providers that the endpoint is no longer
// valid
}
}
ResourceAdapter 메소드에 전달되는 ActivationSpec 클래스는 JavaBean으로써, 다양한 속성들의 정보를 입수/설정하는 메소드들을 구현한다. 이러한 입수/설정 메소드들 이외에도 구현은 반드시 validate() 메소드를 제공하여 모든 속성들이 적법하게 설정되어 있는지 확인해야 한다. 만약 속성이 적절히 설정되어 있지 않다면 메소드는 InvalidPropertyException을 반환하게 된다. ActivationSpec 객체가 equals()를 오버라이드할 수 없다는 점에 유의하기 바란다.
public class MyActivationSpec implements ActivationSpec,
Serializable {
public void setMyProperty(MyProperty s) { }
public MyProperty getMyProperty() { }
public void validate() throws InvalidPropertyException { }
}
J2EE 커넥터 아키텍처 버전 1.0의 경우, 자원 어댑터는 자기 자신 혹은 외부 트랜잭션 관리자로부터 EIS에만 트랜잭션 정보를 전달할 수 있었다. 그러나 1.5 버전에 포함된 트랜잭션 유입 컨트렉트에 의해 자원 어댑터가 EIS 트랜잭션 요구를 애플리케이션 서버에 전달할 수 있게 됨은 물론, 생명주기 컨트렉트의 start() 메소드에 전달된 BootstrapContext 오브젝트 또한 사용할 수 있게 되었다. BootstrapContext 인터페이스는 생명주기 관리 contract의 부분에서 잠깐 언급된바 있다. 다음은 BootStrapContext 인터페이스 내의 메소드이다.
public class NexesBootstrapContextImpl implements
BootstrapContext {
public WorkManager getWorkManager() {
// Get the work manager from the application server
}
public XATerminator getXATerminator() {
return new NexesXATerminatorImpl();
}
public Timer createTimer() {
return new Timer();
}
}
이제 XATerminator 인터페이스에 대해 자세히 알아보자. BootStrapContext 인터페이스의 getXATerminator() 메소드의 반환값에 유의하기 바란다. XATerminator 인터페이스는 트랜잭션 터리를 위해 5가지의 간단한 메소드를 제공한다
public class NexesXATerminatorImpl implements XATerminator {
public void commit(Xid xid, boolean onePhase)
throws XAException { }
public void forget(Xid xid) throws XAException { }
public int prepare(Xid xid) throws XAException { }
public Xid[] recover(int flag) throws XAException { }
public void rollback(Xid xid) throws XAException { }
}
자원 어댑터 파일
자원 어댑터 디스크립터 파일인 ra.xml은 매우 쉽게 생성할 수 있다. 이는 단순히 ResourceAdapter 인터페이스를 구현하는 클래스를 파일에 가리키는 것만으로 이루어 진다. 그러면 애플리케이션 서버가 이 객체에 접근하게 된다. J2EE Connector Architecture 1.5 specifications을 참조하면 수신 메시지 클래스를 ActivationSpec 클래스와 묶는 방법 등을 포함하여 자원 어댑터의 배치 디스크립터에 대한 상세한 정보를 얻을 수 있다. 모든 배치 디스크립터와 마찬가지로 ra.xml 파일은 WAR 파일의 WEB-INF 디렉토리 내에 위치하고 있어야 한다.
<?xml version="1.0" encoding="UTF-8"?>
<connector xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/connector_1_5.xsd"
version="1.5">
<display-name>Skeleton Resource Adapter</display-name>
<vendor-name>Sun Microsystems, Inc.</vendor-name>
<eis-type>Unknown</eis-type>
<resourceadapter-version>1.0</resourceadapter-version>
<resourceadapter>
<resourceadapter-class>
com.nexes.ra.NexesResourceAdapterImpl
</resourceadapter-class>
</resourceadapter>
</connector>
J2EE 커넥터 아키텍처에 대한 상세한 정보를 위해서는 J2EE Connector Architecture page를 참조하기 바란다.
JAVASERVER FACES 기술과 사용자 정의 컴포넌트
Improving
Designs With the MVC Design Pattern에서는 모델, 뷰, 컨트롤러
(MVC 혹은 Model2)라는 아키텍처 패턴에 대해 소개하고 있다. MVC는 컴퓨터 과학의
분야에서는 보편적으로 사용되는 패턴이며 또한 JavaServer Faces(JSF) 기술을 이해하기
위해 반드시 필요하다. 이 패턴은 애플리케이션의 데이터 및 비즈니스 로직을 시각적 표시 방식과
분리 시킨다. 데이터 및 비즈니스 로직은 모델이라는 객체에 저장되며, 시각적 표시 방식은 별도의
객체인 뷰에 저장된다. 이 두 개의 객체들은 또다른 객체인 컨트롤러로 함께 연결되어 있다. 컨트롤러는
뷰에서의 입력에 반응하여 그에 따라 모델 데이터를 갱신한다. 이러한 디자인의 장점은 비즈니스
로직 혹은 데이터에 대한 변화가 생겨도 뷰에 영향을 주지 않고 모델을 유지할 수 있다는 것이다.
모델에 영향을 주지 않고 다수의 뷰를 생성할 수 있다.
Introducing JavaServer Faces Technology 에서는 JSF 프레임워크의 모델을 사용하여 GUI 컴포넌트를 사용하는 JSF 애플리케이션을 개발하는 방법에 대해 소개하고 있다. 이 팁을 통해서 JSF 기술을 사용하여 사용자 정의 컴포넌트를 생성하는 방법을 배울 수 있다. 좀더 정확히 말해, 간단한 주식 상황을 보여주는 JSF 기술 기반의 사용자 정의 컴포넌트를 개발할 수 있다. 함께 제공된 JavaServer Pages (JSP)를 통해 사용자는 주식 기호를 입력 텍스트 필드에 삽입하고 전송 버튼을 클릭하도록 할 수 있으며, 이에 대해 사용자의 컴포넌트는 텍스트 필드 밑에 테이블을 표시한다. 이 테이블에는 주식의 기호, 주식의 현재 가격, 그리고 일일 주식 가격 변동을 포함하고있다.
이 팁은 독자가 JSF 기술의 기본에 익숙하며 JSP 기술을 이용하여 사용자 정의 태그 라이브러리를 생성할 수 있다고 가정하고 있다. JSF 기술의 기본에 대해서는 An Introduction to JavaServer Faces를 참조하시기 바란다. 자신만의 JSP 태그 라이브러리를 생성하는 것에 대한 정보는 J2EE 1.4 튜토리얼의 Using Custom Tags를 참조하시기 바란다.
사용자 정의 컴포넌트를 생성하기 위해서는 다음과 같은 사항이 요구된다.
- · 주식 데이터를 회수하기 위해 사용되는 JavaBean 모델 클래스 생성
javax.faces.component.UIComponent를 확장하는 사용자 정의 JSF 뷰 출력 컴포넌트 클래스 생성
javax.faces.render.Renderer를 확장하는 사용자 정의 JSF 뷰 클래스 생성
- 사용자 정의 태그를 사용하여 사용자 정의 컴포넌트를 JSF 프레임워크에 통합
- 입력 텍스트 필드를 포함하는 JSP 페이지 생성, 그리고 사용자 정의 컴포넌트의 입력 텍스트 필드를 위한 백그라운드 빈
다음은 이러한 객체들이 MVC 아키텍처에 적용되는지에 대한 도표이다.
JavaBean 모델 생성
주식 컴포넌트의 모델은 회수/설정 접근 메소드를 이용하여 데이터를 저장 및 회수하는 기능을 갖춘 간단한 JavaBean 클래스이다. 이 빈에는 retrieveStock()이라는 메소드가 있어 사용자가 주식 기호를 입력하면 UI 컴포넌트가 이 메소드를 호출한다. 이 메소드는 입력된 주식 기호를 받아 적절하게 모델 정보를 갱신한다.
이 팁에 포함된 예시에는 주식 컴포넌트에 대한 모든 소스 코드가 포함되어 있다. 모델 컴포넌트인 StockModel 클래스에 대한 다음과 같은 소스 코드를 찾을 수 있을 것이다.
public class StockModel {
private String selectedStock = "UNKNOWN";
private String currentValue = "0";
private String dailyChange = "0";
public String getSelectedStock() { return selectedStock; }
public String getCurrentValue() { return currentValue; }
public String getDailyChange() { return dailyChange; }
public void retrieveStock(String stockSubmitted) {
selectedStock = stockSubmitted;
currentValue = "23.5";
dailyChange = "+2.5";
}
}
일반적으로 retrieveStock()과 같은 메소드는 데이터베이스에 접근하여 데이터를 회수하지만 단순화를 위해 이 클래스의 메소드는 클래스에 정의된 컨스턴트 스트링을 이용하여 모델을 갱신한다.
UI 컴포넌트 생성
뷰의 한 부분인 UI 컴포넌트의 주 목적은 모델로부터 데이터를 회수하여 자신이 직접 이를 표시하거나, 필요에 따라 사용자 정의 renderer에 데이터를 전달하여 표시할 수 있도록 하는 것이다. 사용자 정의 UI 컴포넌트는 javax.faces.component.UIComponent를 확장한다. 이 클래스는 javax.faces.component.UIOutput을 확장하며 UIOutput 클래스는 UIComponent 클래스의 서브 클래스이다. 사용자 정의 컴포넌트에서 필요한 뷰의 많은 기능들이 이미 UIOutput을 통하여 제공된다. 이 클래스에 추가될 것은 단지 컴포넌트 패밀리의 정의에 대한 스트링(이는 후에 자원 디스크립터의 입력값과 동일해야함)을 반환하는 getFamily() 메소드이다. 다음은 UIStockChoiceOutput: 클래스에 대한 소스 코드이다.
public class UIStockChoiceOutput extends UIOutput {
public static final String STOCK_FAMILY = "StockFamily";
public UIStockChoiceOutput() {
super();
}
public String getFamily() {
return STOCK_FAMILY;
}
}
사용자 정의 renderer 생성
다음 과정은 JSF 컴포넌트가 클라이언트 브라우저에 어떻게 표시될 것인지를 결정하는 renderer를 생성하는 것이다. 이는 javax.faces.render.Renderer 클래스를 확장하는 사용자 정의 뷰 클래스이다. 이 renderer의 목적은 주식 정보 표시를 위한 HTML 테이블을 생성하는 것이다. 비록 이 경우에는 해당하지 않지만 renderer는 입력값을 렌더링할 수도 있다. 따라서 renderer는 두 종류의 변환 서비스를 수행한다. 우선 모든 입력 데이터를 컨트롤러로 전달할 수 있는 형식으로 디코딩 시켜주는 것과 컨트롤러 객체로부터의 모든 데이터를 엔코딩하여 브라우저로 렌더링시켜주는 것이다. 디코딩은 renderer의 decode() 메소드를 통해서 실행되며, 엔코딩은 여러 가지 방식의 엔코딩 방법을 통해 가능하다. 다음 예제는 encodeEnd() 메소드를 사용하고 있다. 아래에는 renderer(그리고 사용자 정의 뷰 컴포넌트)인 SimpleStockRenderer의 소스 코드를 일부 발췌한 것이다.
public class SimpleStockRenderer extends Renderer {
public void encodeEnd(FacesContext context,
UIComponent component) throws IOException
{
if (!component.isRendered())
return;
String selectedStock =
(String)component.getAttributes().get("selectedStock");
String currentValue =
(String)component.getAttributes().get("currentValue");
String dailyChange =
(String)component.getAttributes().get("dailyChange");
String id = (String)component.getClientId(context);
ResponseWriter out = context.getResponseWriter();
out.startElement("table", component);
out.writeAttribute("border", "0", "border");
out.startElement("tr", component);
out.writeAttribute("bgcolor", "#000077", "bgcolor");
writeTableHeader(out, component, "Stock Symbol");
writeTableHeader(out, component, "Current Value");
writeTableHeader(out, component, "Daily Change");
out.endElement("tr");
out.startElement("tr", component);
out.writeAttribute("bgcolor", "#FFFFFF", "bgcolor");
writeTableEntry(out, component, selectedStock);
writeTableEntry(out, component, currentValue);
writeTableEntry(out, component, dailyChange);
out.endElement("tr");
out.endElement("table");
}
// Methods writeTableEntry() and writeTableHeader() omitted
}
FacesContext 객체와 UIComponent 객체가 encodeEnd() 메소드에 전달되는 것에 유의하기 바란다. FacesContext 객체는 JSF 환경에 대한 정보를 담고 있으며, UIComponent는 Controller 객체의 참조 객체이다. encodeEnd() 메소드는 UIComponent 컨트롤러를 통해 모델 데이터를 회수하고 ResponseWriter 객체를 생성한다. 이 메소드는 이 객체를 사용하여 HTML 요소와 헤더를 포함한 HTML 테이블의 속성을 작성하게 된다. Renderer 클래스에는 이 이외에도 다양한 엔코딩 메소드가 있다. 이러한 메소드들에 대한 좀더 자세한 정보는 JSF specification을 참조하기 바란다.
백그라운드 빈 생성
다음 과정은 입력 컴포넌트를 위한 백그라운드 빈을 생성하는 것이다. 백그라운드 빈은 입력 주식을 위한 스트링 기반의 속성 접근자를 제공할 뿐만 아니라 결과 테이블이 보여져야 하는지 보여주는 (렌더링된) 불리언도 제공합니다. 인증자가 소스 코드에 추가되었다는 점에 유의하기 바란다. 만약 입력 값이 부적절하다면 렌더링된 불리언은 거짓으로 설정되며 renderer는 결과 테이블을 표시하지 않는다. 백그라운드 빈에 대한 소스 코드는 다음과 같다.
public class InputBackingBean {
private String inputStock = "";
private boolean rendered = false;
public void setStockOutputRendered(boolean r)
{ rendered = r; }
public boolean getStockOutputRendered()
{ return rendered; }
public String getInputStock() { return inputStock; }
public void setInputStock(String stock)
{ inputStock = stock; }
public void validateStock
(FacesContext ctx, UIComponent component, Object value)
throws ValidatorException
{
public void validateStock(FacesContext ctx,
UIComponent component, Object value)
throws ValidatorException
{
String string = (String)value;
if ((value.equals("AAA")) || (value.equals("BBB")) ||
(value.equals("CCC")) || (value.equals("DDD")) ||
(value.equals("EEE")) || (value.equals("FFF")) ||
(value.equals("GGG")) || (value.equals("HHH"))) {
rendered = true;
} else {
rendered = false;
throw new ValidatorException(
new FacesMessage
("Invalid Stock Entry: (Enter AAA,BBB, etc.)"));
}
}
public String inputStockSubmitted() {
FacesContext context = FacesContext.getCurrentInstance();
StockModel model = (StockModel)
context.getApplication().getVariableResolver().resolveVariable(
context, "StockModel");
model.retrieveStock(inputStock);
return "Input Stock Accepted";
}
}
inputStockSubmitted() 메소드는 매우 중요하다. 이 메소드는 액션 속성인 code><h:commandButton> (JSP 페이지의 submit 버튼)에 연결되어 있다. 활성화 되면 이 메소드는 현재의 페이스 내용을 바탕으로 StockModel을 회수하게 된다. 그 후 retrieveStock() 메소드가 모델에 호출되어 결과 테이블의 주식 정보를 갱신하게 된다.
최종 작업
사용자 정의 컴포넌트를 사용하기 위해서는 몇 가지 추가 작업이 필요하다. 컴포넌트를 사용하기 위해서는 JSP 프레임워크가 JSP 파일과의 데이터 통신을 위해서 사용하는 사용자 정의 태그 라이브러리 클래스가 필요하다. SimpleStockInputTag.java 클래스는 이번 팁에서 사용되는 사용자 정의 태그 라이브러리 클래스이다. 이번 팁에서 사용하는 이 사용자 정의 태그 라이브러리는 "stock"이라고 부른다.
또한 JSF 프레임워크는 모델 빈을 사용자 정의 태그에 연결시킬 방법을 필요로 한다. 이는 표준 JSP 태그 라이브러리 디스크립터 파일을 사용하여 해결된다. JSP 태그 라이브러리 디스크립터 파일인 stock.tld는 예제의 WEB-INF/lib 디렉토리에서 찾아 볼 수 있다.
사용자 정의 컴포넌트 객체들은 반드시 JSF 아키텍처에 등록되어 있어야 한다. 이는 WEB-INF 디렉토리 내의 faces-config.xml을 통해서 가능하다.
마지막으로 submit 버튼을 제공하고 컴포넌트를 표시하기 위해 JSP 페이지가 필요하다. 다음은 컴포넌트를 표시해주는 대부분의JSP 페이지인 Stock.jsp이다.
...
<%@taglib prefix="stock"
uri="http://nexes.org/example/stock"%>
<html>
<head>
<title>Stock Choice Example</title>
</head>
<body>
<h2>Please Enter a Stock Symbol</h2>
<f:view>
<p>
<h:messages id="messageList" showSummary="true"/>
</p>
<h:form>
<h:inputText value="#{InputBackingBean.inputStock}"
validator="#{InputBackingBean.validateStock}" />
<h:commandButton value="Submit"
action="#{InputBackingBean.inputStockSubmitted}" />
<stock:stockOutput id="symbol"
rendered="#{InputBackingBean.stockOutputRendered}"
selectedStock="#{StockModel.selectedStock}"
currentValue="#{StockModel.currentValue}"
dailyChange="#{StockModel.dailyChange}" />
</h:form>
</f:view>
</body>
</html>
예제 코드 실행
예제 파일들을 다운로드 받으세요. 이 애플리케이션의 루트는 ttnov2004이며, 다운로드된 war 파일에는 예제의 모든 소스 코드가 포함되어 있습니다.
애플리케이션 파일들(ttnov2004.war)을 J2EE 1.4 애플리케이션 서버에 설치하려면 deploytool 프로그램 혹은 관리자 콘솔을 사용해야 합니다. 혹은 아래와 같이 asadmin 명령어를 입력하여 설치를 할 수도 있습니다.
asadmin deploy install_dir/ttnov2004.war
install_dir을 war 파일을 설치한 디렉토리로 대체하십시오.
애플리케이션은 http://localhost:8000/ttnov2004를 통해서 접속할 수 있습니다.
J2EE 1.4 애플리케이션 서버 이외의 J2EE 1.4 호환 설치를 위해서는 J2EE 제품의 설치 툴을 사용하여 원하는 플랫폼에 애플리케이션을 설치하시기 바랍니다.
애플리케이션을 시작하면 아래와 같은 페이지가 나타납니다. (페이지 전체가 나타나 있지는 않습니다.)
사용자 정의 컴포넌트 링크를 클릭하세요. 주식 기호를 입력하라는 페이지가 나타날 것입니다. AAA 혹은 BBB와 같은 주식 기호를 데이터 필드에 입력하면, 입력값에 따라서 적절한 주식 정보가 테이블에 나타납니다.
만약 인증자가 판단하였을 때, 잘못된 주식 기호를 입력 받으면 이 컴포넌트는 JSP 페이지에서 <h:messages> 태그와 함께 표시되는 FacesMessage를 생성합니다. 예를 들어 만약 ABC 기호를 입력하면 "Invalid Stock Entry ..."라는 메시지가 나타납니다.
본 메일은 수신을 동의한 회원님에게만 발송됩니다. 관련문의 : SunKorea@sun.com
본 메일의 수신을 거부하시려면 수신거부를
클릭해 주세요.
Copyright 2003-2005 Sun Korea, Inc. All rights reserved.
|
