<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns="http://www.w3.org/2001/XMLSchema"
     targetNamespace="http://java.sun.com/xml/ns/j2ee"
     xmlns:j2ee="http://java.sun.com/xml/ns/j2ee"
     xmlns:xsd="http://www.w3.org/2001/XMLSchema"
     elementFormDefault="qualified"
     attributeFormDefault="unqualified"
     version="1.1">
<xsd:annotation>
<xsd:documentation>
@(#)j2ee_web_services_1_1.xsds	1.10 09/30/02
</xsd:documentation>
</xsd:annotation>

<xsd:annotation>
<xsd:documentation>

Copyright 2002 Sun Microsystems, Inc., 901 San Antonio
Road, Palo Alto, California 94303, U.S.A. All rights
reserved.

Sun Microsystems, Inc. has intellectual property rights
relating to technology described in this document. In
particular, and without limitation, these intellectual
property rights may include one or more of the U.S. patents
listed at http://www.sun.com/patents and one or more
additional patents or pending patent applications in the
U.S. and other countries.

This document and the technology which it describes are
distributed under licenses restricting their use, copying,
distribution, and decompilation. No part of this document
may be reproduced in any form by any means without prior
written authorization of Sun and its licensors, if any.

Third-party software, including font technology, is
copyrighted and licensed from Sun suppliers.

Sun, Sun Microsystems, the Sun logo, Solaris, Java, J2EE,
JavaServer Pages, Enterprise JavaBeans and the Java Coffee
Cup logo are trademarks or registered trademarks of Sun
Microsystems, Inc. in the U.S. and other countries.

Federal Acquisitions: Commercial Software - Government Users
Subject to Standard License Terms and Conditions.

</xsd:documentation>
</xsd:annotation>

<xsd:annotation>
<xsd:documentation>

(C) Copyright International Business Machines Corporation 2002

</xsd:documentation>
</xsd:annotation>

<xsd:annotation>
<xsd:documentation>
<![CDATA[

The webservices element is the root element for the web services
deployment descriptor.  It specifies the set of web service
descriptions that are to be deployed into the J2EE Application
Server and the dependencies they have on container resources and
services.  The deployment descriptor must be named
"META-INF/webservices.xml" in the web services' jar file.

Used in: webservices.xml

All webservices deployment descriptors must indicate the
webservices schema by using the J2EE namespace:

http://java.sun.com/xml/ns/j2ee

and by indicating the version of the schema by using the version
element as shown below:

    <webservices xmlns="http://java.sun.com/xml/ns/j2ee"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
        http://www.ibm.com/webservices/xsd/j2ee_web_services_1_1.xsd"
      version="1.1">
      ...
    </webservices>

The instance documents may indicate the published version of the
schema using the xsi:schemaLocation attribute for the J2EE
namespace with the following location:

http://www.ibm.com/webservices/xsd/j2ee_web_services_1_1.xsd

]]>
</xsd:documentation>
</xsd:annotation>

<xsd:annotation>
<xsd:documentation>

The following conventions apply to all J2EE
deployment descriptor elements unless indicated otherwise.

- In elements that specify a pathname to a file within the
  same JAR file, relative filenames (i.e., those not
  starting with "/") are considered relative to the root of
  the JAR file's namespace.  Absolute filenames (i.e., those
  starting with "/") also specify names in the root of the
  JAR file's namespace.  In general, relative names are
  preferred.  The exception is .war files where absolute
  names are preferred for consistency with the Servlet API.

</xsd:documentation>
</xsd:annotation>

<xsd:include schemaLocation="j2ee_1_4.xsd"/>


<!-- **************************************************** -->


<xsd:element name="webservices" type="j2ee:webservicesType">
    <xsd:annotation>
    <xsd:documentation>

    The webservices element is the root element for the web services
    deployment descriptor.  It specifies the set of web service
    descriptions that are to be deployed into the J2EE Application Server
    and the dependencies they have on container resources and services.

    Used in: webservices.xml

    </xsd:documentation>
    </xsd:annotation>

    <xsd:key name="webservice-description-name-key">
    <xsd:annotation>
    <xsd:documentation>

    The webservice-description-name identifies the collection of
    port-components associated with a WSDL file and JAX-RPC mapping. The
    name must be unique within the deployment descriptor.

    </xsd:documentation>
    </xsd:annotation>
        <xsd:selector xpath="j2ee:webservice-description"/>
        <xsd:field xpath="j2ee:webservice-description-name"/>
    </xsd:key>
</xsd:element>

<!-- **************************************************** -->

<xsd:complexType name="port-componentType">
    <xsd:annotation>
    <xsd:documentation>

    The port-component element associates a WSDL port with a web service
    interface and implementation.  It defines the name of the port as a
    component, optional description, optional display name, optional iconic
    representations, WSDL port QName, Service Endpoint Interface, Service
    Implementation Bean.

    </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
        <xsd:element name="description"
                     type="j2ee:descriptionType"
                     minOccurs="0" maxOccurs="1"/>
        <xsd:element name="display-name"
                     type="j2ee:display-nameType"
                     minOccurs="0" maxOccurs="1"/>
        <xsd:element name="icon"
                     type="j2ee:iconType"
                     minOccurs="0" maxOccurs="1"/>
        <xsd:element name="port-component-name"
                     type="j2ee:string">
        <xsd:annotation>
        <xsd:documentation>
        <![CDATA[

        The port-component-name element specifies a port component's
        name.  This name is assigned by the module producer to name
        the service implementation bean in the module's deployment
        descriptor. The name must be unique among the port component
        names defined in the same module.

        Used in: port-component

        Example:
                <port-component-name>EmployeeService
                </port-component-name>

        ]]>
        </xsd:documentation>
        </xsd:annotation>
        </xsd:element>
        <xsd:element name="wsdl-port"
                     type="j2ee:xsdQNameType">
        <xsd:annotation>
        <xsd:documentation>

        Defines the name space and local name part of the WSDL port QName.

        </xsd:documentation>
        </xsd:annotation>
        </xsd:element>
        <xsd:element name="service-endpoint-interface"
                     type="j2ee:fully-qualified-classType">
        <xsd:annotation>
        <xsd:documentation>
        <![CDATA[

        The service-endpoint-interface element contains the
        fully-qualified name of the port component's Service Endpoint
        Interface.

        Used in: port-component

        Example:
                <remote>com.wombat.empl.EmployeeService</remote>

        ]]>
        </xsd:documentation>
        </xsd:annotation>
        </xsd:element>
        <xsd:element name="service-impl-bean"
                     type="j2ee:service-impl-beanType"/>

        <xsd:element name="handler"
                     type="j2ee:port-component_handlerType"
                     minOccurs="0" maxOccurs="unbounded"/>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
</xsd:complexType>

<!-- **************************************************** -->

<xsd:complexType name="port-component_handlerType">
    <xsd:annotation>
    <xsd:documentation>

    Declares the handler for a port-component. Handlers can access the
    init-param name/value pairs using the HandlerInfo interface.

    Used in: port-component

    </xsd:documentation>
    </xsd:annotation>
    <xsd:sequence>
        <xsd:group ref="j2ee:descriptionGroup"/>
        <xsd:element name="handler-name"
                     type="j2ee:string">
        <xsd:annotation>
        <xsd:documentation>

        Defines the name of the handler. The name must be unique within the
        module.

        </xsd:documentation>
        </xsd:annotation>
        </xsd:element>
        <xsd:element name="handler-class"
                     type="j2ee:fully-qualified-classType">
        <xsd:annotation>
        <xsd:documentation>

        Defines a fully qualified class name for the handler implementation.

        </xsd:documentation>
        </xsd:annotation>
        </xsd:element>
        <xsd:element name="init-param"
                     type="j2ee:param-valueType"
                     minOccurs="0" maxOccurs="unbounded"/>

        <xsd:element name="soap-header"
                     type="j2ee:xsdQNameType"
                     minOccurs="0" maxOccurs="unbounded">
        <xsd:annotation>
        <xsd:documentation>

        Defines the QName of a SOAP header that will be processed by the
        handler.

        </xsd:documentation>
        </xsd:annotation>
        </xsd:element>
        <xsd:element name="soap-role"
                     type="j2ee:string"
                     minOccurs="0" maxOccurs="unbounded">
        <xsd:annotation>
        <xsd:documentation>

        The soap-role element contains a SOAP actor definition that the
        Handler will play as a role.

        </xsd:documentation>
        </xsd:annotation>
        </xsd:element>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
</xsd:complexType>

<!-- **************************************************** -->

<xsd:complexType name="service-impl-beanType">
    <xsd:annotation>
    <xsd:documentation>

    The service-impl-bean element defines the web service implementation.
    A service implementation can be an EJB bean class or JAX-RPC web
    component.  Existing EJB implementations are exposed as a web service
    using an ejb-link.

    Used in: port-component

    </xsd:documentation>
    </xsd:annotation>
    <xsd:choice>
        <xsd:element name="ejb-link"
                     type="j2ee:ejb-linkType"/>
        <xsd:element name="servlet-link"
                     type="j2ee:servlet-linkType"/>
    </xsd:choice>
    <xsd:attribute name="id" type="xsd:ID"/>
</xsd:complexType>

<!-- **************************************************** -->

<xsd:complexType name="servlet-linkType">
    <xsd:annotation>
    <xsd:documentation>
    <![CDATA[

    The servlet-link element is used in the service-impl-bean element
    to specify that a Service Implementation Bean is defined as a
    JAX-RPC Service Endpoint.

    The value of the servlet-link element must be the servlet-name of
    a JAX-RPC Service Endpoint in the same WAR file.

    Used in: service-impl-bean

    Example:
            <servlet-link>StockQuoteService</servlet-link>

    ]]>
    </xsd:documentation>
    </xsd:annotation>
    <xsd:simpleContent>
        <xsd:restriction base="j2ee:string"/>
    </xsd:simpleContent>
</xsd:complexType>

<!-- **************************************************** -->

<xsd:complexType name="webservice-descriptionType">
    <xsd:annotation>
    <xsd:documentation>

    The webservice-description element defines a WSDL document file
    and the set of Port components associated with the WSDL ports
    defined in the WSDL document.  There may be multiple
    webservice-descriptions defined within a module.

    All WSDL file ports must have a corresponding port-component element
    defined.

    Used in: webservices

    </xsd:documentation>
    </xsd:annotation>

    <xsd:sequence>
        <xsd:element name="description"
                     type="j2ee:descriptionType"
                     minOccurs="0" maxOccurs="1"/>
        <xsd:element name="display-name"
                     type="j2ee:display-nameType"
                     minOccurs="0" maxOccurs="1"/>
        <xsd:element name="icon"
                     type="j2ee:iconType"
                     minOccurs="0" maxOccurs="1"/>
        <xsd:element name="webservice-description-name"
                     type="j2ee:string">
        <xsd:annotation>
        <xsd:documentation>

        The webservice-description-name identifies the collection of
        port-components associated with a WSDL file and JAX-RPC
        mapping. The name must be unique within the deployment descriptor.

        </xsd:documentation>
        </xsd:annotation>
        </xsd:element>
        <xsd:element name="wsdl-file"
                     type="j2ee:pathType">
        <xsd:annotation>
        <xsd:documentation>

        The wsdl-file element contains the name of a WSDL file in the
        module.  The file name is a relative path within the module.

        </xsd:documentation>
        </xsd:annotation>
        </xsd:element>
        <xsd:element name="jaxrpc-mapping-file"
                     type="j2ee:pathType">
        <xsd:annotation>
        <xsd:documentation>

        The jaxrpc-mapping-file element contains the name of a file that
        describes the JAX-RPC mapping between the Java interaces used by
        the application and the WSDL description in the wsdl-file.  The
        file name is a relative path within the module.

        </xsd:documentation>
        </xsd:annotation>
        </xsd:element>
        <xsd:element name="port-component"
                     type="j2ee:port-componentType"
                     minOccurs="1" maxOccurs="unbounded">
            <xsd:key name="port-component_handler-name-key">
            <xsd:annotation>
            <xsd:documentation>

            Defines the name of the handler. The name must be unique within the
            module.

            </xsd:documentation>
            </xsd:annotation>
                <xsd:selector xpath="j2ee:handler"/>
                <xsd:field xpath="j2ee:handler-name"/>
            </xsd:key>
        </xsd:element>
    </xsd:sequence>
    <xsd:attribute name="id" type="xsd:ID"/>
</xsd:complexType>

<!-- **************************************************** -->

<xsd:complexType name="webservicesType">
    <xsd:sequence>
        <xsd:group ref="j2ee:descriptionGroup"/>
        <xsd:element name="webservice-description"
                     type="j2ee:webservice-descriptionType"
                     minOccurs="1" maxOccurs="unbounded">
            <xsd:key name="port-component-name-key">
            <xsd:annotation>
            <xsd:documentation>
            <![CDATA[

            The port-component-name element specifies a port
            component's name.  This name is assigned by the module
            producer to name the service implementation bean in the
            module's deployment descriptor. The name must be unique
            among the port component names defined in the same module.

            Used in: port-component

            Example:
                    <port-component-name>EmployeeService
                    </port-component-name>

            ]]>
            </xsd:documentation>
            </xsd:annotation>
                <xsd:selector xpath="j2ee:port-component"/>
                <xsd:field xpath="j2ee:port-component-name"/>
            </xsd:key>
        </xsd:element>
    </xsd:sequence>

    <xsd:attribute name="version"
                   type="j2ee:dewey-versionType"
                   fixed="1.1"
                   use="required">
    <xsd:annotation>
    <xsd:documentation>

    The required value for the version is 1.1.

    </xsd:documentation>
    </xsd:annotation>
    </xsd:attribute>
    <xsd:attribute name="id" type="xsd:ID"/>
</xsd:complexType>

</xsd:schema>

