原文： https://howtodoinjava.com/restful-web-service/

JAX-RS 2.0 是一个旨在帮助您在客户端和服务器端编写 RESTful 应用的框架。 以下教程是使用 RESTEasy 框架构建的。

在 Jersey 和 Dropwizard 页面上获得更多 JAX-RS 教程。

HelloWorld 应用

RESTEasy + JBOSS 7 HelloWorldd 应用

了解在 JBOSS AS7 中构建 RESTful Web 应用所需的最基本配置。

RESTEasy + Tomcat HelloWorld 应用

了解使用 Tomcat 服务器构建 RESTful Web 应用所需的最低配置。

REST 客户端

使用java.net包的 RESTful 客户端

使用java.net package构建 Restful 客户端以使用 Restful API。

RESTEasy 客户端示例

使用内置的 jax-rs 功能构建 RESTful 客户端以使用 RESTful API。

Apache HttpClient 示例

使用 apache http 客户端框架构建 Restful 客户端以使用 Restful API。

Ajax/JavaScript 客户端示例

学习构建 resteasy ajax 客户端

JAX-RS 2.0 客户端 API 示例

JAX-RS 2.0 在以前的版本中带来了很多改进。 主要改进之一是客户端 API，它在 JAX-RS 1.0 中完全丢失。 在本教程中学习使用。

XML / JSON 支持

RESTEasy + JAXB xml 示例

学习使用 JAXB 在 XML 文档中封送模型对象，并将其作为服务器响应发送给客户端

RESTEasy + Jettison json 示例

使用 Jettison 学习在 JSON 文档中封送模型对象，并将其作为服务器响应发送给客户端

RESTEasy + Jackson JSON 示例

学习使用 Jackson 封送 JSON 文档中的模型对象，并将其作为服务器响应发送给客户端

文件下载/上传

RESTEasy + 文件下载示例

此示例显示了使用 RESTful API 下载各种文件格式所需的配置和代码

RESTEasy + 文件上传 + HttpClient 纯 Java 客户端示例

使用纯 Java 客户端将文件上传到服务器

RESTEasy + 文件上传 + HTML 表单示例

使用 html 表单提交将文件上传到服务器

注解用法和示例

基于 JAX-RS @Path正则表达式的 URI 匹配

使用@Path注解的 API 路径匹配示例。 还包括一些正则表达式示例。

Hateoas 实现

RESTful Web 服务的 HATEOAS 示例

学习启用 HATEOAS 链接来制作 RESTful Web 服务

JAX-RS 安全

使用PreProcessorInterceptor的基本认证和授权示例

使用PreProcessorInterceptor实现安全性。

JAX-RS 2.0 RESTEasy 3.0.2.Final 使用ContainerRequestFilter的安全性示例

PreProcessorInterceptor和PostProcessorInterceptor现在已过时。 因此，从现在开始，使用ContainerRequestFilter和ContainerReponseFilter。 在本教程中学习使用它们。

REST 安全性指南

保护 RESTful Web 服务的知识与编写它们一样重要。 编写安全的 API 以保护业务非常重要。 但是在开始保护 RESTful API 之前，让我们了解作为开发人员我们有哪些选择？ 什么将最适合我们的用例？

请求验证

使用 Ajax 自定义 HTML 表单

为您的网页构建 Ajax 支持的 html 表单验证功能

Hiberate 验证器供应器演示

将 Hiberate bean 验证功能集成到您的 RESTEasy API 中

各种整合

使用 Spring 3 mvc 的 RESTful Web 服务

了解如何使用 Spring 3 框架编写 RESTful Web 服务

日志支持

RESTEasy + Log4j 示例

在 RESTEasy 应用中添加 log4j 日志记录支持的演示配置

RESTEasy + SLF4j 示例

演示配置以在 RESTEasy 应用中添加 slf4j 日志支持

最佳实践

使用ResteasyProviderFactory共享上下文数据

当您想在应用的各个层中共享某些数据而不将其作为方法参数传递时，ResteasyProviderFacory可以证明非常方便

使用自定义异常映射器进行异常处理

构建自定义异常映射器以处理各种异常的应用特定处理

启用 gzip 压缩内容编码

JAX-RS Resteasy 具有自动 GZIP 解压缩支持。 学习使用它。

带有 ETag 示例的 JAX-RS RESTEasy 缓存控制

ETags 或实体标签是有用的 HTTP 标头，可通过最小化系统上的服务器负载来帮助构建超快速的应用。 ETag 设置为对客户端的响应，因此客户端可以对条件请求使用各种控制请求标头，例如If-Match和If-None-Match。 javax.ws.rs.core.Response.ResponseBuilder#tag和javax.ws.rs.core.EntityTag是用于处理 ETags 的有用类。

RESTful Web 服务的资源