XML complex type and Java beans

Fault messages and exception classes

portType definition and service endpoint interface in WSDL

portType definition and service endpoint interface in WSDL

<java-wsdl-mapping>

Root element of the JAX-RPC mapping file, which includes other mapping elements.

<package-mapping>

Used by the JAX-RPC compiler to generate Java class and interface definitions by using various types specified in the WSDL file. The <package-mapping> element must be specified.

The <package-type> element value corresponds to the Java package name, and the <namespaceURI> element value is an XML namespace that is mapped to the specified Java package.

<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>

Relationship between the XML schema complex type and Java type. This element is required when using a complex or simple type of XML schema, but is not needed if the built-in type allows standard Java mapping.

<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>

Maps WSDL fault message to Java exception class.

<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>

Maps the service definition of WSDL to JAX-RPC service interface type. The <service-interface> element specifies the full class package name of the Java interface, and the name must match the <package-mapping> element value.

The <port-mapping> element specifies the port name returned from the getPortName() method of the service interface as the <port> element value of the WSDL.

<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>

The following Java service interface class is created by using the previous definitions.

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>

This element maps the service endpoint element to the portType and binding definition of the WSDL. It also provides information required to generate an appropriate endpoint stub and endpoint interface and specifies how the operation and message part definition of the WSDL are mapped to a Java endpoint method.

The following is an example of the definitions in the mapping file of the 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>