JAVA开发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。