일반적으로 Java EE 애플리케이션을 호출하거나 Java EE의 서비스를 제공받기 위해서는 JEUS의 클라이언트 컨테이너에서 구동되는 애플리케이션 클라이언트(Application Client) 모듈을 사용한다.

애플리케이션 클라이언트는 Java EE 환경을 사용하는 standalone 클라이언트로 Java EE 스펙에 정의되어 있는 애플리케이션 클라이언트 컨테이너(Application Client Container)에서 구동되는 애플리케이션이다. 애플리케이션 클라이언트 모듈은 JEUS 클라이언트의 한 형태이다. 이 형태는 클라이언트 또는 서버 시스템이나 테스트 및 디버깅을 하는 경우 유용하게 사용할 수 있는 클라이언트이다.

JEUS 애플리케이션 클라이언트는 클라이언트 컨테이너를 사용해서 Naming Service, Scheduler, Security 등과 같은 JEUS 서비스를 사용할 수 있다. 클라이언트 컨테이너를 사용하지 않더라도 JEUS 클라이언트 라이브러리를 사용하면 JNDI, Security 등의 일부 Java EE 서비스를 사용할 수는 있지만 Dependency Injection, JEUS Scheduler 등에 해당하는 서비스는 사용할 수 없다.

본 절에서는 JEUS 클라이언트와 서버 환경의 아키텍처에 대해 알아보고, 간단한 샘플 코드를 예로 들어 설명한다.

1.2.1. 프로그램 구조

애플리케이션 클라이언트는 서버와는 다른 JVM에서 실행되는 클라이언트 프로그램이다.

애플리케이션 클라이언트는 main() 메소드를 호출해서 실행하고, 가상 머신이 종료되면 실행을 마친다. 다른 Java EE 애플리케이션 컴포넌트처럼 애플리케이션 클라이언트는 시스템 서비스를 제공하는 클라이언트 컨테이너에서 동작한다. 클라이언트 컨테이너는 다른 Java EE 컨테이너에 비해서 적은 양의 시스템 리소스를 사용한다. 클라이언트 컨테이너는 일반 애플리케이션 클라이언트에서 JEUS가 제공하는 Java EE 서비스를 사용할 수 있는 환경을 제공한다.

이 서비스에는 JNDI, Scheduler, Security 그리고 JNDI 서비스를 통해서 JEUS에 바인딩되어 있는 애플리케이션 컴포넌트(EJB) 및 시스템 리소스들(JDBC DataSource, JMS Connection Factory 등)에 대한 사용이 포함된다.

[그림 1.1] 애플리케이션 클라이언트 아키텍처

package helloejb;

import java.io.*;
import javax.ejb.EJB;

public class HelloClient {
    @EJB(mappedName="helloejb.Hello")
    private static Hello hello;
    
    public static void main(String[] args) {
        System.out.println("EJB output : " + hello.sayHello());
    }
}

본 절에서는 Deployment Descriptor(이하 DD)를 작성하고 생성하는 방법에 대해 설명한다.

<jeus-client-dd>
    <env>
        <name>year</name>
        <type>java.lang.Integer</type>
        <value>2002</value>
    </env>
    <ejb-ref>
        <jndi-info>
            <ref-name>count</ref-name>
            <export-name>count_bean</export-name>
        </jndi-info>
    </ejb-ref>
    <res-ref>
        <jndi-info>
            <ref-name>datasource</ref-name>
            <export-name>Oracle_DataSource</export-name>
        </jndi-info>
    </res-ref>
    <res-env-ref>
        <jndi-info>
            <ref-name>jms/SalaryInfo</ref-name>
            <export-name>jms/salary_info_queue1</export-name>
        </jndi-info>
    </res-env-ref>
</jeus-client-dd>

클라이언트 모듈의 패키징 방식은 수동 패키징 방식과 IDE를 사용한 패키징 방식으로 나눠진다.

애플리케이션 클라이언트 모듈은 수동으로 직접 deploy를 진행하거나 JEUS WebAdmin를 사용한다.

모듈에는 필요에 따라 Java EE 표준 DD 파일인 application-client.xml과 JEUS에서 제공하는 jeus-client-dd.xml이 있다. 애플리케이션 클라이언트에 대한 모듈 파일을 생성한 후 해당 파일을 원하는 위치로 이동한다.

만약 웹 서비스 클라이언트로 동작하는 기능이 있다면 추가로 콘솔 툴(jeusadmin)이나 WebAdmin을 통해 deploy하거나 appcompiler를 사용해야 웹 서비스 Stub이 생성된다.

본 절에서는 각 서비스별로 추가적으로 필요한 JEUS 라이브러리와 콘솔에서 모듈을 실행하는 방법에 대해 설명한다.

애플리케이션 클라이언트로 웹 서비스를 사용할 경우 라이브러리 실행 단계에서 기본 라이브러리인 JEUS_HOME/lib/client/clientcontainer.jar 외에 추가적으로 필요한 라이브러리들이 존재한다. 이들은 대부분 JEUS_HOME/lib/system(이하 SYSTEM_LIB_DIR) 아래에 위치한다.

다음은 서비스별 추가적으로 필요한 JEUS 라이브러리 목록이다.