JAX-RS 2.0 教程 · HowToDoInJava 中文系列教程

# JAX-RS 2.0 教程 > 原文： [https://howtodoinjava.com/restful-web-service/](https://howtodoinjava.com/restful-web-service/) **JAX-RS 2.0** 是一個旨在幫助您在客戶端和服務器端編寫 RESTful 應用的框架。以下教程是使用 **RESTEasy** 框架構建的。在 [Jersey](//howtodoinjava.com/jersey-jax-rs-tutorials/) 和 [Dropwizard](//howtodoinjava.com/dropwizard-tutorials/) 頁面上獲得更多 **JAX-RS 教程**。 ## HelloWorld 應用 #### [RESTEasy + JBOSS 7 HelloWorldd 應用](//howtodoinjava.com/resteasy/resteasy-jboss-7-hello-world-application/ "RESTEasy + JBOSS 7 HelloWorld application") 了解在 JBOSS AS7 中構建 RESTful Web 應用所需的最基本配置。 #### [RESTEasy + Tomcat HelloWorld 應用](//howtodoinjava.com/resteasy/resteasy-tomcat-hello-world-application/ "RESTEasy + Tomcat HelloWorld application") 了解使用 Tomcat 服務器構建 RESTful Web 應用所需的最低配置。 ## REST 客戶端 #### [使用`java.net`包的 RESTful 客戶端](//howtodoinjava.com/resteasy/restful-webservices-client-using-java-net-package/ "testful client using java.net package") 使用`java.net package`構建 Restful 客戶端以使用 Restful API。 #### [RESTEasy 客戶端示例](//howtodoinjava.com/resteasy/resteasy-client-for-consuming-rest-apis/ "RESTEasy client for consuming REST APIs") 使用內置的 jax-rs 功能構建 RESTful 客戶端以使用 RESTful API。 #### [Apache HttpClient 示例](//howtodoinjava.com/apache-commons/jax-rs-restful-client-using-apache-httpclient/ "JAX-RS RESTful client using apache httpclient") 使用 apache http 客戶端框架構建 Restful 客戶端以使用 Restful API。 #### [Ajax/JavaScript 客戶端示例](//howtodoinjava.com/resteasy/resteasy-javascriptajax-client-demo/ "RESTEasy javascript/ajax client demo") 學習構建 resteasy ajax 客戶端 #### [JAX-RS 2.0 客戶端 API 示例](//howtodoinjava.com/resteasy/jax-rs-2-0-resteasy-3-0-2-final-client-api-example/ "JAX-RS 2.0 RESTEasy 3.0.2.Final Client API example") JAX-RS 2.0 在以前的版本中帶來了很多改進。主要改進之一是客戶端 API，它在 JAX-RS 1.0 中完全丟失。在本教程中學習使用。 ## XML / JSON 支持 #### [RESTEasy + JAXB xml 示例](//howtodoinjava.com/resteasy/resteasy-jaxb-xml-example/ "RESTEasy + JAXB xml example") 學習使用 JAXB 在 XML 文檔中封送模型對象，并將其作為服務器響應發送給客戶端 #### [RESTEasy + Jettison json 示例](//howtodoinjava.com/resteasy/resteasy-jettison-json-example/ "RESTEasy + Jettison json example") 使用 Jettison 學習在 JSON 文檔中封送模型對象，并將其作為服務器響應發送給客戶端 #### [RESTEasy + Jackson JSON 示例](//howtodoinjava.com/2013/05/10/resteasy-jackson-json-example/ "RESTEasy + Jackson JSON example") 學習使用 Jackson 封送 JSON 文檔中的模型對象，并將其作為服務器響應發送給客戶端 ## 文件下載/上傳 #### [RESTEasy + 文件下載示例](//howtodoinjava.com/resteasy/resteasy-file-download-example/ "RESTEasy + File download example") 此示例顯示了使用 RESTful API 下載各種文件格式所需的配置和代碼 #### [RESTEasy + 文件上傳 + HttpClient 純 Java 客戶端示例](//howtodoinjava.com/resteasy/jax-rs-resteasy-file-upload-httpclient-example/ "JAX-RS RESTEasy file upload + httpclient example") 使用純 Java 客戶端將文件上傳到服務器 #### [RESTEasy + 文件上傳 + HTML 表單示例](//howtodoinjava.com/resteasy/jax-rs-resteasy-file-upload-html-form-example/ "JAX-RS RESTEasy file upload + html form example") 使用 html 表單提交將文件上傳到服務器 ## 注解用法和示例 #### [基于 JAX-RS `@Path`正則表達式的 URI 匹配](//howtodoinjava.com/resteasy/jax-rs-path-regex-based-uri-matching/ "@Path example") 使用`@Path`注解的 API 路徑匹配示例。還包括一些正則表達式示例。 ## Hateoas 實現 #### [RESTful Web 服務的 HATEOAS 示例](//howtodoinjava.com/resteasy/writing-restful-webservices-with-hateoas-using-jax-rs-and-jaxb-in-java/ "How to write RESTful web services using jax-rs and jaxb in java [HATEOAS?example]") 學習啟用 HATEOAS 鏈接來制作 RESTful Web 服務 ## JAX-RS 安全 #### [使用`PreProcessorInterceptor`的基本認證和授權示例](//howtodoinjava.com/resteasy/jax-rs-resteasy-basic-authentication-and-authorization-tutorial/ "JAX-RS RESTEasy basic authentication and authorization tutorial") 使用`PreProcessorInterceptor`實現安全性。 #### [JAX-RS 2.0 RESTEasy 3.0.2.Final 使用`ContainerRequestFilter`的安全性示例](//howtodoinjava.com/resteasy/jax-rs-2-0-resteasy-3-0-2-final-security-tutorial/ "JAX-RS 2.0 RESTEasy 3.0.2.Final security tutorial") `PreProcessorInterceptor`和`PostProcessorInterceptor`現在已過時。因此，從現在開始，使用`ContainerRequestFilter`和`ContainerReponseFilter`。在本教程中學習使用它們。 #### [REST 安全性指南](//howtodoinjava.com/security/restful-web-services-security-guide/) 保護 RESTful Web 服務的知識與編寫它們一樣重要。編寫安全的 API 以保護業務非常重要。但是在開始保護 RESTful API 之前，讓我們了解作為開發人員我們有哪些選擇？什么將最適合我們的用例？ ## 請求驗證 #### [使用 Ajax 自定義 HTML 表單](//howtodoinjava.com/resteasy/jax-rs-custom-validation-example-using-ajax/ "JAX-RS custom validation example using ajax") 為您的網頁構建 Ajax 支持的 html 表單驗證功能 #### [Hiberate 驗證器供應器演示](//howtodoinjava.com/resteasy/resteasy-bean-validation-using-hibernate-validator-provider/ "RESTEasy bean validation using hibernate validator provider") 將 Hiberate bean 驗證功能集成到您的 RESTEasy API 中 ## 各種整合 #### [使用 Spring 3 mvc 的 RESTful Web 服務](//howtodoinjava.com/spring/spring-restful/how-to-write-restful-webservices-using-spring-3-mvc/) 了解如何使用 Spring 3 框架編寫 RESTful Web 服務 ## 日志支持 #### [RESTEasy + Log4j 示例](//howtodoinjava.com/log4j/resteasy-tomcat-7-log4j-logging-example/ "RESTEasy + Tomcat 7 + Log4j logging example") 在 RESTEasy 應用中添加 log4j 日志記錄支持的演示配置 #### [RESTEasy + SLF4j 示例](//howtodoinjava.com/resteasy/resteasy-tomcat-7-slf4j-logging-example/ "RESTEasy + Tomcat 7 + SLF4J logging example") 演示配置以在 RESTEasy 應用中添加 slf4j 日志支持 ## 最佳實踐 #### [使用`ResteasyProviderFactory`共享上下文數據](//howtodoinjava.com/resteasy/share-context-data-with-jax-rs-resteasyproviderfactory/ "Share context data with JAX-RS ResteasyProviderFactory") 當您想在應用的各個層中共享某些數據而不將其作為方法參數傳遞時，`ResteasyProviderFacory`可以證明非常方便 #### [使用自定義異常映射器進行異常處理](//howtodoinjava.com/resteasy/exception-handling-in-jax-rs-resteasy-with-exceptionmapper/ "Exception handling in JAX-RS RESTEasy with ExceptionMapper") 構建自定義異常映射器以處理各種異常的應用特定處理 #### [啟用 gzip 壓縮內容編碼](//howtodoinjava.com/resteasy/enable-gzip-compression-content-encoding-in-resteasy/ "Enable gzip compression content encoding in RESTEasy") JAX-RS Resteasy 具有自動 GZIP 解壓縮支持。學習使用它。 #### [帶有 ETag 示例的 JAX-RS RESTEasy 緩存控制](//howtodoinjava.com/2013/06/05/jax-rs-resteasy-cache-control-with-etag-example/ "JAX-RS RESTEasy Cache control with ETag example") **ETags** 或實體標簽是有用的 HTTP 標頭，可通過最小化系統上的服務器負載來幫助構建超快速的應用。 ETag 設置為對客戶端的響應，因此客戶端可以對條件請求使用各種控制請求標頭，例如`If-Match`和`If-None-Match`。 `javax.ws.rs.core.Response.ResponseBuilder#tag`和`javax.ws.rs.core.EntityTag`是用于處理 **ETags** 的有用類。 ## RESTful Web 服務的資源 * [Jboss RESTEasy 主頁](http://resteasy.jboss.org/ "reasteasy") * [JBoss 服務器](http://jbossas.jboss.org/) * [Tomcat 服務器](https://tomcat.apache.org/) * [JAX-RS 2 規范](https://jax-rs-spec.java.net/) * [Jettison 庫](https://github.com/codehaus/jettison) * [Jackson 庫](https://github.com/FasterXML/jackson)