자원 어댑터 구성

JCA(Java™ EE Connector Architecture) 스펙 버전 1.6, 1.5 또는 1.0을 충족하는 자원 어댑터를 구성할 수 있습니다.

이 태스크 정보

JCA 스펙에서 정의된 것처럼 자원 어댑터와 다양한 연결 팩토리, 관리 오브젝트 및 활성화 스펙을 설치하고 구성할 수 있습니다.

프로시저

  1. server.xml 파일을 업데이트하여 featureManager 태그 아래에 jca-1.6 기능을 추가하십시오. server.xml 파일은 [path_to_liberty\wlp\usr\servers\server_name]에 있습니다.
     <featureManager>
      <feature>jca-1.6</feature>
     </featureManager>
  2. (선택사항) 시스템의 요구사항에 따라 다음 추가 기능을 사용하도록 설정하십시오.
    • 자원 어댑터가 JMS 스펙 인터페이스를 제공하는 경우, jms-1.1 기능을 사용하도록 설정하십시오.
      <feature>jms-1.1</feature>
    • 애플리케이션에서 연결 팩토리 및 관리 오브젝트를 검색하려면 jndi-1.0 기능을 사용하도록 설정하십시오.
      <feature>jndi-1.0</feature>
    • 자원 어댑터가 메시지 구동 Bean의 활성화 스펙을 제공하는 경우, mdb-3.1 기능을 사용하도록 설정하십시오.
      <feature>mdb-3.1</feature>
    • 지원 어댑터가 인바운드 보안을 지원하는 경우, jcaInboundSecurity-1.0 기능을 사용하도록 설정하십시오.
      <feature>jcaInboundSecurity-1.0</feature>
    • 자원 어댑터가 Bean 유효성 검증을 지원하는 경우 Bean이 유효성 검증되게 하려면 beanValidation-1.0 기능을 사용으로 설정할 수 있습니다.

      <feature>beanValidation-1.0</feature>
  3. 서버에서 하나 이상의 자원 어댑터를 구성하십시오. 다음 방법 중 하나를 사용하여 자원 어댑터를 구성할 수 있습니다.
    • server.xml 파일을 편집하여 독립형 자원 어댑터를 구성합니다.
      <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
    • server.xml 파일을 편집하여 하나 이상의 자원 어댑터 모듈을 임베드하는 애플리케이션을 설치하도록 임베디드 자원 어댑터를 구성합니다. 다음 예제는 app1.ear 파일이 하나 이상의 임베디드 RAR 파일을 포함한다고 가정합니다.
       <application location="C:/applications/app1.ear"/>
    • 서버 드롭인 폴더에 RAR 파일을 놓아서 서버가 독립형 자원 어댑터를 자동으로 구성하도록 허용하십시오.
       wlp/usr/servers/your-server-name/dropins/MyDropinAdapter.rar
    • 서버 드롭인 폴더에 EAR 파일을 놓아서 서버가 하나 이상의 임베디드 자원 어댑터를 포함하는 애플리케이션을 자동으로 구성하도록 허용하십시오. 다음 예제는 app2.ear 파일이 하나 이상의 임베디드 RAR 파일을 포함한다고 가정합니다.
      wlp/usr/servers/your-server-name/dropins/app2.ear
  4. Application Server를 시작하십시오. 서버가 시작된 후 다음과 같은 메시지가 console.log 파일에 표시됩니다.
    [AUDIT ] J2CA7001I: Resource adapter MyAdapter installed in 0.495 seconds. 
    [AUDIT ] J2CA7001I: Resource adapter MyDropinAdapter installed in 0.311 seconds. 
    [AUDIT ] J2CA7001I: Resource adapter app1.MyEmbeddedAdapter installed in 0.247 seconds.
    [AUDIT ] J2CA7001I: Resource adapter app2.anotherEmbeddedAdapter installed in 0.518 seconds.

자원 어댑터의 고유 ID는 설치된 자원 어댑터와 연결될 때 연결 팩토리, 관리 오브젝트 및 활성화 스펙의 구성된 인스턴스를 식별하기 위해 필요합니다. 독립형 자원 어댑터의 경우, 모듈 이름이 ID로 사용됩니다. 애플리케이션에 임베드된 자원 어댑터의 경우, 애플리케이션 이름의 조합 더하기 모듈 이름(마침표 문자로 구분된)이 ID로 사용됩니다.

  • 자원 어댑터 ID MyAdapter를 포함하는 properties.MyAdapter 하위 요소를 사용하여 독립형 자원 어댑터의 특성을 지정:

    <resourceAdapter location="C:/adapters/MyAdapter.rar">
      <properties.MyAdapter logFile="${server.output.dir}/logs/myAdapter.log"/>
    </resourceAdapter>
  • 자원 어댑터 ID MyAdapter를 포함하는 a.MyAdapter 하위 요소를 사용하여 연결 팩토리를 독립형 자원 어댑터와 연관:

    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
    <connectionFactory jndiName="eis/cf">
     <properties.MyAdapter serverName="localhost" portNumber="1234"/>
    </connectionFactory> 
  • properties.app1.MyEmbeddedAdapter 하위 요소를 사용하여 연결 팩토리를 app1 애플리케이션에서 사용되는 자원 어댑터 MyEmbeddedAdapter와 연관:

    <application location="C:/applications/app1.ear"/>
    <connectionFactory jndiName="eis/cf">
     <properties.app1.MyEmbeddedAdapter serverName="localhost" portNumber="1234"/>
    </connectionFactory> 
  • 모듈 이름이 ID로 사용하기에 충분히 고유하지 않은 경우가 있습니다. 예를 들어, 동일한 자원 어댑터의 두 버전을 설치하는 경우에 발생할 수 있습니다. 또는 모듈 이름은 고유하지만 길이가 길거나 영숫자가 아닌 문자를 포함하므로 구성에 사용하기를 원하지 않을 수 있습니다. id 속성을 지정하여 자원 어댑터 ID를 대체할 수 있습니다.

    다음 예제는 독립형 자원 어댑터의 ID를 대체하는 방법을 설명합니다.

    <resourceAdapter id="MyAdapterV1" location="C:/adapters/version-1.0/MyAdapter.rar"/>
    <resourceAdapter id="MyAdapterV2" location="C:/adapters/version-2.0/MyAdapter.rar"/>
    <connectionFactory jndiName="eis/cf1">
     <properties.MyAdapterV1 serverName="localhost" portNumber="1234"/>
    </connectionFactory>
    <connectionFactory jndiName="eis/cf2">
     <properties.MyAdapterV2 serverName="localhost" portNumber="1234"/>
    </connectionFactory> 
  • 다음 예제는 애플리케이션에 임베드된 자원 어댑터의 ID를 대체하는 방법을 설명합니다. 이 예제는 ID를 MyEmbeddedRA로 변경합니다.

    <application location="C:/applications/app1.ear">
     <resourceAdapter id="MyEmbeddedAdapter" alias="MyEmbeddedRA"/>
    </application>
    <connectionFactory jndiName="eis/cf">
     <properties.app1.MyEmbeddedRA serverName="localhost" portNumber="1234"/>
    </connectionFactory> 
  • 임베디드 자원 어댑터의 모듈 이름을 계산하기 위해, 자원 어댑터 배치 디스크립터(ra.xml)의 <module-name> 항목이 모듈 이름으로서 우선합니다. 예를 들어, ra.xml에 다음 정의가 주어진 경우:

    <connector ...> 
    	<module-name>MyRARModule</module-name> 
    </connector>

    모듈 이름은 "MyRARModule"로 설정됩니다.

    커넥터 배치 디스크립터에 모듈 이름이 없는 경우, 애플리케이션 배치 디스크립터(application.xml)의 자원 어댑터 모듈을 참조하는 간단한 형식의 URI가 사용됩니다. 예를 들어, application.xml에 다음 모듈 정의가 주어진 경우:

    <module>         
    	<connector>connectors/MyRARModule.rar</connector>     
    </module>

    모듈 이름은 "MyRARModule"로 계산됩니다.

    여러 자원 어댑터가 애플리케이션에 임베드되어 있으며 동일한 <module-name> 값을 정의하는 경우, application.xml에 나열된 첫 번째 자원 어댑터가 해당 모듈 이름을 사용합니다. 충돌하는 동일한 이름의 다른 커넥터 모듈 이름은 모든 /(슬래시) 문자가 마침표(.)로 변환된 전체 형식의 URI로부터 계산됩니다. 예를 들어, 둘 다 ra.xml에 다음과 같은 정의를 포함하는 두 개의 커넥터가 애플리케이션에 임베드된 경우:

    <connector ...> 
    	<module-name>MyRARModule</module-name>
    </connector>

    그리고 application.xml에 다음 정의가 있는 경우:

    <module>        
    	<connector>subfolder1/connector1.rar</connector>     
    </module>     
    <module>        
    	<connector>subfolder2/connector2.rar</connector>     
    </module>

    첫 번째 커넥터의 모듈 이름은 "MyRARModule"이 되고 두 번째의 모듈 이름은 "subfolder2.connector2.rar"이 됩니다.


주제의 유형을 표시하는 아이콘 태스크 주제

파일 이름: twlp_jca_config_resadapters.html