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

----------------------------------------------------------------------------------------------整理自传智播客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_HOMEbin目录下.
?? ?常用参数为:
?? ??? ?-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();
        }
    }

???????