在上一篇文章中，我逐步介紹了使用apache CXF開發簡單的RESTFull服務的步驟。 在本文中，我將討論使用CXF開發SOAP Web服務。 在繼續前進之前，讓我們了解構成SOAP Web服務的一些概念/元素。

SOAP或簡單對象訪問協議

SOAP是一種協議，用于使用諸如http，smtp等應用程序協議作為載體在網絡上交換基于XML的消息。 SOAP消息包含一個SOAP信封。 信封可以分為標題和正文。 標頭包含與上下文相關的定義（例如安全性），而主體包含實際的應用程序數據。 典型的SOAP消息看起來像

<?xml version="1.0"?> <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"><soap:Header></soap:Header><soap:Body><m:GetStockPrice xmlns:m="http://www.example.org/stock"><m:StockName>IBM</m:StockName></m:GetStockPrice></soap:Body> </soap:Envelope>

WSDL或Web服務描述語言

WSDL是基于標準的XML語言，用于描述Web服務。 WSDL完全描述了Web服務公開的公共接口，期望的參數，返回的輸出結構以及Web服務的位置。 WSDL將Web服務定義為能夠交換消息的通信端點的集合。 這些通信端點稱為端口。 端口由兩部分組成。

包含Web服務公開的公共接口。 接口包含所有方法，調用它們所需的參數以及它們返回的響應結構。

第二部分將公共接口綁定到諸如http之類的網絡協議。 綁定包括諸如公共接口的位置和服務的消息格式之類的信息。

SOAP通訊樣式

存在兩種類型的溝通方式

文獻

RPC

SOAP Web服務使用的通信樣式在其WSDL中定義。

在文檔樣式中，作為肥皂主體一部分的應用程序數據作為XML文檔發送。 可以通過也是WSDL一部分的xml模式來完全驗證該文檔。 由于XML可以按照服務開發人員的意愿包含結構，因此，編組和解編xml有效負載的責任在于提供者和使用者代碼的末尾。

顧名思義，以RPC風格表示，使用者調用服務方法就像調用本地方法一樣。 為此，RPC消息包含使用者可以調用的公共接口方法的列表。 這些方法按名稱列為xml元素。 這些方法所需的方法參數構成方法元素的子元素。 封送/取消封送的責任在于Web服務框架。 該框架包含其自己的封送/解封庫。 RPC樣式導致應用程序代碼和Web服務框架之間的代碼緊密耦合，因此規范是創建文檔樣式服務。 掌握了關鍵概念之后，讓我們看一下如何使用Apache CXF編寫肥皂網絡服務的示例。

獲取本教程的源代碼

我已經在SVN中提交了本教程的源文件。

• 您可以從以下網站下載該Web應用程序： http : //subversion.assembla.com/svn/weblog4j/Weblog4jDemo/trunk
• 您可以從以下 網址 下載客戶端： http : //subversion.assembla.com/svn/weblog4j/DemoClient/trunk

注意：這兩個都是ItelliJ maven項目，因此您可以將它們直接導入到intelliJ IDE或將文件手動復制到其他IDE

創建一個struts2框架應用程序以包含您的服務。

您可以使用任何MVC框架，但出于我自己的原因，我更喜歡struts2。 您可以在此處看到有關如何使用Eclipse在eclipse中創建空的struts2應用程序的示例。

添加CXF依賴項

在您的項目POM中添加以下依賴項以下載CXF jar

<properties><cxf.version>2.5.0</cxf.version> </properties> <dependencies><!-- apache cxf --><dependency><groupId>org.apache.cxf</groupId><artifactId>cxf-rt-frontend-jaxws</artifactId><version>${cxf.version}</version></dependency><dependency><groupId>org.apache.cxf</groupId><artifactId>cxf-rt-frontend-jaxrs</artifactId><version>${cxf.version}</version></dependency><dependency><groupId>org.apache.cxf</groupId><artifactId>cxf-rt-transports-http</artifactId><version>${cxf.version}</version></dependency> </dependencies>

例如，讓我們創建一個簡單的書架網絡服務。 為簡單起見，讓我們假設以下用例。

在自己的書中插入一本書

從書架上按標題檢索一本書。

開發服務

可以通過兩種方式完成：“代碼優先”和“合同優先”。 我們將使用代碼優先方法。

創建服務端點接口（SEI）

讓我們創建一個名為BookShelfService的SEI接口

package com.aranin.weblog4j.services;import com.aranin.weblog4j.vo.BookVO;import javax.jws.WebMethod; import javax.jws.WebService;@WebService public interface BookShelfService {@WebMethodpublic String insertBook(BookVO bookVO);@WebMethodpublic BookVO getBook(String title); }

如果看上面的SEI，可以看出它是一個普通的Java接口，但有兩個注釋

• @WebService –這是一個注釋JAXWS庫。 它將普通的POJO轉換為Web服務。 在我們的例子中，注釋位于接口定義的正上方，它通知BookShelfService不是普通接口，而是Web服務接口或SEI。 該注釋還有其他一些屬性可以完全定義Web服務，但是我們現在不會使用它。
• @WebMethod –此注釋是可選的，主要用于為wsdl中的公共方法提供名稱屬性。

實施服務。

現在我們有了SEI，因此讓我們在BookShelfServiceImpl的接口中實現方法

package com.aranin.weblog4j.services;import com.aranin.weblog4j.hashdb.HashDB; import com.aranin.weblog4j.vo.BookVO;import javax.jws.WebService;@WebService(endpointInterface = "com.aranin.weblog4j.services.BookShelfService",serviceName="bookShelfService") public class BookShelfServiceImpl implements BookShelfService {public String insertBook(BookVO bookVO) {HashDB.insertBook(bookVO);return "Book with name : " + bookVO.getBookName() + " is now available on the shelf"; //To change body of implemented methods use File | Settings | File Templates.}public BookVO getBook(String title) {return HashDB.getBook(title); //To change body of implemented methods use File | Settings | File Templates.} }

此類是實現SEI的簡單POJO。 這里唯一值得注意的是@WebService批注。 如果您仔細看一下，我們提供了它實現的SEI的完全合格的類名和Web服務的名稱。

數據綁定類（BookVO）

package com.aranin.weblog4j.vo;import javax.xml.bind.annotation.XmlRootElement; import java.io.Serializable;@XmlRootElement(name = "Book") public class BookVO implements Serializable {private long bookId;private String bookName;private String author;public long getBookId() {return bookId;}public void setBookId(long bucketId) {this.bookId = bookId;}public String getBookName() {return bookName;}public void setBookName(String bookName) {this.bookName = bookName;}public String getAuthor() {return author;}public void setAuthor(String author) {this.author = author;} }

這里唯一要注意的是@XmlRootElement批注。 該注釋是JAXB庫的一部分。 CXF使用JAXB作為默認數據綁定組件。 由于BookVO在Web服務調用期間需要作為XML進行傳輸，因此需要在CXF安裝中由JAXB引擎進行編組/解組。 使用@XmlRootElement批注，我們可以幫助JAXB將BookVO類映射到xml，并將其name屬性作為xml的根元素。

基于Spring的服務器Bean

使CXF成為Web服務框架的第一選擇的原因在于，它通過基于Spring的配置文件發布其服務端點。 讓我們創建一個配置文件并在其中注冊我們的服務。 我們將文件命名為beans.xml并將其保存在應用程序的WEB-INF文件夾中

<?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"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsdhttp://cxf.apache.org/jaxrshttp://cxf.apache.org/schemas/jaxrs.xsdhttp://cxf.apache.org/jaxwshttp://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:endpointid="bookShelfService"implementor="com.aranin.weblog4j.services.BookShelfServiceImpl"address="/bookshelfservice" /></beans>

現在要加載beans.xml，我們只需在web.xml中添加以下內容

<context-param> <param-name>contextConfigLocation</param-name><param-value>/WEB-INF/beans.xml,/WEB-INF/applicationContext.xml</param-value> </context-param>

最后，我們需要通過web.xml連接spring和CXF。

<servlet><servlet-name>CXFServlet</servlet-name><display-name>CXF Servlet</display-name><servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class><load-on-startup>2</load-on-startup> </servlet><servlet-mapping><servlet-name>CXFServlet</servlet-name><url-pattern>/*</url-pattern> </servlet-mapping>

注意：我沒有包括Spring ContextLoaderListner的加載。 如果您使用struts2入門原型通過maven創建了struts2應用程序，那么spring將由maven項目本身下載并注冊。

現在您的Web服務已準備就緒。 在任何servlet容器中編譯和部署應用程序。 如果一切都很好，那么您可以在以下位置看到您的wsld： http：// localhost：8080 / weblog4jdemo / bookshelfservice？wsdl

創建您的客戶

有許多工具可用于使用wsdl生成客戶端代碼。 為了節省您的更多麻煩，我們將利用CXF自己的前端api。 因此，讓我們看看步驟。

使用您選擇的IDE創建一個簡單的Maven項目。 我目前正在使用IntelliJ，它很棒。 可以說該項目的名稱為DemoClient。

如創建框架應用程序部分所示，添加CXF依賴項。

既然我們知道SEI，公共方法和綁定對象是什么。 我們將在客戶端創建它們，以免給我們帶來麻煩。 如果有很多此類，我們可以使用wsdl2java等工具來生成我們的代碼。

在與父SEI完全相同的包結構中創建存根SEI。

以與父BookVO相同的包結構創建BookVO。

以上類應與在父應用程序中創建的類完全相同。

我們不需要在客戶端創建SEI實現。

現在，我們將使用JaxWsProxyFactoryBean創建一個客戶端。 此類是與SEI代理一起使用以調用Web服務方法的工廠。 這是課程。

package com.aranin.weblog4j.client;import com.aranin.weblog4j.services.BookShelfService; import com.aranin.weblog4j.vo.BookVO; import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;public class DemoClient {public static void main(String[] args){String serviceUrl = "http://localhost:8080/weblog4jdemo/bookshelfservice";JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();factory.setServiceClass(BookShelfService.class);factory.setAddress(serviceUrl);BookShelfService bookService = (BookShelfService) factory.create();//insert bookBookVO bookVO = new BookVO();bookVO.setAuthor("Issac Asimov");bookVO.setBookName("Foundation and Earth");String result = bookService.insertBook(bookVO);System.out.println("result : " + result);bookVO = new BookVO();bookVO.setAuthor("Issac Asimov");bookVO.setBookName("Foundation and Empire");result = bookService.insertBook(bookVO);System.out.println("result : " + result);bookVO = new BookVO();bookVO.setAuthor("Arthur C Clarke");bookVO.setBookName("Rama Revealed");result = bookService.insertBook(bookVO);System.out.println("result : " + result);//retrieve bookbookVO = bookService.getBook("Foundation and Earth");System.out.println("book name : " + bookVO.getBookName());System.out.println("book author : " + bookVO.getAuthor());} }

這是上述調用的輸出

INFO: Creating Service {http://services.weblog4j.aranin.com/}BookShelfServiceService from class com.aranin.weblog4j.services.BookShelfService result : Book with name : Foundation and Earth is now available on the shelf result : Book with name : Foundation and Empire is now available on the shelf result : Book with name : Rama Revealed is now available on the shelf book name : Foundation and Earth book author : Issac AsimovProcess finished with exit code 0

您可以在Apache CXF中探索大量其他內容，例如創建動態客戶端，攔截器，利用其他傳輸協議，基于https的Web服務等。但是，我打算將本文作為入門教程。

ew，這又是一個漫長的帖子。 我需要提高寫作技巧以縮短篇幅。 但我仍然希望您喜歡它并發現它有用。 我打算在我的下一篇文章中撰寫有關Web服務的javascript客戶端的文章。 在那之前，再見，編碼愉快。

參考： Weblog4j博客上的JCG合作伙伴 Niraj Singh 使用Apache CXF開發SOAP Web服務 。

翻譯自: https://www.javacodegeeks.com/2013/06/developing-soap-web-service-using-apache-cxf.html

總結

以上是生活随笔為你收集整理的使用Apache CXF开发SOAP Web服务的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。