使用CXF和Jersey架構來進行Java的WebService編程_java

CXF
CXF是在xfire的基礎上實現的。
1）首先呢，還是包的問題，在http://cxf.apache.org/download.html這裡可以下到最新版的CXF，當然，我用的是最新版的。接下來還是那句廢話，建WEB項目，放入JAR包。而JAR包我們就不選擇了，一堆全部放入。
我們會看到它包含了spring的JAR包，後面當我們需要把CXF作為WEB項目部署時，就需要用到spring的設定檔，這個後面再講。
還是介面類和實作類別：

@WebService public interface IReaderService {   public Reader getReader(@WebParam(name="name") String name,@WebParam(name="password") String password);   public List<Reader> getReaders(); } @WebService(endpointInterface="com.cxf.servlet.IReaderService",serviceName="readerService") public class ReaderService implements IReaderService{   public Reader getReader(@WebParam(name="name") String name,@WebParam(name="password") String password) {     return new Reader(name,password);   }      public List<Reader> getReaders(){     List<Reader> readerList = new ArrayList<Reader>();     readerList.add(new Reader("shun1","123"));     readerList.add(new Reader("shun2","123"));     return readerList;   } } 

 這兩個類除了加入註解外，其他均和昨天講的webservice的一樣。這裡就不多講了，對註解的解釋，大家可以看看JAVAEE的文檔。不過按意思應該很容易理解的。
接下來就是JAVABEAN，還是那個Reader類：

public class Reader{   private static final long serialVersionUID = 1L;   private String name;   private String password;      public Reader(){}   public Reader(String name,String password) {     this.name = name;     this.password = password;   }   //Get/Set方法省略   public String toString(){     return "Name:"+name+",Password:"+password;   }    } 

 上面的已經寫完了。
2）我們要用做WEB項目嗎？不急，先不用，CXF內建了一個輕量的Container Service，相當於spring自己提供了IOC容器一樣。我們可以先用它來測試一下我們部署成功沒。
直接來一個測試類別：

public static void main(String[] args) {     System.out.println("Server is starting...");     ReaderService readerService = new ReaderService();     Endpoint.publish("http://localhost:8080/readerService",readerService);     System.out.println("Server is started...");   } 

 簡單得不得了吧。直接publish地址，然後指定介面或類就OK了。我這裡用的是類，但盡量用介面，畢竟面向介面編程才是真正的面對對象思想。
我們啟動看看結果：

 我們看到啟動已經完成，接著啟動瀏覽器看看是否成功了。
直接在瀏覽器輸入http://localhost:8080/readerService?wsdl，我們可以看到：

它產生了我們所需要的wsdl檔案，說明我們部署成功了。
3）部署成功後，我們就是要調用啦，它的調用也相當簡單，跟xfire類似，取得介面，然後就可以跟本地類一樣調用方法了。

public static void main(String[] args) {     JaxWsProxyFactoryBean factoryBean = new JaxWsProxyFactoryBean();     factoryBean.setServiceClass(IReaderService.class);     factoryBean.setAddress("http://localhost:8080/readerService");          IReaderService readerService = (IReaderService)factoryBean.create();     Reader reader = readerService.getReader("shun","123");     System.out.println("Reader:"+reader);   } 

 這裡很簡單，也是取得一個工廠類，然後直接設介面和地址再create就可以得取相應的介面了，這裡跟xfire一樣，也是需要調用端先定義好介面原型，否則這些調用將無從說起。
我們運行得到結果：

沒問題，跟我們預想的結果一致。
 
4）但很多情況下，我們並不希望我們的webservice和我們的應用分開兩個伺服器，而希望他們在同一個容器，tomcat或JBOSS或其他的，這樣我們就必須通過WEB來部署我們前面完成的webservice。
注意，我們這裡需要用到spring定義檔案。
首先看看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" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"   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">      <context-param>     <param-name>contextConfigLocation</param-name>     <param-value>WEB-INF/beans.xml</param-value>   </context-param>      <listener>     <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>   </listener>      <servlet>     <servlet-name>CXFServlet</servlet-name>     <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>   </servlet>   <servlet-mapping>     <servlet-name>CXFServlet</servlet-name>     <url-pattern>/webservice/*</url-pattern>   </servlet-mapping> </web-app> 

 這裡很簡單，只是指定了spring的監聽器和相應的設定檔路徑，並且指定了CXF的攔截方式。
接下來看看beans.xml:

<?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"   xsi:schemaLocation="     http://www.springframework.org/schema/beans     http://www.springframework.org/schema/beans/spring-beans.xsd     http://cxf.apache.org/jaxws     http://cxf.apache.org/schemas/jaxws.xsd">   <import resource="classpath:META-INF/cxf/cxf.xml" />   <import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />   <import resource="classpath:META-INF/cxf/cxf-servlet.xml" />      <jaxws:endpoint id="readerServicce2"     implementor="com.cxf.servlet.ReaderService" address="/readerService2" /> </beans> 

 這裡很簡單，只是通過jaxws:endpoint定義了一個webservice，implementor是webservice的處理類，而address是它的訪問路徑，跟我們前面寫的readerService類似。
這時我們可以把它部署到tomcat中，通過http://localhost:8080/CXFWebservice/webservice/readerService2?wsdl可以直接存取。
 
有些朋友會問，為什麼這次訪問的URL跟前面的不一樣呢。其實前面的訪問地址是我們自己定義的，而這裡的webservice地址是我們在設定檔中配置好的，並且是通過web項目來部署的，這裡就需要用項目名稱，而且我們在CXFServlet那裡配置了url-pattern是webservice，所以最後的URL就跟上面一致了。
我們可以看到效果：

 這證明我們部署成功了。
 
可以再次用前面的測試類別測試一下，注意，需要把address修改成我們發布後的URL。
CXF相比xfire又更簡潔了一些，雖然它增加了一些註解，但這些無傷大雅，它只是把以前的services.xml中的資訊集中到類中，反而更方便維護，但這還是見仁見智的，有些人就喜歡設定檔，而有些人就不喜歡。另外CXF的調用方式更加簡潔，比起xfire它的代碼量更小了，是一個較大的進步。
 
有些朋友在搭建的過程中出現了一些問題，免去一個個回複了，這裡放出代碼，有需要的朋友可以下載看看。
lib目錄下的所有包均沒有放入，把cxf的所有包放入即可。
註：所用IDE為idea，檔案結構跟eclipse不通用，如果需要在eclipse下使用的，可以直接複製代碼和檔案到eclipse建立的項目即可。

Jersey
我們來看看它的基本用法。
 直接來個項目看看。開始項目之前大家還是先自己去下載包：https://maven.java.net/content/repositories/releases/com/sun/jersey/要運行例子需要同時下載server和client。當然不想找那麼多，可以直接下這個zip包，https://maven.java.net/service/local/artifact/maven/redirect?r=releases&g=com.sun.jersey&a=jersey-archive&v=1.10&e=zip
 1）直接來個JAVABEAN

@XmlRootElement public class Reader implements Serializable{   private static final long serialVersionUID = 1L;   private String name;   private String password;      public Reader(){}   public Reader(String name,String password) {     this.name = name;     this.password = password;   }   //省略Get/Set方法   public String toString(){     return "Name:"+name+",Password:"+password;   } } 

  這裡用到了一個標籤，這裡用到的表示它返回的時候的類型，即此Reader類可以用於XML返回。
 2）來個service類，這時已經不用像以前的CXF和xfire一樣要介面了，直接來個類就OK了。 

@Path("/readerService/{name}/{password}") public class ReaderService {      @GET   @Produces(MediaType.APPLICATION_JSON)   public Reader getReader(@PathParam("name") String name,@PathParam("password") String password) {     return new Reader(name,password);   }      public static void main(String[] args) throws IllegalArgumentException, IOException, URISyntaxException {     HttpServer server = HttpServerFactory.create("http://localhost:8080/");     server.start();   } } 

  這時用到了幾個標籤，Path相信用過springMVC的朋友應該知道這種寫法，就是URL匹配，如果不清楚的，可以先去看看。Get標籤表示這個方法只能通過Get方法來進行訪問，而Produces表示產生的結果，它表示系統會把Reader對象封閉成JSON結果進行返回。
 如果不理解不要緊，等一下看結果就可以理解了。
 而這時有一個main方法，相信有很大疑問吧。這是jersey內部提供的一個輕量級的內部容器，它可以暫時供我們調試用，但真正使用肯定不能用這個。
 3）我們寫一個測試類別

public class ReaderClient {    public static void main(String[] args) {     Client client = Client.create();     WebResource resource = client.resource("http://localhost:8080/readerService/shun/123213");     Reader reader = resource.get(Reader.class);     System.out.println(reader);   }  } 

  很簡單的代碼，應該都看得懂的，一個client對象，請求webservice，返回一個resource，然後resource就直接調用相應的方法，當然這個方法是通過我們的URl來進行匹配的。
 
 這裡我們先用它內建的一個輕量級服務測試一下。直接運行ReaderService，它裡面有包含一個main方法，運行後，我們再運行ReaderClient，我們可以看到結果為：

  結果正確。
 
 我們當然不想就這樣用內建的輕量級服務來作為我我們的伺服器，我們需要放到和我們的項目在同一個伺服器，比如tomcat，jboss等。
 4）WEB項目當然就少不了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" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"   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">   <servlet>     <servlet-name>Jersey Web Application</servlet-name>     <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>     <load-on-startup>1</load-on-startup>   </servlet>   <servlet-mapping>     <servlet-name>Jersey Web Application</servlet-name>     <url-pattern>/rest/*</url-pattern>   </servlet-mapping>   <welcome-file-list>     <welcome-file>index.jsp</welcome-file>   </welcome-file-list> </web-app> 

  這時指定了rest路徑下的所有都將被jersey進行攔截。
 我們部署到tomcat下啟動後再重新運行readerClient，注意先要修改resource的路徑：

WebResource resource = client.resource("http://localhost:8080/jerseyWebService/rest/readerService/shun/123213"); 

  我的項目名為jerseyWebService，請根據你的項目名進行修改。
 修改後，我們重新運行，結果如下：

和上面的結果一致，說明部署的效果是一樣的，也是正確的。