JCA 연결 팩토리 구성

JCA(Java™ EE Connector Architecture) 스펙을 준수하는 연결 팩토리를 구성할 수 있습니다.

이 태스크 정보

설치된 자원 어댑터가 제공하는 연결 팩토리 유형을 위해 하나 이상의 연결 팩토리 인스턴스를 구성할 수 있습니다.
참고: Liberty 프로파일에 대한 JCA 지원을 구성하려면 WebSphere® Application Server Developer Tools for Eclipse의 서버 구성 편집기의 소스 보기 또는 다른 일부 문서 편집기를 사용하여 server.xml 파일을 편집해야 합니다. 이 주제에서는 MyAdapter라는 고유 ID가 있는 자원 어댑터가 이미 서버에 구성되어 있다고 가정하고 자원 어댑터 구성에 대한 문서에서 세부사항을 참조합니다. 기본 시나리오를 구성하는 엔드-투-엔드 예제는 다음 단계에서 제공됩니다.
참고: WebSphere® Development Tools(WDT)의 디자인 보기에서는 연결 팩토리, 관리 오브젝트, 활성화 스펙 및 자원 어댑터에 대한 서버 구성의 특성 하위 요소를 편집할 수 없습니다.

프로시저

  1. server.xml 파일을 업데이트하여 featureManager 태그 아래에 jca-1.6 기능을 추가하십시오.
    <featureManager>
    	<feature>jca-1.6</feature> 
    	<feature>jndi-1.0</feature>  <!-- Add the jndi feature to enable look up of connection factories and administered objects. -->   
    		... 
    </featureManager>
  2. 자원 어댑터를 설치하십시오. 예를 들어, server.xml 파일을 다음과 같이 업데이트하십시오.
    <resourceAdapter location="C:/adapters/MyAdapter.rar"/>
  3. 하나 이상의 연결 팩토리 인스턴스를 구성하십시오. 연결 팩토리 인스턴스를 구성할 때, connectionFactory 요소를 특정 자원 어댑터가 제공하는 연결 팩토리 인터페이스와 연관시키려면 구성 특성을 대체하지 않는 경우에도 properties 하위 요소를 제공해야 합니다. 다음 예제에서 MyAdapter 자원 어댑터는 단일 유형의 연결 팩토리만 제공합니다.
    <connectionFactory jndiName="eis/cf1">
     <properties.MyAdapter portNumber="1234" someVendorProperty="100"/>
    </connectionFactory>
    
    <connectionFactory jndiName="eis/cf2" containerAuthDataRef="auth2">
     <connectionManager maxPoolSize="20" connectionTimeout="0"/>
     <properties.MyAdapter portNumber="1234" someVendorProperty="200"/>
    </connectionFactory>
    <authData id="auth2" user="user2" password="{xor}Lz4sLCgwLTtt"/>
  4. (선택사항) 필요한 경우, 사용 가능한 연결 팩토리 특성 하위 요소 이름을 식별하십시오.
    • 자원 어댑터가 JMS 연결 팩토리를 제외하면 단 하나의 연결 팩토리 인터페이스만 제공하는 경우, 하위 요소 이름은 properties.<rar_identifier>입니다.

    • 인터페이스 이름이 패키지 이름을 제외하면 고유한 경우, 하위 요소 이름은 properties.<rar_identifier>.<InterfaceName>입니다.
    • 구현 이름이 패키지 이름을 제외하면 고유한 경우, 하위 요소 이름은 properties.<rar_identifier>.<ImplementationName>입니다.
    • 그밖의 경우, 하위 요소 이름은 properties.<rar_identifier>.<fully.qualified.InterfaceName>입니다.

다음 예제를 사용하여 두 개의 연결 팩토리와 고유한 인터페이스 클래스 이름을 가진 자원 어댑터를 구성하는 방법을 학습하십시오.

다음 스니펫은 ra.xml 파일에 있으며, MyAdapter 자원 어댑터는 고유한 인터페이스 클래스 이름과 두 개의 연결 팩토리를 제공합니다.

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
<connection-definition>
 <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>javax.sql.DataSource</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.DataSourceImpl</connectionfactory-impl-class>
</connection-defintion> 
다음은 이 시나리오를 위한 서버 구성의 예제입니다.
<connectionFactory jndiName="eis/cf">
 <properties.MyAdapter.ConnectionFactory serverName="localhost"/>
</connectionFactory>

<connectionFactory jndiName="jdbc/ds">
 <properties.MyAdapter.DataSource serverName="localhost"/>
</connectionFactory>

다음 예제를 사용하여 두 개의 연결 팩토리와 고유한 구현 클래스 이름을 가진 자원 어댑터를 구성하는 방법을 학습하십시오.

다음 스니펫은 ra.xml 파일에 있으며, MyAdapter 자원 어댑터는 고유한 구현 클래스 이름과 두 개의 연결 팩토리를 제공합니다.

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>

<connection-definition>
  <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property>
 <connectionfactory-interface>com.vendor.adapter.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.MyConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
다음은 이 시나리오를 위한 서버 구성의 예제입니다.
<connectionFactory jndiName="eis/cf1">
 <properties.MyAdapter.ConnectionFactoryImpl serverName="localhost"/>
</connectionFactory> 

<connectionFactory jndiName="eis/cf2">
 <properties.MyAdapter.MyConnectionFactoryImpl serverName="localhost"/>
</connectionFactory>

다음 예제를 사용하여 두 개의 연결 팩토리가 있고 단순 인터페이스와 구현 클래스 이름이 모두 고유하지 않은 자원 어댑터를 구성하는 방법을 학습하십시오.

다음 스니펫은 ra.xml 파일에 있으며, MyAdapter 자원 어댑터는 단순 인터페이스와 구현 클래스 이름이 둘 다 고유하지 않은 두 개의 연결 팩토리를 제공합니다.

<connection-definition>
 <config-property>
  <config-property-name>ServerName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>javax.resource.cci.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>

<connection-definition>
  <config-property>
  <config-property-name>HostName</config-property-name>
  <config-property-type>java.lang.String</config-property-type>
 </config-property> 
 <connectionfactory-interface>com.vendor.adapter.custom.ConnectionFactory</connectionfactory-interface>
 <connectionfactory-impl-class>com.vendor.adapter.custom.ConnectionFactoryImpl</connectionfactory-impl-class>
</connection-defintion>
다음은 이 시나리오를 위한 서버 구성의 예제입니다.
<connectionFactory jndiName="eis/cci-cf">
 <properties.MyAdapter.javax.resource.cci.ConnectionFactory serverName="localhost"/>
</connectionFactory>

<connectionFactory jndiName="eis/custom-cf">
 <properties.MyAdapter.com.vendor.adapter.custom.ConnectionFactory hostName="localhost"/>
</connectionFactory>
구성 요소 이름의 접미부를 대체할 수 있습니다. 구성 요소 이름의 접미부를 대체하는 방법에 대해 학습하려면 JCA 구성 요소 사용자 정의에 대한 정보를 참조하십시오.

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



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