[그림 3.1]을 보면 Jakarta EE 애플리케이션은 하나 이상의 Jakarta EE 모듈과 2개의 DD로 구성된다. DD는 Jakarta EE DD(application.xml)와 JEUS DD(jeus-application-dd.xml)로 구성된다. 이때 Jakarta EE 모듈은 1개 이상의 동일한 타입인 컴포넌트들과 DD들로 구성되기 때문에 하나의 컴포넌트만으로도 애플리케이션을 생성할 수 있다.

Jakarta EE 애플리케이션은 확장자가 .ear인 일반적인 JAR Archive 형식의 파일로 다음은 EAR 구성의 간단한 예이다. EAR 파일의 루트 디렉터리에는 애플리케이션에 포함된 각 모듈의 Archive 파일들과 lib, META-INF 디렉터리가 존재한다.

다음은 .ear archive의 구성과 각 각 디렉터리에 대한 설명이다.

myApp.ear
   |--lib
   |    |--[J]myLib.jar
   |- META-INF
   |    |--[X]application.xml
   |    |--[X]jeus-application-dd.xml
   |--[J]appclient.jar
   |--[J]ejb.jar
   |--[J]web.war

* Legend
- [01]: binary or executable file
- [X] : XML document
- [J] : JAR file
- [T] : Text file
- [C] : Class file
- [V] : jaba source file
- [DD] : deployment dexcriptor 

lib/application은 DOMAIN_HOME과 SERVER_HOME에 위치할 수 있다.

클래스 로딩 방식

애플리케이션 라이브러리는 SERVER_HOME과 DOMAIN_HOME에 존재한다.

클래스 로더에서 클래스 패스에 추가하는 순서는 SERVER_HOME/lib/application이 먼저이고, DOMAIN_HOME/lib/application이 나중이다. 따라서 SERVER_HOME과 DOMAIN_HOME에 같은 라이브러리가 존재할 경우에는 SERVER_HOME에 설치되어 있는 것이 로딩되기 때문에 DOMAIN_HOME에 존재하는 라이브러리는 무시될 수 있다.

클래스 로더에 라이브러리를 클래스 패스로 추가할 때 라이브러리 파일 이름이 같은 경우에는 서버를 부팅할 때 다음과 같은 WARNING 메시지를 출력한다.

Warning [same classpath-name] : [JEUS_HOME/domains/domain1/servers/adminServer
/lib/application/applib.jar] is registered earlier than 
[JEUS_HOME/domains/domain1/lib/application/applib.jar] in JEUSClassLoader.

애플리케이션 라이브러리는 애플리케이션뿐만 아니라 서버에 특정 클래스를 설정해서 사용할 수 있는 부분에서는 모두 사용 가능하다. 그 예로는 서버 Lifecycle 호출 기능과 사용자 로거, 로그 메시지 필터 클래스, 로그 메시지 포맷터 클래스가 있다. 여기에 설정한 클래스에서는 애플리케이션 라이브러리의 라이브러리를 참조하는 것이 아니라 해당 클래스가 lib/application에 위치해야 한다.

라이브러리 설치 및 설정

<library>
     <library-name>myLibrary</library-name>
     <specification-version>2.0</specification-version>
     <implementation-version>2.1</implementation-version>
     <files dir=".">
         <include name="commons-logging.jar"/>
         <include name="commons-util.jar"/>
     </files>
     <files dir="myLib-2.1"/>
</library>

애플리케이션에서 라이브러리 참조

<library-ref>
     <library-name>myLibrary</library-name>
</library-ref>

위의 예에서 애플리케이션은 deploy될 때 라이브러리 이름이 'myLibrary'인 라이브러리를 찾고 해당 클래스 패스를 애플리케이션 클래스 패스에 추가한다. 여러 버전의 'myLibrary'가 있는 경우 가장 높은(highest) 버전을 선택하게 된다. 참조되는 라이브러리 버전이 설정되지 않으면, 항상 절 3.3.2. “Version Ordering Rule”에 따라 최상위 버전을 찾게 된다.

다음은 최소 버전이 필요한 경우의 예이다.

<library-ref>
     <library-name>myLibrary</library-name>
     <specification-version>
          <value>2.0</value>
     </specification-version>
     <implementation-version>
          <value>2.0</value>
     </implementation-version>
</library-ref>

다음은 정확한 버전이 필요한 경우의 예이다.

<library-ref>
     <library-name>myLibrary</library-name>
        <specification-version>
             <value>2.0</value>
             <exact-match>true</exact-match>
        </specification-version>
        <implementation-version>
             <value>2.0</value>
             <exact-match>true</exact-match>
        </implementation-version>
</library-ref>

다음은 정해진 스펙 버전만 설정하는 경우의 예이다. 이렇게 되면 해당 스펙 버전의 최상의 implementation 버전을 찾게 된다.

<library-ref>
     <library-name>myLibrary</library-name>
          <specification-version>
               <value>2.0</value>
               <exact-match>true</exact-match>
          </specification-version>
</library-ref>

기본적으로 애플리케이션이 deploy될 때 참조하고 있는 라이브러리를 찾을 수 없다면 WARNING 로그를 보여주지만, deploy는 계속 진행된다. 만약 이런 동작을 원하지 않는다면 다음과 같이 <failon-error> 속성을 설정하여 deploy를 실패시킬 수 있다.

<library-ref>
     <library-name>myLibrary</library-name>
     <failon-error>true</failon-error>
</library-ref>

클래스 로딩 방식

Version Ordering Rule

Version ::= <fraction_part> | <string_part> | <fraction_part> <string_part>
fraction_part ::= <integer> | <integer> "." <fraction_part>
string_part ::= <non-numeric> <character>*

6.0 < 6.2.3 < 6.2.3-b12 < 6.2.3-beta < 6.2.4

주요 기능

3.3.3.2. 애플리케이션에서 라이브러리 참조

애플리케이션을 배포할 때 참조할 라이브러리를 지정할 수 있다. 콘솔 툴이나 WebAdmin을 통해 배포 작업을 진행할 때 참조할 라이브러리의 식별자와 버전을 지정할 수 있다. 버전을 지정하지 않은 경우에는 가장 높은(최신) 버전의 라이브러리를 지정한 것으로 간주한다.

JEUS는 배포할 때 지정한 정보를 사용하여 해당 라이브러리를 애플리케이션이 참조할 수 있도록 연결하는 작업을 수행한다. 애플리케이션이 참조하는 라이브러리에 대한 정보는 다른 배포 정보와 같이 domain.xml에 기록된다.

WebAdmin 사용

WebAdmin을 사용해서 애플리케이션을 배포할 때 배포 관련 설정을 입력하는 팝업창에서 어떤 라이브러리를 사용할지를 지정할 수 있다.

[그림 3.5] 라이브러리 지정

콘솔 툴 사용

deploy-application 명령어를 수행할 때 참조할 라이브러리의 식별자와 버전을 지정한다.

[MASTER]domain1.adminServer>deploy-application sample -lib log4j -version 1.2.17 -servers adminServer
deploy the application for the application [sample] succeeded.
[MASTER]domain1.adminServer>library-info
Library information
================================================================================
+-----------+--------+--------+---------------+------------------+-------------+
| Library ID| Version|  State | Target Servers|  Target Clusters | Applications|
+-----------+--------+--------+---------------+------------------+-------------+
| log4j     | 1.2.17 | RUNNING| adminServer   |                  | sample      |
+-----------+--------+--------+---------------+------------------+-------------+
================================================================================