WebService基础教程之一（概念，如何发布和调用一个简单的WebService）

----------------------------------------------------------------------------------------------整理自传智播客WebService视频教程

一：基本概念

通过几个问题来了解一下WebService的概念

1）什么是WebService?

答：WebService，顾名思义就是基于Web的服务。它使用Web(HTTP)方式，接收和响应外部系统的某种请求。从而实现远程调用.

2）它能做什么?

答：我们可以调用互联网上查询天气信息Web服务，然后将它嵌入到我们的程序(C/S或B/S程序)当中来，当用户从我们的网点看到天气信息时，

他会认为我们为他提供了很多的信息服务，但其实我们什么也没有做，只是简单调用了一下服务器上的一段代码而已。

3）为什么要学习WebService?

答：学习WebService可以将你的服务(一段代码)发布到互联网上让别人去调用,也可以调用别人机器上发布的WebService,就像使用自己的代码一样。

使用图例：

   

二：WebService需要用到的名词解释

名词1：XML. Extensible Markup Language －扩展性标记语言

    XML，用于传输格式化的数据，是Web服务的基础。

        namespace-命名空间。

            xmlns=“http://itcast.cn” 使用默认命名空间。

            xmlns:itcast=“http://itcast.cn”使用指定名称的命名空间。

名词2：WSDL – WebService Description Language – Web服务描述语言。

    通过XML形式说明服务在什么地方－地址。

    通过XML形式说明服务提供什么样的方法 – 如何调用。

名词3：SOAP-Simple Object Access Protocol(简单对象访问协议)

    SOAP作为一个基于XML语言的协议用于有网上传输数据。

    SOAP = 在HTTP的基础上+XML数据。

    SOAP是基于HTTP的。

        SOAP的组成如下：

            Envelope – 必须的部分。以XML的根元素出现。

            Headers – 可选的。

            Body – 必须的。在body部分，包含要执行的服务器的方法。和发送到服务器的数据。

    请求和响应图例：

        请求：

           


        响应：

       


   

三：发布一个WebService

    １.在类上添加@WebService注解。

        这是jdk1.6提供的一个注解。它位于：javax.jws.*包中。

    ２.通过EndPoint(端点服务)发布一个webService。

        Endpoint也是jdk提供的一个专门用于发布服务的类，它的publish方法接收两个参数，一个是本地的服务地址，二是提供服务的类。它位于javax.xml.ws.*包中。

        static Endpoint.publish(String address, Object implementor)    在给定地址处针对指定的实现者对象创建并发布端点。

        stop方法用于停止服务。

        EndPoint发布完成服务以后，将会独立的线程运行。所以，publish之后的代码，可以正常执行。

    其他注意事项：

        给类添加上@WebService注解后，类中所有的非静态方法都将会对外公布。

        不支持静态方法，final方法。

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

        如果一个类上，被添加了@WebService注解，则必须此类至少有一个可以公开的方法，否则将会启动失败。

    

    程序示例：

       /*
* 将 Java 类标记为实现 Web Service，或者将 Java 接口标记为定义 Web Service 接口
*/
@WebService
public class HelloService {
//至少包含一个可以对外公开的服务方法
public String sayHello(String name){
System.err.println("invoke "+name);
return "Hello "+name;
}
public static void main(String[] args) {
/*
*static Endpoint publish(String address, Object implementor)
* 在给定地址处针对指定的实现者对象创建并发布端点。
* 第一个参数称为Binding即绑定地址
* 第二个参数是实现者，即谁提供服务
*/
//地址后添加了一个helloservice的别名
Endpoint.publish("http://localhost:9999/helloservice", new HelloService());
}
}

     运行程序后即可启动WebService，以供其它应用调用

四：查看WSDL（调用说明书）

    在地址栏中输入以下地址（后面需带上参数?WSDL表示查看应用服务说明文件）：

        http://localhost:9999/helloservice?WSDL

    注：此访问只是查看WebService的说明文件(.wsdl文件)，并非访问WebService

    文件示例：

       


        

五：使用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://192.168.0.100/one?wsdl
    注意：

        -s不能分开，-s后面有个小点，用于指定源代码生成的目录。点即当前目录。

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

    生成的文件为：

   


        

    调用代码：

    package com.leaf;

public class RunMain {
public static void main(String[] args) {

HelloServiceService hs = new HelloServiceService();

HelloService service = hs.getHelloServicePort();

String str = service.sayHi();
}
}

    根据WSDL分析调用过程：