使用 Apache Wink 和 OpenJPA 构建 REST 资源（3）

look_w

CRUD 操作 本小节介绍可以使用 Wink 框架和 OpenJPA 在 Employee 资源上执行的基本 CRUD 操作。对于每个操作，有一个惟一的 URI 和一个 HTTP 方法。对于创建和更新操作，资源数据（Employee 详细资料）必须作为 Content-Body 表示。Employee 资源的 Content-Body 可以是 JSON 或 XML。Apache Wink 支持 XML、JSON、HTML 和 Atom。表 1 显示 CRUD 操作的设计。
表 1. CRUD 操作操作描述资源/URI资源数据CREATE包括用户创建一个新资源的设备。在该示例中，操作包括创建一个新 Employee 或添加一个新 Employee 到现有数据库。

HTTP 方法：POST /employeeContent-Body 以一种特别的表现形式包括 Employee 详细资料。每个 RESTful 接口可以为其客户端决定它所支持的表现方式类型。例如 中的 XML 结构可以使用 Content-Body 来创建一个新 Employee。RETRIEVE允许用户通过 Employee Id 检索现有员工的详细资料。检索数据可以以不同的表示方式（客户端 REST 支持的）来表示。例如，/employee/121: 检索 ID 为 121 的员工的详细资料。

HTTP 方法：GET /employee/{id}Content-Body 不能为 GET 方法所调用。GET 应该是一个安全的只读幂等（idempotent）调用，它不应该以任何方式更改资源的状态。UPDATE包括一个可供用户更新现有资源的设备。在本例中，该操作包括更新数据中现有的 Employee。

HTTP 方法：PUT /employeeContent-Body 以一种特别的表现形式包括 Employee 详细资料。每个 RESTful 接口可以为其客户端决定它所支持的表现方式类型。例如  中的 XML 结构可以使用 Content-Body 来更新一个 Employee。DELETE允许用户通过 Employee Id 删除一个现有员工的详细信息。删除后，用户将得到一个关于该员工信息是否成功删除的 HTTP 响应。例如，/employee/121: 删除 ID 为 121 的员工的详细资料。

HTTP 方法：DELETE /employee/{id}Content-Body 不能为 DELETE 方法所调用。