最近，我不得不編寫一些Java代碼以通過HTTP 使用 REST服務 。 我決定使用RestEasy的客戶端庫，該框架是我大部分時間用來公開Java REST服務的框架，因為它也實現了官方的JAX-RS規范。 我對規范定義的注釋驅動方法非常滿意，這使REST服務公開成為一項非常愉快的任務。 但不幸的是， 我不能說我以同樣的方式喜歡客戶端API 。 如果您有幸能夠根據服務實現的接口構建代理客戶端，那還不錯：

import org.jboss.resteasy.client.ProxyFactory; ... // this initialization only needs to be done once per VM RegisterBuiltin.register(ResteasyProviderFactory.getInstance());SimpleClient client = ProxyFactory.create(MyRestServiceInterface.class, 'http://localhost:8081'); client.myBusinessMethod('hello world');

我同意擁有一個類似于JAX-WS的代理客戶端是很好的。 但是大多數時候，當我們使用REST Web服務時，我們沒有要導入的Java接口。 所有這些Twitter，Google或其他可用的公共休息服務都只有HTTP端點。 在這些情況下，使用RestEasy的方法是依靠RestEasy手動ClientRequest API：

ClientRequest request = new ClientRequest('http://localhost:8080/some/path'); request.header('custom-header', 'value');// We're posting XML and a JAXB object request.body('application/xml', someJaxb);// we're expecting a String back ClientResponse<String> response = request.post(String.class);if (response.getStatus() == 200) // OK! {String str = response.getEntity(); }

我認為這是一種非常冗長的方式來獲取大多數時間的內容，只需從網絡中獲取一串字符串即可。 如果需要包括身份驗證信息，情況將變得更加糟糕：

// Configure HttpClient to authenticate preemptively // by prepopulating the authentication data cache.// 1. Create AuthCache instance AuthCache authCache = new BasicAuthCache();// 2. Generate BASIC scheme object and add it to the local auth cache BasicScheme basicAuth = new BasicScheme(); authCache.put('com.bluemonkeydiamond.sippycups', basicAuth);// 3. Add AuthCache to the execution context BasicHttpContext localContext = new BasicHttpContext(); localContext.setAttribute(ClientContext.AUTH_CACHE, authCache);// 4. Create client executor and proxy httpClient = new DefaultHttpClient(); ApacheHttpClient4Executor executor = new ApacheHttpClient4Executor(httpClient, localContext); client = ProxyFactory.create(BookStoreService.class, url, executor);

我發現Rest-assured提供了一個更好的API來編寫客戶端調用。 該項目的正式目的是建立一個測試和驗證框架 ; 而且大多數教程都涵蓋了這些方面，例如最近的Heiko Rupp的教程： http : //pilhuhn.blogspot.nl/2013/01/testing-rest-apis-with-rest-assured.html 。 我建議您改為使用它作為開發工具來非常快速地進行實驗和編寫REST調用。 關于放心的重要事項：

• 它通過流暢的API實現了特定于域的語言
• 它是單個Maven依賴項
• 它幾乎完全公開了xml和json響應對象的共享樣式
• 它依賴于Apache Commons Client

因此，我將向您展示大量實際的用例，如果您想了解更多信息，我將為您提供一些良好的鏈接。 與Java上的大多數DSL一樣，如果您靜態導入最重要的對象 ，效果會更好：

import static com.jayway.restassured.RestAssured.*; import static com.jayway.restassured.matcher.RestAssuredMatchers.*;

基本用法：

get('http://api.twitter.com/1/users/show.xml').asString();

返回：

<errors><error code="34">Sorry, that page does not exist</error> </errors>

呃，有些錯誤 。 是的，我們需要傳遞一些參數：

with().parameter('screen_name', 'resteasy') .get('http://api.twitter.com/1/users/show.xml').asString();

返回：

<user><id>27016395</id><name>Resteasy</name><screen_name>resteasy</screen_name><location></location><profile_image_url>http://a0.twimg.com/sticky/default_profile_images/default_profile_0_normal.png</profile_image_url><profile_image_url_https>https://si0.twimg.com/sticky/default_profile_images/default_profile_0_normal.png</profile_image_url_https><url></url><description>jboss.org/resteasyJBoss/Red Hat REST project</description><protected>false</protected><followers_count>244</followers_count><profile_background_color>C0DEED</profile_background_color><profile_text_color>333333</profile_text_color><profile_link_color>0084B4</profile_link_color><profile_sidebar_fill_color>DDEEF6</profile_sidebar_fill_color><profile_sidebar_border_color>C0DEED</profile_sidebar_border_color><friends_count>1</friends_count><created_at>Fri Mar 27 14:39:52 +0000 2009</created_at><favourites_count>0</favourites_count><utc_offset></utc_offset><time_zone></time_zone><profile_background_image_url>http://a0.twimg.com/images/themes/theme1/bg.png</profile_background_image_url><profile_background_image_url_https>https://si0.twimg.com/images/themes/theme1/bg.png</profile_background_image_url_https><profile_background_tile>false</profile_background_tile><profile_use_background_image>true</profile_use_background_image><geo_enabled>false</geo_enabled><verified>false</verified><statuses_count>8</statuses_count><lang>en</lang><contributors_enabled>false</contributors_enabled><is_translator>false</is_translator><listed_count>21</listed_count><default_profile>true</default_profile><default_profile_image>true</default_profile_image> ... </user>

好多了！ 現在，假設我們只想要這個大String XML的令牌 ：

with().parameter('screen_name', 'resteasy') .get('http://api.twitter.com/1/users/show.xml').path('user.profile_image_url')

這是我們的輸出：

http://a0.twimg.com/sticky/default_profile_images/default_profile_0_normal.png

如果是JSON響應怎么辦？

with().parameter('screen_name', 'resteasy') .get('http://api.twitter.com/1/users/show.json')

這是我們的輸出：

{"id":27016395,"id_str":"27016395","name":"Resteasy","screen_name":"resteasy","location":"","url":null,"description":"jboss.org\/resteasy\n\nJBoss\/Red Hat REST project","protected":false,"followers_count":244,"friends_count":1,"listed_count":21,"created_at":"Fri Mar 27 14:39:52 +0000 2009","favourites_count":0,"utc_offset":null,"time_zone":null,"geo_enabled":false,"verified":false,"statuses_count":8,"lang":"en","status":{"created_at":"Tue Mar 23 14:48:51 +0000 2010","id":10928528312,"id_str":"10928528312","text":"Doing free webinar tomorrow on REST, JAX-RS, RESTEasy, and REST-*. Only 40 min, so its brief. http:\/\/tinyurl.com\/yz6xwek","source":"web","truncated":false,"in_reply_to_status_id":null,"in_reply_to_status_id_str":null,"in_reply_to_user_id":null,"in_reply_to_user_id_str":null,"in_reply_to_screen_name":null,"geo":null,"coordinates":null,"place":null,"contributors":null,"retweet_count":0,"favorited":false,"retweeted":false},"contributors_enabled":false,"is_translator":false,"profile_background_color":"C0DEED","profile_background_image_url":"http:\/\/a0.twimg.com\/images\/themes\/theme1\/bg.png","profile_background_image_url_https":"https:\/\/si0.twimg.com\/images\/themes\/theme1\/bg.png","profile_background_tile":false,"profile_image_url":"http:\/\/a0.twimg.com\/sticky\/default_profile_images\/default_profile_0_normal.png","profile_image_url_https":"https:\/\/si0.twimg.com\/sticky\/default_profile_images\/default_profile_0_normal.png","profile_link_color":"0084B4","profile_sidebar_border_color":"C0DEED","profile_sidebar_fill_color":"DDEEF6","profile_text_color":"333333","profile_use_background_image":true,"default_profile":true,"default_profile_image":true,"following":null,"follow_request_sent":null,"notifications":null}

并且同一接口無法理解JSON對象導航。 請注意，導航表達式不包含“用戶”，因為它在完整的json響應中不存在：

with().parameter('screen_name', 'resteasy') .get('http://api.twitter.com/1/users/show.json').path('profile_image_url')

這是我們的輸出：

http://a0.twimg.com/sticky/default_profile_images/default_profile_0_normal.png

現在是路徑參數的示例：

with().parameter('key', 'HomoSapiens') .get('http://eol.org/api/search/{key}').asString()

有關http請求的信息 ：

get('http://api.twitter.com/1/users/show.xml').statusCode(); get('http://api.twitter.com/1/users/show.xml').statusLine();

基本身份驗證的示例：

with().auth().basic('paolo', 'xxxx') .get('http://localhost:8080/b/secured/hello').statusLine()

分段表格上傳的示例

with().multiPart('file', 'test.txt', fileContent.getBytes()) .post('/upload')

Maven依賴項 ：

<dependency><groupid>com.jayway.restassured</groupid><artifactid>rest-assured</artifactid><version>1.4</version><scope>test</scope> </dependency>

得益于Grapes ，可以在groovyConsole中直接粘貼和執行的Groovy代碼片段提取依賴關系并將其自動添加到類路徑中，從而向您展示JAXB支持：

@Grapes([ @Grab('com.jayway.restassured:rest-assured:1.7.2') ]) import static com.jayway.restassured.RestAssured.* import static com.jayway.restassured.matcher.RestAssuredMatchers.* import javax.xml.bind.annotation.*@XmlRootElement(name = 'user') @XmlAccessorType( XmlAccessType.FIELD )class TwitterUser {String id;String name;String description;String location;@OverrideString toString() {return 'Id: $id, Name: $name, Description: $description, Location: $location'}}println with().parameter('screen_name', 'resteasy').get('http://api.twitter.com/1/users/show.xml').as(TwitterUser.class)//

這只是庫功能的簡短列表，只是您了解使用它的難易程度。 有關其他示例，建議您在此處閱讀官方頁面： https : //code.google.com/p/rest-assured/wiki/Usage 。 或此處提供的另一個具有示例應用程序的優秀教程： http : //www.hascode.com/2011/10/testing-restful-web-services-made-easy-using-the-rest-assured-framework

參考： Java：在Someday Never Comes博客上，由我們的JCG合作伙伴 Paolo Antinori 保證（或稱Rest-Very-Easy） 。

翻譯自: https://www.javacodegeeks.com/2013/03/java-rest-assured-or-rest-very-easy.html

總結

以上是生活随笔為你收集整理的Java：放心（或非常容易）的全部內容，希望文章能夠幫你解決所遇到的問題。

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