webservice第一篇【介绍、Scoket、http调用、wsimport调用】

柔光的暖阳◎ 2021-09-17 07:18 300阅读 0赞

# WebService介绍 #

首先我们来谈一下为什么需要学习webService这样的一个技术吧….

## 问题一 ##

如果我们的网站需要提供一个**天气预报**这样一个需求的话，那我们该怎么做？？？？？

天气预报这么一个功能并不是简单的JS组件就能够实现的，它的数据是依赖数据库分析出来的，甚至需要卫星探测..我们个人建站是不可能搞这么一个数据库的吧。

那么既然我们自己干不了，我们可以去找别人吗？？？我们**从搜索引擎搜索，可以发现很多提供天气预报的网站，但是它返回的是一个网页，而我们仅仅需要的是对应的数据**！

我们可能就在想，我们**能不能仅仅只要它返回的数据，而并不是经过加工处理后返回的网页呢**？？

于是乎，webService就诞生了，webservice就是一个部署在Web服务器上的，**它向外界暴露出一个能够通过Web进行调用的API**。也就是说：**当我们想要获取天气预报的信息，我们可以调用别人写好的service服务，我们调用就能够得到结果了**！

## 问题二 ##

可是我们写网站主流的就有好几个平台：Java、.net、PHP等等，那么**部署在Web服务器上的服务器也就是webserice怎么能够就让我们不同的平台都能够调用呢**？？

我们知道**java、.net这样的平台他们语言的基本数据类型、复杂数据类型就可能不一样，那么怎么能够实现调用的呢**？？？

来引用一段话

> 大家在写应用程序查询数据库时，并没有考虑过为什么可以将查询结果返回给上层的应用程序，甚至认为，这就是数据库应该做的，其实不然，这是数据库通过TCP/IP协议与另一个应用程序进行交流的结果，而上层是什么样的应用程序，是用什么语言，数据库本身并不知道，它只知道接收到了一份协议，这就是SQL92查询标准协议。

无论是Java、.net、PHP等等的平台，**只要是网页开发都是可以通过http协议来进行通信的，并且返回的数据要是通用的话，那么我们早就学过这样的一种技术【XML】**

所以**webservice实际上就是http+XML**

![这里写图片描述][SouthEast]

## 对webservice的理解 ##

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

我们可以调用互联网上查询天气信息Web服务，然后将它嵌入到我们的程序(C/S或B/S程序)当中来，当用户从我们的网点看到天气信息时，他会认为我们为他提供了很多的信息服务，但其实我们什么也没有做，只是简单调用了一下服务器上的一段代码而已。

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

--------------------

# 回顾Socket #

我们在学习Java基础网络编程章节已经知道了Scoket这么一个连接了。

## Socket服务端 ##

public class SocketSer {
    
        public static void main(String[] args) throws Exception {
    
            ServerSocket ss = new ServerSocket(6666);
            boolean flag = true;
            while (flag) {
                //接收客户端的请求
                System.out.println("监听客户端的数据:");
                Socket sc = ss.accept();
                InputStream is = sc.getInputStream();
                byte[] buffer = new byte[1024];
                int len = -1;
                len = is.read(buffer);
                String getData = new String(buffer, 0, len);
                System.out.println("从客户端获取的数据:" + getData);
                //业务处理 大小写转化
                String outPutData = getData.toUpperCase();
    
                //向客户端写数据
                OutputStream os = sc.getOutputStream();
                os.write(outPutData.getBytes("UTF-8"));
    
                //释放资源
                os.close();
                is.close();
                sc.close();
            }
            ss.close();
        }
    
    }

## Socket客服端 ##

public class SocketClient {
    
        public static void main(String[] args) throws Exception {
            //获取用户输入的数据
            Scanner input = new Scanner(System.in);
            System.out.println("请输入数据:");
            String inputData = input.nextLine();
    
            //开启一个Socket端口
            Socket sc = new Socket("127.0.0.1", 6666);
            OutputStream os = sc.getOutputStream();
            os.write(inputData.getBytes());
    
            //获取服务端回传的数据
            InputStream is = sc.getInputStream();
            byte[] buffer = new byte[1024];
            int len = -1;
            len = is.read(buffer);
            String getData = new String(buffer, 0, len);
            System.out.println("从服务端获取的数据:" + getData);
            //是否流
            is.close();
            os.close();
            sc.close();
        }
    
    }

当我们从客户端输入数据以后，那么服务端就会把数据转成是大写

![这里写图片描述][SouthEast 1]

![这里写图片描述][SouthEast 2]

其实HTTP协议就是基于Socket对其进行封装，我们也可以在IE浏览器中对其进行访问.我们一样能够获取得到数据！

![这里写图片描述][SouthEast 3]

![这里写图片描述][SouthEast 4]

--------------------

## Scoket与HTTP简述 ##

![这里写图片描述][SouthEast 5]

ISO的七层模型 ： 物理层、数据链路层、网络层、传输层、表示层、会话层、应用层

*  Socket访问 ： Socket属于传输层，它是对Tcp/ip协议的实现，包含TCP/UDP,它是所有通信协议的基础，Http协议需要Socket支持，以Socket作为基础
 *  Socket通信特点：  
    \- 开启端口，该通信是 长连接的通信 ，很容易被防火墙拦截，可以通过心跳机制来实现 ，开发难度片段  
    \- 传输的数据一般是字符串 ，可读性不强  
    \- socket端口不便于推广  
    \- 性能相对于其他的通信协议是最优的
 *  Http协议访问 ：属于应用层的协议，对Socket进行了封装  
    \- 跨平台  
    \- 传数据不够友好  
    \- 对第三方应用提供的服务，希望对外暴露服务接口

问题：

*  **数据封装不够友好 ：可以用xml封装数据** 
 *  **希望给第三方应用提供web方式的服务 （http + xml） = web Service**

--------------------

# webService相关术语 #

*  名词1：XML. **Extensible Markup Language** －扩展性标记语言  
    
    
     *  XML，用于传输格式化的数据，是Web服务的基础。
     *  namespace-命名空间。
     *  xmlns=“[http://itcast.cn][http_itcast.cn]” 使用默认命名空间。
     *  xmlns:itcast=“[http://itcast.cn][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，来体验一把：我们访问[http://www.webxml.com.cn/zh\_cn/index.aspx][http_www.webxml.com.cn_zh_cn_index.aspx]

![这里写图片描述][SouthEast 6]

进入到里边

![这里写图片描述][SouthEast 7]

当我们输入一个号码，它就能够查询出我们的手机位置信息：

![ypzDm1n.png][]

我们现在要做的就是**将这个服务让我们自己写的应用程序中也可以调用**，那怎么做呢？？？

## http-get方式访问webservice ##

![这里写图片描述][SouthEast 8]

public void get(String mobileCode ,String userID ) throws Exception{
            URL url=new URL("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx/getMobileCodeInfo?mobileCode="+mobileCode+
                    "&userID="+userID);
            HttpURLConnection conn=(HttpURLConnection) url.openConnection();
            conn.setConnectTimeout(5000);
            conn.setRequestMethod("GET");
            if(conn.getResponseCode()==HttpURLConnection.HTTP_OK){ //结果码=200
                InputStream is=conn.getInputStream();
                //内存流 ， 
                ByteArrayOutputStream boas=new ByteArrayOutputStream();
                byte[] buffer=new byte[1024];
                int len=-1;
                while((len=is.read(buffer))!=-1){
                    boas.write(buffer, 0, len);
                }
                System.out.println("GET请求获取的数据:"+boas.toString());
                boas.close();
                is.close();
            }
        }

![这里写图片描述][SouthEast 9]

--------------------

## Http-Client 框架POST请求 ##

为什么要使用HttpClient工具：

*  原生态的Socket基于传输层,现在我们要访问的WebService是基于HTTP的属于应用层,所以我们的Socket通信要借助HttpClient发HTTP请求,这样**格式才能匹配**

HttpClient使用步骤如下：

1.  创建 HttpClient 的实例
2.  创建某种连接方法的实例，在这里是 GetMethod。在 GetMethod 的构造函数中传入待连接的地址
3.  配置要传输的参数，和消息头信息
4.  调用第一步中创建好的实例的 execute 方法来执行第二步中创建好的 method 实例
5.  通过response读取字符串
6.  释放连接。无论执行方法是否成功，都必须释放连接

//2.Post请求 ：通过Http-Client 框架来模拟实现 Http请求
        public void post(String mobileCode ,String userID) throws Exception{
    
    /**HttpClient访问网络的实现步骤： * 1. 准备一个请求客户端:浏览器 * 2. 准备请求方式： GET 、POST * 3. 设置要传递的参数 * 4.执行请求 * 5. 获取结果 */
            HttpClient client=new HttpClient();
            PostMethod postMethod=new PostMethod("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx/getMobileCodeInfo");
            //3.设置请求参数
            postMethod.setParameter("mobileCode", mobileCode);
            postMethod.setParameter("userID", userID);
            //4.执行请求 ,结果码
            int code=client.executeMethod(postMethod);
            //5. 获取结果
            String result=postMethod.getResponseBodyAsString();
            System.out.println("Post请求的结果："+result);
        }
    
    
        //2.Post请求 ：通过Http-Client 框架来模拟实现 Http请求
        public void soap() throws Exception{
    
            HttpClient client=new HttpClient();
            PostMethod postMethod=new PostMethod("http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx");
            //3.设置请求参数
              postMethod.setRequestBody(new FileInputStream("c:/soap.xml"));
              //修改请求的头部
              postMethod.setRequestHeader("Content-Type", "text/xml; charset=utf-8");
            //4.执行请求 ,结果码
            int code=client.executeMethod(postMethod);
            System.out.println("结果码:"+code);
            //5. 获取结果
            String result=postMethod.getResponseBodyAsString();
            System.out.println("Post请求的结果："+result);
        }

--------------------

# wsimport #

上面我们使用的是GET方式或者使用Http-Client框架来调用webservice的服务，其实这两种方式也有弊端

*  传递参数麻烦【get方式都写在请求地址上、post方式要一个一个封装】
 *  解析结果麻烦【根据返回的XML来解析字符串】

如果**我们可以把整个对象传递进去，返回的结果更加友好的话，就好像我们平常调用Java类一样使用webservice就好咯**！

Java也提供了类似的方法，**把webservice服务搞成是Java类让我们自己调用**，既然是Java类的话，那么我们使用起来就非常方便了！

把webservice服务搞成是Java类让我们自己调用其实就是**Java帮我们生成本地代理，再通过本地代理来访问webservice**

## 快速入门 ##

wsimport是Java自带的一个命令，我们想要使用该命令，就必须**配置环境变量**，并且**jdk的版本最好是1.7或以上**

值得注意的是：**ide带的JDK版本要和wsimport生成本地的版本一致，不然就用不了！！！**

*  wsimport使用：  
    
    
     *    
        **wsimport命令后面跟着的是WSDL的url路径** 语法 wsimport \[opations\]
     *  wsdl\_uri:wsdl 的统一资源标识符
     *  d ：指定要输出的文件的位置
     *  s ：表示要解析java的源码 ，默认解析出的是class字节码
     *  p ： 指定输出的包名

![这里写图片描述][SouthEast 10]

首先我们先把cmd的路径退到桌面上：

![这里写图片描述][SouthEast 11]

然后对WSDL文件生成本地代理

![这里写图片描述][SouthEast 12]

![这里写图片描述][SouthEast 13]

该本地代理其实就是一堆的字节码文件

![这里写图片描述][SouthEast 14]

将得到的字节码文件打包成jar，那么我们只要在项目中导入jar包，就可以调用了！

语法

jar cvf  test.jar【jar包的名称】 打包目录

![这里写图片描述][SouthEast 15]

本来我是想将本地代理的class文件生成jar包，然后导入到idea环境下，那么直接调用就行了。**可是idea老是报出找不到对应的类，找了半天也找不到，很烦呀**！！！！我考虑了以下的几种情况

*  *\* 生成的class文件的JVM和idea下的JVM环境不匹配【后来切换了也不行】\**
 *  **idea缓存原因，把idea所有缓存去掉也不行**
 *  **生成的本地代理包名cn不行【？？？idea就是对cn这个包名报错，后来我改成自定义的包名也不行】**

最后我还是没有找到办法，如果知道是什么原因的，麻烦在评论中告诉我吧….因此这次的测试import，我就不仅仅生成class字节码文件，还生成了.java文件。我就直接使用java文件来测试了。

在zhongfucheng目录下生成本地代理，把java源码也带上

![这里写图片描述][SouthEast 16]

于是我就把java源码复制到我的项目中，用java源码来进行测试

![这里写图片描述][SouthEast 17]

--------------------

## 解析WSDL ##

有的同学可能会疑问，为啥wsimport能那么厉害，将`http://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL`这么一个url生成本地代理，其实我们看了WSDL文件就知道了。

![这里写图片描述][SouthEast 18]

值得注意的是，本地代理仅仅是有其方法，类，并不能解析出具体的实现的。具体的操作其实还是webservice去完成的。代理这么一个概念就更加清晰了。

[SouthEast]: /images/20210827/d19d6dbe53ce46aca4dd555f01dc7a21.png
[SouthEast 1]: /images/20210827/6dcea90fe13c40a2867fef976a67a12c.png
[SouthEast 2]: /images/20210827/36f1a4904b8d450aa204500f99055f02.png
[SouthEast 3]: /images/20210827/aee3df393fb0496799850a939712ee91.png
[SouthEast 4]: /images/20210827/9ff7c37be1b141c39334316655e34769.png
[SouthEast 5]: /images/20210827/56ddcbbd501849d6ae55980a84d453d4.png
[http_itcast.cn]: http://itcast.cn
[http_www.webxml.com.cn_zh_cn_index.aspx]: http://www.webxml.com.cn/zh_cn/index.aspx
[SouthEast 6]: /images/20210827/f87c018795ea4ea1a4d8ed563f37d127.png
[SouthEast 7]: /images/20210827/88c7f53b7b234a0987a379bfd968fe11.png
[ypzDm1n.png]: http://i.imgur.com/ypzDm1n.png
[SouthEast 8]: /images/20210827/1d633e9c45eb44a780981af3fd30ce75.png
[SouthEast 9]: /images/20210827/33566b253aca443eb59592ceb993c82e.png
[SouthEast 10]: /images/20210827/72070502f8144b7fbd76578a1a1fb7c6.png
[SouthEast 11]: /images/20210827/1be3ecc1f15446e1ac52a3cdb22a921e.png
[SouthEast 12]: /images/20210827/0a6b1b551804469b8d2a6792ca64bbeb.png
[SouthEast 13]: /images/20210827/ee64ea4527d348d8ac9e6d1544642337.png
[SouthEast 14]: /images/20210827/27ced9edef3944e4ac7ef7b646510205.png
[SouthEast 15]: /images/20210827/aaeaf033b42c48f588a880ec2c55bbf6.png
[SouthEast 16]: /images/20210827/8fe767088e9b4364add27bd2ea42b5aa.png
[SouthEast 17]: /images/20210827/50e96a682a0d405296faae482ef8840e.png
[SouthEast 18]: /images/20210827/6ad12ebc5dd647588605d942916fc2b4.png