WSIF를 이용한 통합
Matjaz B. Juric

BPEL 프로세스가 WSIF를 이용해서 Java 클래스 및 EJB에 액세스하도록 구현하는 방법에 대해 알아봅니다.

전체 BPEL Cookbook 목록 보기

아티클 관련 다운로드: 샘플 코드 Oracle BPEL Process Manager 및 Designer Oracle JDeveloper 10.1.3 또는 이후 버전

작성일 2005년 10월

실제 환경에서 BPEL 비즈니스 프로세스를 기존 애플리케이션 또는 시스템에 연결해야 할 경우가 종종 발생하곤 합니다. 이 문서는 Java 클래스, EJB(Enterprise Java Beans), JMS(Java Message Service), ERP 시스템 등의 J2EE 구성요소를 JCA(Java Connector Architecture), JDBC 데이터베이스 및 기타 Java 리소스를 통해 연결하는 방법에 초점을 맞추고 있습니다.
물론 이러한 리소스를 웹 서비스로 변환할 수도 있습니다. 하지만 이 방법에는 몇 가지 문제가 있습니다:

• 네이티브 Java 클래스를 호출하는 경우, 또는 EJB 및 기타 네이티브 Java 리소스를 호출하는 경우에 비해 웹 서비스의 호출 작업에 훨씬 높은 성능 오버헤드가 수반됩니다 (오른쪽 글상자 참고).
  
• 웹 서비스 호출 과정에서, 트랜잭션 컨텍스트(transaction context)를 전달하는 중요한 기능을 사용할 수 없습니다. 이에 반해, EJB, JCA 등의 Java 리소스를 직접 사용하는 경우에는 트랜잭션 컨텍스트의 자동 전달이 가능합니다 (단, Java 리소스가 이러한 기능을 지원하는 경우에 한정).

BPEL Cookbook시리즈의 이번 연재에서는, 웹 서비스가 아닌 다른 리소스에 대한 액세스를 위해 BPEL 프로세스에서 WSIF를 활용하는 방법에 대해 알아보기로 합니다.

• SIF를 통해 서비스를 호출함으로써, 네이티브 프로토콜의 성능 수준을 유지할 수 있습니다. 따라서 Java 리소스, 네이티브 Java 클래스, EJB, 또는 다른 리소스를 호출하는 경우에도 웹 서비스에 수반되는 성능 오버헤드의 문제를 피할 수 있습니다.
  
• SIF는 Java Transaction API(JTA)를 이용하여 “transaction-aware” Java 리소스의 호출 과정에서 트랜잭션 컨텍스트(transaction context)를 자동으로 전달(propagate)합니다.

• DOM (Document Object Model) API를 이용하여 XML을 수작업으로 처리합니다. Java 메소드의 입력/출력 매개변수는 W3C DOM API가 제공하는 타입의 변수로 처리되며, DOM 메소드를 이용하여 XML을 직접 조작할 수 있습니다.
  
  
• Java-XML 바인딩을 자동으로 수행합니다. Java-to-XML 바인딩을 통해 XML Schema 타입을 Java 타입으로 자동 변환할 수 있습니다. 이를 위해, XML 조작에 사용될 인터페이스와 Java 클래스를 생성해야 합니다. 여기서 두 가지 대안이 가능합니다:
• Oracle BPEL Process Manager는 XML façade를 이용한 Java-to-XML 바인딩을 기본으로 지원합니다.
• 커스텀 Java 시리얼라이저(custom Java serializer)를 사용할 수 있습니다. 오라클은 JAXB (Java API for XML Bindings), XML Beans, Axis Beans 등을 지원하는 커스텀 시리얼라이저를 제공합니다. 또 개발자가 직접 시리얼라이저를 작성할 수도 있습니다 (뒷부분에서 자세히 설명합니다).

XML Façade. XML façade는 Oracle BPEL Process Manage가 기본으로 지원하는 WSIF 기반 Java-to-XML 바인딩 테크놀로지입니다. XML façade에 포함된 Java 인터페이스와 클래스가 제공하는 get/set 메소드를 이용하면 BPEL 변수에 저장된 XML 데이터를 비교적 쉽게 액세스하고 수정할 수 있습니다. XML façade를 이용하면 XML을 직접 조작할 필요가 없으며, XML의 존재가 façade의 하부에 숨겨지므로 표준 Java 인터페이스를 이용한 데이터 조작이 가능해집니다 (이 개념을 XML serialization이라 부릅니다). XML façade는 빌트인 타입의 매핑을 통해 심플 데이터 타입(simple data type)을 지원하고, 컴플렉스 데이터 타입(complex data type)을 갖는 XML Schema로부터 Java 클래스를 생성할 수 있게 하는 것을 기본적인 목적으로 합니다.

XML Schema와 Java 타입 간의 기본적인 데이터 타입 매핑이 아래와 같습니다:

위에서 확인할 수 있는 것처럼, 대부분의 심플 타입(simple type)은 프리미티브 타입(primitive type) 또는 오브젝트 타입(object type)으로 매핑이 가능합니다. 이것은 Java 코드에 사용된 실제 타입을 직접 매핑할 수 있다는 점에서 매우 유용한 기능입니다. 이와 별도로, WSDL의 <types> 섹션 또는 외부 XML Schema(XSD) 파일에 정의된 컴플렉스 타입(complex type)을 매핑할 수 있는 방법이 필요합니다. 예를 들어, Book Rating 웹 서비스 WSDL에는 BookDscType 타입의 BookRatingRequestMessage를 입력으로 취하는 작업이 포함되어 있습니다. BookDscType 컴플렉스 XML 타입은 BookRatingRequestMessage와 BookRatingRequest BPEL 변수를 위해 사용됩니다:

<xs:schema elementFormDefault="qualified" 
            targetNamespace="http://oracle.com/service/bookrating/">

   <xs:complexType name="BookDscType">
     <xs:sequence>
       <xs:element name="Title" type="xs:string" /> 
       <xs:element name="ISSN" type="xs:string" /> 
       <xs:element name="Publisher" type="xs:string" /> 
       <xs:element name="Authors" type="xs:string" /> 
     </xs:sequence>
   </xs:complexType>

</xs:schema>

• getTitle() and setTitle()
• getISSN() and setISSN()
• getPublisher() and setPublisher()
• getAuthors() and setAuthors()

Z:\WSIF\2_JavaBindingClass>schemac BookRating.wsdl
----------------------------------------------------
Oracle XML Schema Processor Version 10.1.2.0.0
http://otn.oracle.com/bpel
Copyright (c) 2002-2004 - Oracle
(type schemac -help for help)
----------------------------------------------------

schemac> parsing schema file 'BookRating.wsdl' ...
schemac> Loaded schemas from wsdl located at BookRating.wsdl
schemac> generating XML business document ...
schemac> compiling XML business documents ...
Schemac completed successfully.

Z:\WSIF\2_JavaBindingClass>

Java 클래스의 개발. BPEL 프로세스를 수정하지 않고 Book Rating 웹 서비스를 Java 클래스로 대체하려면, 기존의 Book Rating 웹 서비스와 동일한 인터페이스(또는 contract)를 갖는 Java 클래스를 생성해야 합니다. 이는 Java 클래스가 웹 서비스와 동일한 기능을 갖는 오퍼레이션(operation)을 제공해야 하며, 동일한 매개변수를 수신하고 동일한 결과 타입을 반환해야 함을 의미합니다. 단, 오퍼레이션 네임(operation name)은 동일하지 않아도 상관없습니다.

샘플 WSDL 파일에서 Book Rating 웹 서비스가 BookRating이라는 이름의 오퍼레이션을 제공하고 있음을 확인할 수 있을 것입니다. BookRating 오퍼레이션은 입력/출력 메시지를 모두 필요로 하는 동기식 작업을 수행합니다:

<portType name="BookRatingPT">
  <operation name="BookRating">
    <input message="tns:BookRatingRequestMessage" /> 
    <output message="tns:BookRatingResponseMessage" /> 
  </operation>
</portType>

The signatures of both messages are as follows:
<message name="BookRatingRequestMessage">
  <part name="book" type="tns:BookDscType" /> 
</message>

<message name="BookRatingResponseMessage">
  <part name="rating" type="xs:int" />
</message>

이제 Book Rating 웹 서비스를 대체할 Java 클래스를 작성할 준비가 완료되었습니다. 새로운 Java 클래스는 BookRatingJava라는 이름을 가지며, getBookRating이라는 하나의 메소드를 갖습니다. 메소드의 코드는 아주 단순합니다. 서버 콘솔에 메시지를 디스플레이하고 4의 rating 값을 반환합니다. (물론 실제 환경이라면 데이터베이스 쿼리를 통해 rating 값을 얻어야 할 것입니다.) 코드는 아래와 같습니다. getTitle() 메소드와 getISSN() 메소드를 이용하여 book title과 ISSN 정보에 액세스하고 있음을 주목하시기 바랍니다.

import com.oracle.service.bookrating.*;

public class BookRatingJava {

  public Integer getBookRating (BookDscType book) {

    System.out.println("Book rating for "+book.getTitle()+" ("+book.getISSN()+"): 4.");

    return new Integer(4);

  }
}

• 사용되는 바인딩의 종류 (Java 클래스, EJB, JCA 등)
  
• 타입의 매핑 – XML 타입을 대상 타입(Java 리소스의 경우 Java 타입)으로 매핑하는 방법을 지정합니다 컴플렉스 타입의 경우에는 매핑을 일일이 정의해 주어야 합니다. 심플 타입은 자동으로 위의 표에 지정된 방식대로 자동 매핑됩니다.
  
• 오퍼레이션의 매핑 – (<portType> 태그에 정의된) 각 WSDL 오퍼레이션을 대상 리소스(예: Java 클래스의 메소드 네임)로 매핑하는 방법을 지정합니다.

1. Java-to-XML 바인딩을 생성하고, 입력 매개변수와 리턴 값을 XML으로 매핑하는 방법을 정의합니다. 이때 XML façades와 schemac 툴의 –R 스위치를 이용하면 Java 클래스를 기반으로 하는 XML 스키마를 쉽게 생성할 수 있습니다.
   
2. 각 오퍼레이션의 시그니처와 입력/출력 메시지를 정의합니다. (에러 핸들링에 대해서는 뒷부분에서 설명합니다.)
   
3. WSIF 바인딩을 추가합니다.
   
4. <partnerLinkType> 선언을 추가하여, BPEL 프로세스로부터 WSDL을 사용할 수 있게 합니다.

<?xml version="1.0" encoding="utf-8" ?> 
<definitions xmlns:xs="http://www.w3.org/2001/XMLSchema" 
             xmlns:tns="http://oracle.com/service/bookrating/" 
             targetNamespace="http://oracle.com/service/bookrating/" 
             xmlns="http://schemas.xmlsoap.org/wsdl/"
             xmlns:plnk="http://schemas.xmlsoap.org/ws/2003/05/partner-link/" 
             xmlns:format="http://schemas.xmlsoap.org/wsdl/formatbinding/"
             xmlns:java="http://schemas.xmlsoap.org/wsdl/java/" >
...

1. XML에서 Java로의 타입 매핑을 정의합니다. 입력 매개변수의 BookDscType XML 타입은 com.oracle.service.bookrating.BookDscType Java 클래스로 매핑됩니다. 출력 매개변수의 xs:int 타입은 매핑을 따로 정의할 필요가 없으며, 자동으로 java.lang.Integer으로 매핑됩니다.
   
2. WSDL 오퍼레이션 BookRating이 Java 메소드 getBookRating()으로 매핑됨을 정의합니다. WSDL 오퍼레이션 네임과 Java 클래스의 메소드 네임은 같을 필요가 없지만, 입력/반환 매개변수의 타입은 동일하게 설정되어야 합니다:

   ...
   <binding name="JavaBinding" type="tns:BookRatingPT">
   
       <java:binding/>
   
       <format:typeMapping encoding="Java" style="Java">
   
         <format:typeMap typeName="tns:BookDscType" 
                 formatType="com.oracle.service.bookrating.BookDscType" />
   
       </format:typeMapping>
   
       <operation name="BookRating">
   
         <java:operation methodName="getBookRating"/>
   
         <input/>
         <output/>
       </operation>     
   
     </binding>
   ...
   

...
  <service name="BookRating">

    <port name="JavaPort" binding="tns:JavaBinding">

      <java:address className="com.oracle.rating.BookRatingJava"/>

    </port>

  </service>

...
          <!-- Synchronously invoke the Book Rating Web Service -->
          <scope name="BookRatingInvoke">
          
            <faultHandlers>

              <catchAll>
                <!-- If book rating is not available assign 0 -->
                <assign>
                  <copy>
                    <from expression="number(0)"/>
                    <to variable="BookRatingResponse" part="rating"/>
                  </copy>
                </assign>          
              </catchAll>
              
            </faultHandlers>
            
            <invoke partnerLink="BookRating" 
                  portType="bkr:BookRatingPT" 
                  operation="BookRating"
                  inputVariable="BookRatingRequest" 
                  outputVariable="BookRatingResponse" />
          
          </scope>
...

<?xml version="1.0" encoding="UTF-8"?>
<BPELSuitcase>
  <BPELProcess src="BuyBook.bpel" id="BuyBookJavaBinding">
    <partnerLinkBindings>
      <partnerLinkBinding name="Client">
        <property name="wsdlLocation">
           BuyBook.wsdl
        </property>
      </partnerLinkBinding>
      <partnerLinkBinding name="BookRating">
        <property name="wsdlLocation">
            BookRating.wsdl
        </property>
      </partnerLinkBinding>
      <partnerLinkBinding name="BookStore1">
        <property name="wsdlLocation">
            http://localhost:9700/orabpel/default/BookStore1/BookStore1?wsdl</property>
      </partnerLinkBinding>
      <partnerLinkBinding name="BookStore2">
        <property name="wsdlLocation">
            http://localhost:9700/orabpel/default/BookStore2/BookStore2?wsdl</property>
      </partnerLinkBinding>
    </partnerLinkBindings>
  </BPELProcess>
</BPELSuitcase>

<?xml version="1.0"?>
<project name="BuyBookJavaBinding" default="all" basedir=".">
    <property name="deploy" value="default"/>
    <property name="rev" value="1.0"/>

    <target name="CompileJava">
        <schemac input="${basedir}/BookRating.wsdl" out="${home}/system/classes"/>
        <javac srcdir="${basedir}/src" destdir="${home}/system/classes"/>
    </target> 
       
    <target name="main">
        <bpelc home="${home}" rev="${rev}" deploy="${deploy}"/>        
    </target>    

    <target name="all" depends="CompileJava, main"/>

</project>

Z:\WSIF\2_JavaBindingClass>obant

Z:\WSIF\2_JavaBindingClass>SETLOCAL
Buildfile: build.xml

CompileJava:
  [schemac] schemac> parsing schema file 'Z:\WSIF\2_JavaBindingClass/BookRating.
wsdl' ...
  [schemac] schemac> Loaded schemas from wsdl located at Z:\WSIF\2_JavaBindingCl
ass/BookRating.wsdl
  [schemac] schemac> generating XML business document ...
  [schemac] schemac> compiling XML business documents ...
    [javac] Compiling 1 source file to C:\OraBPELPM_1\integration\orabpel\system
\classes

main:
    [bpelc] validating "Z:\WSIF\2_JavaBindingClass\BuyBook.bpel" ...
    [bpelc] BPEL suitcase deployed to: C:\OraBPELPM_1\integration\orabpel\domain
s\default\deploy

all:

BUILD SUCCESSFUL
Total time: 17 seconds

Z:\WSIF\2_JavaBindingClass>ENDLOCAL

Z:\WSIF\2_JavaBindingClass>

05/10/19 19:35:36 Book rating for Business Process Execution Language (1-904811-
18-3): 4.

1. Java에 user exception을 정의합니다.
   
2. BookRatingJava Java 클래스를 수정하여 exception을 발생시키도록 합니다.
   
3. WSDL에 이에 대응하는 fault를 정의합니다. 이를 위해 fault 메시지의 XML Schema 타입, fault 메시지를 정의하고 <fault> 메시지를 WSDL <operation> description에 추가합니다.
   
4. exception을 위한 WSIF 바인딩을 정의합니다.

package com.oracle.rating;

public class BookDoesNotExistException extends Exception 
{
  String detailDesc;
  String bookTitle;

  public BookDoesNotExistException(String message, String detailDesc, String bookTitle)
  {
    super(message);
    this.detailDesc = detailDesc;
    this.bookTitle = bookTitle;
  }

  public String getDetailDesc()
  {
    return detailDesc;
  }

  public String getBookTitle()
  {
    return bookTitle;
  }
}

package com.oracle.rating;

import com.oracle.service.bookrating.*;

public class BookRatingJavaUserException {

  public Integer getBookRating (BookDscType book) throws BookDoesNotExistException {

    if (book.getISSN().equals("999"))
       throw(new BookDoesNotExistException("Book does not exist",
                                           "Book (ISSN="+book.getISSN()+") does not exist",
                                           book.getTitle()));

    System.out.println("Book rating for "+book.getTitle()+" ("+book.getISSN()+"): 4.");

    return new Integer(4);

  }
}

<xs:complexType name="BookDoesNotExistExceptionType">
  <xs:sequence>
    <xs:element name="faultstring" type="xs:string" /> 
    <xs:element name="detail" type="xs:string" /> 
  </xs:sequence>
</xs:complexType>

<message name="BookDoesNotExistException">
  <part name="exception" type="tns:BookDoesNotExistExceptionType" />
</message>

<portType name="BookRatingPT">
  <operation name="BookRating">
    <input message="tns:BookRatingRequestMessage" /> 
    <output message="tns:BookRatingResponseMessage" /> 
    <fault name="BookDoesNotExistException" message="tns:BookDoesNotExistException" />
  </operation>
</portType>

<binding name="JavaBinding" type="tns:BookRatingPT">
  <java:binding/>
  <format:typeMapping encoding="Java" style="Java">
    <format:typeMap typeName="tns:BookDscType" 
                    formatType="com.oracle.service.bookrating.BookDscType" />
    <format:typeMap typeName="tns:BookDoesNotExistExceptionType" 
                    formatType="com.oracle.rating.BookDoesNotExistException" />
  </format:typeMapping>
  <operation name="BookRating">
    <java:operation methodName="getBookRating"/>
    <input/>
    <output/>
    <fault name="BookDoesNotExistException"/> 
  </operation>     
</binding>

Z:\WSIF\3_JavaBindingUserExceptionDefaultSerializer>obant

Z:\WSIF\3_JavaBindingUserExceptionDefaultSerializer>SETLOCAL
Buildfile: build.xml

CompileJava:
  [schemac] schemac> parsing schema file 'Z:\WSIF\3_JavaBindingUserExceptionDefa
ultSerializer/BookRating.wsdl' ...
  [schemac] schemac> Loaded schemas from wsdl located at Z:\WSIF\3_JavaBindingUs
erExceptionDefaultSerializer/BookRating.wsdl
  [schemac] schemac> generating XML business document ...
  [schemac] schemac> compiling XML business documents ...
    [javac] Compiling 2 source files to C:\OraBPELPM_1\integration\orabpel\syste
m\classes

main:
    [bpelc] validating "Z:\WSIF\3_JavaBindingUserExceptionDefaultSerializer\BuyB
ook.bpel" ...
    [bpelc] BPEL suitcase deployed to: C:\OraBPELPM_1\integration\orabpel\domain
s\default\deploy

all:

BUILD SUCCESSFUL
Total time: 18 seconds

Z:\WSIF\3_JavaBindingUserExceptionDefaultSerializer>ENDLOCAL

Z:\WSIF\3_JavaBindingUserExceptionDefaultSerializer>

Custom Exception Serializer. WSDL default exception serializer의 구조(faultstring과 detail 엘리먼트)로는 요구사항을 만족할 수 없는 경우, custom exception serializer를 사용할 수 있습니다. custom exception serializer는 exception과 그 속성을 WSDL fault에서 사용되는 컴플렉스 타입으로 매핑해 주는 Java 클래스입니다. custom serializer을 작성하는 방법이 아래와 같습니다:

1. WSDL fault 메시지를 위한 커스텀 컴플렉스 타입(custom complex type)을 정의합니다
   
2. customer exception serializer를 작성하여 Java exception을 WSDL fault로 전달합니다.
   
3. custom exception serializer를 등록합니다.

<xs:complexType name="BookDoesNotExistExceptionType">
  <xs:sequence>
    <xs:element name="message" type="xs:string" /> 
    <xs:element name="detailDesc" type="xs:string" /> 
    <xs:element name="bookTitle" type="xs:string" /> 
  </xs:sequence>
</xs:complexType>

public interface IExceptionSerializer {

	public Element serialize(Throwable ex, 
                             String messageName, 
                             String namespaceURI);
}

package com.oracle.rating;

import org.w3c.dom.Element;

import com.collaxa.xml.XMLHelper;
import com.oracle.bpel.xml.util.ExceptionSerializer;
import com.oracle.bpel.xml.util.IExceptionSerializer;

public class BookDoesNotExistExceptionSerializer extends ExceptionSerializer
		implements IExceptionSerializer {

	public Element serialize(Throwable ex, String messageName, String namespaceURI) {
		
		if(ex instanceof BookDoesNotExistException)
		{
			BookDoesNotExistException brEx = (BookDoesNotExistException)ex;
			
			Element exceptionElement = 
                         XMLHelper.createRootElement(messageName, namespaceURI,"tns");
			
			Element messageElement = 
                         XMLHelper.createElement("message","tns",namespaceURI);
			messageElement.setNodeValue(brEx.getMessage());
			exceptionElement.appendChild(messageElement);
			
			Element detailElement = 
                         XMLHelper.createElement("detailDesc","tns",namespaceURI);
			detailElement.setNodeValue(brEx.getDetailDesc());
			exceptionElement.appendChild(detailElement);
			
			Element bookElement = 
                          XMLHelper.createElement("bookTitle","tns",namespaceURI);
			bookElement.setNodeValue(brEx.getBookTitle());
			exceptionElement.appendChild(bookElement);		

			return exceptionElement;

		}
		return super.serialize(ex, messageName, namespaceURI);
	}

}

<partnerLinkBinding name="BookRating">
  <property name="wsdlLocation">
      BookRating.wsdl
  </property>
  <property name="exceptionSerializer">
      com.oracle.rating.BookDoesNotExistExceptionSerializer
  </property>	        
</partnerLinkBinding>

Z:\WSIF\3_JavaBindingUserExceptionCustomSerializer>obant

Z:\WSIF\3_JavaBindingUserExceptionCustomSerializer>SETLOCAL
Buildfile: build.xml

CompileJava:
  [schemac] schemac> parsing schema file 'Z:\WSIF\3_JavaBindingUserExceptionCust
omSerializer/BookRating.wsdl' ...
  [schemac] schemac> Loaded schemas from wsdl located at Z:\WSIF\3_JavaBindingUs
erExceptionCustomSerializer/BookRating.wsdl
  [schemac] schemac> generating XML business document ...
  [schemac] schemac> compiling XML business documents ...
    [javac] Compiling 3 source files to C:\OraBPELPM_1\integration\orabpel\syste
m\classes

main:
    [bpelc] validating "Z:\WSIF\3_JavaBindingUserExceptionCustomSerializer\BuyBo
ok.bpel" ...
    [bpelc] BPEL suitcase deployed to: C:\OraBPELPM_1\integration\orabpel\domain
s\default\deploy

all:

BUILD SUCCESSFUL
Total time: 21 seconds

Z:\WSIF\3_JavaBindingUserExceptionCustomSerializer>ENDLOCAL

Z:\WSIF\3_JavaBindingUserExceptionCustomSerializer>

Custom Java Serializer. custom Java serializer는 IJavaSerializer 인터페이스의 구현을 위한 Java 클래스로, serialize와 deserialize의 두 가지 메소드를 제공합니다.

public interface IJavaSerializer {
	
	public Element serialize(Object obj, Class type, String name, String namespaceURI, 
                             String prefix, Map classMap) throws Exception;
	public Object deserialize(Element el, Class type) throws Exception;
}

<partnerLinkBinding name="helper">
    <property name="wsdlLocation">HelperService.wsdl</property>
    <property name="javaSerializer">com.oracle.bpel.xml.util.MyCustomSerializer</property>
</partnerLinkBinding>

1. JWSDP 설치 디렉토리(예: c:\jwsdp-1.5\jaxb\lib)를 C:\OraBPELPM_1\integration\orabpel\bin 디렉토리의 obsetenv.bat 파일과 C:\OraBPELPM_1\integration\orabpel\system\appserver\oc4j\j2ee\home\confi 디렉토리의 application.xml 파일의 BASE_OB_CLASSPATH 환경 변수에 추가합니다.
   
2. JAXBSerializer.class 파일(샘플 코드 다운로드 참고)을 C:\OraBPELPM_1\integration\orabpel\system\classes\com\oracle\bpel\xml\util 디렉토리에 복사합니다.
   
3. JAXB 컴파일러(xjc)가 생성한 Java 클래스를 C:\OraBPELPM_1\integration\orabpel\system\classes 디렉토리에 복사합니다.

<partnerLinkBinding name="helper">
  <property name="wsdlLocation">HelperService.wsdl</property>
  <property name="javaSerializer">com.oracle.bpel.xml.util.JAXBSerializer</property>
</partnerLinkBinding>

1. XML Beans JAR 파일((BEA Weblogic의 xbean.jar 파일)을 C:\OraBPELPM_1\integration\orabpel\bin 디렉토리의 obsetenv.bat 파일과 C:\OraBPELPM_1\integration\orabpel\system\appserver\oc4j\j2ee\home\config 디렉토리의 application.xml 파일의 BASE_OB_CLASSPATH 환경 변수에 추가합니다.
2. XMLBeansSerializer.class 파일(샘플코드 다운로드참고)을 C:\OraBPELPM_1\integration\orabpel\system\classes\com\oracle\bpel\xml\util 디렉토리에 복사합니다.
3. XML Beans 컴파일러가 생성한 Java 클래스를 C:\OraBPELPM_1\integration\orabpel\system\classes 디렉토리에 복사합니다.
4. ANT 유틸리티(obant)에서 사용하는 build.xml 파일에 xbean.jar의 경로를 추가합니다.

<partnerLinkBinding name="xmlBeansService">
  <property name="wsdlLocation">XMLBeansService.wsdl</property>
  <property name="javaSerializer">
        com.oracle.bpel.xml.util.XMLBeanJavaSerializer
  </property>
</partnerLinkBinding>

1. Axis Beans JAR 파일(Axis 1.2의 axis.jar 파일)을 C:\OraBPELPM_1\integration\orabpel\bin 디렉토리의 obsetenv.bat 파일과 C:\OraBPELPM_1\integration\orabpel\system\appserver\oc4j\j2ee\home\config 디렉토리의 application.xml 파일의 BASE_OB_CLASSPATH 환경 변수에 추가합니다.
   
   
2. AxisSerializer.zip 파일(샘플코드 다운로드)의 serializer 클래스들을 C:\OraBPELPM_1\integration\orabpel\system\classes 디렉토리에 복사합니다.
   
   
3. Axis Bean에 의해 생성된 Java 클래스를 C:\OraBPELPM_1\integration\orabpel\system\classes 디렉토리에 복사합니다.

<partnerLinkBinding name="AxisBeansService">
  <property name="wsdlLocation">AxisBeansService.wsdl</property>
  <property name="javaSerializer">
        com.oracle.bpel.xml.util.AxisJavaSerializer
  </property>
</partnerLinkBinding>

지금까지 WSIF 바인딩을 이용하여 웹 서비스 대신 Java 클래스를 이용하도록 설정하는 방법을 설명했습니다. 같은 방법으로 EJB, 특히 stateless 세션 빈(session bean)을 사용하도록 설정하는 것도 가능합니다. WSIF EJB 바인딩의 실습을 위해 샘플 코드를 확장해 보기로 합니다. 먼저 BPEL 프로세스에 새로운 액티비티를 추가하고, Book Rating 서비스를 호출한 뒤 Publisher Rating 서비스를 호출하도록 합니다. WSIF 바인딩을 이용하여 웹 서비스 대신 세션 빈을 사용하도록 설정합니다. 세션 빈은 이미 존재하는 것으로 가정합니다. 이를 위해 필요한 작업이 아래와 같습니다:

• 세션 빈을 위한 WSDL을 정의합니다.
  
• SDL에 partner link type을 추가합니다.
  
• BPEL 프로세스가 Publisher Rating 서비스를 추가로 호출하도록 수정합니다.
  
• WSIF 바인딩을 EJB에 추가합니다.
  

package com.oracle.ratingSB;

import java.rmi.RemoteException;
import javax.ejb.EJBObject;

public interface PubRating extends EJBObject
{
    public int getAvgPubRating (String name) throws RemoteException;

}

이제 WSDL 다큐먼트를 정의할 차례입니다. WSDL 다큐먼트는 아주 간단한 구조를 가지며, 두 개의 메시지(PubRatingRequestMessage, PubRatingResponseMessage)를 포함합니다. 메시지는 PubRating 오퍼레이션의 입력 및 출력으로 사용됩니다. PubRating 오퍼레이션은 PubRatingPT 포트 타입 내부에 정의됩니다:

<?xml version="1.0"?> 
<definitions xmlns:xs="http://www.w3.org/2001/XMLSchema" 
             xmlns:tns="http://oracle.com/service/pubrating/" 
             targetNamespace="http://oracle.com/service/pubrating/" 
             xmlns="http://schemas.xmlsoap.org/wsdl/"
             xmlns:plnk="http://schemas.xmlsoap.org/ws/2003/05/partner-link/"
             xmlns:format="http://schemas.xmlsoap.org/wsdl/formatbinding/"
             xmlns:ejb="http://schemas.xmlsoap.org/wsdl/ejb/" >
             
  <message name="PubRatingRequestMessage">
    <part name="name" type="xs:string" /> 
  </message>
  
  <message name="PubRatingResponseMessage">
    <part name="rating" type="xs:int" />
  </message>
  
  <portType name="PubRatingPT">
    <operation name="PubRating">
      <input name="PubRatingRequest" message="tns:PubRatingRequestMessage" /> 
      <output name="PubRatingResponse" message="tns:PubRatingResponseMessage" /> 
    </operation>
  </portType>
</definitions>

<plnk:partnerLinkType name="PubRatingLT">
  <plnk:role name="PubRatingService">
    <plnk:portType name="tns:PubRatingPT" />
  </plnk:role>
</plnk:partnerLinkType>

<partnerLink name="PubRating" 
             partnerLinkType="pbr:PubRatingLT"
             partnerRole="PubRatingService"/>

<scope name="RetrievePublisherRating">

  <variables>
      <variable name="PubRatingRequest" messageType="pbr:PubRatingRequestMessage"/>
      <variable name="PubRatingResponse" messageType="pbr:PubRatingResponseMessage"/>
  </variables>

  <faultHandlers>
      
      <catchAll>
      
        <sequence>
          <assign>
            <copy>
              <from expression="string('Unable to retrieve publisher rating')" />
              <to variable="Fault" part="error" />
            </copy>
          </assign>
        
          <invoke partnerLink="Client" 
                  portType="buy:ClientCallbackPT" 
                  operation="ClientCallbackFault"
                  inputVariable="Fault" />
        </sequence>
                      
      </catchAll>
      
  </faultHandlers>
        
  <sequence>

    <assign>
      <copy>
        <from variable="BookPurchase" part="book" query="/book/bkr:Publisher"/>
        <to variable="PubRatingRequest" part="name"/>
      </copy>
    </assign>
          
    <invoke partnerLink="PubRating" 
            portType="pbr:PubRatingPT" 
            operation="PubRating"
            inputVariable="PubRatingRequest" 
            outputVariable="PubRatingResponse" />

  </sequence>
    
</scope>

아래는 Publisher Rating 서비스 WSDL 파일의 WSIF EJB 바인딩에서 발췌한 내용입니다. 먼저 타입 매핑(type mapping)을 정의한 다음, PubRating 오퍼레이션을 위해 사용할 메소드를 지정해야 합니다(getAvgPubRating()). 매개변수(name)와 리턴(rating) 값을 위한 메시지 네임과 입력/출력을 위한 메시지 네임((PubRatingRequest, PubRatingResponse)이 각각 정의되어 있음을 참고하시기 바랍니다:

<binding name="EJBBinding" type="tns:PubRatingPT">
  <ejb:binding/>
  <format:typeMapping encoding="Java" style="Java">
    <format:typeMap typeName="xs:string" formatType="java.lang.String" />
    <format:typeMap typeName="xs:int" formatType="int" /> 
  </format:typeMapping>
  <operation name="PubRating">
    <ejb:operation
       methodName="getAvgPubRating"
       parameterOrder="name"
       interface="remote"
       returnPart="rating" />
    <input name="PubRatingRequest"/>
    <output name="PubRatingResponse"/>
  </operation>
</binding>

<service name="PubRatingPT">
  <port name="EJBPort" binding="tns:EJBBinding">
    <ejb:address className="com.oracle.ratingSB.PubRatingHome"
                 jndiName="ejb/session/PubRating"
                 initialContextFactory="com.evermind.server.rmi.RMIInitialContextFactory"
                 jndiProviderURL="[jndiProviderURL]"/> 
  </port>
</service>

<partnerLinkBinding name="PubRating">
  <property name="wsdlLocation">PubRatingBinded.wsdl</property>
</partnerLinkBinding>

<partnerLinkBinding name="PubRating">
  <property name="wsdlLocation">PubRatingBinded.wsdl</property>
  <property name="java.naming.security.principal">admin</property>
  <property name="java.naming.security.credentials">welcome</property>	
</partnerLinkBinding>

Z:\WSIF\4_JavaBindingEJB>obant

Z:\WSIF\4_JavaBindingEJB>SETLOCAL
Buildfile: build.xml

deploySessionBean:

build_ear:

deployIas:

deployOc4j:
     [java] Notification ==> Application Deployer for SessionBean STARTS [ 2005-
10-19T19:47:00.891CEST ]
     [java] Notification ==> Undeploy previous deployment
     [java] Notification ==> Copy the archive to C:\OraBPELPM_1\integration\orab
pel\system\appserver\oc4j\j2ee\home\applications\SessionBean.ear
     [java] Notification ==> Unpack SessionBean.ear begins...
     [java] Notification ==> Unpack SessionBean.ear ends...
     [java] Notification ==> Initialize SessionBean.ear begins...
     [java] Notification ==> Initialize SessionBean.ear ends...
     [java] Notification ==> Application Deployer for SessionBean COMPLETES [ 20
05-10-19T19:47:19.470CEST ]


bindingWsdl:
     [copy] Copying 1 file to Z:\WSIF\4_JavaBindingEJB

setJndiUrlOrclej2ee:

setJndiUrlIas:

setJndiUrlOc4j:
     [echo] Replacing token [jndiProviderURL] by ormi://virtualxp/SessionBean in
 Z:\WSIF\4_JavaBindingEJB/PubRatingBinded.wsdl

main:
    [bpelc] validating "Z:\WSIF\4_JavaBindingEJB\BuyBook.bpel" ...
    [bpelc] BPEL suitcase deployed to: C:\OraBPELPM_1\integration\orabpel\domain
s\default\deploy

all:

BUILD SUCCESSFUL
Total time: 28 seconds

Z:\WSIF\4_JavaBindingEJB>ENDLOCAL

Z:\WSIF\4_JavaBindingEJB>

05/10/19 19:50:51 Tutalii: C:\OraBPELPM_1\integration\orabpel\lib\orabpel.jar ar
chive
05/10/19 19:50:54 Avg. publisher rating for Packt Publishing: 5.

WSIF 바인딩을 수작업으로 생성하는 것은 매우 복잡한 작업입니다. Oracle JDeveloper 10.1.3(이 문서를 작성하는 시점에 Early Access Release가 제공되고 있습니다)은 Java 클래스, EJB와 같은 Java 리소스를 위한 WSDL과 WSIF의 자동 생성을 위한 마법사를 제공합니다. 이 마법사를 이용하면 BPEL로부터 Java 리소스를 호출하는 수고를 덜고, BPEL을 통합 작업에 보다 효과적으로 활용할 수 있습니다.

Java 클래스 또는 EJB를 기반으로 Java 웹 서비스를 생성하기 위해 마법사를 실행합니다. 아래 스크린샷은 Java 클래스를 이용한 경우의 실행 예를 보여 주고 있습니다:

(Java EE 1.4와 호환하는) JAX-RPC 웹 서비스 타입을 선택합니다.

다음으로, 사용하려는 Java 클래스 또는 stateless 세션 빈을 선택합니다. (WSIF 바인딩의 생성을 위해) WSIF 바인딩 옵션을 체크합니다.

그 밖에도 마법사를 통해 class loader, JAX-RPC handler classe, service state (stateful), 그리고 서비스에 의해 사용되는 기타 클래스 등을 정의할 수 있습니다. 대부분의 상황에서는 이와 같은 옵션을 설정할 필요가 없으므로, Finish 버튼을 클릭하여 마법사를 종료하고 생성된 WSDL과 WSDL 내부에 정의된 WSIF 바인딩을 확인합니다. 마법사에 대한 자세한 정보는 JDeveloper 제품문서를 참고하시기 바랍니다.

결론

지금까지 여러 가지 예제를 통해 설명한 것처럼, WSIF는 EAI 환경과 유사한 기능을 제공하고 BPEL 프로세스의 파트너 서비스를 쉽고 유연하게 구성할 수 있게 합니다. WSIF를 이용하여 BPEL의 적용범위를 기존 리소스 환경으로 확장하는 한편, SOA의 구현 과정에서 BPEL을 보다 유용하게 활용할 수 있습니다.

여러분의 의견을 보내주십시오.