webservice系统学习笔记1-使用注解创建ws服务

简单入门之helloword，具体详细的在后面的章节详细介绍。

使用JDK自带的jax-ws创建并发布一个简单的webservice

在本地创建服务，然后本机访问

1、创建服务提供接口

IMyService.java

import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;

@WebService
public interface IMyService {
    
    /**
     * @WebResult(name="addResult")
     *     此注解可加可不加，如果加了但不指定name属性的值跟没加是一样的，
     *      加上name的效果就是在wsdl文件的定义中将该方法的返回值的名称固定了，
     *      而不是【方法名Response】,例如add方法的返回参数的定义将为：addResponse
     * 
     * @WebParam(name="a")
     *     此注解是将方法的参数的名称用一个有意义的名称进行定义,
     *     如果不定义那wsdl中将是arg0、arg1....这种无意义的名称
     * @param a
     * @param b
     * @return
     */
    @WebResult(name="addResult")
    public int add(@WebParam(name="a")int a,@WebParam(name="b")int b);
    
    @WebResult(name="loginResult")
    public boolean login(@WebParam(name="username")String username,@WebParam(name="password")String password);
}

2、服务接口的实现类
MyServiceImpl.java

import javax.jws.WebService;

//这里指定服务的接口类的路径
@WebService(endpointInterface="com.yzl.ws01.IMyService")
public class MyServiceImpl implements IMyService {

    @Override
    public int add(int a, int b) {
        System.out.println("a+b=" + (a+b));
        return a+b;
    }

    @Override
    public boolean login(String username, String password) {
        if("test".equals(username) && "123456".equals(password)){
            System.out.println(username+":login success!!");
            return true;
        }
        System.out.println(username+":login failure!!");
        return false;
    }
}

3、服务发布类
RunService.java

import javax.xml.ws.Endpoint;

public class RunService {
    
    public static void main(String[] args) {
        String url = "http://localhost:8888/ws01";
        Endpoint.publish(url, new MyServiceImpl());
    }
}

4、测试类

import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Service;

/**
 * 
 * helloword项目:测试环境跟服务器环境在同一机器同一项目内使用,服务在其他机器上则在后续介绍
 * 
 * @author Administrator
 *
 */
public class Test {

    public static void main(String[] args) throws Exception {
        
        String namespaceUrl = "http://ws01.yzl.com/";
        
        URL url = new URL("http://localhost:8888/ws01?wsdl");
        
        //使用namespaceURL和服务名创建QName
        //<definitions ... targetNamespace="http://ws01.yzl.com/" name="MyServiceImplService">
        //<service name="MyServiceImplService">
        QName qname = new QName(namespaceUrl,"MyServiceImplService");
        
        //创建服务
        Service service = Service.create(url, qname);
        
        //服务器和客户端在同一机器时可以直接用服务的接口类,不在同一机器的具体用法见后面的章节
        IMyService client = service.getPort(IMyService.class);
        
        System.out.println(client.add(10, 20));
        System.out.println(client.login("test", "123456"));
        System.out.println(client.login("test", "111111"));
    }
}

 如果不想用默认的命名空间(包反转)，可以通过如下方法修改

@WebService(targetNamespace=http://com.ws.test)

需要注意的是：如果只在接口上加上这个自定义的命名空间而不在实现类上加会导致wsdl文件里命名空间出现2个不同的(一个默认、一个自定义)