작업 영역 파티션 관리자 인터페이스

애플리케이션은 작업 영역 파티션 관리자 인터페이스를 사용하여 작업 영역 파티션과 상호 작용합니다. 사용자는 이름 지정을 벗어난 작업 영역 파티션 관리자 인터페이스의 인스턴스를 검색할 수 있고 다음 절에서 정의된 메소드를 사용할 수 있습니다.

작업 영역 파티션 관리자 인터페이스의 구현은 java:comp/websphere/WorkAreaPartitionManager에서 Java™ 이름 지정에 바인드됩니다. 이 인터페이스는 작업 영역 파티션 작성, 검색, 조작을 수행할 수 있습니다.

package com.ibm.websphere.workarea;

import com.ibm.websphere.workarea.UserWorkArea;
import com.ibm.websphere.workarea.PartitionAlreadyExistsException;
import com.ibm.websphere.workarea.NoSuchPartitionException;
import java.util.Properties; 

public interface WorkAreaPartitionManager {
	
  //Returns an instance of a work area partition for the given name, or throws an exception if the 
  //partition name doesn't exists.                                   
  public UserWorkArea getWorkAreaPartition(String partitionName) throws NoSuchPartitionException;
	
  //Returns a new instance of a work area partition (an implementation of the UserWorkArea interface) 
  //or throws an exception if the partition name already exists.  The createWorkAreaPartition should 
  //only be used within a Java EE platform client and NOT on the 
  //server.  To create a work area partition on the server, use the WebSphere administrative 
  //console.
  public UserWorkArea createWorkAreaPartition(String partitionName, Properties props) throws
     PartitionAlreadyExistsException, java.lang.IllegalAccessException;
  }
}

EJB 애플리케이션은 원격 또는 로컬 인터페이스의 메소드 구현 내에서만 작업 영역 파티션 관리자 인터페이스를 사용할 수 있습니다. 마찬가지로, 서블릿은 HTTPServlet 클래스의 서비스 메소드 내에서만 인터페이스를 사용할 수 있습니다. 서블릿 또는 엔터프라이즈 Bean의 라이프 사이클 메소드 내에서 작업 영역을 사용하는 것은 작업 영역 프로그래밍 모델에서 벗어나는 것으로 간주되어 지원되지 않습니다.

createWorkAreaPartition 메소드를 통해 프로그래밍 방식으로 작업 영역 파티션을 작성하는 방법은 Java EE 클라이언트에서만 사용 가능합니다. 서버에서 작업 영역 파티션을 작성하려면 작업 영역 파티션 구성 문서에서 설명한 대로 WebSphere® 관리 콘솔을 사용하십시오. 작업 영역 서비스가 적절한 컨테이너 협업자로 등록할 수 있도록 서버 프로세스의 모든 파티션이 서버 시작 완료 전에 작성되어야 합니다. 따라서 서버가 시작된 후 서버 프로세스에서 createWorkAreaPartition 메소드를 호출하면 java.lang.IllegalAccessException 예외가 발생합니다. createWorkAreaPartition 메소드는 언제라도 Java EE 애플리케이션 클라이언트에서 호출 가능합니다.

구성 가능한 작업 영역 파티션 특성

이 절은 WorkAreaPartitionManager 인터페이스에서 createWorkAreaPartition 메소드를 사용할 때 적용됩니다. 이전에 설명한 대로, 이 메소드는 Java EE 클라이언트에서만 사용되어야 합니다. 서버에서 파티션을 작성하려면 작업 영역 파티션 구성을 참조하십시오.

WorkAreaPartitionManager 인터페이스의 "createWorkAreaPartition" 메소드는 java.util.Properties 오브젝트를 사용합니다. 이 Properties 오브젝트 및 여기에 포함된 특성을 사용하여 작업 영역 파티션을 정의합니다. 다음은 Properties 오브젝트를 작성하고 특성을 설정하는 예입니다.

주의: WorkAreaPartitionManager 사용에 대한 자세한 예제는 예제: 작업 영역 파티션 관리자 사용에서 찾을 수 있습니다.
java.util.Properties props = new java.util.Properties():
props.put("maxSendSize","12345");

파티션 정의를 위해 승인 가능한 키/값 쌍(특성)은 다음과 같습니다.

  • maxSendSize - 원격 호출로 보낼 수 있는 작업 영역의 최대 크기(바이트)를 나타냅니다. 승인 가능한 값은 다음과 같습니다.
    • "-1" = 기본 크기 32767을 사용합니다.
    • "0" = 크기 제한 없음, 이 값은 규제되지 않으며, 따라서 애플리케이션에 있는 작업 영역의 수에 따라 성능 향상에 도움이 될 수 있습니다.
    • "1" = Integer.MAX_VALUE
  • maxReceiveSize - 수신할 수 있는 작업 영역의 최대 크기(바이트)를 나타냅니다. 승인 가능한 값은 다음과 같습니다.
    • "-1" = 기본 크기 32767을 사용합니다.
    • "0" = 크기 제한 없음, 이 값은 규제되지 않으며, 따라서 애플리케이션에 있는 작업 영역의 수에 따라 성능 향상에 도움이 될 수 있습니다.
    • "1" = Integer.MAX_VALUE
  • Bidirectional - 다운스트림 프로세스에 의해 변경된 작업 영역 컨텍스트가 해당 컨텍스트의 제안자로 다시 업스트림 전파되어야 하는지 여부를 나타냅니다. 이 특성에 대한 보다 완전한 설명은 작업 영역 파티션 서비스 문서에서 "작업 영역 컨텍스트의 양방향 전파"를 참조하십시오. 승인 가능한 값은 다음과 같습니다.
    • "true" = 원격 호출로부터 컨텍스트 변경사항이 리턴됩니다.
    • "false" = 원격 호출로부터 컨텍스트 변경사항이 리턴되지 않습니다.
    주의: 기본 설정은 "false"입니다.
  • DeferredAttributeSerialization - 속성의 직렬화가 프로세스당 정확히 한 번씩 발생하도록 최적화되어야 하는지 여부를 나타냅니다. 이 특성에 대한 보다 완전한 설명은 작업 영역 파티션 서비스 문서에서 "작업 영역 컨텍스트의 연기된 속성 직렬화" 절을 참조하십시오. 승인 가능한 값은 다음과 같습니다.
    • "true"
      • 속성이 작업 영역에 설정되면, 원격 요청이 있을 때까지 직렬화되지 않습니다.
      • 값이 응답에 따라 변경되지 않은 경우, 후속 응답에 대해 직렬화된 양식이 사용됩니다. 활성 오브젝트는 Getter를 통해 검색합니다.
      • 원격 요청 중에 요청이 있으면 값이 요구에 따라 정확히 한 번만 직렬화 해제됩니다. 이 분배된 스레드에서 원격 프로세스로부터의 후속 요청에 대해 직렬화된 양식이 사용됩니다. 동일한 속성에 대해 처리 중인 후속 요청은 이미 직렬화 해제된 값을 리턴합니다. DeferredAttributeSerialization과의 동시성과 관련하여 위험 요소가 있습니다. 클라이언트 프로세스에서 직렬화 이후에 UserWorkArea 인터페이스를 통해 값을 명시적으로 재설정할 때까지 작업 영역의 사본에서 속성에 대한 업데이트는 더 이상 반영되지 않습니다. UserWorkArea 인터페이스를 통해 명시적으로 재설정하지 않으면, 다운스트림 프로세스에서 검색된 참조에 대한 변경사항이 후속 다운스트림 요청에 전파되지 않습니다. (또는 응답 시 변경된 값으로 리턴되지 않습니다.)
    • "false"
      • 속성이 작업 영역에 설정되면, 즉시 직렬화되고 바이트가 저장됩니다.
      • 작업 영역에서 속성을 가져오는 경우에는 항상 저장된 바이트로부터 직렬화 해제됩니다.
    주의: 기본값은 "false"입니다.
  • EnableWebServicePropagation - 작업 영역 컨텍스트가 WebService 호출에 전파되어야 하는지 여부를 나타냅니다. 승인 가능한 값은 다음과 같습니다.
    • "true" = 컨텍스트가 WebService 호출에 전파됩니다.
    • "false" = 컨텍스트가 WebService 호출에 전파되지 않습니다.
    주의: 기본값은 "false"입니다.

예외

작업 영역 파티션 서비스는 작업 영역 파티션 관리자 인터페이스에서 사용할 수 있도록 다음 예외를 정의합니다.
PartitionAlreadyExistsException
이 예외는 사용자가 기존의 파티션 이름으로 작업 영역 파티션을 작성하려는 경우 WorkAreaPartitionManager 구현의 createWorkAreaPartition 메소드에 의해 발생합니다. 파티션 이름은 고유해야 합니다.
NoSuchPartitionException
이 예외는 사용자가 존재하지 않는 파티션 이름의 작업 영역 파티션을 요청할 경우 WorkAreaPartitionManager 구현의 getWorkAreaPartition 메소드에 의해 발생합니다.
java.lang.IllegalAccessException
이 예외는 사용자가 서버 프로세스에서 런타임 중 작업 영역 파티션을 작성하려는 경우에 WorkAreaPartitionManager 구현의 createWorkAreaPartition 메소드에 의해 발생합니다. 이 메소드는 Java EE 클라이언트 프로세스에서만 사용할 수 있습니다. 서버 프로세스에서는 관리 콘솔을 사용하여 파티션을 작성해야 합니다.

작업 영역에 대한 추가 정보는 API(Application Programming Interface)의 com.ibm.websphere.workarea 패키지를 참조하십시오. 생성된 API 문서는 참조 > API - 애플리케이션 프로그래밍 인터페이스 경로의 Information Center 목차에서 사용 가능합니다.


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



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