1.什么是webService?
1.1.先说好处:
- WebService是两个系统的远程调用,使两个系统进行数据交互,如应用: 天气预报服务、银行ATM取款、使用邮箱账号登录各网站等。
- WebService之间的调用是跨语言的调用。Java、.Net、php,发送Http请求,使用的数据格式是XML格式。
- 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_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到我们的项目中运行。