Resty 使用与技术文档

1. 安装指南

Resty 是一个用于从 Java 访问 RESTful 服务的便捷接口。安装 Resty 有两种方式：

• 手动创建 JAR 文件：查看目标目录或获取 rest-*.jar 文件，并将其添加到您的 CLASSPATH 中。
• 使用 Maven：在 Maven 项目的 pom.xml 文件中添加以下依赖项：

<dependency>
    <groupId>us.monoid.web</groupId>
    <artifactId>resty</artifactId>
    <version>0.3.2</version>
</dependency>

2. 项目的使用说明

Resty 的基本使用非常简单：创建一个 Resty 实例，使用 authenticate 方法添加凭证，然后调用特定于内容类型的 方法。方法名表示期望的内容类型，然后您可以对其进行操作。

以下是 Resty 支持的一些操作示例：

• GET 请求以获取 JSON 数据：

new Resty().json(url);

• 使用 multipart/form-data 发送 POST 请求并接收 JSON 响应：

new Resty().json(url, form(data("name", "Don Draper"), data("occupation", "Ad Man")));

• 发送 PUT 请求并接收 JSON 响应：

new Resty().json(url, put(content(someJSON)));

• 通过 URL 删除资源并期望返回 JSON：

new Resty().json(url, delete());

3. 项目API使用文档

Resty 提供了以下功能：

• 支持 GET、POST、PUT、DELETE 方法，适用于文本、XML、JSON 和二进制数据。
• 支持链式风格的 API，便于跟随超链接。
• 支持复杂的路径查询，适用于 JSON（对字段进行大于、等于、小于以及完整的布尔表达式操作）。
• 支持XPath 表达式。
• 支持登录/密码认证。
• 自动管理 Cookie。
• 支持 multipart/form-data。
• 与 GAE 兼容（但不支持 Cookie）。

目前 Resty 仍在发展过程中，一些 HTTP 动词（如 HEAD、OPTIONS）尚不支持，且没有明确的 HTML 支持。

4. 项目安装方式

如安装指南所述，您可以选择手动创建 JAR 文件并将其添加到项目的 CLASSPATH 中，或者通过在 Maven 项目的 pom.xml 文件中添加依赖项来安装 Resty。以下是使用 Maven 的示例：

<dependency>
    <groupId>us.monoid.web</groupId>
    <artifactId>resty</artifactId>
    <version>0.3.2</version>
</dependency>

通过上述步骤，您可以使用 Resty 来便捷地访问和操作 RESTful 服务。