CXF WebService笔记day1.txt

Web Service
   --不是框架。更不是一种技术。
     而是一种跨平台、跨语言的规范。
 
   为了解决这样的需求场景：
    不同平台、不同语言所编写的应用之间如何相互调用？

   通俗点：假如java里有如下方法
     public List<Cat> getCatsByUser(User user)

   要求是，有一个C语言写的程序,它想去调用上面getCatsByUser方法。
  

   Web Service集中解决：
   - 远程调用
   - 跨平台调用
   - 跨语言调用

Web Service实际中用途：
 
   1.同一个公司的新、旧系统的整合。
     Linux上的Java应用，去调用windows平台的Delphi应用。

   2.不同公司的业务整合。
     业务的整合就要带来，不同公司的系统整合。
     不同公司的系统可能存在平台不同、语言不同的问题。

   3.内容聚合。
     一个应用需要提供，天气预报、股票行情、黄金行情、编程语言行情……
     这个内容聚合的应用，需要调用大量不同平台，不同语言编写的应用的方法。

   ……

CXF
   Axis(Apache)  ->  Axis 2(Apache)

       XFire  ->  CXF(XFire + Celtrix)

XFire       (Web Service框架)
Celtrix     (ESB框架)

SOA (面向服务的架构）
    Service1, Service2, Service3--所有组件都是“即插即用”的。

    IBM提倡的SOA架构： 希望以“组装电脑”的方式来开发软件。

    1.各种提供服务的组件。(Web Service)
    2.企业服务总线(Enterprise Service Bus ,  ESB)

CXF号称是SOA框架

CXF (Apache)
        CXF内置了一个Jetty Web服务器。

--------------------------------------------
使用CXF开发Web Service服务器端：

/****************************************
每个Web Service组件需要2个部分：接口和实现类。
*****************************************/
  （1）开发一个Web Service业务接口。
       该接口要用@WebService修饰。
   (2) 开发一个Web Service实现类。
       实现类也需要用@WebService修饰。
   (3) 使用Endpoint类的静态方法来发布WebService

--------------------------------------------
使用CXF开发Web Service客户端：

 (1) 调用CXF提供的wsdl2java工具，根据WSDL文档生成相应的Java代码。
     WSDL - Web Service Definition Language
     任何语言实现了Web Service, 都需要提供、并暴露WSDL文档。
 (2) 找到wsdl2java所生成类中，一个继承了Service的类。
     该类的实例可当成工厂来使用。
 (3) 调用Service子类的实例的getXxxPort方法，返回远程Web Service的代理。

形参、返回值
  
    1. 当形参、返回值的类型是String、基本数据类型时，CXF肯定可以轻松地处理。

    2. 当形参、返回值类型是JavaBean式的复合类、List集合、数组等时
       CXF也可以很好的的处理。

    3. 还有一些像Map、非JavaBean式的复合类，CXF是处理不了的。

/***********************************
XML里的两个属性：

targetNamespace   - 相当于Java语言里的package
xmlns             - 相当于Java语言的import 
   import:u java.util.*;
   import:s java.sql.*;

   u:Date d = new u:Date();

************************************/

Web Service的三个技术基础：

   1. WSDL Web Service Definition Language - Web Service定义语言。
   2. SOAP Simple Object Access Protocol ,简单对象访问协议。
   3. UDDI

   一次Web Service的调用 -- 其实并不是方法调用，而是发送SOAP消息(即XML文档片段)。

对于sayHi操作来说，

   传入消息是：
    <sayHi>
        <arg0>字符串</arg0>
    <sayHi>
   传出消息是：
    <sayHiResponse>
        <return>字符串</return>
    </sayHiResponse>

对于getCatsByUser操作来说，
   传入消息是：
    <getCatsByUser>
        <arg0>
           <address>字符串</adress>
           <id>整数值</id>
           <name>字符串</name>
           <pass>字符串</pass>
        </arg0>
    </getCatsByUser>
   传出消息是：
    <getCatsByUserResponse>
        <return>  --可能出现0~N次
           <color>字符串</color>
           <id>整数值</id>
           <name>字符串</name>
        </return>
    </getCatsByUserResponse>  

----------------------------------------
阅读wsdl文档个人小总结：
1.进入wsdl接口文档http://192.168.1.27:9999/fkjava?wsdl=HelloWorld.wsdl
  +<wsdl:types>
  +<wsdl:message name="sayHiResponse">
  +<wsdl:message name="getCatsByUserResponse">
  +<wsdl:message name="sayHi">
  +<wsdl:message name="getCatsByUser">
  +<wsdl:portType name="HelloWorld">
2.先展开portType，->找到operation(<wsdl:operation name="sayHi">)->input message(message="nsl:sayHi")
  再展开对应的message->part element
  再展开types->找到对应元素，通过对应元素的类型type,找到下面相应的复合类型complexType->展开就可以看到传入/传出消息的参数名/返回name,及返回类型type
----------------------------------------

通俗地说，WSDL文档描述了Web Service如下3个方面：
  - WHAT  :该Web Service包含“什么”操作。
  - HOW   :该Web Service的操作应该“怎样”调用？
  - WHERE :该Web Service的服务地址。

/********************************
  只要得到Web Service的WSDL文档

  接下来程序就可以调用Web Service

********************************/

调用一次Web Service的本质：

  1.客户端把调用方法参数，转换XML文档片段（SOAP消息，input消息)
    --该文档片段必须符合WSDL定义的格式。 
  2.通过网络、把XML文档片段从传给服务器。
  3.服务器接收到XML文档片段。
  4.服务器解析XML文档片段，提取其中的数据。
    并把数据转换调用Web Service所需要的参数值。
  5.服务器执行方法
  6.把执行方法得到的返回值，再次转换生成为XML文档片段（SOAP消息,output消息）
    --该文档片段必须符合WSDL定义的格式。
  7.通过网络、把XML文档片段传给客户端。
  8.客户端接收到XML文档片段。
  9.客户端解析XML文档片段，提取其中的数据。
    并把数据转换调用Web Service的返回值。

从上面调用本质来看，要一个语言支持Web Service,
唯一的要求是：该语言支持XML文档解析、生成、支持网络传输。

在CXF开发中，如果遇到系统无法自动处理的类型，就需要程序员自行处理。

处理思路是：提供一个转换器，该转换器负责把CXF搞不定的类型，转换CXF搞得定的类型
    （1） 使用@XmlJavaTypeAdapter修饰CXF无法自动处理的类型.
          使用该Annotation时，通过value属性指定一个转换器。
    （2） 实现自己的转换器。
          实现转换器时，需要开发一个CXF搞得定的类型。

对于getAllCats操作来说，
   传入消息是：
    <getAllCats> 
    </getAllCats>
   传出消息是：
    <getAllCatsResponse>
        <return>
           <entries>  -- 可出现0~N次
                <key>字符串</key>
                <value>
                     <color>字符串</color>
                     <id>整数值</id>
                     <name>字符串</name>
                </value>
           </entries>
        </return>
    </getAllCatsResponse>