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

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

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

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

애플리케이션 클라이언트는 일반적인 Java 프로그램과 마찬가지로 반드시 public으로 선언된 main() 메소드를 가지고 있어야 한다.

다음 예제는 Injection을 통해 EJB를 호출한다(JEUS_HOME/samples/client/hello/hello-client 예제를 참고).

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

DD 작성 방법은 다음과 같이 2가지로 나누어진다.

DD를 생성할 때 필요하다면 JEUS에서 클라이언트 모듈을 디플로이하기 전에 jeus-client-dd.xml 파일을 작성한다.

다음은 DD를 작성한 XML 파일의 예이다.

XML에서 클라이언트가 사용하는 환경변수, EJB 애플리케이션이 바인딩된 이름, 바인딩된 JDBC DataSource의 이름, JMS Queue의 JNDI 바인딩 이름을 지정하고 있다. 환경변수를 제외하고는 application-client.xml의 <ref-name>에 실제 바인딩된 JNDI 이름을 <export-name>으로 지정한다.

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

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

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

콘솔에서 모듈을 실행하기 위해서 appclient 명령어를 사용한다. appclient는 JEUS_HOME\bin에 존재하는 스크립트로 클라이언트 컨테이너를 통해 애플리케이션 클라이언트 모듈을 실행한다.

다음은 JEUS에서 제공하는 클라이언트 컨테이너의 command line 형식이다.