Jersey 2.25.1 用户指南：搭建与实战

"Jersey 2.25.1 用户指南是官方文档，旨在随着新功能的添加保持更新。用户可以结合 Jersey API 文档（链接）来获取更多关于 Jersey 特性和 API 的信息。如果你想要对指南作出贡献或对文档中未涵盖的内容有疑问，可以通过邮件联系 users@jersey.java.net。若发现文档错误，请在 Jersey JIRA 问题追踪器中创建新问题报告。" 以下是 Jersey 2.25.1 用户指南中的关键知识点： 1. **入门**： - **创建 Maven 架构项目**：介绍如何使用 Maven 快速创建一个基于 Jersey 的新项目。 - **探索新建项目**：指导用户理解新项目的结构和组件。 - **运行项目**：阐述如何启动并测试项目。 - **构建 Java EE Web 应用**：说明如何构建能在 Java EE 容器中运行的应用。 - **部署到 Heroku**：提供在 Heroku 上部署 Jersey 应用的步骤。 - **其他 Jersey 示例**：鼓励用户探索更多的示例应用以加深理解。 2. **模块与依赖**： - **Java SE 兼容性**：确保 Jersey 在 Java SE 环境下也能运行。 - **Jersey 依赖介绍**：列出了不同类型的依赖及其用途。 - **常见 Jersey 使用场景**：涵盖 Servlet 基础的应用，包括 Glassfish 上的 Servlet 应用、Servlet 服务器端应用、JDK 上的客户端应用以及在支持的容器上的服务器端应用。 - **模块列表**：提供了所有可用的 Jersey 模块概述，方便用户根据需求选择。 3. **JAX-RS 应用、资源和子资源**： - **根资源类**：解释如何使用 `@Path` 注解定义资源，并通过 `@GET`, `@PUT`, `@POST`, `@DELETE` 注解映射 HTTP 方法。 - **生产与消费媒体类型**：介绍 `@Produces` 和 `@Consumes` 注解，用于指定资源返回和接受的数据类型。 - **参数注解 (@*Param)**：讨论了如 `@PathParam`, `@QueryParam` 等注解，它们用于从请求中提取参数。 - **子资源**：描述了如何定义和使用资源的子层次结构。 - **根资源类的生命周期**：讨论了资源类实例的创建、初始化和销毁。 - **注入规则**：讲解了如何利用依赖注入（DI）管理对象。 - **@Context 使用**：说明了如何使用 `@Context` 注解访问上下文信息，如请求、响应、会话等。 - **程序化配置**：介绍了如何通过代码动态配置和扩展 Jersey 应用。 4. **过滤器与拦截器**： - 不同类型的过滤器（如 `ContainerRequestFilter` 和 `ContainerResponseFilter`）用于处理请求和响应。 - **安全与认证**：讲解如何实现认证和授权，例如使用 `@RolesAllowed` 注解。 5. **客户端API**： - 如何使用 Jersey 客户端 API 进行 RESTful 调用，包括创建客户端实例、发送请求和处理响应。 6. **异常处理**： - 讨论了如何捕获和处理异常，包括自定义错误处理器。 7. **性能与扩展性**： - 描述了性能优化技巧，如缓存、流处理和线程池配置。 Jersey 2.25.1 用户指南详尽地涵盖了开发、配置、测试和部署基于 Jersey 的 RESTful 服务所需的所有关键概念和技术。无论你是初学者还是经验丰富的开发者，都能从中找到有价值的信息。