第2章 JAX-RS 2.0快速实现

学习和使用一种新技术,说起来并没有多少玄机。相信每一位深得其法的读者,都遵循着这样一条学习路线,那就是,首先了解背景知识,收集相关概念、标准和实现工具,在脑海里形成根枝结构,希望第1章已经带给读者这样的帮助。接着就是找到一个好用的、有引领性的例子来快速学习,这是不断成长的过程,是走向“枝繁叶茂”的第一步。当然,最后会找寻一两本该领域的权威书籍来深入掌握,最终达到运用熟练的地步。这是本书后续章节希望为读者呈现的。

本章是入门章节,希望读者可以掌握JAX-RX 2.0应用开发的相关技能。本章可以形象地比喻为通往掌握Java RESTful开发的快速干道,读者将从若干不同场景的例子中了解实现和部署REST应用的过程。

实践一个REST应用需要考虑两点:第一点是如何定义一个资源,包括以什么方式发布一个请求,它的输入和输出是什么;第二点要考虑的是如何部署一个Java RESTful Web Service应用,以匹配既有的REST服务类型。

阅读指南

关于对资源设计和定位的思考远不止本章所述,详细情况,读者可以阅读第3章。作为入门章节,本章去除“噪声”,让读者只关注能实现REST的最少知识。正像迪米特法则那样,知道的最少时最整洁。

举个例子,有一个资源是关于更新设备的API,我们需要考虑该API将以PUT方式发布还是其他方式发布?它的输入是XML格式、JSON格式,还是流呢?它的输出是否覆盖更新设备所遇到的所有情形,输出格式是否合理,信息是否完整且合理?另一个要考虑的是这个关于设备的REST应用是否部署到Servlet容器,以及该容器的版本。带着这样的疑问走进本章,你一定迫切地想知道答案。首先,我们必须做一些准备工作。