EJB 배치 디스크립터 편집기

EJB 배치 디스크립터 편집기를 사용하여 EJB JAR 파일 및 연관된 Java™ 파일을 수정합니다.

EJB 배치 디스크립터 편집기는 EJB 배치 디스크립터에서 다양한 특성 및 설정을 표시하는 페이지 및 섹션으로 구성되어 있습니다. 또한 이 편집기에는 EJB 스펙에 대한 WebSphere® Application Server 바인딩 및 확장기능과 관련된 섹션 및 페이지가 있습니다. 편집기를 열려면 EJB 프로젝트의 배치 디스크립터를 마우스 오른쪽 단추로 클릭하고 연결 프로그램 > 배치 디스크립터 편집기를 선택하십시오.

코어 기능은 일반적으로 편집기 페이지의 맨 위에 있습니다. 코어 페이지 및 섹션을 보려면 편집기에서 초점을 설정하고 alt-shift-c를 누르십시오. 코어 페이지, 섹션, 헤더 및 탭은 파란색으로 강조표시되어 있으며 alt-shift-c를 다시 누를 때까지 계속 파란색으로 표시됩니다. 확장기능 및 바인딩은 보통 중첩된 섹션이며 편집기 페이지의 맨 아래에 있습니다. 섹션을 접으면 컨텐츠가 숨겨지지만 표제 정보는 남아 있습니다. 각 페이지에서 데이터 및 특성을 필터링할 때 유용합니다. 이 편집기에서는 사용자가 편집기를 닫은 후 다시 열 때 사용자가 접은 섹션을 기억합니다. 또한 각 섹션의 끝이나 처음에 있는 숨겨진 경계를 끌어서 섹션의 크기를 조정할 수 있습니다.

편집기의 다른 중요한 기능은 향상된 마법사 지원입니다. 편집기에서 다양한 요소의 작성 및 수정을 안내하는 마법사를 열 수 있습니다. 마법사는 작성 프로세스를 안내하는 동시에 문제점 해결에도 유용합니다. 오류가 발생했거나 올바르지 않은 데이터를 입력한 경우 마법사는 마법사 페이지의 맨 위에 경고 또는 오류 메시지를 표시합니다. 마법사는 여러 오브젝트를 한 번에 작성하거나 편집하는 기능을 제공하므로 여러 Bean에서 동시에 작업할 수 있습니다.

EJB 편집기는 다음의 자원을 수정합니다.

EJB 배치 디스크립터 디스크립터 페이지는 사용하는 기능( > 환경 설정 > Workbench > 기능)에 따라 변경될 수 있지만 EJB 배치 디스크립터 편집기는 보통 다음의 기본 탭 페이지를 표시합니다.

개요 페이지

EJB 모듈의 기본 특성을 보고 작성 및 수정하려면 개요 페이지를 사용하십시오. 여기에서 맨 처음 편집기 컨텐츠를 찾을 수 있습니다. 이 페이지의 본문은 ejb-jar.xml 파일의 사용자 인터페이스를 나타냅니다. ejb-jar.xml의 코어 XML 태그는 다음 섹션으로 구성되어 있습니다.

일반 정보
디스플레이 및 설명 이름을 추가하려면 이 섹션을 사용하십시오. 이러한 이름은 웹 서버 및 Java EE 보기에서 식별하는 데 사용됩니다.
사용
EJB JAR과 연관된 편집기의 링크 목록을 보려면 이 섹션을 사용하십시오. 예를 들어, EJB JAR이 EAR에 정의된 경우 EAR 이름이 링크로 표시됩니다. 링크를 클릭하면 EAR 배치 디스크립터 편집기가 실행됩니다.
엔터프라이즈 JavaBeans
EJB의 Bean에 해당하는 링크 목록을 보려면 이 섹션을 사용하십시오. 링크를 클릭하면 Beans 페이지로 이동하며 엔터프라이즈 Bean을 강조표시합니다.
어셈블리 디스크립터
이 섹션에는 어셈블리 페이지로 링크되는 세부사항 단추가 있습니다. 어셈블리 페이지에는 보안 역할, 메소드 권한, 컨테이너 트랜잭션 및 제외 목록의 섹션 및 마법사가 있습니다.
참조
이 섹션에는 참조 페이지로 링크되는 세부사항 단추가 있습니다.
EJB 클라이언트 JAR
이 섹션에는 EJB 모듈에 대해 작성된 EJB 클라이언트 JAR 파일의 이름이 표시됩니다. EJB 클라이언트 JAR 파일이 작성되지 않은 경우 작성 단추를 클릭하여 EJB 클라이언트 JAR 작성 마법사를 열고 JAR 파일을 작성할 수 있습니다.
관계 2.0
이 섹션은 EJB 2.0 모듈의 경우에만 사용할 수 있습니다. 관계 섹션에는 기존 관계 목록이 있습니다. 관계의 모든 작성 및 수정을 여기에서 수행할 수 있습니다.
아이콘
EJB JAR의 아이콘을 지정하려면 이 섹션을 사용하십시오. 이 섹션은 주로 런타임 시 식별하는 데 사용됩니다.
시각화
클래스 다이어그램 섹션을 사용하여 프로젝트에서 클래스 다이어그램을 작성하십시오. 이 섹션은 프로젝트에서 작성하는 Bean 및 기타 오브젝트의 시각적 표시를 제공합니다.
WebSphere 확장기능
프로젝트 대상이 WebSphere Application Server인 경우에만 표시됩니다. 이 섹션에는 관계 1.x, 상속EJB CMP 시퀀스 그룹 컴포지트가 있습니다. 각 영역에는 선택한 Bean의 배치 디스크립터 특성을 업데이트하기 위해 마법사를 실행하는 편집 단추가 있습니다.
WebSphere 바인딩
프로젝트 대상이 WebSphere Application Server인 경우에만 표시됩니다.

EJB 1.1 모듈의 경우:

  • JNDI 기본 데이터 소스 바인딩: 데이터 소스 JNDI 이름, JNDI 사용자 ID 및 데이터 소스 암호를 지정하려면 이 섹션을 사용하십시오.
EJB 2.0 모듈의 경우:
  • 백엔드 ID: 배치 시 로드되는 persister 클래스를 판별하려면 이 섹션을 사용하십시오.
  • JNDI CMP 팩토리 연결 바인딩: JNDI 이름 컨테이너 권한 유형을 지정하려면 이 섹션을 사용하십시오. 컨테이너 관리 인증 또는 컴포넌트 관리 인증을 선택할 수 있습니다.

Bean 페이지

엔터프라이즈 Bean에서 기능 및 자원을 작성, 수정 및 제거하려면 Bean 페이지를 사용하십시오. Bean 페이지의 왼쪽에는 EJB 프로젝트의 Bean 목록이 표시됩니다. 오른쪽에 있는 두 개의 화면 이동 가능한 섹션에는 선택한 Bean에 대한 세부사항이 있습니다. 예를 들어, EJB 1.x CMP 엔티티 Bean을 선택한 경우 이 Bean 유형과 관련된 섹션만 표시됩니다.

Bean 페이지는 다음 섹션으로 구성되어 있습니다.

일반 섹션
모든 엔터프라이즈 Bean에는 공통 정보에 대한 신속한 액세스를 제공하는 일반 섹션이 있습니다. EJB 1.1 CMP 엔티티 Bean의 경우 섹션에는 표시 이름, 재진입 유형, 설명 및 CMP 필드가 있습니다. EJB 2.x CMP 엔티티 Bean에도 추상 스키마 이름의 필드가 있습니다. 표시 이름 및 설명 필드는 Java EE 보기 및 웹 서버에서 식별하는 데 사용됩니다. 현재 실행을 완료할 때까지 Bean에 대한 액세스를 방지하려면 재진입 필드를 사용할 수 있습니다. EJBQL 문을 작성할 때 추상 스키마 이름을 설정하고 사용합니다. 추상 섹션을 사용하여 속성을 작성하고 제거할 수 있습니다. 속성은 데이터를 지속시키고 검색하기 위해 데이터베이스에 액세스하는 맵핑된 필드입니다.

Bean을 두 번 클릭하여 Java 편집기에서 Java 소스 코드를 여십시오.

클래스 및 인터페이스 파일
EJB 1.1 및 EJB 2.x Bean의 경우에 해당합니다. 이 섹션을 사용하여 Bean과 연관된 Java 자원을 수정하십시오. 예를 들어, Bean Java 클래스 및 비즈니스 로직을 열려면 Bean 클래스를 두 번 클릭하거나 테이블에서 Bean 클래스를 선택하고 열기를 클릭하십시오. 열기 단추는 엔터프라이즈 Bean 편집을 지원하는 Java 편집기를 실행합니다. 클래스 인터페이스 섹션은 Java 자원을 기타 기존 자원으로 변경하는 기능도 제공합니다. 찾아보기 단추를 클릭하면 이 재사용 기능에 액세스할 수 있습니다. 자원 찾아보기 대화 상자가 표시됩니다. 자원을 삭제하는 데 유용한 마법사를 실행하는 제거 기능도 사용할 수 있습니다.
환경 변수
EJB 1.1 및 EJB 2.x Bean의 경우에 해당합니다. 이 섹션을 사용하여 환경 변수를 추가, 제거 및 수정하십시오. 편집기에서 변수를 두 번 클릭하면 소스 보기에서 해당 요소가 강조표시됩니다.

환경 변수는 웹 및 EJB 컴포넌트에서 정의하는 상수입니다. 예를 들어, Circle Bean을 정의한 경우 PI라는 환경 변수를 작성하고 값을 3.1415926으로 설정할 수 있습니다. Cone이라는 다른 엔터프라이즈 Bean 또는 서블릿이 있는 경우 JNDI 찾아보기를 수행하여 PI 변수에 액세스할 수 있습니다.

아이콘
EJB 1.1 및 EJB 2.x Bean의 경우에 해당합니다. 아이콘 섹션은 EJB JAR 섹션과 같습니다. 이 섹션을 사용하여 Bean 레벨에서 아이콘을 지정하십시오. 주로 런타임 시 식별하는 데 사용됩니다.
메시지 구동 대상
EJB 2.x 메시지 구동 Bean의 경우에 해당합니다. 이 섹션을 사용하여 메시지 구동 Bean의 대상 유형 및 구독 지속성을 지정하십시오.
관계
EJB 2.x CMP 엔티티 Bean의 경우에 해당합니다. 이 섹션을 사용하여 EJB 2.0 CMP 엔티티 Bean의 관계를 작성하고 해당 작업을 수행하십시오.
조회
EJB 2.x CMP 엔티티 Bean의 경우에 해당합니다. 이 섹션을 사용하여 파인더 메소드를 작성하고 이 메소드에 파인더 명령문을 지정하십시오. 파인더 디스크립터를 제거할 수도 있습니다. 파인더 메소드는 홈 인터페이스에 있습니다. 파인더 디스크립터가 이러한 메소드에 지정됩니다. 파인더 디스크립터는 특정 Bean 인스턴스를 리턴하기 위해 데이터베이스를 조회하는 데 사용됩니다. 추가를 클릭하여 기존 파인더 메소드를 작성하거나 사용하는 옵션을 제공하는 파인더 메소드를 여십시오. 메소드가 작성된 후 마법사는 디스크립터 정보 추가를 안내합니다.
WebSphere 바인딩
프로젝트 대상이 WebSphere Application Server인 경우에만 표시됩니다. EJB 1.1 및 EJB 2.x Bean의 경우에 해당합니다. 이 섹션을 사용하여 WebSphere Application Server의 바인딩 특성을 지정하십시오. 데이터 소스를 사용하여 런타임에 지정된 데이터베이스를 찾습니다. 서버 구성에서 데이터 소스를 작성해야 합니다. WebSphere Application Server를 사용하는 경우 서버 도구를 사용하여 데이터 소스를 작성할 수 있습니다. 사용자 이름 및 암호는 데이터베이스 액세스 시 검증하는 데 사용됩니다.
WebSphere 확장기능
프로젝트 대상이 WebSphere Application Server인 경우에만 표시됩니다. EJB 1.1 및 EJB 2.x Bean의 경우에 해당합니다. 이 섹션을 사용하여 WebSphere Application Server에서 사용할 추가 확장기능을 지정하십시오. 다음 섹션 또는 필드는 선택한 Bean의 유형 및 레벨에 따라 사용 가능합니다.
세션 제한시간
세션 Bean의 경우 이 섹션을 사용하여 제한시간 값 및 활동 세션 유형을 지정하십시오.
관계
EJB 1.1 CMP 엔티티 Bean의 경우에 해당합니다. 이 섹션을 사용하여 관계를 정의하십시오.
파인더
EJB 1.1 CMP 엔티티 Bean의 경우에 해당합니다. 이 섹션을 사용하여 파인더 메소드를 작성하고 이 메소드에 파인더 명령문을 지정하십시오. 파인더 디스크립터를 제거할 수도 있습니다. 파인더 메소드는 홈 인터페이스에 있습니다. 파인더 디스크립터가 이러한 메소드에 지정됩니다. 파인더 디스크립터는 특정 Bean 인스턴스를 리턴하기 위해 데이터베이스를 조회하는 데 사용됩니다. 추가를 클릭하여 기존 파인더 메소드를 작성하거나 사용하는 옵션을 제공하는 파인더 메소드를 여십시오. 메소드가 작성된 후 마법사는 디스크립터 정보 추가를 안내합니다.
액세스 Bean
EJB 1.1 및 EJB 2.x 세션과 엔티티 Bean의 경우에 해당합니다. 메시지 구동 Bean의 경우에는 사용할 수 없습니다. 이 섹션을 사용하여 액세스 Bean을 작성하고 편집하십시오. 액세스 Bean은 엔터프라이즈 Bean에 대한 액세스 권한을 받을 수 있는 편리한 방법입니다.
Bean 캐시
이 섹션을 사용하여 Bean 캐시 설정을 정의하십시오.
보상
이 섹션을 사용하여 Bean이 웹 서비스 비즈니스 활동 표준에 대한 WebSphere Application Server 지원을 사용하도록 지정할 수 있습니다.

애플리케이션 컴포넌트를 작업 단위와 연관된 비즈니스 활동 범위에서 실행하도록 지정하려면 비즈니스 활동 범위에서 EJB 메소드 실행 선택란을 선택하십시오. 비즈니스 활동 범위는 컴포넌트 또는 동일한 범위에서 실행 중인 다른 컴포넌트가 등록한 보상 핸들러의 경계선입니다. 비즈니스 활동 범위는 웹 서비스 비즈니스 활동(WS-BusinessActivity) 스펙에 설명된 메커니즘을 사용하여 원격 런타임 사이에 분배됩니다.

비즈니스 활동 범위에서 EJB 메소드를 실행하도록 선택한 경우 선택적으로 보상 핸들러를 지정하여 비즈니스 활동이 실패한 경우 정정 조치를 수행할 수 있습니다. 보상 핸들러 클래스 이름은 com.ibm.websphere.wsba.CompensationHandler 인터페이스를 구현하고 애플리케이션의 일부분으로 배치되는 애플리케이션 클래스의 이름입니다. 보상 핸들러는 비즈니스 활동 범위가 종료되면 호출되고 범위의 정방향 실행 중 애플리케이션에서 제공한 보상 데이터가 전달됩니다.

글로벌 트랜잭션
글로벌 트랜잭션 설정은 엔터프라이즈 JavaBeans 스펙에 대한 WebSphere Application Server 확장입니다. 애플리케이션이 둘 이상의 자원을 사용하는 경우 외부 트랜잭션 관리자는 글로벌 트랜잭션의 두 자원 관리자에 대한 업데이트 사항을 조정해야 합니다.
로컬 트랜잭션
이 섹션을 사용하여 로컬 트랜잭션 설정을 정의하십시오.
로케일 호출
이 설정을 사용하면 WebSphere Application Server에서 실행 중인 EJB의 성능을 최대한 높일 수 있습니다.
데이터 캐시
EJB 2.x CMP 엔티티 Bean의 경우에 해당합니다. 이 섹션을 사용하여 캐시의 수명과 캐시 사용의 수명을 지정하십시오.
동시성 제어
1.1 CMP 엔티티 Bean의 경우에 해당합니다. 기본적으로 낙관적 잠금은 사용할 수 없습니다. 즉, 엔티티 Bean이 데이터베이스의 한 행에 액세스하는 경우 원래의 Bean이 이 행을 해제할 때까지 다른 Bean이 이 행을 편집할 수 없습니다. 행이 잠겨 있는 동안 편집하려고 시도하면 예외로 처리됩니다.

참조 페이지

프로젝트에서 엔터프라이즈 Bean에 대한 참조를 정의하려면 참조 페이지를 사용하십시오. 참조의 JNDI 이름과 같은 참조의 WebSphere 바인딩도 이 페이지에서 설정합니다. Bean을 선택하고 추가를 클릭하여 참조 추가 마법사를 여십시오. 자세한 정보는 Java EE 모듈에 대한 참조 정의를 참조하십시오.

참조 페이지는 Bean 페이지와 같이 설정되며 왼쪽 여백 섹션의 선택에 따라 오른쪽 세부사항 섹션이 동적으로 변경됩니다.

WS 핸들러 페이지

EJB 모듈의 엔터프라이즈 Bean에 대해 정의된 각 웹 서비스 참조의 웹 서비스 핸들러를 정의하려면 핸들러 페이지를 사용하십시오. 자세한 정보는 웹 서비스 핸들러 정의를 참조하십시오.

어셈블리 페이지

보안 역할, 메소드 권한 및 메소드 트랜잭션을 정의하려면 이 페이지를 사용하십시오. 이 페이지에서는 보안 제한조건에서 메소드를 제외할 수도 있습니다. 어셈블리 페이지는 다음 섹션으로 구성되어 있습니다.

보안 역할
이 섹션을 사용하여 보안 역할을 정의하십시오. 보안 역할은 메소드 권한을 빌드하는 데 필요합니다. 이 섹션에는 정의된 보안 역할이 나열되며 선택한 보안 역할의 세부사항이 표시됩니다.
메소드 권한
이 섹션을 사용하여 메소드 레벨에서 Bean에 권한을 추가하십시오. 이 섹션에는 기존 메소드 권한 목록이 있는 트리가 있습니다. 메소드 권한을 작성할 때 트리에서 확인할 수 있습니다. 트리를 펼치면 메소드 권한에 정의된 Bean과 메소드가 표시됩니다.
컨테이너 트랜잭션
추가를 클릭하여 컨테이너 트랜잭션 마법사를 실행하십시오. 트리 오브젝트를 선택하고 제거 단추를 클릭하면 트랜잭션이 제거됩니다.
제외 목록
EJB 2.x 모듈의 경우 이 섹션을 사용하여 배치 디스크립터에서 호출할 수 없는 메소드 요소를 표시하십시오.

액세스 페이지

액세스 페이지를 사용하여 CMP 엔티티 Bean의 액세스 목적, 분리 레벨 및 보안 ID 특성 변수를 정의하십시오. EJB 프로젝트의 EJB 버전 레벨에 따라 액세스 페이지에는 WebSphere 확장기능을 포함한 여러 섹션이 표시됩니다. 사용 가능한 섹션은 다음과 같습니다.

보안 ID(Bean 레벨)
이 섹션을 사용하여 보안 ID를 추가하십시오.
엔티티 2.x의 기본 액세스 목적(Bean 레벨)
이 섹션을 사용하여 Bean 레벨 보안 ID의 기본 액세스 목적을 정의하십시오.
엔티티 2.x의 액세스 목적(메소드 레벨)
이 섹션을 사용하여 메소드 레벨 보안 ID의 액세스 목적을 정의하십시오.
엔티티 1.x의 액세스 목적
WebSphere Application Server 확장기능입니다. 이 섹션을 사용하여 Bean 레벨 보안 ID의 기본 액세스 목적을 정의하십시오.
분리 레벨
WebSphere Application Server 확장기능입니다. 이 섹션을 사용하여 Bean 레벨 보안 ID의 기본 액세스 목적을 정의하십시오.
보안 ID(메소드 레벨)
WebSphere Application Server 확장기능입니다. 이 섹션을 사용하여 보안 ID를 추가하십시오.

WS 확장 페이지

이 페이지를 사용하여 WebSphere Application Server의 웹 서비스 클라이언트 보안 확장기능을 정의하십시오.

WS 바인딩 페이지

이 페이지를 사용하여 WebSphere Application Server의 웹 서비스 클라이언트 바인딩을 정의하십시오.

중개 핸들러 페이지

이 페이지를 사용하여 중개 핸들러 엔터프라이즈 Bean의 배치 디스크립터 파일을 편집하고 WebSphere Application Server를 내보낼 준비가 된 EAR 파일로 저장하십시오.

중개 핸들러는 중개에서 배치 및 관리 유닛의 역할을 담당하는 Java 프로그램입니다. 여기에는 동작을 제어하는 중개 매개변수가 있습니다. 중개 핸들러는 중개 핸들러 목록의 컴포넌트입니다. 각 중개 핸들러는 런타임에 다음과 같은 특정 메시지 처리를 실행합니다.
  • 한 형식에서 다른 형식으로 메시지 변환
  • 송신 애플리케이션에서 지정하지 않은 하나 이상의 대상 목적지로 메시지 라우팅
  • 데이터 소스에서 데이터를 추가하여 메시지 기능 보강

국제화 페이지

이 페이지를 사용하여 Bean의 국제화 정책 유형 및 속성을 구성하십시오.

ActivitySession 페이지

이 페이지를 사용하여 Bean의 ActivitySession을 추가, 편집 또는 제거하십시오.

확장 액세스 페이지

이 페이지를 사용하여 컨테이너 및 애플리케이션 관리 태스크와 엔터프라이즈 Bean의 기타 액세스 특성을 구성하십시오.

소스 페이지

소스 페이지를 사용하여 EJB 모듈의 배치 디스크립터(ejb-jar.xml)와 연관된 XML 소스 코드를 보고 수정하십시오. 소스 페이지는 XML 편집기입니다. EJB 배치 디스크립터 편집기가 편집되면 XML이 동적으로 변경됩니다. XML 소스를 변경하면 EJB 배치 디스크립터 편집기의 다른 페이지가 이러한 변경의 영향을 받습니다.

편집기를 저장할 때까지 EJB 배치 디스크립터 편집기의 변경사항은 커미트되지 않습니다. 편집기를 저장하지 않고 닫으면 변경사항이 커미트되지 않습니다. EJB 배치 디스크립터 편집기에서 편집할 수 있는 Java 파일과 바인딩 및 확장 파일에 대해 변경한 사항도 여기에 포함됩니다. 기존 Java 편집기가 현재 열려 있으며 EJB 배치 디스크립터 편집기를 변경하여 열려 있는 Java 파일로 코드가 생성된 경우 열려 있는 편집기로 변경사항이 생성됩니다. EJB 배치 디스크립터 편집기가 저장된 경우 Java 변경사항도 저장됩니다. EJB 배치 디스크립터 편집기를 저장하지 않고 닫은 경우 모든 변경사항을 버리지만 열려 있는 Java 편집기에 현재 있는 변경사항은 제외됩니다. 현재 열린 파일에 대한 다른 참조가 있으므로 이러한 변경사항은 계속 남아 있습니다. EJB 배치 디스크립터 편집기 또는 해당 자원에 대한 다른 참조가 없는 경우에만 EJB 배치 디스크립터 편집기를 저장하도록 프롬프트가 표시됩니다. 두 개의 EJB 배치 디스크립터 편집기가 두 개의 다른 퍼스펙티브에 열려 있거나 EJB 배치 디스크립터 편집기 및 EJB 배치 디스크립터 편집기가 하나 이상의 퍼스펙티브에 열려 있는 경우 두 경우에 모두 변경사항이 표시되며 후자가 닫힌 경우에만 저장하도록 프롬프트가 표시됩니다.


피드백