개발자가 구현한 EJB 소스 파일들을 컴파일한다.

EJB 소스 파일들로부터 EJB 모듈을 조립하는 첫 번째 과정은 소스 파일들을 컴파일하는 것이다. 이는 JDK의 javac 컴파일러를 이용한다. 클래스 패스로는 기본적으로 JEUS_HOME\lib\system\javaee.jar를 사용하며, jeus-ejb-dd.xml에 대응되는 Annotation을 사용했다면 JEUS_HOME\lib\system\jeusapi.jar, 또 다른 helper 클래스가 있다면 모두 추가한다.

다음은 “counter” Bean에서 사용될 EJB Java 파일들을 Windows 환경에서 컴파일하는 명령 실행에 대한 예이다.

> javac –classpath c:\jeus\lib\system\javaee.jar *.java 

위 명령의 실행하면 클래스 파일들이 생성된다.

EJB 모듈을 디플로이할 때 사용되는 DD는 다음과 같이 2가지로 나누어진다.

ejb-jar.xml DD 작성

Descriptors의 포맷은 EJB 표준에 따른다. 대부분 Annotation으로 가능하지만 필요한 경우 Descriptors를 사용한다.

package ejb.basic.statefulSession;
@Remote
public interface Counter
{
   public void increase();
  ...
}

package ejb.basic.statefulSession;
@Stateful
@EJB(name="counter")
@TransactionManagement( TransactionManagementType.BEAN)
public class CounterEJB implements Counter {
   private int count = 0;

   public void increase()
   {
      count++;
   }
 ...
}

위의 Annotation을 표준 DD인 ejb-jar.xml로 나타내면 다음과 같다. 다음 예제는 “counter” Bean의 간단한 EJB 표준 DD를 나타낸 것이다.

<?xml version="1.0"?>
<ejb-jar version="3.0" xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
        http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd">
    <enterprise-beans>
        <session>
            <ejb-name>counter</ejb-name>
            <business-remote>ejb.basic.statefulSession.Counter</business-remote>
            <ejb-class>ejb.basic.statefulSession.CounterEJB</ejb-class>
            <session-type>Stateful</session-type>
            <transaction-type>Bean</transaction-type>
        </session>
    </enterprise-beans>
    <assembly-descriptor/>
</ejb-jar>

jeus-ejb-dd.xml DD 작성

JEUS EJB DD가 필요한 이유는 EJB 엔진에 디플로이하기 위한 기본 설정 및 External Reference들을 JEUS 서비스에 매핑시키기 위해서이다. 그 외에도 인스턴스 Pooling과 Entity Bean, 데이터베이스 테이블과의 매핑 설정도 jeus-ejb-dd.xml에서 한다.

JEUS EJB DD는 표준 EJB DD에 부가적인 설정으로 볼 수 있다. 표준 EJB DD와 마찬가지로 JEUS EJB DD도 EJB 모듈에 적용된다.

다음은 JEUS EJB DD의 전반적인 구성이다.

<?xml version="1.0"?>
<jeus-ejb-dd xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <module-info>
        <role-permission>
            <!-- See chapter “4.2.6. EJB 보안 설정” -->
            . . .
        </role-permission>
    </module-info>
    <beanlist>
        <jeusbean>
            <!-- See chapters “제4장 EJB의 공통 특성”
                 and “제7장 Session Bean” -->
            . . .
        </jeusbean>
        <jeusbean>
            <!-- See chapters “제4장 EJB의 공통 특성”
                 and “제7장 Session Bean” -->
            . . .
        </jeusbean>
            . . .
    </beanlist>
    <ejb-relation-map>
        <!-- See chapter “제8장 Entity Bean” -->
    </ejb-relation-map>
    <message-destination> 
        <jndi-info>
            <ref-name>ejb/AccountEJB</ref-name>
            <export-name>ACCEJB</export-name>
        </jndi-info>
    </message-destination>
    <library-ref>
        <library-name>jsf</library-name>
        <specification-version>1.2</specification-version>
        <implementation-version>1.2</implementation-version>
    </library-ref>
</jeus-ejb-dd>  

JEUS EJB DD의 주요 요소들은 다음과 같다.

본 절에서는 JAR 파일로 EJB 클래스와 DD 패키징에 대해 설명한다.

EJB JAR 파일을 패키징할 때에는 jar 유틸리티를 이용한다. 먼저 다음 사항을 가정한다.

EJB JAR 파일의 패키징 과정은 다음과 같다.

[그림 3.1]에서 설명했듯이 JEUS에서는 다음과 같은 방법으로 EJB 모듈을 디플로이한다.

EJB 모듈을 EJB 엔진에 디플로이할 때는 jeusadmin, WebAdmin 등의 툴을 이용한다. 일반적으로는 디플로이할 때 EJB 클래스를 컴파일하게 되지만 appcompiler를 이용해서 미리 EJB 클래스를 컴파일해서 디플로이할 때의 속도를 향상시킬 수 있다.

또한 Auto Deploy 기능을 이용해서 손쉽게 EJB 모듈을 디플로이할 수도 있다. Deploy에 관한 좀 더 자세한 내용은 "JEUS Applications & Deployment 안내서"를 참고한다.

appcompiler 툴 이용

EJB 2.x 모듈의 경우 appcompiler 툴을 사용함으로써 Stub과 skeleton 파일들을 미리 생성하여 디플로이하는 속도를 빠르게 할 수 있다. appcompiler를 사용할 경우에는 jeus-ejb-dd.xml이나 jeus-application-dd.xml의 <fast-deploy>를 true로 설정하거나 jeusadmin 툴의 deploy 명령어에서 [–f] 옵션을 사용한다. 이 옵션이 사용되지 않을 경우에는 appcompiler는 효과가 없다.

EJB 모듈의 Runtime Deploy

Runtime Deploy는 실행되고 있는 EJB 엔진에 EJB 모듈을 디플로이하는 것을 의미한다. 콘솔 툴(jeusadmin)의 deploy 명령어를 이용하여 실행되고 있는 EJB 엔진에 모듈을 설치할 수 있다.

본 절에서는 “countermod” EJB 모듈의 디플로이 과정을 설명한다. 모듈을 디플로이하기 위해 다음의 사항을 가정한다.

다음은 디플로이 과정에 대한 설명이다.

deploy 명령어와 –per(“permanent”) 파라미터를 사용하면 디플로이된 EJB모듈은 JEUSMain.xml의 <application> 태그로 추가된다.

EJB 모듈의 Boot-time Deploy

엔진이 기동(Booting)할 때마다 EJB 엔진에 디플로이하는 것을 Boot-time Deploy라고 한다. Boot-time Deploy를 설정하려면 JEUSMain.xml 파일 내에 <application> 태그를 이용해 EJB 애플리케이션을 추가해야 한다.

<jeus-system>
    . . .
    <application>
        <name>countermod</name>
        <path>countermod.jar</path>
        <deployment-target>
           <target>
              <engine-container-name>johan_container1</engine-container-name>
           </target>
        </deployment-target>
        <deployment-type>COMPONENT</deployment-type>
        <ejb-component/>
    </application>
    . . .
</jeus-system>

여러 개의 <application> 태그들이 하나의 JEUSMain.xml 파일에 추가될 수 있다. JEUSMain.xml 파일에 애플리케이션을 추가한 후 countermod 모듈이 디플로이되도록 EJB 엔진을 재시작한다.

EJB 모듈이 디플로이된 후에 클래스 파일들과 설정 파일들은 다음 그림의 구조로 JEUS 설치 디렉터리에 배포된다.

[그림 3.3] 디플로이된 EJB 모듈의 디렉터리 구조

JEUS_HOME\webhome\<node name>_<container name> 디렉터리는 <containner name>에 해당하는 컨테이너에 디플로이된 애플리케이션들이 존재하는 디렉터리이다. 여기에는 디플로이된 EJB 모듈의 EJB 구현 클래스들뿐만 아니라 helper 클래스들이 위치한다.

디플로이된 파일이 위치하는 디렉터리에 따라서 다음과 같이 나누어진다.

Exploded EAR Deploy 방식과 Exploded Standalone Deploy 방식은 webhome 디렉터리로 복사되지 않고 원래의 위치를 참조하게 된다. JEUS에서는 Archive 파일이 존재하는 Standalone Deployment를 COMPONENT Type, 풀어놓은 것을 EXPLODED COMPONENT Type이라고 한다.

디플로이된 EJB 모듈을 suspend, resume, redeploy 명령어들을 적용하여 EJB 모듈 내의 EJB의 실행 상태를 컨트롤할 수 있다. [그림 3.1]을 참고한다.

디플로이된 EJB모듈을 컨트롤하는 방법에는 크게 2가지가 있다. 하나는 콘솔 툴(jeusadmin)을 이용하는 것이고 다른 하나는 WebAdmin을 이용하는 것이다. 여기서는 콘솔 툴을 사용하는 것만 설명한다.

콘솔 툴 사용

콘솔 툴(jeusadmin)에는 다음과 같은 컨트롤 명령어들이 존재한다. 모든 명령어들은 EJB 모듈 이름을 파라미터로 받는다.

다음은 다음은 콘솔 툴(jeusadmin)을 사용하여 EJB 모듈을 undeploy하는 방법을 설명하는 예이다.

콘솔 툴(jeusadmin)을 이용해서 EJB 모듈을 모니터링할 때 다음의 2가지의 명령어를 이용한다.