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());
            }
        }

四：查看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();
        }
    }