zoukankan      html  css  js  c++  java

  • webService（简单小demo）

    1.什么是webService？

    1.1.先说好处：

    1.  WebService是两个系统的远程调用，使两个系统进行数据交互，如应用： 天气预报服务、银行ATM取款、使用邮箱账号登录各网站等。
    2.  WebService之间的调用是跨语言的调用。Java、.Net、php，发送Http请求，使用的数据格式是XML格式。
    3. webxml.com.cn上面有一些免费的WebService服务，可以进去看看。

    　　基础概念：　　

    （1）理解服务：

    　　现在的应用程序变得越来越复杂，甚至只靠单一的应用程序无法完成全部的工作。更别说只使用一种语言了。因此需要访问别人写的服务，以获得感兴趣的数据。

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

    　　目前的云计算、云查杀都是一种服务，现在比较流行的说法是SOA(面向服务的框架)。

    　　既然数据库可以依据某些标准对外部其他应用程序提供服务、而且不关心对方使用什么语言，那我们为什么就不能实现跨平台、跨语言的服务呢？

    　　只要我们用Java写的代码，可以被任意的语言所调用，我们就实现了跨平台，跨语言的服务！---WebService

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

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

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

    （2）基础概念：XML

    　　XML Extensible Markup Language －扩展性标记语言

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

    　　namespace-命名空间。

    （3）基础概念：WSDL

    　　WSDL – WebService Description Language – Web服务描述语言。

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

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

    （4）基础概念：SOAP

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

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

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

    　　SOAP是基于HTTP的。

    　　SOAP的组成如下：

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

    　　　　Headers – 可选的。

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

    　　传递的数据格式：

     1 <Envelope>
 2 
 3       <Header></Header>
 4 
 5       <Body>
 6 
 7                 <方法名>
 8 
 9                           方法参数
10 
11 　　　　    </方法名>
12 
13       </Body>
14 
15 </Envelope>

    （5）请求示例：

              以下发出HTTP请求，但不同的是向服务器发送的是XML数据！

     说明：（1），因为是在HTTP上发数据，所以必须先遵循HTTP协议

         （2），XML部分即SOAP协议，必须包含Envelope和Body元素。

    （6）响应示例：

    　　　

     

    1.2. 应用说明

    1，WebService通过HTTP协议完成远程调用

    （1），WebService只采用HTTP POST方式传输数据，不使用GET方式;  -- 握手，WSDL-get,（基于soap协议，传输数据格式是XML）

    　　普通http post的contentType为

    　　application/x-www-form-urlencoded

    　　WebService的contentType为－即在Http的基础上发SOAP协议

    　　text/xml 这是基于soap1.1协议。

    　　application/soap+xml 这是基于soap1.2协议。

     （2），WebService从数据传输格式上作了限定。WebService所使用的数据均是基于XML格式的。目前标准的WebService在数据格式上主要采用SOAP协议。SOAP协议实际上就是一种基于XML编码规范的文本协议。

     （3），SOAP – Simple Object Access protocol 简单对像访问协议。是运行在HTTP协议基础之上的协议。其实就是在HTTP协议是传输XML文件，就变成了SOAP协议。

     （4），SOAP1.1和SOAP1.2的 namespace不一样。可以通过查看类

    javax.xml.ws.soap.SOAPBinding来查看里面的常量

    默认情况下，Jdk1.6只支持soap1.1

    即：@BindingType(value=javax.xml.ws.soap.SOAPBinding.SOAP11HTTP_BINDING)

     

    1.3. WebService与Web的区别与联系

    　　可以把WebService看作是Web服务器上应用；反过来说，Web服务器是WebService运行时所必需的容器。这就是它们的区别和联系。 

    1.4. WebService的特点

           WebService通过HTTP POST方式接受客户的请求（如果基于soap协议，传输数据格式是XML），只能是POST方式，因为GET方式没有请求体。

    　　WebService与客户端之间一般使用SOAP协议传输XML数据.

    　　它本身就是为了跨平台或跨语言而设计的。

    　　　　（1） SOAP1.2注意：当使用SOAP12以后，wsimport和Eclipse和WSExplorer都不可以正常使用了，必须使用cxf提供的wsdl2java工具生成本地代码。

    　　　　（2） 客户端最好发送1.1请求，而服务端最好使用1.2高版本。

    2.简单例子

    　　

    2.1.使用Jdk1.6.0_21以后的版本发布一个WebService服务（使用注解方式）

    与Web服务相关的类，都位于javax.jws.*包中。

    主要类有：

    　　@WebService － 它是一个注解，用在类上指定将此类发布成一个ws。

    　　Endpoint – 此类为端点服务类，它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。

    （1）一个简单的Java项目，webService

    　　①建立如下包结构：

    　　　　

    　　　　　　

     ②新建带有main方法的类HelloWebService.java，并在类上加@WebService的注释。

    在类中使用EndPoint类的publish方法：

    还需要至少提供一个可以发布的方法：（方法不能是静态并且是非final的），只有这样的方法才可被发布。 

     1 package cn.jingyangxu.service;
 2 
 3 import javax.jws.WebService ;
 4 import javax.xml.ws.Endpoint ;
 5 
 6 @WebService
 7 public class HelloWebService {
 8     
 9     public String test(String name){
10         return "我叫："+name;
11     }
12     
13     public static void main(String [] args) {
14         Endpoint.publish("http://localhost:8899/hello", new HelloWebService());
15         System.out.println("start...") ;
16     }
17     
18 }

    　　

    ③服务发布成功后，在客户端调用：

    　　启动服务后，在浏览器中输入绑定的服务地址+”?wsdl”即可查看服务的说明书。wsdl- WebService　Description　Language,是以XML文件形式来描述WebService的”说明书”,有了说明书,我们才可以知道如何使用或是调用这个服务.

    ④使用wsimport –s . http://localhost：8899/hello?wsdl

    　　即可生成客户端代码。（包含.class文件和.java文件）

    　　此处注意：是生成而不是下载，服务器上并没有所生成的所有的类和方法。

    ⑤新建一个Java项目Client做客户端，将.java文件打包一起放在此项目下，调用：

    　　　　　　　　

     

     1 package cn.jingyangxu.client ;
 2 
 3 import cn.jingyangxu.service.HelloWebService ;
 4 import cn.jingyangxu.service.HelloWebServiceService ;
 5 
 6 public class Client {
 7     public static void main(String [] args) {
 8         HelloWebServiceService service=new HelloWebServiceService();
 9         HelloWebService servicePort = service.getHelloWebServicePort() ;
10         String test = servicePort.test("ะกร๗") ;
11         //System.out.println(test) ;
12     }
13 }

    成功！

    3.说明

    　　wsimport是jdk自带的,可以根据wsdl文档生成客户端调用代码.当然,无论服务器端的WebService是用什么语言写的,都将在客户端生成Java代码。服务器端用什么写的并不重要。

    wsimport.exe位于JAVA_HOMEin目录下.

    常用参数为:

    　　-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到我们的项目中运行。

     
  • 相关阅读:
    RabbitMQ 入门指南（Java）
    RabbitMQ 四种Exchange
    使用Spring AMQP开发消费者应用
    RestTemplate源码浅析
    Spring Boot整合Rabbitmq
    RestTemplate实践（及遇到的问题）
    binlog之三：binlog开启、查看
    微服务架构的六种模式
    SpringBoot自动化配置之四：@Conditional注解详解
    微服务理论之一：应用架构演进史
  • 原文地址：https://www.cnblogs.com/xujingyang/p/7815913.html
Copyright © 2011-2022 走看看