@(#)j2ee_jaxrpc_mapping_1_1.xsds 1.11 09/03/03 Based on j2ee_jaxrpc_mapping_1_0.dtd, Last updated: 09/19/2002 10:26 DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. Copyright 2003-2007 Sun Microsystems, Inc. All rights reserved. The contents of this file are subject to the terms of either the GNU General Public License Version 2 only ("GPL") or the Common Development and Distribution License("CDDL") (collectively, the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the License at https://glassfish.dev.java.net/public/CDDL+GPL.html or glassfish/bootstrap/legal/LICENSE.txt. See the License for the specific language governing permissions and limitations under the License. When distributing the software, include this License Header Notice in each file and include the License file at glassfish/bootstrap/legal/LICENSE.txt. Sun designates this particular file as subject to the "Classpath" exception as provided by Sun in the GPL Version 2 section of the License file that accompanied this code. If applicable, add the following below the License Header, with the fields enclosed by brackets [] replaced by your own identifying information: "Portions Copyrighted [year] [name of copyright owner]" Contributor(s): If you wish your version of this file to be governed by only the CDDL or only the GPL Version 2, indicate your decision by adding "[Contributor] elects to include this software in this distribution under the [CDDL or GPL Version 2] license." If you don't indicate a single choice of license, a recipient has the option to distribute your version of this file under either the CDDL, the GPL Version 2 or to extend the choice of license to its licensees as provided above. However, if you add GPL Version 2 code and therefore, elected the GPL Version 2 license, then the option applies only if the new code is made subject to such option by the copyright holder. (C) Copyright International Business Machines Corporation 2002 ... The instance documents may indicate the published version of the schema using the xsi:schemaLocation attribute for J2EE namespace with the following location: http://www.ibm.com/webservices/xsd/j2ee_jaxrpc_mapping_1_1.xsd ]]> 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. This is the root of the java-wsdl-mapping deployment descriptor. The constructor-parameter-order element defines the order that complexType element values are applied to a Java exception constructor. Element names are specified for each parameter of the constructor, including element names of inherited types if necessary. Used in: exception-mapping The element-name element defines the name of a complexType element name attribute value. The exception-mapping element defines the mapping between the service specific exception types and wsdl faults and SOAP headerfaults. This element should be interpreted with respect to the mapping between a method and an operation which provides the mapping context. Used in: service-endpoint-method-mapping The exception-type element defines Java type of the exception. It may be a service specific exception. It must be a fully qualified class name. The wsdl-message-part-name element is required only when the message referenced by the wsdl-message element has more than one part. This only occurs when multiple headerfaults use the same message. The element describes the Java mapping to a known WSDL document. It contains the mapping between package names and XML namespaces, WSDL root types and Java artifacts, and the set of mappings for services. The required value for the version is 1.1. The java-xml-type-mapping element contains a java-type that is the fully qualified name of the Java class, primitive type, or array type, QName of the XML root type or anonymous type, the WSDL type scope the QName applies to and the set of variable mappings for each public variable within the Java class. Used in: java-wsdl-mapping The java-type element is the fully qualified class name of a Java class, primitive, or array type. The root-type-qname identifies the WSDL QName of an XML type. The anonymous-type-qname identifies the WSDL QName of an anonymous XML type. The method-param-parts-mapping element defines the mapping between a Java method parameters and a wsdl-message. Used in: service-endpoint-method-mapping The param-position element defines the position of a parameter within a Java method. It must be an integer starting from 0. The param-type element defines the fully qualified class name of a Java class, primitive, or array type. The package-mapping indicates the mapping between java-package-name and XML namespace in the WSDL document. Used in: java-wsdl-mapping The package-type indicates the Java package name. It must be a fully qualified package name, even though the XML schema type is fully-qualified-classType. The namespaceURI element indicates a URI. The parameter-mode element defines the mode of the parameter. It can have only three values, IN, OUT, INOUT. Used in: java-xml-type-mapping The port-mapping defines the mapping of the WSDL port name attribute to the Java name used to generate the Generated Service Interface method get{java-name}. Used in: service-interface-mapping The port-mapping defines the mapping of the WSDL port name attribute to the Java name used to generate the Generated Service Interface method get{java-name}. The java-port-name element is the string to use as the port name in Java. It is used in generating the Generated Service Interface method get{java-port-name}. The qname-scope elements scopes the reference of a QName to the WSDL element type it applies to. The value of qname-scope may be simpleType, complexType, or element. Used in: java-xml-type-mapping The service-endpoint-interface-mapping defines a tuple to specify Service Endpoint Interfaces to WSDL port types and WSDL bindings. An interface may be mapped to a port-type and binding multiple times. This happens rarely. Used in: java-wsdl-mapping The service-endpoint-interface element defines the Java type for the endpoint interface. The name must be a fully qualified class name. The wsdl-port-type element defines the wsdl port type by a QNAME which uniquely identifies the port type. The wsdl-binding element defines the wsdl binding by a QNAME which uniquely identifies the binding. The service-endpoint-method-mapping element defines the mapping of Java methods to operations (which are not uniquely qualified by qnames). The wsdl-operation should be interpreted with respect to the portType and binding in which this definition is embedded within. See the definitions for service-endpoint-interface-mapping and service-interface-mapping to acquire the proper context. The wrapped-element indicator should only be specified when a WSDL message wraps an element type. The wsdl-return-value-mapping is not specified for one-way operations. Used in: service-endpoint-interface-mapping The java-method-name element defines the name of a Java method within an interface. The wsdl-operation element defines an operation within a WSDL document. It must be interpreted with respect to a port type. The wrapped-element element is defined when a WSDL message with a single part is used to wrap an element type and the element's name matches the operation name. The service-interface-mapping element defines how a Java type for the service interface maps to a WSDL service. Used in: java-wsdl-mapping The service-interface element defines the Java type for the service. For static services, it is javax.xml.rpc.Service interface. For generated service, it would be the generated interface name. The name must be a fully qualified class name. The wsdl-service-name element defines the wsdl service name by a QNAME which uniquely identifies the service. The variable-mapping element defines the correlation between a Java class data member or JavaBeans property to an XML element or attribute name of an XML root type. If the data-member element is present, the Java variable name is a public data member. If data-member is not present, the Java variable name is a JavaBeans property. Used in: java-xml-type-mapping The java-variable-name defines the name of a public data member or JavaBeans property within a Java class. The data-member element is a boolean indicator that a Java variable is a public data member and not a JavaBeans property. The xml-attribute-name element defines name attribute value of a WSDL attribute element within a root type. The value of an xml-attribute-name element must match the value of the ref attribute if mapping an attribute reference. The xml-element-name element defines name attribute value of a WSDL element within a root type. The value of an xml-element-name element must match the value of the ref attribute if mapping an element reference. The xml-wildcard element associates the variable-mapping with an xsd:any element within a root type. The wsdl-message-mapping element defines the mapping to a specific message and its part. Together they define uniquely the mapping for a specific parameter. Parts within a message context are uniquely identified with their names. The parameter-mode is defined by the mapping to indicate whether the mapping will be IN, OUT, or INOUT.. The presence of the soap-header element indicates that the parameter is mapped to a soap header only. When absent, it means that the wsdl-message is mapped to a Java parameter. The soap headers are interpreted in the order they are provided in the mapping. Used in: method-param-parts-mapping The soap-header element is a boolean element indicating that a parameter is mapped to a SOAP header. Interpretation of the wsdl-message-part-name element depends on whether or not wrapped-element has been defined in the service-endpoint-method-mapping. If wrapped-element is not specified, wsdl-message-part-name defines a WSDL message part. It should always be interpreted with respect to a wsdl-message element. If wrapped-element is specified, wsdl-message-part-name refers to an element name of the element type. Used in: wsdl-message-mapping, wsdl-return-value-mapping The wsdl-message element defines a WSDL message by a QNAME. Used in: wsdl-message-mapping, wsdl-return-value-mapping, exception-mapping The wsdl-return-value-mapping element defines the mapping for the method's return value. It defines the mapping to a specific message and its part. Together they define uniquely the mapping for a specific parameter. Parts within a message context are uniquely identified with their names. The wsdl-message-part-name is not specified if there is no return value or OUT parameters. Used in: service-endpoint-method-mapping The method-return-value element defines a fully qualified class name or void type for the method's return value type.