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

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

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

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

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

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

다음은 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)

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

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

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

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

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;
    }
}

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;
    }
    
}

WebAdmin 사용

다음은 WebAdmin에서 동적으로 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)
================================================================================

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

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

JMS Source

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

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

[그림 5.11] WebAdmin에서 JMS Source 설정

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

Connector 추가

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

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

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

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

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);
}

WebAdmin 사용

다음은 WebAdmin에서 동적으로 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
================================================================================
+-------------+---------------------------------------------------+------------+
| Export 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
================================================================================
+-------------+---------------------------------------------------+------------+
| Export Name |                   Resource Class                  | Properties |
+-------------+---------------------------------------------------+------------+
(No data available)
================================================================================