Groovy-wslite 技术文档

本文档旨在帮助用户了解和使用 Groovy-wslite 库，它是一个为 Groovy 提供无装饰的 SOAP 和 REST webservice 客户端的库。

1. 安装指南

环境要求

• Groovy 1.7.6 或更高版本
• JDK 1.5 或更高版本（对于 1.0 版本）
• JDK 1.7 或更高版本（对于 2.0 beta 版本）

依赖安装

通过 Groovy 的 @Grab 注解导入 groovy-wslite 库：

@Grab('com.github.groovy-wslite:groovy-wslite:1.1.2')

确保在使用前已经正确安装了所需的 Groovy 和 JDK 版本。

2. 项目的使用说明

SOAP 客户端示例

以下是一个使用 SOAP 客户端发送请求的示例：

import wslite.soap.*

def client = new SOAPClient('http://www.holidaywebservice.com/Holidays/US/Dates/USHolidayDates.asmx')
def response = client.send(SOAPAction: 'http://www.27seconds.com/Holidays/US/Dates/GetMothersDay') {
    body {
        GetMothersDay('xmlns':'http://www.27seconds.com/Holidays/US/Dates/') {
            year(2011)
        }
    }
}

REST 客户端示例

以下是一个使用 REST 客户端发送请求的示例：

import wslite.rest*

def client = new RESTClient("http://api.twitter.com/1/")
def response = client.get(path: '/users/show.json', query: [screen_name: 'jwagenleitner', include_entities: true])

3. 项目 API 使用文档

SOAP API

SOAPClient 类提供了以下方法：

• send(): 发送 SOAP 请求并获取响应。
• sslTrustAllCerts(): 设置是否信任所有 SSL 证书。
• sslTrustStoreFile(): 设置自定义 SSL 信任存储文件路径。
• sslTrustStorePassword(): 设置自定义 SSL 信任存储文件的密码。

REST API

RESTClient 类提供了以下方法：

• head(): 发送 HEAD 请求。
• get(): 发送 GET 请求。
• delete(): 发送 DELETE 请求。
• post(): 发送 POST 请求。
• put(): 发送 PUT 请求。
• patch(): 发送 PATCH 请求。

参数和选项

大部分方法都接受以下参数：

• path: 请求的路径。
• query: 请求的查询参数。
• headers: 请求的 HTTP 头。
• connectTimeout: 连接超时时间。
• readTimeout: 读取超时时间。
• followRedirects: 是否跟随重定向。
• useCaches: 是否使用缓存。
• sslTrustAllCerts: 是否信任所有 SSL 证书。

4. 项目安装方式

请参考上述安装指南中的依赖安装步骤，使用 Groovy 的 @Grab 注解来安装 groovy-wslite 库。确保你的项目环境满足所需的环境要求。