WebService详解

开发及原理：
WebService开发可以分为服务器端开发和客户端开发两个方面：
服务端开发：把公司内部系统的业务方法发布成WebService服务，供远程合作单位和个人调用。(借助一些WebService框架可以很轻松地把自己的业务对象发布成WebService服务，Java方面的典型WebService框架包括：axis，xfire，cxf等，java ee服务器通常也支持发布WebService服务，例如JBoss。)

客户端开发：调用别人发布的WebService服务，大多数人从事的开发都属于这个方面，例如，调用天气预报WebService服务。（使用厂商的WSDL2Java之类的工具生成静态调用的代理类代码；使用厂商提供的客户端编程API类；使用SUN公司早期标准的jax-rpc开发包；使用SUN公司最新标准的jax-ws开发包。当然SUN已被Oracle收购)

WebService的工作调用原理：对客户端而言，我们给这各类WebService客户端API传递wsdl文件的url地址，这些API就会创建出底层的代理类，调用这些代理，就可以访问到webservice服务。代理类把客户端的方法调用变成soap格式的请求数据再通过HTTP协议发出去，并把接收到的soap数据变成返回值返回。对服务端而言，各类WebService框架的本质就是一个大大的Servlet，当远程调用客户端给它通过http协议发送过来soap格式的请求数据时，它分析这个数据，就知道要调用哪个java类的哪个方法，于是去查找或创建这个对象，并调用其方法，再把方法返回的结果包装成soap格式的数据，通过http响应消息回给客户端。

体系架构：
Web服务的体系结构是基于Web服务提供者、Web服务请求者、Web服务中介者三个角色和发布、发现、绑定三个动作构建的。简单地说，Web服务提供者就是Web服务的拥有者，它耐心等待为其他服务和用户提供自己已有的功能；Web服务请求者就是Web服务功能的使用者，它利用SOAP消息向Web服务提供者发送请求以获得服务;Web服务中介者的作用是把一个Web服务请求者与合适的Web服务提供者联系在一起，它充当管理者的角色，一般是UDDI。这三个角色是根据逻辑关系划分的，在实际应用中，角色之间很可能有交叉：一个Web服务既可以是Web服务提供者，也可以是Web服务请求者，或者二者兼而有之。显示了Web服务角色之间的关系:其中，“发布”是为了让用户或其他服务知道某个Web服务的存在和相关信息;“查找（发现）”是为了找到合适的Web服务;“绑定”则是在提供者与请求者之间建立某种联系。

JAX-RS提供了一些标注将一个资源类，一个POJOJava类，封装为Web资源。标注包括：
@Path，注释被用来描述根资源、子资源方法或子资源的位置。
value 值可以包含文本字符、变量或具有定制正则表达式的变量。
@GET，@PUT，@POST，@DELETE，标注方法是用的HTTP请求的类型.您可以使用它们来绑定根资源或子资源内的 Java 方法与 HTTP 请求方法。
HTTP GET 请求被映射到由 @GET 注释的方法；
HTTP POST 请求被映射到由 @POST 注释的方法，以此类推。用户可能还需要通过使用 @HttpMethod 注释定义其自己的定制 HTTP 请求方法指示符。
@Produces，注释代表的是一个资源可以返回的 MIME 类型。这些注释均可在资源、资源方法、子资源方法、子资源定位器或子资源内找到。
@Consumes，注释代表的是一个资源可以接受的 MIME 类型。
@PathParam，@QueryParam，@HeaderParam，@CookieParam，@MatrixParam，@FormParam,分别标注方法的参数来自于HTTP请求的不同位置，

功能特性
CXF 包含了大量的功能特性，但是主要集中在以下几个方面：
支持 Web Services 标准：CXF 支持多种 Web Services 标准，包含 SOAP、Basic Profile、WS-Addressing、WS-Policy、WS-ReliableMessaging
和 WS-Security。
Frontends：CXF 支持多种“Frontend”编程模型，CXF 实现了 JAX-WS API （遵循 JAX-WS 2.0 TCK 版本），它也包含一个“simple frontend”
允许客户端和 EndPoint 的创建，而不需要 Annotation 注解。CXF 既支持 WSDL 优先开发，也支持从 Java 的代码优先开发模式。
容易使用： CXF 设计得更加直观与容易使用。有大量简单的 API 用来快速地构建代码优先的 Services，各种 Maven 的插件也使集成更加容易，
支持 JAX-WS API ，支持 Spring 2.0 更加简化的 XML 配置方式，等等。
支持二进制和遗留协议：CXF 的设计是一种可插拨的架构，既可以支持 XML ，也可以支持非 XML 的类型绑定，比如：JSON 和 CORBA。

访问路径：项目路径+web.xml中的路径+applicationContext-wedService.xml中的路径+请求方法的路径@Path(“/associationUsers”)
传递参数示例：

    请求：Customer customer = WebClient
                    .create("http://localhost:9002/crm_management/services/customerService/findCustomerByTelephone/"
                            + model.getTelephone())
                    .accept(MediaType.APPLICATION_JSON).get(Customer.class);
    @GET
    @Path("/associationCustomers")
    @Produces({ "application/xml", "application/json" })
    public List<Customer> findNoAssociationCustomers();


    @GET
    @Path("/hasAssociationFixedAreaCustomers/{fixedAreaId}")
    @Produces({ "application/xml", "application/json" })
    @Consumes({ "application/xml", "application/json" })
    public List<Customer> findHasAssociationFixedAreaCustomers(@PathParam("fixedAreaId") String fixedAreaId);


    请求：WebClient.create("http://localhost:9002/crm_management/services/customerService/updateCustomerType/"
                        + model.getTelephone()).put(null);
    @PUT
    @Path("/associationCustomersToFixedArea")
    @Consumes({ "application/xml", "application/json" })
    public void associationCustomersToFixedArea(@QueryParam("customerIdStr") String customerIdStr,
            @QueryParam("fixedAreaId") String fixedAreaId);

    请求： WebClient.create("hement/services/customerService/customer/")
                .type(MediaType.APPLICATION_JSON).post(model);

    @POST
    @Path("/customer")
    @Consumes({ "application/xml", "application/json" })
    public void registCustomer(Customer customer);


例如@PathParam来自于URL的路径，
@QueryParam来自于URL的查询参数，
@HeaderParam来自于HTTP请求的头信息，
@CookieParam来自于HTTP请求的Cookie。

spring整合相关xml配置
web.xml
<!-- 使用CXF -->
    <servlet>
        <servlet-name>CXFService</servlet-name>
        <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>CXFService</servlet-name>
        <url-pattern>/services/*</url-pattern>
    </servlet-mapping>

applicationContext-wedService.xml
<!-- 配置cxf相关文件 -->
    <jaxrs:server id="customerService" address="/customerService">
        <jaxrs:serviceBeans>
            <bean class="service.impl.CustomerServiceImpl"/>
        </jaxrs:serviceBeans>
        <jaxrs:inInterceptors>
            <bean class="org.apache.cxf.interceptor.LoggingInInterceptor"/>
        </jaxrs:inInterceptors>
        <jaxrs:outInterceptors>
            <bean class="org.apache.cxf.interceptor.LoggingOutInterceptor"></bean>
        </jaxrs:outInterceptors>
    </jaxrs:server>