apache cxf是一款可提供webservice服務的輕量級框架。主要格式有xml和json。下面就以apache cxf和spring以及tomcat框架為基礎，搭建一個簡單的對外提供json格式的介面服務。

下面就開始快樂的學習之旅吧！

由於apache cxf是基於servlet技術的SOA應用框架，所以當然第一件事情就是配置web.xml了。

<web-app>
<display-name>application</display-name>

<!--由於spring也需要進行啟動，所以順帶也進行了配置。下面制定了的spring配置檔案位置-->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:com/resources/spring-context.xml</param-value>
</context-param>

<!-- 預設的spring配置檔案是在WEB-INF下的applicationContext.xml,下面這個是上下文載入器，用於初始化spring容器-->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<!--下面定義了cxfServlet以及載入的順序-->
<servlet>
<servlet-name>CXFServlet</servlet-name>
<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>

<!--定義訪問cxf提供的服務時，servlet所做的對映-->
<servlet-mapping>
<servlet-name>CXFServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>

上面就把spring容器和cxf框架在servlet容器(此處用tomact)中定義好了。

下面就開始寫介面服務了。先上我的專案結構圖，如下圖所示。

其中介面CxfTestService.java內容如下所示：

//@path指定訪問的路徑，這個註釋是由jsr.jar來提供，下面的@GET註釋也是由該jar包來提供，除此之外還提供了@POST(以post進行訪問)，@QueryParam(用於介面引數宣告),@FormParam(用於介面引數宣告，如果訪問用post方式進行，則若介面方法有引數則可以用該註釋申明)等註釋。

@Path("/test")
public interface CxfTestService {

@GET
@Path("/init")
public ResultDomain init();
}

上面用註釋的方法把介面定義好了，當然也可以選擇程式碼的方式進行宣告，本文還是同一採用註釋的方式(ps:本人習慣用註釋的方式了)。

下面就來看介面實現類CxfTestService.java吧。下面上程式碼：

public class CxfTestServiceImpl implements CxfTestService{
public ResultDomain init() {
ResultDomain domain = new ResultDomain();
domain.setCode(1);
domain.setResult("成功了");
domain.setResultDesc("操作成功");
return domain;
}
}

大家不要罵我，就是一個用於測試的方法而已，和普通方法完全沒區別，但注意了，我們進入這個方法返回ResultDomain去看一下有什麼不同吧。

@XmlRootElement
@XmlAccessorType(XmlAccessType.FIELD)
public class ResultDomain {
public String resultDesc;
public Integer code;
public Object result;

從上面可以看到，該實體類也進行了註釋申明。因為cxf使用jaxb進行資料繫結時，要知道對應實體的屬性，所以要將類申明為@XmlRootElement。這樣jaxb才知道類裡面有什麼屬性。而@XmlAccessorType(XmlAccessType.FIELD)則指定 JAXB 繫結類中的每個非靜態、非瞬態欄位將會自動繫結到 XML。

搞定了上面兩塊東西，下面就剩最後一塊內容了，那就是spring容器和cxf的整合。本配置內容放在spring-cxf-out.xml檔案中。上配置檔案：

<!--下面這塊dtd,xsd我就不解釋了，就是配置的規範約束-->

<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:jaxrs="http://cxf.apache.org/jaxrs"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd
http://cxf.apache.org/transports/http/configuration
http://cxf.apache.org/schemas/configuration/http-conf.xsd">
<import resource="classpath:META-INF/cxf/cxf.xml" />
<import resource="classpath:META-INF/cxf/cxf-servlet.xml" />

    <!--生成一個cxfTestService例項物件-->
    <bean id="cxfTestService" class="com.cxf.webService.impl.CxfTestServiceImpl" />

    <bean id="securityExceptionMapper" class="com.cxf.webService.impl.CxfTestServiceImpl" />
    

<!--指定返回的json的格式，可以安裝字面理解-->

<bean id="jsonProvider" class="org.apache.cxf.jaxrs.provider.json.JSONProvider">

<!--忽視名稱空間-->
<property name="ignoreNamespaces" value="true" />

<!--忽略根節點-->

<property name="dropRootElement" value="true" />

<!--若返回結果是集合，則這個配置為true和false影響到集合內屬性的括號問題，若為true,json格式大概是[{}],而反之則是{{}}，第一種格式是用gson可以解析的，而第二種是gson無法解析的-->

<property name="dropCollectionWrapperElement" value="true" />

<!--結合的序列化-->
<property name="serializeAsArray" value="true" />
</bean>

<!--用jaxrs來宣告服務,ps:spring容器中提供了jaxrs和jaxws來發布cxf服務-->
<jaxrs:server id="cxfServices" address="/">
<jaxrs:serviceBeans>

<!--這裡就是將定義好的服務-->
<ref bean="cxfTestService" />
</jaxrs:serviceBeans>
<jaxrs:providers>
<ref bean="jsonProvider" />
</jaxrs:providers>
</jaxrs:server>
</beans>

好了，到此為止一個簡易的對外提供json格式的服務已經搭好了，下面就開啟服務進行訪問吧！看下圖所示，就可已用get方式來訪問該介面服務並返回json格式的結果了。

資源下載地址：

http://download.csdn.net/detail/shihai1991/8021127

參考博文：

http://cxf.apache.org/docs/index.html

http://www.ibm.com/developerworks/cn/education/java/j-cxf/