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

最新推荐文章于 2024-07-22 21:04:31 发布

dream_maker2333

最新推荐文章于 2024-07-22 21:04:31 发布

阅读量4.1k

点赞数 3

分类专栏： WebService

本文链接：https://blog.csdn.net/huqingpeng321/article/details/70318794

版权

WebService 专栏收录该内容

4 篇文章 0 订阅

订阅专栏

----------------------------------------------------------------------------------------------整理自传智播客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分析调用过程：