Home:Learn XQuery:XQuery Examples:XQueryWebService:XQueryWebService Framework:WSDL Generation

Generating WSDL Documents

XQueryWebService also automatically generates a Web Service Definition Language (WSDL) document based on the XQuery in your Java servlet container's XQuery folder. The WSDL document describes the services that are exposed by a given XQuery, and this can be useful if you plan to provide programmatic access to one or more of those services.

To take a look at the WSDL document generated — in real-time — for the Employee Lookup example, click here.

If we take a closer look, we see that the WSDL document defines a single service (<wsdl:service> ), exposed through two ports: SOAP and HTTPGET.

Each query is exposed as a WSDL operation (<wsdl:operation> ), with each query's external variables exposed as operation parameters. Further, all built-in schema types are preserved in the parameter declaration.

Consider the following external variable declared in our example XQuery:

declare variable $id as xs:string external;

In the <wsdl:types> section of the generated WSDL document, you find the following global element:

            <xs:element name="emp">
                <xs:complexType>
                    <xs:all>
                        <xs:element name="id" type="xs:string"/>
                    </xs:all>
                </xs:complexType>
            </xs:element>

The input message references the global element, "emp":

    <wsdl:message name="empInputMsg">
        <wsdl:part element="dd:emp" name="parameters"/>
    </wsdl:message>

Currently, XQueryWebService does not support user-defined types for external variables.

Next Steps

You can use a WSDL document to create a set of classes that can be used to manipulate the data service as if it was a local library. Learn more about using WSDL service references in the next section.