首页
/ Groovy-wslite 技术文档

Groovy-wslite 技术文档

2024-12-24 15:53:47作者:凌朦慧Richard

本文档旨在帮助用户了解和使用 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 库。确保你的项目环境满足所需的环境要求。

登录后查看全文
热门项目推荐