제5장 External Resource

내용 목차

5.1. 리소스 종류
5.2. 리소스 설정
5.2.1. 데이터소스 설정
5.2.2. 메일 소스 설정
5.2.3. URL 소스 설정
5.2.4. Custom Resource 설정
5.2.5. External Source 설정
5.2.6. External Resource 설정

본 장에서는 JEUS와 연동하여 하나의 시스템을 구축할 수 있는 다양한 외부 리소스(External Resource)에 대한 소개와 설정 방법에 대해 설명한다. 외부 리소스에 대한 설정이나 사용법에 관한 자세한 내용들은 각 외부 리소스의 안내서를 참고한다.

5.1. 리소스 종류

External Resource는 애플리케이션이 JEUS를 통해서 접근할 수 있는 JEUS 외부에 존재하는 리소스로 DB가 대표적인 예이다. 이러한 리소스들은 JEUS에 관련 설정을 추가함으로써 연결이 가능하다.

참고

만약 External Resource에서 JCA 표준 호환의 리소스 어댑터를 제공하는 경우에는 리소스 어댑터를 deploy해서 사용하길 권장한다.

다음은 JEUS에 설정할 수 있는 리소스이다.

  • 데이터소스

    데이터소스(Datasource)는 JDBC 호환 DB를 의미한다.

    데이터소스는 클라이언트에서 직접적으로 접근할 수 있는데 이런 경우에는 특별히 JEUS에 설정하지 않아도 된다. 그러나 데이터소스를 설정하면 JNDI를 이용해서 JDBC Connection Pool을 사용할 수 있으므로 애플리케이션이 더욱 편리하게 DB에 접근할 수 있다. 데이터소스의 설정은 “제6장 DB Connection Pool과 JDBC”를 참고한다.

  • Mail Resource

    메일 리소스(Mail Resource)는 SMTP와 같은 메일 프로토콜을 이용하여 클라이언트 애플리케이션으로부터 이메일(e-mail)을 전송할 때 사용한다. JEUS에서는 JNDI Export name에 이메일 호스트의 정보를 bind하고, 클라이언트에서 간접적으로 접근하여 호스트를 사용하도록 한다. JNDI를 Lookup하면 javax.mail.Session 타입의 메일 소스를 가져온다.

  • URL Resource

    URL 리소스(URL Resource)는 애플리케이션에서 외부 URL 객체를 JNDI를 통해 접근할 수 있도록 한다. URL이 변경되는 경우 해당 URL 설정을 수정함으로써 애플리케이션의 소스 수정 없이 그대로 사용할 수 있도록 한다. JNDI를 Lookup하면 java.net.URL 타입의 URL 객체를 가져온다.

  • Message Bridge

    Message Bridge는 여러 JMS 벤더의 Destination 사이에 연결을 위해 사용된다. JMS 1.1 스펙을 충족하는 MQ라면 무엇이든 설정 가능하며 자세한 내용은 JEUS MQ 안내서”의 “6.1. JEUS MQ Message Bridge”를 참고한다.

  • Custom Resource

    Custom Resource는 Java Bean 형태의 리소스를 JNDI repository에 bind 시킬 수 있다. lookup할 때 JNDI ObjectFactory를 통해 등록한 서비스를 사용할 수 있도록 하는 일반적인 리소스이다.

  • External Source - IBM MQ, Sonic MQ 등

    JEUS와 연결할 수 있는 비정규화된 소스들을 말한다. 일반적으로 JEUS에 설정할 수 있는 것으로는 IBM MQ, Sonic MQ 등의 JMS(Java Message Service) 제품들과 Tmax TP Monitor 등이 있다. 이 리소스들은 JEUS에 설정하지 않아도 Java API를 통해서 직접적으로 액세스할 수도 있다. 그러나 트랜잭션 매니저에서 이 소스들을 관리하려면 설정을 해야 한다(“제7장 트랜잭션 매니저” 참조).

  • External Resource

    JEUS위에서 동작하는 리소스들을 말한다. 주로 JEUS와 연동되는 WebT나 jTmax, 또는 InifiniteCache에서 사용한다. JEUS에서 이런 External Resource를 사용하려면 jeus.external.ResourceBootstrapper 를 구현한 class를 등록해야 한다.

5.2. 리소스 설정

본 절에서는 각각의 리소스를 WebAdmin을 통해 설정하는 방법을 설명한다.

리소스는 도메인 범위에 설정하고, 서버가 부팅할 때 이 정보를 읽어 자신의 서버에 리소스를 등록한다.

WebAdmin의 왼쪽 메뉴에서 [Resources]를 선택하면 각 리소스를 조회하고 서버에 등록, 변경 또는 삭제할 수 있다.

[그림 5.1] WebAdmin에서 리소스 설정

WebAdmin에서 리소스 설정


5.2.1. 데이터소스 설정

데이터소스는 DB 관련 설정을 다루게 된다. 이 내용은 “제6장 DB Connection Pool과 JDBC”에 기술되어 있으므로 해당 절을 참고한다.

5.2.2. 메일 소스 설정

JEUS에 클라이언트 애플리케이션에서 메일을 보낼 때 사용될 SMTP 호스트를 설정할 수 있다. WebAdmin을 통해서 각각의 SMTP 서버마다 각각의 이메일 호스트에 대한 정보를 설정한다. 이메일 호스트에 대한 정보는 JavaMail 스펙을 참고한다.

WebAdmin의 왼쪽 메뉴에서 [Resources] > [Mail Source]를 선택하면 도메인에 등록된 메일 소스를 조회할 수 있다.

[그림 5.2] WebAdmin에서 메일 소스 설정 (1)

WebAdmin에서 메일 소스 설정 (1)


[ADD] 버튼을 클릭하면 도메인에 메일 소스를 등록할 수 있다.

[그림 5.3] WebAdmin에서 메일 소스 설정 (2)

WebAdmin에서 메일 소스 설정 (2)


참고

'Main Property'에 설정하는 속성명은 JavaMail 스펙을 따르므로 스펙을 참고해서 지정한다.

5.2.3. URL 소스 설정

다음은 JNDI 이름은 PRIMARY_URL과 SECONDARY_URL이고 각각에 bind되는 URL은 다음과 같다.

http://www.foo.com
http://www.bar.com

WebAdmin의 왼쪽 메뉴에서 [Resources] > [URL Source]를 선택하면 URL 소스를 조회하고 등록, 변경, 삭제할 수 있는 화면으로 이동한다.

[그림 5.4] WebAdmin에서 URL 소스 설정 (1)

WebAdmin에서 URL 소스 설정 (1)

[ADD] 버튼을 클릭하면 도메인에 URL 소스를 등록할 수 있다.

[그림 5.5] WebAdmin에서 URL 소스 설정 (2)

WebAdmin에서 URL 소스 설정 (2)

5.2.4. Custom Resource 설정

Custom Resource는 Java Bean 형태의 리소스를 JNDI ObjectFactory를 통해 Lookup하여 사용할 수 있도록 하는 일반적인 리소스이다. 본 절에서는 Custom Resource 구현 방법과 등록 방법에 대해서 설명한다

다음은 JavaBean 형태의 리소스 클래스와 리소스 인스턴스를 생성할 ObjectFactory 클래스에 대한 예제이다. 이 클래스는 SERVER_HOME/lib/application 또는 DOMAIN_HOME/lib/application에 있어야 한다.

[예 5.1] Custom Resource 예제 클래스

package dog;

import java.util.Hashtable;
import javax.naming.Context;
import javax.naming.Name;
import javax.naming.spi.ObjectFactory;

public class DogFactory implements ObjectFactory {    
    public DogFactory() {}

    public Object getObjectInstance(Object obj, Name name, Context nameCtx, Hashtable<?, ?> environment) 
        throws Exception {
        Dog dog = Dog.getInstance();
        System.out.println("Creating a dog whose name is " + dog.getName() + ", 
and age is " + dog.getAge());
        return dog;
    }
}

[예 5.2] Custom Resource를 생성할 팩토리 클래스의 예제

package dog;

public class Dog implements java.io.Serializable {
    public static final String DOG_NAME = "wangwang";
    public static final int DOG_AGE = 1;
    
    private static Dog instance = new Dog();
    
    private int age = DOG_AGE;
    private String name = DOG_NAME;
    
    public Dog() {}
    
    public static Dog getInstance() {
        return instance;
    }
    
    public int getAge() {
        return age;
    }
    
    public void setAge(int age) {
        this.age = age;
    }
    
    public String getName() {
        return name;
    }
    
    public void setName(String name) {
        this.name = name;
    }

    public boolean equals(Object anObject) {
        if (this == anObject) {
           return true;
        }
        if (anObject instanceof Dog) {
           Dog anotherDog = (Dog) anObject;
           return (this.age == anotherDog.age && this.name.equals(anotherDog.name));
        }
        return false;
    }
    
}

참고

Custom Resource를 동적으로 추가하기 위해서는 이미 해당 클래스들이 서버의 클래스 로더에 클래스 패스로 잡혀있어야 가능하다. 만약 서버의 클래스 로더에서 이 클래스를 로딩할 수 없으면 동적 추가 명령은 pending 처리된다. 이럴 경우 Custom Resource 클래스를 SERVER_HOME/lib/application 또는 DOMAIN_HOME/lib/application에 추가하고 서버를 재기동해야 한다.

Custom Resource를 삭제하는 동작은 Graceful하게 수행되지 않는다. 즉, 진행 중인 요청이 있더라도 이를 완료하지 않기 때문에 사용자 애플리케이션에서는 에러가 발생할 수 있음을 유의한다.

WebAdmin 사용

다음은 WebAdmin에서 동적으로 Custom Resource를 등록하는 방법에 대해 알아본다.

  1. WebAdmin의 왼쪽 메뉴에서 [Resources] > [Custom Resource]를 선택한다.

    [그림 5.6] WebAdmin에서 Custom Resource 설정 (1)

    WebAdmin에서 Custom Resource 설정 (1)


  2. [ADD] 버튼을 클릭하여 도메인에 등록하려고 하는 Custom Resource의 설정 정보를 입력하고 [확인] 버튼을 클릭한다.

    [그림 5.7] WebAdmin에서 Custom Resource 설정 (2)

    WebAdmin에서 Custom Resource 설정 (2)


  3. [확인] 버튼을 클릭해서 임시저장을 하면 화면 상단에 임시저장 결과에 대한 메시지가 나타난다. 또한 Custom Resource 테이블에 추가할 리소스 정보가 나타난다.

    [그림 5.8] WebAdmin에서 Custom Resource 설정 (3)

    WebAdmin에서 Custom Resource 설정 (3)


  4. 추가한 Custom Resource를 서버에서 사용할 수 있도록 서버 설정에 Custom Resource를 추가한다.

    WebAdmin 왼쪽 메뉴에서 [Servers] > [Server1] > [Basic Info] > Custom Resource Refs 목록에서 도메인에 추가한 Custom Resource를 선택하고 [확인] 버튼을 클릭한다.

    [그림 5.9] WebAdmin에서 Custom Resource 설정 (4)

    WebAdmin에서 Custom Resource 설정 (4)


  5. [Activate Changes] 버튼을 클릭하여 Custom Resource를 도메인에 반영한다. 다음과 같이 화면 상단에서 Custom Resource가 도메인에 반영되었다는 메시지를 확인할 수 있다. 해당 Custom Resource는 추가한 서버에서 바로 사용가능하다.

콘솔 툴 사용

Custom Resource는 콘솔 툴을 통해서 서버에 등록된 리소스에 대한 조회 명령이 가능하다. 또한 새로운 Custom Resource를 동적으로 추가, 삭제하는 것이 가능하다.

[DAS]domain1.adminServer>add-custom-resource custom/dog -resource dog.Dog -factory dog.DogFactory
Successfully performed the ADD operation for A custom resource.
Check the results using "list-custom-resources or add-custom-resource"

[DAS]domain1.adminServer>list-custom-resources
List of Custom Resources
================================================================================
+-------------+--------------------+--------------------------+----------------+
| Export Name |   Resource Class   |       Factory Class      |   Properties   |
+-------------+--------------------+--------------------------+----------------+
| custom/dog  | dog.Dog            | dog.DogFactory           | [test=1,       |
|             |                    |                          |test1=2]        |
+-------------+--------------------+--------------------------+----------------+
================================================================================

[DAS]domain1.adminServer>add-custom-resource-to-servers custom/dog -servers server1
Successfully performed the ADD operation for A custom resource.
Check the results using "list-custom-resources"

[DAS]domain1.adminServer>remove-custom-resource custom/dog
Successfully performed the REMOVE operation for A custom resource.
Check the results using "list-custom-resources or remove-custom-resource"

[DAS]domain1.adminServer>list-custom-resources
List of Custom Resources
================================================================================
+-------------+--------------------+--------------------------+----------------+
| Export Name |   Resource Class   |       Factory Class      |   Properties   |
+-------------+--------------------+--------------------------+----------------+
(No data available)
================================================================================

5.2.5. External Source 설정

외부 소스는 크게 JMS 소스와 Connector로 나뉜다. WebAdmin의 왼쪽 메뉴에서 [Resources] > [External Source]를 선택하면 나타나는 External Source 목록 화면에서 설정한다.

[그림 5.10] WebAdmin에서 External Source 설정

WebAdmin에서 External Source 설정


JMS Source

WebAdmin에서는 도메인에 설정된 JMS 소스를 조회하고, JMS 소스를 추가, 변경, 삭제할 수 있다. JMS 리소스를 추가하기 위해서 External Source 목록 화면에서 Jms Source 영역 상단에 [ADD] 버튼을 클릭한다.

다음은 JMS 소스 설정에 대한 설명이다.

[그림 5.11] WebAdmin에서 JMS Source 추가

WebAdmin에서 JMS Source 추가

다음은 설정 항목에 대한 설명이다.

항목설명
Vendor

JMS 벤더를 설정한다. 다음의 값 중 하나를 설정한다.

  • ibmmq : IBM사의 제품을 지칭한다.

  • sonicmq : Sonic MQ를 지한다.

  • others : 그 외의 제품들을 지칭한다.

Factory Class Name해당 JMS 리소스의 Factory Class의 이름을 지정한다.
Resource Type

해당하는 JMS의 타입을 결정한다.

다음의 8가지 값 중에 하나를 설정한다.

  • QCF

  • TCF

  • Q

  • T

  • XAQCF

  • XATCF

  • LOCALXAQCF

  • LOCALXATCF

Export NameJNDI에 바인딩될 이름을 지정한다. 사용자는 이 이름을 이용하여 JMS의 ConnectionFactory, Destination 등을 이용할 수 있다.
Queue'Rresource Type'이 'Q'일 때만 사용한다.
Queue Manager'Rresource Type'이 'Q'일 때만 사용한다.
Topic'Rresource Type'이 'T'일 때만 사용한다.
PropertyJMS 리소스에 필요한 속성들을 기록한다. 이 설정은 name, type, value로 구성된다.

참고

각 태그에 대한 자세한 내용은 자세한 것은 IBM MQ나 Sonic MQ의 매뉴얼을 참조한다.

Connector 추가

WebAdmin에서는 도메인에 설정된 Connector를 조회하고, 추가, 변경, 삭제할 수 있다. Connector에 대한 자세한 설명은 "JEUS JCA 안내서"를 참고한다.

5.2.6. External Resource 설정

JEUS에서는 Tmax나 InfiniCache와 같이 타 제품을 JEUS에서 연동하기 위해서 External Resource를 설정할 수 있다. Tmax와의 연동을 위해서는 JEUS에서 Tmax로 연결해서 Tmax의 트랜잭션 서비스를 사용하는 아웃바운드(Outbound)인 WebT와 Tmax에서 JEUS로 온 서비스 요청을 받아주는 인바운드(Inbound)인 JTmax를 설정할 수 있다. 자세한 내용은 관련된 Tmax 매뉴얼의 "Tmax Server Guide"를 참고한다.

본 절에서는 External Resource 구현 방법과 등록 방법에 대해서 설명한다

다음은 jeus.external.ResourceBootstrapper 인터페이스이다. 이 인터페이스를 구현한 클래스는 SERVER_HOME/lib/application 또는 DOMAIN_HOME/lib/application에 있어야 한다.

[예 5.3] jeus.external.ResourceBootstrapper

package jeus.external;

import javax.naming.Context;
import java.util.Map;

/**
 * 외부 resource를 JEUS에서 사용할 수 있도록 하는 bootstrapper이다.
 */
public interface ResourceBootstrapper {
    /**
     *
     * @param propertyMap resource의 설정을 가진 Map
     */
    void setProperties(Map propertyMap) throws InvalidPropertyException;

    /**
     * resource를 bind한다.
     * @param context
     */
    void initResources(Context context);

    /**
     * 사용할 수 있는 property의 정보를 return한다.
     * @return
     */
    ResourcePropertyInfo[] getPropertyInfo();

    /**
     *
     * @param propertyMap 변경되는 property가 있는 Map
     */
    void modifyProperties(Map propertyMap) throws InvalidPropertyException;

    /**
     * resource를 다시 bind할때 호출된다.
     * @param context
     */
    void reconfigResources(Context context);

    /**
     * resource를 제거할때 사용한다.
     * @param context
     */
    void destroyResources(Context context);
}


참고

External Resource를 동적으로 추가하기 위해서는 이미 해당 클래스들이 서버의 클래스 로더에 클래스 패스로 잡혀있어야 가능하다. 만약 서버의 클래스 로더에서 이 클래스를 로딩할 수 없으면 동적 추가 명령은 pending 처리된다. 이럴 경우 External Resource 클래스를 SERVER_HOME/lib/application 또는 DOMAIN_HOME/lib/application에 추가하고 서버를 재기동해야 한다.

External Resource를 삭제하는 동작은 Graceful하게 수행되지 않는다. 즉, 진행 중인 요청이 있더라도 이를 완료하지 않기 때문에 사용자 애플리케이션에서는 에러가 발생할 수 있음을 유의한다.

WebAdmin 사용

다음은 WebAdmin에서 동적으로 External Resource를 등록하는 방법에 대해 알아본다.

  1. WebAdmin의 왼쪽 메뉴에서 [Resources] < [External Resource] 를 선택한다. [ADD] 버튼을 클릭하여 JTmax와 WebT, Inifinite Cache를 위한 ResourceBootstrpper를 도메인에 등록한다.

    [그림 5.12] WebAdmin에서 서버의 External Resource 설정 (1)

    WebAdmin에서 서버의 External Resource 설정 (1)


  2. 등록할 External Resource의 설정 정보를 입력하고 [확인] 버튼을 클릭한다.

    [그림 5.13] WebAdmin에서 서버의 External Resource 설정 (2)

    WebAdmin에서 서버의 External Resource 설정 (2)

  3. [확인] 버튼을 클릭해서 임시저장을 하면 화면 상단에 임시저장 결과에 대한 메시지가 나타난다. 또한 External Resource 테이블에 추가하려고 하는 리소스 정보가 나타난다.

    [그림 5.14] WebAdmin에서 서버의 External Resource 설정 (3)

    WebAdmin에서 서버의 External Resource 설정 (3)

  4. 추가한 External Resource를 서버에서 사용할 수 있도록 서버 설정에 External Resource를 추가한다.

    WebAdmin 왼쪽 메뉴에서 [Servers] > [Server1] > [Basic Info]'External Resource Refs' 항목에서 도메인에 추가한 External Resource를 선택하고 [확인] 버튼을 클릭한다.

    [그림 5.15] WebAdmin에서 서버의 External Resource 설정 (4)

    WebAdmin에서 서버의 External Resource 설정 (4)

  5. [Activate Changes] 버튼을 클릭하여 External Resource를 도메인에 반영한다. 화면 상단에서 External Resource가 도메인에 반영되었다는 메시지를 확인할 수 있다. 해당 External Resource는 추가한 서버에서 바로 사용가능하다.

콘솔 툴 사용

External Resource는 콘솔 툴을 통해서 서버에 등록된 리소스에 대한 조회 명령이 가능하다. 또한 새로운 External Resource를 동적으로 추가, 삭제하는 것이 가능하다.

[DAS]domain1.adminServer>add-external-resource test/ext -resource test.ext.TestResourceBootstrapper  
Successfully performed the ADD operation for A external resource.
Check the results using "list-external-resources or add-external-resource"

[DAS]domain1.adminServer>list-external-resources
List of External Resources
=============================================================================
+----------+---------------------------------------------------+------------+
| Name     |                   Resource Class                  | Properties |
+----------+---------------------------------------------------+------------+
| test/ext | test.ext.TestResourceBootstrapper                 | []         |
+----------+---------------------------------------------------+------------+
=============================================================================

[DAS]domain1.adminServer>add-external-resource-to-servers test/ext -servers server1
Successfully performed the ADD operation for A external resource.
Check the results using "list-external-resources"

[DAS]domain1.adminServer>remove-external-resource test/ext 
Successfully performed the REMOVE operation for A external resource.
Check the results using "list-external-resources or remove-external-resource"

[DAS]domain1.adminServer>list-external-resources
List of External Resources
=========================================================================
+------+---------------------------------------------------+------------+
| Name |                   Resource Class                  | Properties |
+------+---------------------------------------------------+------------+
(No data available)
=========================================================================