1、WebService简述
WebService是一个平台独立的,低耦合的,自包含的、基于可编程的web的应用程序,可使用开放的XML(标准通用标记语言下的一个子集)标准来描述、发布、发现、协调和配置这些应用程序,用于开发分布式的互操作的应用程序。?
WebService是应用程序之间的远程调用,调用是跨语言的调用,具有开放性。
2、名词
XML. Extensible Markup Language -扩展性标记语言?
XML,用于传输格式化的数据,是Web服务的基础。?
namespace-命名空间。?
xmlns=“http://xxx.cn” 使用默认命名空间。?
xmlns:xxx=“http://xxx.cn”使用指定名称的命名空间。
WSDL – WebService Description Language – Web服务描述语言。?
通过XML形式说明服务在什么地方-地址。?
通过XML形式说明服务提供什么样的方法 – 如何调用。
SOAP-Simple Object Access Protocol(简单对象访问协议)?
SOAP作为一个基于XML语言的协议用于有网上传输数据。?
SOAP = 在HTTP的基础上+XML数据。?
SOAP是基于HTTP的。?
SOAP的组成如下:
Envelope – 必须的部分。以XML的根元素出现。?
Headers – 可选的。?
Body –必须的。在body部分,包含要执行的服务器的方法。和发送到服务器的数据。
3、简单入门
3.1、使用JDK发布webService
在JDK1.6中JAX-WS规范定义了如何发布一个webService服务。JAX-WS是指Java Api for XML – WebService。
@WebService?
这是jdk1.6提供的一个注解。它位于:javax.jws.*包中,用在类上指定将此类发布成一个ws服务。?
给类添加上@WebService注解后,类中所有的非静态方法都将会对外公布。?
不支持静态方法(static),final方法。?
如果一个类上,被添加了@WebService注解,则必须此类至少有一个可以公开的方法,否则将会启动失败。
Endpoint?
此类为端点服务类,它的方法publish用于将一个已经添加了@WebService注解对象绑定到一个地址的端口上。?
Endpoint也是jdk提供的一个专门用于发布服务的类,它的publish方法接收两个参数,一个是本地的服务地址,二是提供服务的类。它位于javax.xml.ws.*包中。
static Endpoint.publish(String address,Object implementor)?
——在给定地址处针对指定的实现者对象创建并发布端点。?
stop方法用于停止服务。?
EndPoint发布完成服务以后,将会独立的线程运行。所以,publish之后的代码,可以正常执行。
@WebMethod?
如果希望某个方法(非static,非final)不对外公开,可以在方法上添加@WebMethod(exclude=true),阻止对外公开
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
package cn.com.webService;
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.xml.ws.Endpoint;
@WebService
public class HelloMx {
public String sayHello(String name ){
return "Mx--> "+name;
}
@WebMethod(exclude=true)
public String sayMx(){
"你好";
}
public static void main(String[] args) {
Endpoint.publish("http://172.20.43.163:9999/hello",new HelloMx());
}
}
可以查看发布后的wsdl说明。地址为你发布的地址+?wsdl?
http://172.20.43.163:9999/hello?wsdl
3.2、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://172.20.43.163:9999/hello?wsdl?
注意:-s不能分开,-s后面有个小点,用于指定源代码生成的目录。点即当前目录。
如果使用了-s参数则会在目录下生成两份代码,一份为.class代码。一份为.java代码。?
.class代码,可以经过打包以后使用。.java代码可以直接Copy到我们的项目中运行。
3.3 调用天气预报
使用wsimport命令生成客户端代码?
wsimport –s .?http://webservice.webxml.com.cn/WebServices/WeatherWS.asmx?wsdl
如果报错
则右键另存为到本地 WeatherWS.wsdl,将
替换成
26
27
28
29
30
31
32
33
34
35
package cn.com.test
import java.util.List
import cn.webservice.HelloMx
import cn.HelloMxService.ArrayOfString
public class TestWebService {
public static void main(String[] args) {
WeatherWS ws = new WeatherWS()
WeatherWSSoap ww = ws.getWeatherWSSoap()
ArrayOfString as = ww.getWeather("广州",null)
List<String> list = as.getString()
for (String string : list) {
System.out.println(string)
}
}
}
3.4、简单分析
-
WebService只采用HTTP POST方式传输数据,不使用GET方式; – 握手,WSDL-get,?
普通http post的contentType为application/x-www-form-urlencoded?
WebService的contentType为-即在Http的基础上发SOAP协议?
text/xml 这是基于soap1.1协议。?
application/soap+xml 这是基于soap1.2协议。
-
WebService从数据传输格式上作了限定。WebService所使用的数据均是基于XML格式的。目前标准的WebService在数据格式上主要采用SOAP协议。SOAP协议实际上就是一种基于XML编码规范的文本协议。
-
SOAP – Simple Object Access protocol 简单对像访问协议。是运行在HTTP协议基础之上的协议。其实就是在HTTP协议是传输XML文件,就变成了SOAP协议。
-
SOAP1.1和SOAP1.2的 namespace不一样。可以通过查看类?
javax.xml.ws.soap.SOAPBinding来查看里面的常量?
默认情况下,Jdk1.6只支持soap1.1?
即:@BindingType(value=javax.xml.ws.soap.SOAPBinding.SOAP11HTTP_BINDING)
3.5、WebService和Web服务器的区别
- 我们可以把WebService看作是Web服务器上应用;反过来说,Web服务器是WebService运行时所必需的容器。这就是它们的区别和联系。
- 使用JDK1.6发布的简单Web服务,其内部其实是使用Socket实现。可以查看:SUN公司未对外公布的API类com.sun.xml.internal.ws.transport.http.server. ServerMgr获知,请使用反编译工具
3.6、WebService的特点
- WebService通过HTTP POST方式接受客户的请求
- WebService与客户端之间一般使用SOAP协议传输XML数据
- 它本身就是为了跨平台或跨语言而设计的
3.7、修改wsdl文件
WSDL文件的内容,一般由服务默认生成,但为了更好的向开发人员提供使用说明书,一般应做一些简单的修改。至少不应该暴露我们的包结构。而targetNamespace默认情况下为倒置的包名,这已经暴露了我们的包结构。?
通过在类文件上添加以下注解,可以修改wsdl生成的各元素,而不是直接去修改wsdl文件,直接去修改wsdl文件是无效的。?
WebService的注解包括:?
@WebService-定义服务 –类上?
@WebMethod-定义方法 - 方法?
@WebResult-定义返回值 – 返回值?
@WebParam-定义参数 – 参数
4、使用CXF发布WebService
4.1、搭建环境
- 下载cxf?
Apache CXF = Celtix + XFire,开始叫 Apache CeltiXfire,后来更名为 Apache CXF 了,以下简称为 CXF。CXF 继承了 Celtix 和 XFire 两大开源项目的精华,提供了对 JAX-WS 全面的支持,并且提供了多种 Binding 、DataBinding、Transport 以及各种 Format 的支持,并且可以根据实际项目的需要,采用代码优先(Code First)或者 WSDL 优先(WSDL First)来轻松地实现 Web Services 的发布和使用。Apache CXF已经是一个正式的Apache顶级项目。(来自百度百科)?
可以去Apache官网下载最近版本。http://cxf.apache.org/?
下载后可以配置cxf环境变量,使用wsdl2java生成客户端代码,使用jdk的wsimport只能soap1.1版本,不支持soap1.2。
- jar包?
新建web项目 拷贝cxf lib下的jar包至项目中。
- 配置cxf核心servlet?
在项目web.xml 中配置cxf 核心servlet
4.2、非接口发布
发布配置
客户端调用?
wsdl2java -d .?http://127.0.0.1:8080/demo/cxf/hello?wsdl?
生成客户端代码
4.3、带接口发布
实现类
配置服务
客户端调用
4.4、配置spring启动加载cxf配置文件
web-app version="2.4" "http://java.sun.com/xml/ns/j2ee" "http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
context-param>
param-name>contextConfigLocationparam-name>
param-value>
context-param>
listener>
listener-class>
org.springframework.web.context.ContextLoaderListener
listener-class>
listener>
servlet-mapping>
welcome-file-list>
welcome-file>index.jspwelcome-file>
welcome-file-list>
web-app>