Blueprint XML 파일 작성

Blueprint 구성 파일에는 컴포넌트 어셈블리와 번들 구성 정보가 포함되어 있습니다. 이 파일에는 컴포넌트가 OSGi 서비스 레지스트리에 어떻게 등록되는지 또는 이러한 컴포넌트가 OSGi 서비스 레지스트리에서 서비스를 어떻게 검색하는지가 기술되어 있습니다. 이 정보는 번들이 시작될 때 필수 컴포넌트를 인스턴스화하고 구성하기 위해 런타임 시 사용됩니다.

프로시저

  1. 번들 프로젝트를 마우스 오른쪽 단추로 클릭하고 새로 작성 > Blueprint 파일을 선택하십시오. 새 Blueprint 파일 마법사가 열립니다.
  2. 파일 이름 필드에서 Blueprint 구성 파일의 이름을 입력한 후 다음을 클릭하십시오.
  3. 마법사의 추가 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 보안을 구성하십시오.

    자세한 정보: Blueprint 보안 및 OSGi 애플리케이션

    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에 대한 트랜잭션 요구사항을 선언할 수 있습니다.

    참고: 이 목록에 없는 기타 네임스페이스를 추가하려는 경우 소스 보기로 전환하고 네임스페이스를 입력하십시오.
  4. 완료를 클릭하십시오. Blueprint 구성 파일이 편집기에서 열립니다.
  5. 사용자의 Blueprint 구성 파일에 컴포넌트 어셈블리 및 구성 정보를 추가하려면 추가를 클릭하십시오.
    Bean
    bean 요소는 인스턴스화되는 Blueprint 컴포넌트를 정의합니다. Bean에 인수 및 특성을 추가하려면 확인을 클릭하십시오.
    Bean 속성에 대한 자세한 정보 학습:
    ID
    id 속성은 컴포넌트를 식별합니다. 컴포넌트가 Blueprint와는 다른 곳에서 참조되는 경우(예: 컴포넌트가 서비스 정의에서 참조되는 경우) 이 속성은 필수입니다.
    클래스
    class 속성은 컴포넌트의 구현 클래스가 인스턴스화되는 것을 지정합니다.
    활성화
    이 선택적 속성은 관리자를 위한 활성화 모드를 정의합니다. 다음 두 개의 활성화 모드가 지원됩니다.
    eager
    관리자가 Blueprint 컨테이너 초기화 중에 활성화됩니다.
    lazy
    요청 시 관리자가 활성화됩니다.
    기본적으로 활성화는 eager로 설정됩니다.
    범위
    범위 설정에 따라 Bean 관리자는 단일 또는 여러 오브젝트 인스턴스를 작성할 수 있습니다. Blueprint 컨테이너 스펙은 두 가지 기본 범위를 정의합니다.
    싱글톤
    Bean 관리자는 Bean의 단일 인스턴스를 작성하고 오브젝트 제공 요청을 받을 때마다 해당 인스턴스를 리턴합니다.
    프로토타입
    Bean 관리자는 오브젝트 제공 요청을 받을 때마다 Bean의 새 인스턴스를 작성합니다.
    기본적으로 싱글톤 범위는 최상위 레벨 Bean 관리자에 대해 가정합니다. 범위 속성은 인라인 Bean 관리자에서 설정할 수 없기 때문에 인라인 관리자는 항상 프로토타입 범위를 가지는 것으로 간주됩니다.
    종속 위치
    관리자 ID의 목록을 지정합니다. 관리자가 활성화되기 전에 목록에 있는 관리자가 먼저 활성화됩니다. 관리자는 명시적 및 내재적 종속 항목을 가질 수 있습니다. dependsOn 속성은 명시적 종속 항목을 정의합니다. 내재적 종속 항목은 참조에 의해 관리자 정의 내에서 다른 관리자에 대해 정의됩니다.
    팩토리 참조
    팩토리 역할을 하는 Bean 또는 참조 관리자의 ID를 지정합니다. 지정된 오브젝트에는 팩토리 메소드 속성에서 지정하는 대로 팩토리 메소드가 있어야 합니다.
    영구 삭제 메소드
    Blueprint 컨테이너가 오브젝트 인스턴스를 영구 삭제할 때 호출되는 메소드를 지정합니다.
    팩토리 메소드
    정적 팩토리 메소드의 이름을 지정합니다.
    초기화 메소드
    초기화 메소드는 컴포넌트가 작성될 때 호출됩니다. 번들 초기화 중에 메소드를 호출하지 않으려면 이 속성을 제거하십시오.
    참조
    reference 요소는 서비스 레지스트리에서 찾을 수 있는 특정 서비스를 지정합니다. 참조에 항목을 추가하려면 확인을 클릭하십시오.
    참조 속성에 대한 자세한 정보 학습:
    ID
    id 속성은 컴포넌트를 식별합니다. 컴포넌트가 Blueprint와는 다른 곳에서 참조되는 경우(예: 컴포넌트가 서비스 정의에서 참조되는 경우) 이 속성은 필수입니다.
    인터페이스
    interface 속성은 컴포넌트 클래스가 구현하는 인터페이스를 참조합니다.
    활성화
    이 선택적 속성은 관리자를 위한 활성화 모드를 정의합니다. 다음 두 개의 활성화 모드가 지원됩니다.
    eager
    관리자가 Blueprint 컨테이너 초기화 중에 활성화됩니다.
    lazy
    요청 시 관리자가 활성화됩니다.
    기본적으로 활성화는 eager로 설정됩니다.
    사용 가능성
    선택 기준과 일치하는 최소 한 개 이상의 서비스가 Blueprint 컨테이너 초기화가 계속되기 전에 존재하는 서비스 참조 관리자의 요구사항을 제어합니다. 사용 가능성 속성에는 다음 두 개의 값이 있습니다.
    선택사항
    기준과 일치하는 서비스가 존재하지 않아도 됩니다.
    필수
    기준과 일치하는 서비스가 최소 한 개 이상 있어야 합니다.
    기본적으로 사용 가능성은 필수로 설정됩니다.
    필터
    서비스 선택을 위한 필터 표현식을 지정합니다.
    제한시간
    프록시가 사용 가능한 상태가 될 때까지 지원 서비스를 대기하는 시간의 양을 밀리초로 지정합니다.
    컴포넌트 이름
    필터에서 검색된 컴포넌트를 지정합니다.
    종속 위치
    관리자 ID의 목록을 지정합니다. 관리자가 활성화되기 전에 목록에 있는 관리자가 먼저 활성화됩니다. 관리자는 명시적 및 내재적 종속 항목을 가질 수 있습니다. dependsOn 속성은 명시적 종속 항목을 정의합니다. 내재적 종속 항목은 참조에 의해 관리자 정의 내에서 다른 관리자에 대해 정의됩니다.
    참조 목록
    reference-list 요소를 사용하면 참조 요소가 여러 개의 일치 서비스를 발견할 수 있습니다. 참조 목록에 항목을 추가하려면 확인을 클릭하십시오.
    참조 목록 속성에 대한 자세한 정보 학습:
    ID
    id 속성은 컴포넌트를 식별합니다. 컴포넌트가 Blueprint와는 다른 곳에서 참조되는 경우(예: 컴포넌트가 서비스 정의에서 참조되는 경우) 이 속성은 필수입니다.
    인터페이스
    interface 속성은 컴포넌트 클래스가 구현하는 인터페이스를 참조합니다.
    활성화
    이 선택적 속성은 관리자를 위한 활성화 모드를 정의합니다. 다음 두 개의 활성화 모드가 지원됩니다.
    eager
    관리자가 Blueprint 컨테이너 초기화 중에 활성화됩니다.
    lazy
    요청 시 관리자가 활성화됩니다.
    기본적으로 활성화는 eager로 설정됩니다.
    사용 가능성
    선택 기준과 일치하는 최소 한 개 이상의 서비스가 Blueprint 컨테이너 초기화가 계속되기 전에 존재하는 서비스 참조 관리자의 요구사항을 제어합니다. 사용 가능성 속성에는 다음 두 개의 값이 있습니다.
    선택사항
    기준과 일치하는 서비스가 존재하지 않아도 됩니다.
    필수
    기준과 일치하는 서비스가 최소 한 개 이상 있어야 합니다.
    기본적으로 사용 가능성은 필수로 설정됩니다.
    필터
    서비스 선택을 위한 필터 표현식을 지정합니다.
    멤버 유형
    참조 목록 관리자가 제공하는 멤버의 유형을 지정합니다. 멤버 유형 속성은 다음을 지원합니다.
    서비스 오브젝트
    서비스 프록시 오브젝트의 목록을 삽입합니다.
    서비스 참조
    서비스 참조 오브젝트의 목록을 삽입합니다.
    기본적으로 멤버 유형은 서비스 오브젝트로 설정됩니다.
    컴포넌트 이름
    필터에서 검색된 컴포넌트를 지정합니다.
    종속 위치
    관리자 ID의 목록을 지정합니다. 관리자가 활성화되기 전에 목록에 있는 관리자가 먼저 활성화됩니다. 관리자는 명시적 및 내재적 종속 항목을 가질 수 있습니다. dependsOn 속성은 명시적 종속 항목을 정의합니다. 내재적 종속 항목은 참조에 의해 관리자 정의 내에서 다른 관리자에 대해 정의됩니다.
    서비스
    service 요소는 OSGi 서비스 레지스트리에 대한 컴포넌트의 내보내기를 정의합니다. 서비스에 항목을 추가하려면 확인을 클릭하십시오.
    서비스 속성에 대한 자세한 정보 학습:
    ID
    id 속성은 컴포넌트를 식별합니다. 컴포넌트가 Blueprint와는 다른 곳에서 참조되는 경우(예: 컴포넌트가 서비스 정의에서 참조되는 경우) 이 속성은 필수입니다.
    인터페이스
    interface 속성은 컴포넌트 클래스가 구현하는 인터페이스를 참조합니다.
    활성화
    이 선택적 속성은 관리자를 위한 활성화 모드를 정의합니다. 다음 두 개의 활성화 모드가 지원됩니다.
    eager
    관리자가 Blueprint 컨테이너 초기화 중에 활성화됩니다.
    lazy
    요청 시 관리자가 활성화됩니다.
    기본적으로 활성화는 eager로 설정됩니다.
    자동 내보내기
    자동 내보내기 설정은 자동 내보내기 속성에 의해 지정되고 다음 4개의 옵션을 지원합니다.
    사용 안함
    자동 내보내기 속성이 지정되지 않은 경우 기본값입니다. 인터페이스의 목록은 인터페이스 속성 또는 인터페이스 하위 요소를 사용하여 지정해야 합니다.
    인터페이스
    서비스 클래스와 그 수퍼클래스로 구현되는 모든 공용 인터페이스를 사용하여 서비스를 등록합니다.
    클래스 계층
    서비스 클래스와 그 공용 수퍼클래스를 사용하여 서비스를 등록합니다.
    모든 클래스
    인터페이스와 클래스 계층 옵션을 결합합니다.
    순위
    순위 속성을 사용하여 특정 순위로 서비스를 노출시킬 수 있습니다.
    참조
    ref 속성은 내보낸 컴포넌트의 컴포넌트 ID를 참조합니다. 이는 컴포넌트 요소에서 정의됩니다.
    종속 위치
    관리자 ID의 목록을 지정합니다. 관리자가 활성화되기 전에 목록에 있는 관리자가 먼저 활성화됩니다. 관리자는 명시적 및 내재적 종속 항목을 가질 수 있습니다. dependsOn 속성은 명시적 종속 항목을 정의합니다. 내재적 종속 항목은 참조에 의해 관리자 정의 내에서 다른 관리자에 대해 정의됩니다.
    유형 변환기
    type-converters 요소는 데이터 유형 사이에서 값을 변환합니다. 변환기에 항목을 추가하려면 확인을 클릭하십시오.

    Blueprint 구성 파일에 대한 자세한 정보는 도움말 주제 OSGi Blueprint XML 파일OSGi Blueprint 컨테이너 스펙을 참조하십시오.

  6. 번들의 인증 별명 바인딩에 대한 자원 참조를 포함하는 OSGi Blueprint 구성 파일을 작성하려면 WebSphere Blueprint 바인딩 디스크립터 열기를 클릭하십시오.

    OSGi 애플리케이션에 OSGi Blueprint 바인딩 구성 파일이 있는 경우 이 파일이 자산으로 배치되면 이 바인딩 구성 파일은 자원 참조를 바인딩할 때 사용되는 기본 인증 별명을 제공합니다.

    Blueprint 바인딩 파일에 대한 자세한 정보는 Blueprint 바인딩 XML 파일 작성을 참조하십시오.

  7. 추가 Blueprint 네임스페이스 추가 및 제거를 클릭하여 Blueprint XML 파일에 네임스페이스를 추가하십시오.
    1. Blueprint 네임스페이스 대화 상자에서 Blueprint 파일에 추가할 네임스페이스를 선택하십시오.
    2. 완료를 클릭하십시오.

    이러한 요소는 사용자가 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 스펙을 확장합니다. 트랜잭션 네임스페이스를 추가할 때 이 요소가 추가됩니다. 요소에 속성을 추가하려면 추가를 클릭하십시오.
  8. 파일을 저장하십시오.

    OSGi Blueprint XML 파일에 대한 자세한 정보는 다음 하위 주제를 참조하십시오.

주제 유형을 표시하는 아이콘 태스크 주제
Information Center의 이용 약관 | 피드백

시간소인 아이콘 마지막 업데이트 날짜: 2014-05-22

파일 이름: tcrtblueprintxml.html