WebService详解

1、WebService简述

WebService是一个平台独立的，低耦合的，自包含的、基于可编程的web的应用程序，可使用开放的XML（标准通用标记语言下的一个子集）标准来描述、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的应用程序。
WebService是应用程序之间的远程调用，调用是跨语言的调用，具有开放性。

2、名词

• XML

XML. Extensible Markup Language －扩展性标记语言
XML，用于传输格式化的数据，是Web服务的基础。
namespace-命名空间。
xmlns=“http://xxx.cn” 使用默认命名空间。
xmlns:xxx=“http://xxx.cn”使用指定名称的命名空间。

• WSDL

WSDL – WebService Description Language – Web服务描述语言。
通过XML形式说明服务在什么地方－地址。
通过XML形式说明服务提供什么样的方法 – 如何调用。

• SOAP

SOAP-Simple Object Access Protocol(简单对象访问协议)
SOAP作为一个基于XML语言的协议用于有网上传输数据。
SOAP = 在HTTP的基础上+XML数据。
SOAP是基于HTTP的。
SOAP的组成如下：

Envelope – 必须的部分。以XML的根元素出现。
Headers – 可选的。
Body –必须的。在body部分，包含要执行的服务器的方法。和发送到服务器的数据。

3、简单入门

3.1、使用JDK发布webService

在JDK1.6中JAX-WS规范定义了如何发布一个webService服务。JAX-WS是指Java Api for XML – WebService。

1、用Jdk1.6.0_21以后的版本发布一个WebService服务.
2、与Web服务相关的类，都位于javax.jws.*包中。

• @WebService
  这是jdk1.6提供的一个注解。它位于：javax.jws.*包中，用在类上指定将此类发布成一个ws服务。
  给类添加上@WebService注解后，类中所有的非静态方法都将会对外公布。
  不支持静态方法（static），final方法。
  如果一个类上，被添加了@WebService注解，则必须此类至少有一个可以公开的方法，否则将会启动失败。

• Endpoint
  此类为端点服务类，它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。
  Endpoint也是jdk提供的一个专门用于发布服务的类，它的publish方法接收两个参数，一个是本地的服务地址，二是提供服务的类。它位于javax.xml.ws.*包中。

  static Endpoint.publish(String address, Object implementor)
  ——在给定地址处针对指定的实现者对象创建并发布端点。
  stop方法用于停止服务。
  EndPoint发布完成服务以后，将会独立的线程运行。所以，publish之后的代码，可以正常执行。

• @WebMethod
  如果希望某个方法(非static,非final)不对外公开，可以在方法上添加@WebMethod(exclude=true)，阻止对外公开

package cn.com.webService;

import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.xml.ws.Endpoint;

@WebService//添加注解
public class HelloMx {
   

    //至少包含一个可以对外公开的服务方法
    public String sayHello(String name ){
        return "Mx--> "+name;
    } 
    //此方法不对外发布
    @WebMethod(exclude=true)
    public String sayMx(){
        return "你好";
    }

    public static void main(String[] args) {
        //参数一：发布地址
        //参数二：提供服务者
        Endpoint.publish("http://172.20.43.163:9999/hello", new HelloMx());
    }
}

可以查看发布后的wsdl说明。地址为你发布的地址+?wsdl
http://172.20.43.163:9999/hello?wsdl

3.2、wsimport调用发布的webService

wsimport是jdk自带的,可以根据wsdl文档生成客户端调用代码的工具.当然,无论服务器端的WebService是用什么语言写的,都将在客户端生成Java代码.服务器端用什么写的并不重要
wsimport.exe位于JAVA_HOME\bin目录下.
常用参数为:
-d<目录> - 将生成.class文件。默认参数。
-s<目录> - 将生成.java文件。
-p<生成的新包名> -将生成的类，放于指定的包下。
(wsdlurl) - http://server:port/service?wsdl，必须的参数。
示例：
C:/> wsimport –s . http://172.20.43.163:9999/hello?wsdl
注意：-s不能分开，-s后面有个小点，用于指定源代码生成的目录。点即当前目录。

如果使用了-s参数则会在目录下生成两份代码，一份为.class代码。一份为.java代码。
.class代码，可以经过打包以后使用。.java代码可以直接Copy到我们的项目中运行。

package cn.com.test;

import cn.com.webservice.HelloMx;
import cn.com.webservice.HelloMxService;

public class TestWebService {
   

    public static void main(String[] args) {
        //<service name="HelloMxService">
        HelloMxService hs = new HelloMxService();

        //<port name="HelloMxPort" binding="tns:HelloMxPortBinding">
        HelloMx hm = hs.getHelloMxPort();
        String str = hm.sayHello("kk");
        System.out.println(str);//Mx--> kk
    }
}

3.3 调用天气预报

使用wsimport命令生成客户端代码
wsimport –s .