JAVA6开发WebService （三）——几个概念

要了解WebService，光能写代码不行啊，这说说WebService最基本的概念。

 

首先WebService要知道几个最基本的概念：

1、XML以及XML Schema

    XML 是Web Service表示数据的基本格式。XML是一套通用的数据表示格式，与平台无关，这就使不同语言构建的系统之间相互传递数据成为可能。

    XML Schema-XSD 拥有一套标准的、可扩展的数据类型系统，Web Service即是用XSD来作为数据类型系统的。由于不同语言之间数据类型也不尽相同，因此，数据传输过程中，必须将其转化为一种通用的数据类型，即XSD的数据类型。

 

2、SOAP

    SOAP(Simple Object Access Protocol)，简单对象访问协议，它是基于XML格式的消息交换协议。SOAP定义了一个envelope对象，使用envelope来包装要传递的消息，而消息本身可以采用自身特定的词汇，使用namespace来区分彼此。简单的说，在WebService中传递的东西是一封信，SOAP就是信的通用格式，他定义了一封信应该有信封，信封里装着信的内容，信封（envlope）的格式是固定的，而信的内容（要传递的数据）你可以自己定义。

 

3、WSDL

    WSDL(Web Service Description Language)，Web Service描述语言，使用XML语言对Web Service及其函数、参数、返回值、数据类型等信息进行描述。因为是基于XML的，所以WSDL既是机器可阅读的，又是人可阅读的。

 

4、UDDI

    UDDI（Universal Description Discovery and Integration），统一描述、发现和集成协议。UDDI 是一种目录服务，企业可以使用它对 Web services 进行注册和搜索。UDDI是一个分布式的互联网服务注册机制，他实现了一组可公开访问的接 口，通过这些接口，网络服务可以向服务信息库注册其服务信息、服务需求者可以找到分散在世界各地的网络服务。UDDI 并不像 WSDL 和 SOAP 一样深入人心，因为很多时候，使用者知道 Web 服务的位置（通常位于公司的企业内部网中）。

 

5、远程过程调用（RPC）与消息传递

    Web service本身实际是在实现应用程序间的通信，实现通信的方式有两种：远程过程调用（RPC）和消息传递（DOCUMENT）。使用RPC的时候，客户端的概念是调用服务器上的远程过程，通常方式为实例化一个远程对象并调用其方法和属性。消息传递的概念是，客户端向服务器发送消息，然后等待服务器的回应。消息传递系统强调的是消息的发送和回应，而不是远程对象的界面。他们最大不同就是RPC不能通过Schema 来校验，而Document 类型是可以的。因此document 类型webservice成为主流 ，Document也是JAX-WS默认的实现方式。

    有一种说法是，Web Service = SOAP + WSDL + HTTP。其中，SOAP协议是web service的主体，它通过HTTP或者SMTP等应用层协议进行通讯，自身使用XML文件来描述程序的函数方法和参数信息，从而完成不同主机的异构系统间的服务处理。这里的WSDL（Web Services Description Language）web 服务描述语言也是一个XML文档，它通过HTTP向公众发布，公告客户端程序关于某个具体的 Web service服务的URL信息、方法的命名，参数，返回值等。

 

SOAP协议简介

    上面说了，SOAP是一种基于XML的消息通讯格式，用于网络上，不同平台，不同语言的应用程序间的通讯。一条 SOAP 消息就是一个普通的 XML 文档，包含下列元素：
Envelope    标识XML 文档一条 SOAP 消息
Header       包含头部信息的XML标签
Body          包含所有的调用和响应的主体信息的标签
Fault           错误信息标签。

SOAP 消息的基本结构是

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
	<soap:Header>
		...
	</soap:Header>
	<soap:Body>
		...
		<soap:Fault>
			...
		</soap:Fault>
	</soap:Body>
</soap:Envelope>

 

soap:Envelope是SOAP中根元素元素。Envelope元素中可以包含多个可选的Header元素，必须同时包含一个Body元素。Header元素必须是Envelope元素的直接子元素，并且要位于Body元素之前。

 

soap:Header与HTTP请求中的Headers类似，用于传送一些基础的通用的数据，例如安全、事务等方面的信息。Header不是SOAP消息中的必需元素，但他是扩展SOAP协议的一个功能非常强大的功能。Header有两个非常重要的属性

 

soap:Body是SOAP消息中必需的元素，用于传送实际的业务数据或错误信息。

 

soap:Fault是soap:Body的子元素，用于传送错误信息，当有错误发生时才需要次标签。

 

可参考：http://askcuix.iteye.com/blog/211005

 

WSDL简介

    WSDL是WebService的描述语言，也是使用xml编写，用于描述、也可定位WebService，还不属于W3C标准。WSDL主要包含以下几个元素:

definitions   WSDL的根节点，主要包括：name属性，WebService服务名，可通过@WebService注解的serviceName                      更改；targetNamespace属性，命名空间，可通过@WebService注解的targetNamespace更改。

types          web service 使用的数据类型，他是独立与机器和语言的类型定义，这些类型被message标签所引用。

message     web service 使用的消息，他定义了WebService函数的参数。在WSDL中，输入输出参数要分开定义，使用                    不同的message标签体标识。message定义的输入输出参数被portType标签所引用。

portType    web service 执行的操作。引用message标签定义的内容来描述函数信息（函数名，输入输出参数等）。
binding       web service 使用的通信协议。将portType中定义的服务绑定到SOAP协议，这部分XML 指定最终发布的                   WebService的SOAP 消息封装格式、发布地址等。

service        这个元素的name 属性指定服务名称（这里与根元素的name 属性相同），子元素port的name 属性指定port                   名称，子元素address的location 属性指定Web 服务的地址。

 

WSDL的基本结构是：

<definitions>
	<types>
		...
	</types>
	<message>
		...
	</message>
	<portType>
		...
	</portType>
	<binding>
		...
	</binding>
        <service>
		...
	</service>
</definitions>

 

可参考：http://www.w3school.com.cn/wsdl/index.asp

 

    我就不浪费资源粘一大段WSDL和SOAP的实例过来了，上一篇写了个小例子，发布后在浏览器输入“服务地址”+ “？wsdl”就可以查看（如那个例子的WSDL地址是http://127.0.0.1:8080/helloService?wsdl）。SOAP可以使用一个HTTP监听工具查看（我使用的是HTTPAnalyzerFullV5），或者通过CXF的实现发布程序，使用CXF的拦截器可以看到SOAP消息内容。

 

将上一篇的代码更改为CXF实现：

    首先下载CXF的包，我下的是apache-cxf-2.3.0.zip，将lib下的jar包引入工程路径，将发布服务的代码更改为：

	public static void main(String[] args) {
//		Endpoint.publish("http://localhost:8080/helloService",new HelloImpl());
		
		//使用CXF特有的API---JaxWsServerFactoryBean发布
		JaxWsServerFactoryBean soapFactoryBean = new JaxWsServerFactoryBean();
		soapFactoryBean.getInInterceptors().add(new LoggingInInterceptor());
		soapFactoryBean.getOutInterceptors().add(new LoggingOutInterceptor());
		soapFactoryBean.setServiceClass(HelloImpl.class);
		soapFactoryBean.setAddress("http://127.0.0.1:8080/helloService");
		soapFactoryBean.create();
	}
}

 

    这样，就可以在控制台看到SOAP的消息内容了，信息: Inbound Message是服务器端接受到的内容，信息: Outbound Message是服务器返回给客户端的内容。当然，使用CXF的实现方式时，客户端调用也可以使用CXF的特有方式：

		//1、使用标准的JAX-WS 的API 完成客户端调用
//		QName qName = new QName("http://service.why.com/","HelloService");
//		HelloService helloService = new HelloService(new URL("http://127.0.0.1:8080/helloService?wsdl"),qName);
//		Hello hello = (Hello) helloService.getPort(Hello.class);
		
		//2、使用了CXF 的JaxWsProxyFactoryBean 来访问Web 服务    
		JaxWsProxyFactoryBean soapFactoryBean = new JaxWsProxyFactoryBean();
		soapFactoryBean.setAddress("http://127.0.0.1:8080/helloService");
		soapFactoryBean.setServiceClass(Hello.class);
		Object o = soapFactoryBean.create();
		Hello hello = (Hello) o;

 

    注意，当使用不同的WebService实现时，其生成的WSDL内容可能会稍有差异，但总体上都是一样的。

 

Apache CXF下载地址 ：http://cxf.apache.org/download.html

 

附件是上一篇中例子的工程，有一点点修改，我把lib里的CXF的jar包删了，太大了，不让上传，想看的同学可以到上面的地址下载CXF相应的包，解压后将lib里的东东拷到我工程的lib目录里就OK了，当然还得先在C盘建立几个测试文件c1.jpg、c2.jpg、origin.jpg和why.jpg。

评论

3 楼 springdata-jpa 2015-06-18  

如何在java Web项目中开发WebService接口，地址：
http://www.zuidaima.com/question/1925428495420416.htm

2 楼 younglibin 2012-03-27  

更换成cxf后程序  运行 服务器端 报错：
2012-3-27 16:41:49 org.apache.cxf.phase.PhaseInterceptorChain doDefaultLogging
警告: Interceptor for {http://service.why.com/}HelloService#{http://server.why.com/}selectMaxAgeCustomer has thrown exception, unwinding now
org.apache.cxf.interceptor.Fault: Could not write attachments.

。。。。。。。。

Caused by: org.eclipse.jetty.io.EofException
at org.eclipse.jetty.http.HttpGenerator.flushBuffer(HttpGenerator.java:911)
at org.eclipse.jetty.http.AbstractGenerator.flush(AbstractGenerator.java:433)
...........


Caused by: java.io.IOException: 您的主机中的软件中止了一个已建立的连接。
at sun.nio.ch.SocketDispatcher.write0(Native Method)
at sun.nio.ch.SocketDispatcher.write(Unknown Source)
at sun.nio.ch.IOUtil.writeFromNativeBuffer(Unknown Source)
at sun.nio.ch.IOUtil.write(Unknown Source)

.....................

1 楼 chxiaowu 2011-12-06  

很好啊。@@@