EJB 컨테이너 시스템 특성

관리 콘솔에서 액세스 가능한 설정 외에, 명령행 스크립트를 사용하여 EJB 시스템 특성을 설정할 수 있습니다.

com.ibm.websphere.ejbcontainer.allowEarlyInsert

이 특성은 컨테이너 관리 지속(CMP) 1.1 Bean에만 적용 가능합니다. 기본적으로, EJB 컨테이너는 ejbPostCreate(...) 메소드가 호출된 이후에만 데이터베이스에서 엔티티 Bean 표시를 작성합니다.

지원된 구성 지원된 구성: CMP Bean은 EJB 3.x 모듈에서 지원되지 않습니다. sptcfg

일부 애플리케이션은 ejbCreate(...) 메소드에 의존하여 데이터베이스에서 엔티티 Bean을 작성할 수 있습니다. 이러한 요구사항의 경우, JVM 특성인 com.ibm.websphere.ejbcontainer.allowEarlyInsert를 true로 설정하면 기본 작동이 대체됩니다.

com.ibm.websphere.ejbcontainer.checkEJBApplicationConfiguration

애플리케이션이 Java™ EE(Java Platform, Enterprise Edition) 스펙과 일치하는지 확인하기 위해 컨테이너가 추가 애플리케이션 구성 유효성 검증을 완료해야 함을 표시하는 서버 범위 설정을 지정합니다.

지원된 구성 지원된 구성: 애플리케이션 사용자 정의 특성으로 이 특성을 지정할 수도 있습니다. sptcfg

이 특성은 애플리케이션 개발 중에 결과적으로 예기치 않은 동작을 일으킬 수 있는 부적절한 구성을 식별하는 것을 지원하는 데 사용됩니다. 예를 들어, javax.ejb.Asynchronous 어노테이션을 인터페이스에 적용하는 것은 스펙에 의해 지원되지 않으며 일반적으로 무시됩니다. 이 특성이 사용 가능하면 오류가 로그되고 Bean이 처리될 때 예외가 발생합니다. 이러한 장애는 개발 중에 메소드가 비동기로 작동하지 않는 이유를 이해하는 데 유용합니다.

이 특성이 사용 가능하면 추가 구성 유효성 검증이 완료되고 여러 구성 경고 및 오류가 로그되는 결과가 발생할 수 있습니다. 일반적으로 이 추가 유효성 검증은 추가 오버헤드 실행을 초래하는 시나리오에 필요하며 프로덕션 서버의 안정된 애플리케이션에 대해서는 불필요합니다. 스펙에서 약간 벗어나는 경우, 경고만 로그됩니다. 좀 더 중요한 문제의 경우, 오류가 로그되고 오류가 정정될 때까지 애플리케이션이 실행되지 않습니다.

문제점 방지 문제점 방지: com.ibm.websphere.ejbcontainer.checkEJBApplicationConfiguration 특성이 사용 가능하면 경고로 보고된 일부 문제가 오류로 표시되어 애플리케이션이 시작되지 않습니다. gotcha
지원된 구성 지원된 구성: 개발 모드에 적합하게 구성된 임베드 가능한 컨테이너 및 서버는 이 특성과 연관된 추가 유효성 검증을 수행합니다. 그러나 이 특성이 특정적으로 사용 가능한 경우를 제외하고 모든 식별된 문제는 오류가 아니라 경고로 보고됩니다. sptcfg

com.ibm.websphere.ejbcontainer.declaredUncheckedAreSystemExceptions

이 특성을 사용하여 EJB 메소드의 throws 절에서 선언된 예외가 애플리케이션 예외로 처리되어야 하는지 또는 시스템 런타임 예외로 처리되어야 하는지를 표시할 수 있습니다. 이 특성이 true로 설정되면 해당 예외는 시스템 런타임 예외와 같이 처리되며 EJBException이 클라이언트측에서 발생되는 원인이 됩니다.

이 특성이 지정되지 않거나 이 특성이 false로 설정되면 EJB 메소드의 throws 절에서 선언된 예외가 애플리케이션 예외로 처리됩니다.

이 특성의 기본값은 false입니다.

상태 전이: 버전 7에서 이 특성의 기본값은 true입니다.

com.ibm.websphere.ejbcontainer.defaultSessionAccessTimeout

이 특성을 사용하여 서버에 있는 모든 세션 Bean의 기본 세션 동시성 액세스 제한시간을 지정할 수 있습니다. 값은 밀리초 단위로 지정되었습니다.

다음과 같이 세션 동시성을 사용하거나 사용하지 않도록 Long 데이터 유형 값을 지정하십시오.

  • 값이 0이면 세션 동시성을 사용하게 됩니다(대기 안함).
  • Long 데이터 유형의 양수 값(1, 2, 3 등)이면 세션 동시성을 사용하게 되고 제한시간 값이 지정된 밀리초로 설정됩니다.

이 특성을 설정하면 기본값 -1(영구 대기) 대신, 지정된 세션 Bean 동시성 액세스 제한시간이 서버 전체에서 사용됩니다. 이 특성은 Stateful 및 싱글톤 세션 Bean에 적용됩니다. 개별 세션 Bean 레벨에서는 Bean 클래스나 메소드에서 @AccessTimeout 어노테이션을 사용하거나 액세스 제한시간 배치 디스크립터 요소를 사용하여 제한시간을 대체할 수 있습니다.

com.ibm.websphere.ejbcontainer.defaultStatefulSessionTimeout

Stateful 세션 Bean이 서버에서 보유되는 기간을 표시하는 Stateful 세션 Bean에 대한 서버 범위 제한시간을 지정합니다.

지원된 구성 지원된 구성: 이 특성은 EJB 3.1 모듈 이상에만 적용됩니다. sptcfg

이는 server.xml 파일에 직접 추가하거나 관리 콘솔을 사용하여 일반 JVM 인수로 추가할 수 있는 시스템 특성입니다.

이 특성은 유일한 유효 단위인 분 단위로 지정됩니다. 기본값은 10분입니다. 0의 값은 서버가 10분의 기본값을 사용함을 지정합니다. 음수 값은 유효하지 않습니다. 0 이상의 값은 유효합니다. 유효하지 않은 값이 지정된 경우, 경고가 SystemOut에 발행되며 기본값이 사용됩니다.

어노테이션 또는 xml을 사용하여 Bean당 기준으로 Stateful 세션 Bean 제한시간 지속 기간을 지정할 수 있습니다. 특정 Bean에 대해 제한시간 지속 기간이 명시적으로 지정된 경우, 이는 모든 서버 범위 제한시간 설정보다 우선순위가 높습니다.

특정 Bean에 대해 Bean 특정 제한시간 지속 기간이 없는 경우, 서버 범위 제한시간 설정이 해당 Bean에 적용됩니다.

특정 Bean에 대해 Bean 특정 제한시간 지속 기간이 없고 서버 범위 제한시간 설정도 없는 경우, 기본 제한시간 설정이 해당 Bean에 적용됩니다.

com.ibm.websphere.ejbcontainer.EE5Compatibility

EJB 컨테이너가 Java EE(Java Enterprise Edition) 5.0 스펙과 일치하는 기본 동작을 제공함을 표시하는 서버 범위 설정을 지정합니다.

이는 server.xml 파일에 직접 추가하거나 관리 콘솔을 사용하여 일반 JVM 인수로 추가할 수 있는 시스템 특성입니다.

Java EE 스펙에는 일부 기본 동작을 사소하게 변경하는 결과를 가져온 EJB 프로그래밍 모델에 대한 개선사항이 포함되어 있습니다. 일반적으로 이러한 변경사항은 더 직관적이거나 더 신뢰할 수 있는 동작을 제공합니다. 그러나 애플리케이션이 하나 이상의 Java EE 5.0 동작에 의존하도록 작성된 경우, 이 시스템 특성은 EJB 컨테이너를 Java EE 5.0 기본 동작으로 되돌리도록 설정될 수 있습니다.

이 특성을 true로 설정하면 다음 동작이 대체됩니다.

  • @ApplicationException 어노테이션이 상속되지 않습니다. Java EE 6.0 스펙부터 @ApplicationException 어노테이션이 서브클래스 예외 클래스에 의해 상속됨을 나타내도록 해당 어노테이션의 기본 동작이 변경되었습니다. 이 시스템 특성이 지정되면 @ApplicationException 어노테이션은 서브클래스 예외 클래스에 의해 상속되지 않습니다. 대신에 'inherited=false'를 지정하도록 @ApplicationException 선언을 변경할 수 있습니다.
  • Stateful 세션 Bean에 동시에 액세스하는 것이 금지되며 그 결과 javax.ejb.ConcurrentAccessException 예외가 발생합니다. Java EE 6.0 스펙부터 Stateful 세션 동시성에 대한 기본 동작이 동시 액세스를 허용하도록 변경되었지만 각 동시 요청이 컨테이너에 의해 직렬화되어 인스턴스 잠금을 얻을 수 있을 때까지 Bean 인스턴스에 대한 액세스를 무제한으로 차단합니다. 이 시스템 특성이 지정되면 명시적 액세스 제한시간 값이 지정되지 않은 모든 Stateful 세션 Bean은 기본 액세스 제한시간 값을 0(Java EE 5.0 기본값)으로 가정합니다. 또는 액세스 제한시간 값을 0으로 정의하도록 Stateful 세션 Bean을 수정할 수 있습니다.
  • Enum의 Java 유형인 Class 및 Enum의 모든 서브클래스는 단순 환경 항목이 아니라 자원 환경 참조로 처리됩니다. Java EE 6.0 스펙부터 Enum의 Java 유형, 클래스 및 모든 서브클래스는 지원되는 단순 환경 항목 유형 세트에 추가되었습니다. Java EE의 이전 버전에서는 이러한 유형은 자원 환경 참조로 처리되었으며 ibm-ejb-jar-bnd.xml 파일 또는 ibm-web-bnd.xml 파일에서 바인딩이 필요합니다. 이제 이러한 데이터 유형이 단순 환경 항목으로 지원되므로 플랫폼 특정 바인딩은 더 이상 필요하지 않습니다. 대신에 배치 디스크립터에서 값을 직접 지정할 수 있습니다. 이 시스템 특성이 지정되면 Enum의 모든 서브클래스 또는 Java 유형인 Class에 대해 javax.annotation.Resource 어노테이션을 사용하는 애플리케이션은 자원 환경 참조로 처리되며 바인딩 파일 정보를 사용하여 참조되는 값을 얻습니다. 애플리케이션 설치는 이 특성의 영향을 받지 않으므로 설치 중에 바인딩 정보가 입력되지 않습니다. 대신에 바인딩 파일에 바인딩 정보를 수동으로 입력해야 합니다.

com.ibm.websphere.ejbcontainer.EE6Compatibility

EJB 컨테이너가 Java EE(Java Enterprise Edition) 6.0 스펙과 일치하는 기본 동작을 제공함을 표시하는 서버 범위 설정을 지정합니다.

이는 server.xml 파일에 직접 추가하거나 관리 콘솔을 사용하여 일반 JVM 인수로 추가할 수 있는 시스템 특성입니다.

Java EE 스펙에는 일부 기본 동작을 사소하게 변경하는 결과를 가져온 EJB 프로그래밍 모델에 대한 개선사항이 포함되어 있습니다. 일반적으로 이러한 변경사항은 더 직관적이거나 더 신뢰할 수 있는 동작을 제공합니다. 그러나 애플리케이션이 하나 이상의 Java EE 6.0 동작에 의존하도록 작성된 경우, 이 시스템 특성은 EJB 컨테이너를 Java EE 6.0 기본 동작으로 되돌리도록 설정될 수 있습니다.

Bean 클래스에서 비어 있는 값으로 지정되거나 다른 비즈니스 인터페이스가 지정되더라도 특성을 true로 설정하면 @Local 및 @Remote 어노테이션이 무시되지 않게 합니다. 특성이 지정되지 않으며 이 어노테이션이 Bean 클래스에서 지정된 경우, 다음의 경우가 아닌 경우 어노테이션으로 구현 절의 인터페이스가 로컬이나 원격 비즈니스로 간주됩니다.

  1. <business-local>, <business-remote> 또는 <local-bean> 인터페이스는 ejb-jar.xml 파일에서 지정됩니다.
  2. @LocalBean 어노테이션은 Bean 클래스에 지정됩니다.
  3. 비어 있는 값이 있는 @Local 또는 @Remote 어노테이션은 구현 절의 인터페이스 클래스에서 지정됩니다.

특성이 지정되면, 이 지정 중 하나를 사용하더라도 구현 절의 단일 인터페이스는 로컬이나 원격 비즈니스 인터페이스로 여전히 간주됩니다. 특성 설정 대신, 비어 있는 값이 있는 @Local 또는 @Remote 어노테이션을 제거하고 대신 다른 옵션 중 하나를 사용할 수 있습니다.

com.ibm.websphere.ejbcontainer.excludeRootExceptionOnRollback

기본적으로 EJB 컨테이너는 트랜잭션 롤백 동안 발생하는 예외의 근본 원인을 설정할 것입니다. 이 특성이 true로 설정되는 경우 EJB 컨테이너는 근본 원인을 설정하지 않습니다. 이것은 애플리케이션이 원인을 찾을 것으로 기대하지 않는 경우 또는 애플리케이션이 예외를 로그하고 지금 상당히 더 많은 데이터를 로깅 중인 경우에 유용합니다.

com.ibm.websphere.ejbcontainer.extendSetRollbackOnlyBehaviorToInstanceFor

이 특성을 사용하여 사용자는 EJB 3.x 모듈의 EJB로 EJB 3.0 이전 setRollbackOnly 동작을 설명하려는 애플리케이션 이름을 지정할 수 있습니다.

EJB 3.0 이전 setRollbackOnly 동작은 애플리케이션을 WebSphere "버전 특정" setRollbackOnly 동작으로 변경에 설명되어 있습니다.

com.ibm.websphere.ejbcontainer.limitSetRollbackOnlyBehaviorToInstanceFor

이 특성을 사용하여 사용자는 EJB 3.x 모듈의 EJB로 EJB 3.x setRollbackOnly 동작을 설명하려는 애플리케이션 이름을 지정할 수 있습니다.

EJB 3.x setRollbackOnly 동작은 애플리케이션을 WebSphere "버전 특정" setRollbackOnly 동작으로 변경에 설명되어 있습니다.

com.ibm.websphere.ejbcontainer.poolSize

지정된 Bean 유형에 대한 풀의 크기를 지정합니다. 이 특성은 Stateless, 메시지 구동 및 엔티티 Bean에 적용됩니다. 기본값을 지정하지 않으면 컨테이너 기본값인 50과 500이 사용됩니다.

제공된 엔티티 Bean에 대한 풀 크기를 다음과 같이 설정하십시오.
beantype=[H]min,[H]max [:beantype=[H]min,[H]max...]

beantype 요소는 애플리케이션 이름, # 문자, 모듈 이름, # 문자와 Bean 이름을 연결하여 형성된 Bean의 Java EE 이름(Bean의 배치 디스크립터에 있는 <ejb-name> 필드에 지정된 문자열)입니다. minmax 요소는 해당 Bean 유형의 최소 풀 크기와 최대 풀 크기입니다. 이전 프로토타입에 표시된 대괄호를 지정하지 마십시오. 대괄호는 첫 번째 Bean 유형 다음에 지정할 수 있는 선택척 추가 Bean 유형을 선언합니다. 각 Bean 유형 스펙은 콜론(:)으로 분리됩니다.

모든 Bean 유형이 문자열에 포함된 실제 Bean 유형 스펙에 의해 대체되지 않고 해당 값을 사용하도록 표시하려면 beantype의 값으로 별표(*)를 사용하십시오. 예를 들면, 다음과 같습니다.
*=30,100
기본값을 지정하려면 min 또는 max 값은 생략하고 두 값 사이의 쉼표(,)는 그대로 두십시오. 예를 들면, 다음과 같습니다.
참고: 다음 예제는 공개를 위해 여러 행에 표시됩니다.
SMApp#PerfModule#TunerBean=54,
   :SMApp#SMModule#TypeBean=100,200

문자열 내에서 Bean 유형을 임의 순서로 지정할 수 있습니다.

문자 Hmax 값 앞에 직접 삽입하여 구성된 EJB 풀 크기의 최대값을 하드 한계로 지정할 수 있습니다. H 문자가 없는 경우 이 최대값은 풀할 수 있는 EJB 인스턴스의 수를 나타내며 작성 또는 사용할 수 있는 EJB 인스턴스의 수를 제한하지 않습니다. 최대값 앞에 H 문자를 삽입하면 하드 한계를 나타내는 것으로서, 그 한계보다 많은 인스턴스를 EJB 컨테이너에서 작성하지 않도록 막게 됩니다. 그 이상의 스레드는 인스턴스를 사용 가능하게 되거나 트랜잭션의 제한시간이 초과될 때까지 대기해야 합니다.

문자 Hmin 값 앞에 직접 삽입하여 구성된 EJB 풀 크기의 최소값을 하드 한계로 지정할 수 있습니다. H 문자가 없는 경우 이 최소값은 EJB 유형이 사용되고 있지 않을 때 풀에서 관리되는 EJB 인스턴스의 수는 나타내지만, 애플리케이션이 시작될 때 해당 풀을 사전 로드하지는 않습니다. 일반적으로 최소 풀 크기는 애플리케이션에서 현재 가장 적은 EJB 인스턴스 수에 액세스했을 때 도달됩니다. 최소값 앞에 H 문자를 삽입하면 하드 한계를 나타내는 것으로서, 애플리케이션이 시작할 때 EJB 컨테이너에서 가장 적은 EJB 인스턴스 수로 해당 풀을 사전 로드합니다.

예를 들어, EJB 인스턴스를 200개까지 작성되도록 표시하고 추가 요청이 있는 경우 대기하도록 하며 대기 중 제한시간 초과가 있을 수 있게 하려면 다음을 입력하십시오.
SMApp#SMModule#TypeBean=100,H200
EJB 컨테이너에서 애플리케이션이 시작될 때 최소한 100개의 EJB 인스턴스로 풀을 사전 로드하도록 하려면 다음을 입력하십시오.
SMApp#SMModule#TypeBean=H100,200
지원된 구성 지원된 구성: 하드 한계 표시기는 EJB 버전 2.0 이상인 Stateless 세션 Bean에만 사용할 수 있습니다. sptcfg

주제 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rejb_ecnt
파일 이름:rejb_ecnt.html