XML 복합 타입(Complex Type)과 Java Bean

Fault 메시지와 예외 클래스

WSDL의 portType 정의와 서비스 Endpoint 인터페이스

WSDL의 service 정의와 서비스 인터페이스

<java-wsdl-mapping>

<java-wsdl-mapping> element는 JAX-RPC 매핑 파일의 최상위 element이며, 다른 매핑 element들을 포함하고 있다.

<package-mapping>

<package-mapping> element는 JAX-RPC 컴파일러가 WSDL에 정의된 여러 가지 타입에 대해 Java 클래스와 인터페이스 정의를 생성하려고 할 경우 사용된다. package-mapping 은 반드시 지정되어야 하는 항목이다. <package-type> element의 값은 Java 패키지의 이름이며 namespaceURI의 값은 지정된 Java 패키지로 매핑되어야 하는 XML 이름 공간이다.

다음은 그 예이다.

<java-wsdl-mapping version="1.1"
    xmlns="http://java.sun.com/xml/ns/j2ee">
    <package-mapping>
        <package-type>address</package-type>
        <namespaceURI>urn:AddressBookService</namespaceURI>
    </package-mapping>
    . . .
</java-wsdl-mapping>

<java-xml-type-mapping>

<java-xml-type-mapping>는 XML Schema 복합 타입(Complex Type)이나 단순 타입(Simple Type)을 사용할 때 필요하며 XML 스키마에 정의된 built-in 타입이 Java로 표준적인 매핑이 된다면 이 element를 사용하지 않아도 된다. 이 element는 XML 스키마와 Java 타입 간의 관계를 정의한다.

다음은 그 예이다.

<java-wsdl-mapping version="1.1"
    xmlns="http://java.sun.com/xml/ns/j2ee">
    . . .
    <java-xml-type-mapping>
        <java-type>address.Address</java-type>
        <ns1:root-type-qname 
            xmlns:ns1=”http://java.sun.com/xml/ns/j2ee”
            xmlns="urn:AddressBookService">
            Address
        </ns1:root-type-qname>
        <qname-scope>complexType</qname-scope>
        <variable-mapping>
            <java-variable-name>addr</java-variable-name>
            <xml-element-name>addr</xml-element-name>
        </variable-mapping>
        <variable-mapping>
            <java-variable-name>street</java-variable-name>
            <xml-element-name>street</xml-element-name>
        </variable-mapping>
        <variable-mapping>
            <java-variable-name>zipcode</java-variable-name>
            <xml-element-name>zipcode</xml-element-name>
        </variable-mapping>
    </java-xml-type-mapping>
    . . .
</java-wsdl-mapping>

<exception-mapping>

<exception-mapping>는 WSDL 결함(fault) 메시지를 Java 예외 클래스로 매핑한다. 기본적인 구조는 다음과 같다.

<java-xml-mapping…>
    . . .
    <exception-mapping>
        <exception-type>CLASS_NAME</exception-type>
        <wsdl-message>WSDL_MESSAGE_NAME</wsdl-message>
    </exception-mapping>
    . . .
</java-xml-mapping>

<service-interface-mapping>

<service-interface-mapping>는 WSDL의 service 정의를 JAX-RPC 서비스 인터페이스 타입으로 매핑한다. <service-interface> element는 WSDL의 service 정의를 나타내는 Java 인터페이스의 풀 패키지 클래스 이름을 정의하고, 서비스 인터페이스의 패키지 이름은 package-mapping element에 정의된 패키지 이름과 일치해야 한다.

<port-mapping> element는 서비스 인터페이스의 getPortName() 메소드의 포트 이름을 WSDL의 port element와 대응하게 정의한다.

<java-xml-mapping…>
    . . .
    <service-interface-mapping>
        <service-interface>
            address.AddressBookService
        </service-interface>
        <ns3:wsdl-service-name 
            xmlns:ns3="http://java.sun.com/xml/ns/j2ee" 
            xmlns="urn:AddressBookService">
            AddressBookService
        </ns3:wsdl-service-name>
        <port-mapping>
            <port-name>AddressBookIFPort</port-name>
            <java-port-name>AddressBookIFPort</java-port-name>
        </port-mapping>
    </service-interface-mapping>
    . . .
</java-xml-mapping>

위와 같이 정의될 경우, 생성되는 Java 서비스 인터페이스 정의는 다음과 같다.

package address;

public interface AddressBookService extends javax.xml.rpc.Service {
public java.lang.String getAddressBookIFPortAddress();
public address.AddressBookIF getAddressBookIFPort()
    throws javax.xml.rpc.ServiceException;
public address.AddressBookIF getAddressBookIFPort(
    java.net.URL portAddress)
    throws javax.xml.rpc.ServiceException;
}

<service-endpoint-interface-mapping>

<service-endpoint-interface-mapping>는 서비스 Endpoint 인터페이스를 WSDL의 portType과 binding 정의로 매핑한다. 이 element는 JAX-RPC 컴파일러가 적절한 Endpoint Stub과 Endpoint 인터페이스를 생성할 때 필요한 정보를 제공한다. 또한 WSDL의 operation 과 message part 정의가 어떻게 Java Endpoint 메소드의 정의로 매핑될 것인지에 대한 상세 정보를 제공한다. 다음은 AddressBookService의 매핑 파일에 정의된 예이다.

<java-wsdl-mapping…>
    . . .
    <service-endpoint-interface-mapping>
        <service-endpoint-interface>
            address.AddressBookIF
        </service-endpoint-interface>
        <ns4:wsdl-port-type
            xmlns:ns4="http://java.sun.com/xml/ns/j2ee"
            xmlns="urn:AddressBookService">
            AddressBookIF
        </ns4:wsdl-port-type>
        <ns5:wsdl-binding
            xmlns:ns5="http://java.sun.com/xml/ns/j2ee"
            xmlns="urn:AddressBookService">
            AddressBookIFSoapBinding
        </ns5:wsdl-binding>
        <service-endpoint-method-mapping>
            <java-method-name>add</java-method-name>
            <wsdl-operation>add</wsdl-operation>
            <wrapped-element/>
            <method-param-parts-mapping>
                <param-position>0</param-position>
                <param-type>address.PersonInfo</param-type>
                <wsdl-message-mapping>
                    <ns6:wsdl-message 
                        xmlns:ns6="http://java.sun.com/xml/ns/j2ee"
                        xmlns="urn:AddressBookService">
                        addRequest
                    </ns6:wsdl-message>
                    <wsdl-message-part-name>
                        parameters
                    </wsdl-message-part-name>
                    <parameter-mode>IN</parameter-mode>
                </wsdl-message-mapping>
            </method-param-parts-mapping>
            <wsdl-return-value-mapping>
                <method-return-value>
                    address.PersonInfo[]
                </method-return-value>
                <ns7:wsdl-message 
                    xmlns:ns7=”http://java.sun.com/xml/ns/j2ee“
                    xmlns="urn:AddressBookService">
                    addResponse
                </ns7:wsdl-message>
                <wsdl-message-part-name>
                    parameters
                </wsdl-message-part-name>
            </wsdl-return-value-mapping>
        </service-endpoint-method-mapping>
        . . .
    </service-endpoint-interface-mapping>
    . . .
</java-wsdl-mapping>