4
Programming the JWS File 4-1
4
Programming the JWS File
The following sections provide information about programming the JWS file that implements your Web service:
■
Section 4.1, Overview of JWS Files and JWS Annotations
■
Section 4.2, Java Requirements for a JWS File
■
Section 4.3, Programming the JWS File: Typical Steps
■
Section 4.4, Accessing Run-Time Information About a Web Service
■
Section 4.5, Should You Implement a Stateless Session EJB?
■
Section 4.6, Programming the User-Defined Java Data Type
■
Section 4.7, Throwing Exceptions
■
Section 4.8, Invoking Another Web Service from the JWS File
■
Section 4.9, Programming Additional Miscellaneous Features Using JWS Annotations and APIs
■
Section 4.10, JWS Programming Best Practices
4.1 Overview of JWS Files and JWS Annotations
There are two ways to program a WebLogic Web service from scratch:
1.
Annotate a standard EJB or Java class with Web service Java annotations, as defined by JSR-181, the JAX-WS specification, and by the WebLogic Web services
programming model.
2.
Combine a standard EJB or Java class with the various XML descriptor files and artifacts specified by JSR-109 such as, deployment descriptors, WSDL files, data
mapping descriptors, data binding artifacts for user-defined data types, and so on.
Oracle strongly recommends using option 1 above. Instead of authoring XML metadata descriptors yourself, the WebLogic Ant tasks and run time will generate the
required descriptors and artifacts based on the annotations you include in your JWS. Not only is this process much easier, but it keeps the information about your Web
service in a central location, the JWS file, rather than scattering it across many Java and XML files.
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 Java metadata annotations to specify the shape and characteristics of the Web service. The JWS annotations you can use in a JWS file
4-2 Getting Started With JAX-RPC Web Services for Oracle WebLogic Server
include the standard ones defined by the Web Services Metadata for the Java Platform specification JSR-181, described at
http:www.jcp.orgenjsrdetail?id=181 , plus a set of additional
annotations based on the type of Web service you are building—JAX-WS or JAX-RPC. For a complete list of JWS annotations that are supported for JAX-WS and JAX-RPC
Web services, see Web Service Annotation Support in Oracle Fusion Middleware WebLogic Web Services Reference for Oracle WebLogic Server.
When programming the JWS file, you include annotations to program basic Web service features. The annotations are used at different levels, or targets, in your JWS
file. Some are used at the class-level to indicate that the annotation applies to the entire JWS file. Others are used at the method-level and yet others at the parameter level.
4.2 Java Requirements for a JWS File
