使用CXF开发RestFul风格WebService

1.首先定义一个简单类DD

package service;

import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name="DD")
@XmlAccessorType(XmlAccessType.FIELD)
public class DD {
    private String id;

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }
}

这个类主要用于封装返回的数据。

@XmlRootElement(name="DD")

    当返回类型是xml方式的时候，指定根节点的名称为DD

@XmlAccessorType(XmlAccessType.FIELD)

    表示将该类中的属性字段（非静态）作为序列化的属性或元素

2.定义Service类，对外提供获取数据的方法

package service;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

import org.springframework.stereotype.Component;

@Path("/directoryservice")
@Produces({MediaType.APPLICATION_JSON,MediaType.APPLICATION_XML}) 
@Component("directoryService")
public class DirectoryService {
	@GET
	@Path("/directory/{id}")
	public DD getDirectory(@PathParam("id") String id) {
		DD dd = new DD();
		dd.setId(id);
		return dd;
	}
}

@Path("/directoryservice")

    该Service部署的路径

@Produces({MediaType.APPLICATION_JSON,MediaType.APPLICATION_XML}) 

    支持的返回数据的类型

@Component("directoryService")

    注解，让spring扫描并实例化该类，directoryService为spring实例化的bean的id

@Path("/directory/{id}")

    该方法的发布路径，{id}表示参数

@PathParam("id")

    指定参数对应的路径中的参数名称，这里指定将路径中的{id}参数，注入到该方法中的id参数

3.spring配置

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns:jaxws="http://cxf.apache.org/jaxws"
    xmlns:jaxrs="http://cxf.apache.org/jaxrs"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:tx="http://www.springframework.org/schema/tx"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
                       http://www.springframework.org/schema/beans/spring-beans.xsd
                       http://www.springframework.org/schema/context
           			   http://www.springframework.org/schema/context/spring-context-3.2.xsd
                       http://www.springframework.org/schema/tx 
           			   http://www.springframework.org/schema/tx/spring-tx-3.2.xsd
                       http://cxf.apache.org/jaxrs
    				   http://cxf.apache.org/schemas/jaxrs.xsd
                       http://cxf.apache.org/jaxws 
                       http://cxf.apache.org/schemas/jaxws.xsd">
	<!-- cxf配置 -->
    <import resource="classpath:META-INF/cxf/cxf.xml" />
    <import resource="classpath:META-INF/cxf/cxf-servlet.xml" />
		
	<!-- restful风格服务配置 -->
	<jaxrs:server id="restServiceContainer" address="/">
		<jaxrs:serviceBeans>
			<ref bean="directoryService" />
		</jaxrs:serviceBeans>
		<!--返回json格式数据必须配置 -->
		<jaxrs:providers>  
            <bean class="org.codehaus.jackson.jaxrs.JacksonJsonProvider" />  
        </jaxrs:providers> 
		<jaxrs:extensionMappings>
			<entry key="json" value="application/json" />
			<entry key="xml" value="application/xml" />
		</jaxrs:extensionMappings>
	</jaxrs:server>
	
	
	<!-- 自动扫描组件 -->
	<context:component-scan base-package="service" />

	<bean id="webServicesAgent" class="org.apache.cxf.spring.remoting.Jsr181HandlerMapping">
		<property name="urlPrefix">
			<value>/</value>
		</property>
	</bean>
</beans>

4.web.xml配置

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
  <display-name>restful</display-name>
  <welcome-file-list>
    <welcome-file>index.html</welcome-file>
    <welcome-file>index.htm</welcome-file>
    <welcome-file>index.jsp</welcome-file>
    <welcome-file>default.html</welcome-file>
    <welcome-file>default.htm</welcome-file>
    <welcome-file>default.jsp</welcome-file>
  </welcome-file-list>
  <!--指定spring配置文件位置-->
  <context-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:beans.xml</param-value>
  </context-param>
  <!-- 配置spring的监听器 -->
	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
	</listener>
	<!--cxf配置-->
  <servlet>
    <servlet-name>CXFServlet</servlet-name>
    <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>CXFServlet</servlet-name>
    <url-pattern>/*</url-pattern>
  </servlet-mapping>
</web-app>

5.访问效果

http://localhost:8080/restful/directoryservice/directory/1

指定返回数据的格式

http://localhost:8080/restful/directoryservice/directory/1?_type=json

2.7版本代码： 点击打开链接

3.1.4版本的cxf实现： 点击打开链接