다음은 Java와 XML의 데이터 형과 JEUS 웹 서비스의 내장 타입 매핑(Built-in Type Mapping)을 정리한 표이다.

DII 클라이언트에서는 어떤 타입을 지정할 때, XML의 QName을 사용할 수 있다.

String NS_XSD = “http://www.w3.org/2001/XMLSchema”;
String XSD_DATETIME = new QName(NS_XSD, “dateTime”);
call.addParameter(“arg1”, XSD_DATETIME, PARAM_MODE_IN);

JEUS 웹 서비스는 JAX-RPC 타입에서 정의한 배열들을 지원한다. 예를 들어 int[ ]와 String[ ]이나 다차원 배열인 java.math.BigDecimal[ ][ ]도 지원한다.

JEUS 웹 서비스는 애플리케이션을 위해 작성한 모든 사용자 정의 타입을 지원한다. JAX-RPC 스펙에는 이러한 클래스들을 Value Type이라고 한다.

JEUS 웹 서비스에서 이것을 지원하기 위해서는 사용자 정의 클래스들은 다음 규칙을 따라야 한다.

클래스는 public, private 또는 protected 필드들을 포함할 수 있다. 웹 서비스 호출 중 전달되는 값을 위해서 필드는 다음 조건을 충족해야 한다.

위의 규칙을 따르는 JavaBeans 컴포넌트 또한 지원된다.

다음은 CalcService 소스 코드인 Calculator.java 코드이다.

package calc;

public class Calculator implements CalculatorIF {
    public Calculator() { }
    public double calc(CalcData data) {
        String op = data.getOp();
        double num1 = data.getNum1();
        double num2 = data.getNum2();
        double ret = -9999.0;

        if (op.equals("plus")) {
            ret = num1 + num2;
        } else if (op.equals("minus")) {
            ret = num1 - num2;
        } else if (op.equals("mult")) {
            ret = num1 * num2;
        } else if (op.equals("div")) {
            if (num2 != 0)
                ret = num1 / num2;
        }
        return ret;
    }
}

calc() 메소드는 CalcData형을 인자로 받고, 에러가 발생하면 –9999.0을 반환한다. 이후에 설명하는 예제에서는 좀 더 확장된 에러 처리방법을 설명할 것이다.

다음은 CalcData.java의 소스 코드이다.

package calc;

public class CalcData {
    private double num1;
    private double num2;
    private String op;

    public CalcData() { }
    public double getNum1() { return num1; }
    public double getNum2() { return num2; }
    public String getOp() { return op; }

    public void setNum1(double n) { num1 = n; }
    public void setNum2(double n) { num2 = n; }
    public void setOp(String s) { op = s; }
}

CalcData 클래스는 JAX-RPC Value Type 요구 사항을 따르고 있다. 이것은 CalcData의 인스턴스는 값으로서 전달될 수 있음을 의미한다.

다음은 Service Endpoint Interface 파일 CalculatorIF.java 코드이다.

package calc;

import java.rmi.Remote;
import java.rmi.RemoteException;

public interface CalculatorIF extends Remote {
    public double calc(CalcData data) throws RemoteException;
}

이 파일들을 컴파일하기 위해서 다음과 같이 명령을 수행한다.

ant compile

위 명령은 결과 클래스 파일들을 build 디렉터리 아래에 옮겨놓을 것이다.

배치 가능한 EAR 파일을 생성하기 위해서는 다음 명령을 수행한다.

ant wsear

웹 서비스 모듈을 배치하면 다음과 같은 주소로 서비스에 접근할 수 있다.

http://localhost:8088/Calculator1Service/Calculator1Service?wsdl

다음의 명령을 수행하면 CalcService 웹 서비스를 위한 프록시 클라이언트를 생성한다.

ant wsdl2java

생성된 Stub 코드의 패키지 이름은 com.test.calc로 가정한다.

다음은 클라이언트 프로그램의 소스 코드이다.

import com.test.calc.*;
import javax.xml.rpc.soap.SOAPFaultException;

public class CalcClient {
    public static void main(String[] args) {
        CalcClient calc = new CalcClient();

        if (args.length != 3) {
            System.out.println("usage: java CalcClient num1 op num2");
            System.out.println(" where op is one of " + "'plus', 'minus',
                     'mult', 'div'");
            System.exit(1);
        }
        try {
            calc.run(args);
        } catch (SOAPFaultException e) {
            System.err.println("faultcode = " + e.getFaultCode());
            System.err.println("faultString = " + e.getFaultString());
        } catch (Exception e) {
            System.err.println(e.toString());
            e.printStackTrace();
        }
    }
    public void run(String[] args) throws Exception {
        CalculatorIF port = new
        Calculator1Service_Impl().getCalculatorIFPort();
        CalcData data = new CalcData();
        data.setNum1((new Double(args[0])).doubleValue());
        data.setNum2((new Double(args[2])).doubleValue());
        data.setOp(args[1]);

        double ret = port.calc(data);
        System.out.println(ret);
    }
}

클라이언트 코드 구현이 완료되면 다음 명령을 통해 클라이언트 코드와 Stub 코드를 컴파일한다.

ant build

클라이언트를 실행하기 위해서 다음과 같이 Ant Task를 실행한다.

ant runclient

성공하면 다음과 같은 결과가 출력된다.

2.0

JEUS 웹 서비스는 단순 데이터 타입의 JAX-RPC Holder 클래스들을 제공한다. JAX-RPC가 지원하는 표준 Holder 클래스들은 다음과 같다.

각 Holder 클래스들이 가지고 있는 값을 액세스하기 위해 value 필드를 사용한다.

다음은 Caculator.java를 수정한 소스이다.

package calc;

import javax.xml.rpc.holders.DoubleHolder;

public class Calculator implements CalculatorIF {
    public Calculator() { }

    public void calc(CalcData data, DoubleHolder result){
        String op = data.getOp();
        double num1 = data.getNum1();
        double num2 = data.getNum2();
        double ret = -9999.0;

        if (op.equals("plus")) {
            ret = num1 + num2;
        } else if (op.equals("minus")) {
            ret = num1 - num2;
        } else if (op.equals("mult")) {
            ret = num1 * num2;
        } else if (op.equals("div")) {
            if (num2 != 0)
                ret = num1 / num2;
        }
    
        result.value = ret;
    }
}

소스 코드는 내장 Holder 클래스인 javax.xml.rpc.holders.DoubleHolder를 import하였다.

import javax.xml.rpc.holders.DoubleHolder;

calc() 메소드의 signature 또한 수정되었다. 리턴 타입은 void이고, 두 번째 파라미터로 Holder 객체를 받는다.

public void calc(CalcData data, DoubleHolder result){
. . .
}

Holder 객체가 가진 객체 값을 접근하기 위해서는 Holder 클래스의 value 필드를 이용한다.

result.value = ret;

웹 서비스를 위한 웹 서비스 클라이언트를 생성하기 전에 이 웹 서비스를 패키지로 생성하고 배치해야 한다. 또한 클라이언트 프로그램 CalcClient.java도 수정되어야 한다.

다음은 클라이언트 소스 코드 CalcClient.java의 run() 메소드의 내용이다.

    public void run(String[] args) throws Exception {
        CalculatorIF port = new CalcService_Impl().getCalculatorIFPort();
        CalcData data = new CalcData();
        data.setNum1((new Double(args[0])).doubleValue());
        data.setNum2((new Double(args[2])).doubleValue());
        data.setOp(args[1]);

        DoubleHolder ret = new DoubleHolder();
        port.calc(data, ret);
        System.out.println(ret.value);
    }

다음은 사용자가 작성한 클래스의 Holder 클래스를 작성하는 과정이다.

JAX-RPC Value 타입의 Holder 클래스를 사용하는 방법을 설명하기 위해서 CalcService 예제를 수정한다. 다음 예제에 클래스 CalcData는 계산 결과값을 멤버로 포함한다. private 변수인 result와 getter/setter 메소드를 멤버로 추가하였다.

package calc;

public class CalcData {
    private double num1;
    private double num2;
    private String op;
    private double result;

    public CalcData() { }
    public double getNum1() { return num1; }
    public double getNum2() { return num2; }
    public String getOp() { return op; }
    public double getResult() { return result; }

    public void setNum1(double n) { num1 = n; }
    public void setNum2(double n) { num2 = n; }
    public void setOp(String s) { op = s; }
    public void setResult(double n) { result = n; }
}

CalcData의 Holder 클래스는 CalcDataHolder이다. CalcDataHolder 클래스는 데이터 타입이 CalcData인 public의 value 필드와 value 필드를 초기화하는 2개의 생성자를 가지고 있다.

package calc;
import javax.xml.rpc.holders.Holder;

public class CalcDataHolder implements Holder {
    public CalcData value;

    public CalcDataHolder() {
    }

    public CalcDataHolder(CalcData value) {
        this.value = value;
    }
}

Holder 클래스를 사용하는 Calculator.java 소스 코드는 다음과 같다. calc() 메소드는 데이터 타입이 CalcDataHolder인 파라미터를 지정하고 있다. Holder 객체가 가지고 있는 객체를 접근하기 위해 public의 value 필드를 사용하고 있다.

package calc;

public class Calculator implements CalculatorIF {
    public Calculator() { }
    
    public void calc(CalcDataHolder calcData) {
        CalcData data = calcData.value;
        String op = data.getOp();
        double num1 = data.getNum1();
        double num2 = data.getNum2();
        double ret = -9999.0;

        if (op.equals("plus")) {
            ret = num1 + num2;
        } else if (op.equals("minus")) {
            ret = num1 - num2;
        } else if (op.equals("mult")) {
            ret = num1 * num2;
        } else if (op.equals("div")) {
            if (num2 != 0)
                ret = num1 / num2;
        }
        data.setResult(ret);
        
        // The following line is not necessary in this case.
        // But we will use it to show the usage of holder class.
        calcData.value = data;
    }
}

다음은 클라이언트 소스 코드의 내용이다. Ant wsdl2java 명령 또한 WSDL 문서로부터 클라이언트를 위한 Holder 클래스들을 생성한다. Ant wsdl2java 명령으로부터 생성된 Holder 클래스들은 사용자가 작성한 것과는 다르다는 것을 유념한다.

import com.test.calc.*; // generated by ant process-wsdl 
import com.test.calc.holders.*; // generated by ant process-wsdl 

public class CalcClient {
    public static void main(String[] args) {
        CalcClient calc = new CalcClient();

        if (args.length != 3) {
            System.out.println("usage: java CalcClient num1 op num2");
            System.out.println(" where op is one of " + "'plus', 'minus', 
                  'mult', 'div'");
            System.exit(1);
        }

        try {
            calc.run(args);
        } catch (Exception e) {
            System.err.println(e.toString());
            e.printStackTrace();
        }
    }

    public void run(String[] args) throws Exception {
        CalculatorIF port = new Calculator3Service_Impl().getCalculatorIFPort();
        CalcData data = new CalcData();
        CalcDataHolder dataHolder = new CalcDataHolder(data);

        data.setNum1((new Double(args[0])).doubleValue());
        data.setNum2((new Double(args[2])).doubleValue());
        data.setOp(args[1]);
        
        port.calc(dataHolder);
        System.out.println(dataHolder.value.getResult());
    }
}

다음과 같이 MIME part를 가진 웹 서비스의 WSDL이 있다.

<message name="submission">
    <part name="title" type="xsd:string" />
    <part name="price" type="xsd:float" />
    <part name="attachment" type="xsd:hexBinary" />
</message>
. . .
<operation name="submit">
    . . .
    <input>
        . . .
        <mime:part>
            <mime:content part="attachment" type="application/xml" />
        </mime:part>
        . . .
    </input>
    . . .
</operation>

기본적으로 이러한 WSDL을 가지고 wsdl2java 툴을 사용하여 SEI를 생성하면 다음과 같이 MIME 타입 "application/xml"은 javax.xml.transform.Source 타입으로 매핑된다.

public interface SubmitBook extends java.rmi.Remote {
  public String submit(String title, float price,
                       javax.xml.transform.Source attachment)
                       throws java.rmi.RemoteException;
}

Ant Task, wsdl2java에서 attribute, dataHandlerOnly="true"로 설정하거나 Command Line 툴에서 –datahandleronly 옵션을 사용하면, 다음과 같이 MIME 타입에 상관없이 part는 항상 javax.activation.DataHandler 타입으로 매핑된다.

public interface SubmitBook extends java.rmi.Remote {
  public String submit(String title, float price,
                       javax.activation.DataHandler attachment)
                       throws java.rmi.RemoteException;
}

따라서 웹 서비스 클라이언트 개발자는 DataHandler 타입으로 Attachment를 송부해야 한다.

다음은 DataHandler 타입을 사용한 웹 서비스 클라이언트 예제이다.

// Creates a FileInputStream from the specified path name
FileInputStream inputStream =
    new FileInputStream(new File("attachment/book.xml"));
DataHandler dataHandler = new DataHandler(inputStream, "application/xml");

// Get a Service port
SubmitBook port = new SubmitBookService_Impl().getSubmitBookPort();
String result = port.submit("Sample for a option: datahandleronly", 
                12.34f, dataHandler);
System.out.println("response = " + result);

다음과 같은 Document/Literal로 기술된 WSDL이 있다.

<definitions name="BookQuoteService" ... >
    <types>
        <xsd:schema targetNamespace="...">
            <xsd:complexType name="Book">
                <xsd:sequence>
                    <xsd:element name="title" type="xsd:string" />
                    <xsd:element name="isbn" type="xsd:string" />
                    <xsd:element name="authors" type="xsd:string" />
                </xsd:sequence>
            </xsd:complexType>
            <xsd:element name="Book" type="mh:Book" />
            <xsd:element name="Result" type="xsd:float" />
        </xsd:schema>
    </types>

    <message name="getBookPriceRequest">
        <part name="book" element="mh:Book" />
    </message>
    <message name="getBookPriceResponse">
        <part name="result" element="mh:Result" />
    </message>
    . . .
  
    <binding name="BookServiceSoapBinding" type="mh:BookQuote">
        <soap:binding style="document" ... />
        <operation name="getBookPrice">
            <input>
                <soap:body use="literal" ... />
            </input>
            <output>
                <soap:body use="literal" ... />
            </output>
        </operation>
    </binding>
    . . .
</definitions>

이 WSDL로부터 wsdl2java로 생성한 SEI는 다음과 같이 Object 타입의 Input 파라미터를 갖는다.

public interface BookQuote extends java.rmi.Remote {
    public float getBookPrice(sample.nodatabinding.stub.Book book)
    throws java.rmi.RemoteException;
}

만약 wsdl2java로 생성한 SEI를 생성할 때 Ant Task, wsdl2java에서 attribute, noDataBinding="true"로 설정하거나, Command Line 툴에서 –nodatabinding 옵션을 사용하면 다음과 같이 XML 타입에 상관없이 Input 파라미터 및 Return value 타입은 javax.xml.soap.SOAPElement가 된다.

public interface BookQuote extends java.rmi.Remote {
public javax.xml.soap.SOAPElement
    getBookPrice(javax.xml.soap.SOAPElement book)
    throws java.rmi.RemoteException;
}

wsdl2java의 nodatabinding 옵셥은 Document/Literal의 WSDL에서만 유효하다.

이 경우 웹 서비스 클라이언트 개발자는 SOAPElement 타입으로 메시지를 직접 구성해야 한다.

다음은 SOAPElement 타입을 사용한 웹 서비스 클라이언트 예제이다.

// Creates a FileDataSource from the specified path name
SOAPFactory factroy = SOAPFactory.newInstance();

// Create a SOAPElement object
SOAPElement book = factroy.createElement( "Book", "mh", 
                   "http://www.tmaxsoft.com/j2eews/BookQuote");

SOAPElement title = factroy.createElement("title");
title.addTextNode("Sample for a option: nodatabinding");
book.addChildElement(title);

SOAPElement isbn = factroy.createElement("isbn");
isbn.addTextNode("123-456-789");
book.addChildElement(isbn);

SOAPElement authors = factroy.createElement("authors");
authors.addTextNode("TmaxSoft Co., Ltd.");
book.addChildElement(authors);

// Get a Service port
BookQuote port = new BookQuoteService_Impl().getBookQuotePort();
SOAPElement price = port.getBookPrice(book);
System.out.println("price = " + price.getValue());