배치 디스크립터 보기
배치 디스크립터는 애플리케이션 또는 모듈에 대한 구성 및 컨테이너 옵션을 지정하는 XML(extensible markup language) 파일입니다.
시작하기 전에
이 주제에서는 서버에 애플리케이션 또는 모듈을 설치했으며 배치 디스크립터를 보려는 것으로 가정합니다.
이 태스크 정보
어셈블리 도구에서 J2EE(Java™ 2 Platform, Enterprise Edition) 애플리케이션 또는 모듈을 작성하면, 어셈블리 도구가 애플리케이션 또는 모듈의 배치 디스크립터 파일을 작성합니다. Java EE(Java Platform, Enterprise Edition) 5 이상의 애플리케이션 및 모듈은 배치 디스크립터 대신 어노테이션을 사용할 수도 있습니다.
서버에 애플리케이션이나 모듈이 설치된 후, 관리 콘솔에서 해당 배치 디스크립터를 볼 수 있습니다. Java EE 5 이상의 어노테이션은 볼 수 없습니다.
응응프로그램이 Java EE 5 이상을 지원하지 않는 한, EAR(Enterprise Archive) 파일에 application.xml 파일을 포함해야 합니다. application.xml은 애플리케이션의 각 모듈을 식별합니다. Java EE 5 애플리케이션은 EAR 파일에 application.xml 파일을 제공하지 않아도 됩니다. application.xml 파일이 없는 경우, 제품이 JAR(Java Archive) 파일 컨텐츠를 검사하여 JAR 파일이 엔터프라이즈 Bean(EJB) 모듈 또는 애플리케이션 클라이언트 모듈인지 여부를 판별합니다. JAR 파일은 둘 이상의 배치 디스크립터를 포함해서는 안됩니다. ejb-jar.xml 파일이 JAR 파일에 있는 경우 제품은 해당 파일을 EJB 모듈로 간주합니다. ejb-jar.xml 파일이 없고 application-client.xml은 있는 경우 제품은 JAR 파일을 애플리케이션 클라이언트 모듈로 간주합니다. ejb-jar.xml 및 application-client.xml 파일이 모두 JAR 파일에 있는 경우 제품은 애플리케이션 클라이언트 모듈인 JAR 파일을 EJB 모듈로 간주하거나 EJB 모듈인 JAR 파일을 애플리케이션 클라이언트 모듈로 간주합니다. JAR 파일은 둘 이상의 유형의 배치 디스크립터를 포함하면 안 됩니다.
프로시저
결과
애플리케이션 또는 모듈에 대한 배치 디스크립터가 표시됩니다.
예
제품 DefaultApplication에 대한 배치 디스크립터는 다음과 같습니다.
<application id="Application_ID" >
<display-name> DefaultApplication.ear</display-name>
<description> This is the IBM WebSphere Application Server Default Application.</<description>
<module id="WebModule_1" >
<web>
<web-uri> DefaultWebApplication.war</web-uri>
<context-root> /</context-root>
</web>
</module>
<module id="EjbModule_1" >
<ejb> Increment.jar</ejb>
</module>
<security-role id="SecurityRole_1204342979281" >
<description> All Authenticated users role.</description>
<role-name> All Role</role-name>
</security-role>
</application>
다음에 수행할 작업
콘솔 페이지에 배치 디스크립터가 표시되면, 다음을 수행하십시오.
- 애플리케이션 바인딩, 보안 역할, 다른 자원에 대한 참조 또는 JNDI(Java Naming and Directory Interface) 이름에 대해 갖는
모든 구성을 포함하여 배치 디스크립터 컨텐츠를 검사하십시오.
예를 들어 Java EE 5 이상 모듈의 JAR 파일을 검사하여 각 JAR 파일이 둘 이상 유형의 배치 디스크립터를 포함하지 않는지 확인하십시오. JAR 파일에 둘 이상 유형의 배치 디스크립터가 포함된 경우, 다음 단계로 진행한 후 불필요한 배치 디스크립터를 제거하십시오. 따라서 JAR 파일에 ejb-jar.xml 및 application-client.xml 파일이 모두 있는 경우, 모듈이 필요하지 않은 배치 디스크립터를 제거하십시오.
- 필요에 따라 배치 디스크립터를 변경하십시오.
배치 디스크립터 파일은 수동으로 편집할 수 있습니다. 그러나 배치 디스크립터에 유효한 특성이 있고 해당 참조에 적당한 값이 포함되어 있는지를 확인하기 위해 콘솔 또는 어셈블리 도구 배치 디스크립터 편집기를 사용하여 배치 디스크립터를 편집하는 것이 좋습니다.
Java EE 5 이상의 모듈에 metadata-complete 속성이 없거나 metadata-complete 속성이 false로 설정된 경우 어노테이션의 배치 정보를 포함하여 전체 모듈 배치 디스크립터를 XML 형식으로 작성하도록 제품에 지시할 수 있습니다. 모듈의 메타데이터 페이지에서 메타데이터 완료 속성을 선택하십시오.
