Java - Java Web Service (JWS) (Annotation Method)

Java Conceptuel Diagram


Instead of coding the raw Java class or EJB directly, you use the JWS annotations programming model, which makes programming a WebLogic Web service much easier.

This programing model takes advantage of the new JDK 5.0 metadata annotations feature in which you create an annotated Java file and then use Ant tasks to compile the file into a Java class and generate all the associated artifacts.

The Java Web Service (JWS) annotated file is the core of your Web service. It contains the Java code that determines how your Web service behaves.

A JWS file is an ordinary Java class file that uses annotations to specify the shape and characteristics of the Web service.

The JWS annotations you can use in a JWS file include:

  • the standard ones defined by the JSR 181:Web Services Metadata
  • as well as a set of other standard or WebLogic-specific annotations, depending on the type of Web service you are creating.

The Java Web Service (JWS) file that implements the Web service uses just the one required JWS annotation: @WebService.

A JWS file is a standard Java file that uses JWS metadata annotations to specify the shape of the Web service. Metadata annotations were introduced with JDK 5.0, and the set of annotations used to annotate Web service files are called JWS annotations.



The Java Web Service (JWS) file that implements the Web service uses the JWS annotation: @WebService to specify that the JWS File implements a Web Service.

The standard @WebService annotation:

  • specify, at the class level, that the JWS file implements a Web service.
  • Marks a Java class as implementing a Web Service, or a Java interface as defining a Web Service interface.


@WebService(name="SimplePortType", serviceName="SimpleService",targetNamespace="")


  • SimplePortType is the name of the Web service. It will later map to the wsdl:portType element in the WSDL file generated by the jwsc Ant task.
  • SimpleService is the service name. It will map to the wsdl:service element in the generated WSDL file.
  • is the target namespace used in the generated WSDL.


  • @WebMethod to specify explicitly that a method should be exposed as a Web service operation and to change its operation name from the default method name,
  • @WebParam and @WebResult to configure the parameters and return values,
  • and @SOAPBinding to specify the type of Web service.

Documentation / Reference

Discover More
Java Conceptuel Diagram
Java - J2EE - Web Services Implementation

Java Web services are implemented according to the JSR 109: Implementing Enterprise Web Services specification, which defines the standard Java EE runtime architecture...
Weblogic Web Service Testing
Weblogic - Simple Web Service (Hello World) with a JWS (Java Web Service) class

target such as generates the supporting artifacts, compiles the user-created and generated Java code, and archives all the artifacts into an Enterprise Application EAR file that you later deploy...
Card Puncher Data Processing
Weblogic - Web Service Complex (with User-Defined Data Types)

The URIURL“Defining the Context Path of a WebLogic Web Service”Test...

Share this page:
Follow us:
Task Runner