Blueprint XML 파일 작성
Blueprint 구성 파일에는 컴포넌트 어셈블리와 번들 구성 정보가 포함되어 있습니다. 이 파일에는 컴포넌트가 OSGi 서비스 레지스트리에 어떻게 등록되는지 또는 이러한 컴포넌트가 OSGi 서비스 레지스트리에서 서비스를 어떻게 검색하는지가 기술되어 있습니다. 이 정보는 번들이 시작될 때 필수 컴포넌트를 인스턴스화하고 구성하기 위해 런타임 시 사용됩니다.
프로시저
- 번들 프로젝트를 마우스 오른쪽 단추로 클릭하고 새로 작성 > Blueprint 파일을 선택하십시오. 새 Blueprint 파일 마법사가 열립니다.
- 파일 이름 필드에서 Blueprint 구성 파일의 이름을 입력한 후 다음을 클릭하십시오.
- 마법사의 추가 Blueprint 네임스페이스 추가 또는 제거 페이지에서
Blueprint 파일에 추가할 네임스페이스를
선택하십시오. Blueprint 확장기능, JPA, 자원 참조 및 트랜잭션을 위해 네임스페이스를 추가할 수 있습니다.Blueprint 네임스페이스에 대한 자세한 정보 학습:
표 1. Blueprint 네임스페이스에 대한 설명 스키마 URL 설명 Blueprint 확장기능 http://aries.apache.org/blueprint/xmlns/blueprint-ext/v1.0.0 IBM® Blueprint 확장기능
필드 인젝션과 같은 OSGi Blueprint 프로그래밍 모델에 대한 확장기능입니다.
Blueprint 보안 http://www.ibm.com/appserver/schemas/blueprint/security/v1.0.0 IBM Blueprint 보안
Bean의 메소드에 지정된 역할이 할당된 사용자만 액세스할 수 있도록 Bean 보안을 구성하십시오.
JPA http://aries.apache.org/xmlns/jpa/v1.0.0 JPA Blueprint 지원
JPA(Java™ Persistence API) 통합을 Blueprint에 제공합니다. 지속성 단위와 지속성 컨텍스트는 Blueprint 관리 Bean에 삽입할 수 있습니다.
자원 참조 http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference Blueprint 자원 참조 지원
WebSphere® Application Server JNDI에서 선언되는 오브젝트(예: Blueprint 관리 Bean에 삽입될 데이터 소스 및 연결 팩토리)에 대해 제공됩니다.
트랜잭션 http://aries.apache.org/xmlns/transactions/v1.0.0 Blueprint 트랜잭션 지원
이 기능을 통해 개발자는 Blueprint 관리 Bean에 대한 트랜잭션 요구사항을 선언할 수 있습니다.
참고: 이 목록에 없는 기타 네임스페이스를 추가하려는 경우 소스 보기로 전환하고 네임스페이스를 입력하십시오. - 완료를 클릭하십시오. Blueprint 구성 파일이 편집기에서 열립니다.
- 사용자의 Blueprint 구성 파일에 컴포넌트 어셈블리 및 구성 정보를 추가하려면
추가를 클릭하십시오.
- Bean
- bean 요소는 인스턴스화되는 Blueprint 컴포넌트를 정의합니다. Bean에 인수 및 특성을 추가하려면 확인을 클릭하십시오.
- Bean 속성에 대한 자세한 정보 학습:
- ID
- id 속성은 컴포넌트를 식별합니다. 컴포넌트가 Blueprint와는 다른 곳에서 참조되는 경우(예: 컴포넌트가 서비스 정의에서 참조되는 경우) 이 속성은 필수입니다.
- 클래스
- class 속성은 컴포넌트의 구현 클래스가 인스턴스화되는 것을 지정합니다.
- 활성화
- 이 선택적 속성은 관리자를 위한 활성화 모드를 정의합니다.
다음 두 개의 활성화 모드가 지원됩니다.
- eager
- 관리자가 Blueprint 컨테이너 초기화 중에 활성화됩니다.
- lazy
- 요청 시 관리자가 활성화됩니다.
- 범위
- 범위 설정에 따라 Bean 관리자는 단일 또는 여러 오브젝트 인스턴스를
작성할 수 있습니다. Blueprint 컨테이너 스펙은
두 가지 기본 범위를 정의합니다.
- 싱글톤
- Bean 관리자는 Bean의 단일 인스턴스를 작성하고 오브젝트 제공 요청을 받을 때마다 해당 인스턴스를 리턴합니다.
- 프로토타입
- Bean 관리자는 오브젝트 제공 요청을 받을 때마다 Bean의 새 인스턴스를 작성합니다.
- 종속 위치
- 관리자 ID의 목록을 지정합니다. 관리자가 활성화되기 전에 목록에 있는 관리자가 먼저 활성화됩니다. 관리자는 명시적 및 내재적 종속 항목을 가질 수 있습니다. dependsOn 속성은 명시적 종속 항목을 정의합니다. 내재적 종속 항목은 참조에 의해 관리자 정의 내에서 다른 관리자에 대해 정의됩니다.
- 팩토리 참조
- 팩토리 역할을 하는 Bean 또는 참조 관리자의 ID를 지정합니다. 지정된 오브젝트에는 팩토리 메소드 속성에서 지정하는 대로 팩토리 메소드가 있어야 합니다.
- 영구 삭제 메소드
- Blueprint 컨테이너가 오브젝트 인스턴스를 영구 삭제할 때 호출되는 메소드를 지정합니다.
- 팩토리 메소드
- 정적 팩토리 메소드의 이름을 지정합니다.
- 초기화 메소드
- 초기화 메소드는 컴포넌트가 작성될 때 호출됩니다. 번들 초기화 중에 메소드를 호출하지 않으려면 이 속성을 제거하십시오.
- 참조
- reference 요소는 서비스 레지스트리에서 찾을 수 있는 특정 서비스를 지정합니다. 참조에 항목을 추가하려면 확인을 클릭하십시오.
- 참조 속성에 대한 자세한 정보 학습:
- ID
- id 속성은 컴포넌트를 식별합니다. 컴포넌트가 Blueprint와는 다른 곳에서 참조되는 경우(예: 컴포넌트가 서비스 정의에서 참조되는 경우) 이 속성은 필수입니다.
- 인터페이스
- interface 속성은 컴포넌트 클래스가 구현하는 인터페이스를 참조합니다.
- 활성화
- 이 선택적 속성은 관리자를 위한 활성화 모드를 정의합니다.
다음 두 개의 활성화 모드가 지원됩니다.
- eager
- 관리자가 Blueprint 컨테이너 초기화 중에 활성화됩니다.
- lazy
- 요청 시 관리자가 활성화됩니다.
- 사용 가능성
- 선택 기준과 일치하는 최소 한 개 이상의 서비스가
Blueprint 컨테이너 초기화가 계속되기 전에 존재하는 서비스 참조 관리자의
요구사항을 제어합니다. 사용 가능성 속성에는
다음 두 개의 값이 있습니다.
- 선택사항
- 기준과 일치하는 서비스가 존재하지 않아도 됩니다.
- 필수
- 기준과 일치하는 서비스가 최소 한 개 이상 있어야 합니다.
- 필터
- 서비스 선택을 위한 필터 표현식을 지정합니다.
- 제한시간
- 프록시가 사용 가능한 상태가 될 때까지 지원 서비스를 대기하는 시간의 양을 밀리초로 지정합니다.
- 컴포넌트 이름
- 필터에서 검색된 컴포넌트를 지정합니다.
- 종속 위치
- 관리자 ID의 목록을 지정합니다. 관리자가 활성화되기 전에 목록에 있는 관리자가 먼저 활성화됩니다. 관리자는 명시적 및 내재적 종속 항목을 가질 수 있습니다. dependsOn 속성은 명시적 종속 항목을 정의합니다. 내재적 종속 항목은 참조에 의해 관리자 정의 내에서 다른 관리자에 대해 정의됩니다.
- 참조 목록
- reference-list 요소를 사용하면 참조 요소가 여러 개의 일치 서비스를 발견할 수 있습니다. 참조 목록에 항목을 추가하려면 확인을 클릭하십시오.
- 참조 목록 속성에 대한 자세한 정보 학습:
- ID
- id 속성은 컴포넌트를 식별합니다. 컴포넌트가 Blueprint와는 다른 곳에서 참조되는 경우(예: 컴포넌트가 서비스 정의에서 참조되는 경우) 이 속성은 필수입니다.
- 인터페이스
- interface 속성은 컴포넌트 클래스가 구현하는 인터페이스를 참조합니다.
- 활성화
- 이 선택적 속성은 관리자를 위한 활성화 모드를 정의합니다.
다음 두 개의 활성화 모드가 지원됩니다.
- eager
- 관리자가 Blueprint 컨테이너 초기화 중에 활성화됩니다.
- lazy
- 요청 시 관리자가 활성화됩니다.
- 사용 가능성
- 선택 기준과 일치하는 최소 한 개 이상의 서비스가
Blueprint 컨테이너 초기화가 계속되기 전에 존재하는 서비스 참조 관리자의
요구사항을 제어합니다. 사용 가능성 속성에는
다음 두 개의 값이 있습니다.
- 선택사항
- 기준과 일치하는 서비스가 존재하지 않아도 됩니다.
- 필수
- 기준과 일치하는 서비스가 최소 한 개 이상 있어야 합니다.
- 필터
- 서비스 선택을 위한 필터 표현식을 지정합니다.
- 멤버 유형
- 참조 목록 관리자가 제공하는 멤버의 유형을 지정합니다.
멤버 유형 속성은 다음을 지원합니다.
- 서비스 오브젝트
- 서비스 프록시 오브젝트의 목록을 삽입합니다.
- 서비스 참조
- 서비스 참조 오브젝트의 목록을 삽입합니다.
- 컴포넌트 이름
- 필터에서 검색된 컴포넌트를 지정합니다.
- 종속 위치
- 관리자 ID의 목록을 지정합니다. 관리자가 활성화되기 전에 목록에 있는 관리자가 먼저 활성화됩니다. 관리자는 명시적 및 내재적 종속 항목을 가질 수 있습니다. dependsOn 속성은 명시적 종속 항목을 정의합니다. 내재적 종속 항목은 참조에 의해 관리자 정의 내에서 다른 관리자에 대해 정의됩니다.
- 서비스
- service 요소는 OSGi 서비스 레지스트리에 대한 컴포넌트의 내보내기를 정의합니다. 서비스에 항목을 추가하려면 확인을 클릭하십시오.
- 서비스 속성에 대한 자세한 정보 학습:
- ID
- id 속성은 컴포넌트를 식별합니다. 컴포넌트가 Blueprint와는 다른 곳에서 참조되는 경우(예: 컴포넌트가 서비스 정의에서 참조되는 경우) 이 속성은 필수입니다.
- 인터페이스
- interface 속성은 컴포넌트 클래스가 구현하는 인터페이스를 참조합니다.
- 활성화
- 이 선택적 속성은 관리자를 위한 활성화 모드를 정의합니다.
다음 두 개의 활성화 모드가 지원됩니다.
- eager
- 관리자가 Blueprint 컨테이너 초기화 중에 활성화됩니다.
- lazy
- 요청 시 관리자가 활성화됩니다.
- 자동 내보내기
- 자동 내보내기 설정은 자동 내보내기 속성에 의해 지정되고
다음 4개의 옵션을 지원합니다.
- 사용 안함
- 자동 내보내기 속성이 지정되지 않은 경우 기본값입니다. 인터페이스의 목록은 인터페이스 속성 또는 인터페이스 하위 요소를 사용하여 지정해야 합니다.
- 인터페이스
- 서비스 클래스와 그 수퍼클래스로 구현되는 모든 공용 인터페이스를 사용하여 서비스를 등록합니다.
- 클래스 계층
- 서비스 클래스와 그 공용 수퍼클래스를 사용하여 서비스를 등록합니다.
- 모든 클래스
- 인터페이스와 클래스 계층 옵션을 결합합니다.
- 순위
- 순위 속성을 사용하여 특정 순위로 서비스를 노출시킬 수 있습니다.
- 참조
- ref 속성은 내보낸 컴포넌트의 컴포넌트 ID를 참조합니다. 이는 컴포넌트 요소에서 정의됩니다.
- 종속 위치
- 관리자 ID의 목록을 지정합니다. 관리자가 활성화되기 전에 목록에 있는 관리자가 먼저 활성화됩니다. 관리자는 명시적 및 내재적 종속 항목을 가질 수 있습니다. dependsOn 속성은 명시적 종속 항목을 정의합니다. 내재적 종속 항목은 참조에 의해 관리자 정의 내에서 다른 관리자에 대해 정의됩니다.
- 유형 변환기
- type-converters 요소는 데이터 유형 사이에서 값을 변환합니다. 변환기에 항목을 추가하려면 확인을 클릭하십시오.
Blueprint 구성 파일에 대한 자세한 정보는 도움말 주제 OSGi Blueprint XML 파일 및 OSGi Blueprint 컨테이너 스펙의 내용을 참조하십시오.
- 번들의 인증 별명 바인딩에 대한 자원 참조를 포함하는
OSGi Blueprint 구성 파일을 작성하려면 WebSphere Blueprint 바인딩 디스크립터 열기를 클릭하십시오.
OSGi 애플리케이션에 OSGi Blueprint 바인딩 구성 파일이 있는 경우 이 파일이 자산으로 배치되면 이 바인딩 구성 파일은 자원 참조를 바인딩할 때 사용되는 기본 인증 별명을 제공합니다.
Blueprint 바인딩 파일에 대한 자세한 정보는 Blueprint 바인딩 XML 파일 작성의 내용을 참조하십시오.
- 추가 Blueprint 네임스페이스 추가 및 제거를 클릭하여
Blueprint XML 파일에 네임스페이스를 추가하십시오.
- Blueprint 네임스페이스 대화 상자에서 Blueprint 파일에 추가할 네임스페이스를 선택하십시오.
- 완료를 클릭하십시오.
이러한 요소는 사용자가 Blueprint XML 파일에 추가하는 Blueprint 네임스페이스를 기반으로 사용 설정됩니다.
- 컨텍스트
- bpjpa:context 요소는 Blueprint 트랜잭션 내에서 사용되는 JPA Bean에 대해 Apache Aries Blueprint 스펙을 확장합니다. JPA 네임스페이스를 추가할 때 이 요소가 추가됩니다. 요소에 속성을 추가하려면 추가를 클릭하십시오.
- 특성 플레이스홀더
- bpext:property-placeholder 요소는 Apache Aries Blueprint 스펙에 확장기능을 추가합니다. Blueprint 확장 네임스페이스를 추가할 때 이 요소가 추가됩니다. 요소에 속성을 추가하려면 추가를 클릭하십시오.
- 자원 참조
- bpresref:resource-reference 요소는 Bean 또는 서비스에 자원 참조(예: 데이터 소스)를 삽입합니다. 자원 참조 네임스페이스를 추가할 때 이 요소가 추가됩니다. 요소에 속성을 추가하려면 추가를 클릭하십시오.
- 트랜잭션
- tx:transaction 요소는 트랜잭션 특성을 Blueprint 파일에 추가하여 Apache Aries Blueprint 스펙을 확장합니다. 트랜잭션 네임스페이스를 추가할 때 이 요소가 추가됩니다. 요소에 속성을 추가하려면 추가를 클릭하십시오.
- 파일을 저장하십시오.
OSGi Blueprint XML 파일에 대한 자세한 정보는 다음 하위 주제를 참조하십시오.
- OSGi Blueprint XML 파일
Blueprint XML 파일은 애플리케이션의 다양한 컴포넌트를 정의하고 설명합니다. - Blueprint 바인딩 XML 파일 작성
Blueprint 바인딩 XML 파일인 ibm-eba-bnd.xml에는 번들의 인증 별명 바인딩에 대한 자원 참조가 있습니다. OSGi 애플리케이션에 OSGi Blueprint 바인딩 구성 파일이 있는 경우 이 파일이 자산으로 배치되면 이 바인딩 구성 파일은 자원 참조를 바인딩할 때 사용되는 기본 인증 별명을 제공합니다.