Java Web Services: Up and Running, 2nd Edition

A SOAP-Based Web Service

JAX-WS, like JAX-RS, uses annotations, and machine-generated JAX-WS code is awash with these. The first example is stingy in its use of annotations in order to underscore exactly what is required for a SOAP-based service. Later examples introduce additional annotations.:

The RandService class (see Example 4-1) defines a SOAP-based service with two operations, each an annotated Java method:

• Operation next1 takes no arguments and returns one randomly generated integer.
• Operation nextN takes one argument, the number of randomly generated integers desired, and returns a list (in this implementation, an array) of integers.

Example 4-1. A SOAP-based service with two operations

package rand;

import javax.jws.WebService;
import javax.jws.WebMethod;
import java.util.Random;

@WebService                                                       
public class RandService {
    private static final int maxRands = 16;

    @WebMethod // optional but helpful annotation                 
    public int next1() { return new Random().nextInt(); }
    @WebMethod // optional but helpful annotation                 
    public int[ ] nextN(final int n) {
        final int k = (n > maxRands) ? maxRands : Math.abs(n);
        int[ ] rands = new int[k];
        Random r = new Random();
        for (int i = 0; i < k; i++) rands ...