javax.jws
Annotation Type WebService
@Retention(value=RUNTIME)
@Target(value=TYPE)
public @interface WebService
Marks a Java class as implementing a Web Service, or a Java interface as defining a Web Service interface.
Optional Element Summary |
String |
endpointInterface
The complete name of the service endpoint interface defining the service’s abstract Web Service contract. |
String |
name
The name of the Web Service. |
String |
serviceName
The service name of the Web Service. |
String |
targetNamespace
The XML namespace used for the WSDL and XML elements generated from this Web Service. |
String |
wsdlLocation
The location of a pre-defined WSDL describing the service. |
name
public abstract String name
- The name of the Web Service. Used as the name of the wsdl:portType when mapped to WSDL 1.1.
Defaults to the simple name of the Java class or interface
- Default:
- ""
targetNamespace
public abstract String targetNamespace
- The XML namespace used for the WSDL and XML elements generated from this Web Service.
- Default:
- ""
serviceName
public abstract String serviceName
- The service name of the Web Service. Used as the name of the wsdl:service when mapped to WSDL 1.1.
Not allowed on interfaces. Defaults to the simple name of the Java class + “Service".
- Default:
- ""
wsdlLocation
public abstract String wsdlLocation
- The location of a pre-defined WSDL describing the service. The wsdlLocation is a URL (relative or absolute)
that refers to a pre-existing WSDL file. The presence of a wsdlLocation value indicates that the service
implementation bean is implementing a pre-defined WSDL contract. The JSR-181 tool should instead feedback
if the service implementation bean is inconsistent with the portType and bindings declared in this WSDL. Note
that a single WSDL file might contain multiple portTypes and multiple bindings. The annotations on the service
implementation bean determine the specific portType and bindings that correspond to the Web Service.
- Default:
- ""
endpointInterface
public abstract String endpointInterface
- The complete name of the service endpoint interface defining the service’s abstract Web Service contract. This
annotation allows the developer to separate the interface contract from the implementation. If this annotation
is present, the service endpoint interface is used to determine the abstract WSDL contract (portType and
bindings). The service endpoint interface may include JSR-181 annotations to customize the mapping from Java to
WSDL. The service implementation bean may implement the service endpoint interface, but is not required to do
so.
If this annotation is not present, the Web Service contract will be generated from annotations on the service
implementation bean itself. If a service endpoint interface is required by the target environment, it will be
generated into an implementation-defined package with an implementation defined name.
- Default:
- ""