@jws:wsdl Tag

Specifies a WSDL file that is implemented by a web service or represented by a Service control.

# Syntax

    @jws:wsdl
    	file="fileName"

# Attributes

file

Required. Specifies the name of a WSDL file. fileName may begin with the # character, in which case the referenced WSDL file is expected to be found in line in the current file as the value of a @jws:define tag with name attribute value fileName. This arrangement is illustrated in the following example:

    import weblogic.jws.control.ServiceControl;
    /**
     * @jws:location http-url="creditreport/IRS.jws" jms-url="creditreport/IRS.jws"
     * @jws:wsdl file="#IRSWsdl"
     */
    public interface IRSControl extends ServiceControl
    {
        ...
    }
    /**
     @jws:define name="IRSWsdl" value::
          <?xml version=1.0 encoding=utf-8?>
          <definitions ...>
            ...remainder of WSDL here...
          </definitions>
      ::
     */

# Remarks

The following rules apply to this tag's use:

When optionally applied to a class in a JWS file:

- Only one @jws:wsdl tag may be present within the class' Javadoc comment block.

When optionally applied to an interface in a CTRL file defining a Service control:

- Only one @jws:location tag may be present in the interface's Javadoc comment block.

A WSDL (Web Services Description Language) file conveys the public contract of a web service. When the @jws:wsdl tag is applied to a class in a JWS file or an interface in a CTRL file, it indicates that the service in the JWS file or the service represented by the CTRL file implements the public contract expressed in the WSDL file.
WebLogic Workshop validates the actual interface described by the service or Service control. Errors are generated at compile time if the defined interface does not comply with that described in the WSDL.
A Service control generated from a WSDL file is always annotated as implementing the WSDL file from which it was generated.

Related Topics

Service Control: Using Another Web Service

WSDL Files: Web Service Descriptions

@jws:define Tag