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

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

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

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

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

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

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

$ ant compile

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

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

ant wsear

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

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

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

ant wsdl2java

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

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

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

$ ant build

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

$ ant runclient

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

2.0

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

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

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

소스 코드는 내장 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() 메소드의 내용이다.

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

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());