unirest java

unirest java简介

Unirest可以帮助用户快速配置客户端请求功能。当您设计一个网络程序或本地程序时，您可能需要配置HTTP请求。使用该软件，您可以快速部署请求方案。该软件可以配置GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS等类型的请求，提供简单的即时内存响应缓存机制。包括条目过期的一些选项，您可以使用默认值和过期选项来启用它，或者用户可以提供其所选缓存支持的自定义缓存。建议消费者使用特殊的缓存实现(如EHCache或Guava)来支持高负载系统中的缓存！

unirest java软件功能

自定义Apache客户端

Unirest在后台使用Apache Http Client，这不是永久的要求。Unirest的未来版本可能会用其他东西取代Apache。

自定义缓存

还可以通过实现缓存接口来提供自定义缓存。

错误处理

HttpResponse对象有一些处理程序方法，可以链接在一起处理成功和失败。

开启响应

当您不需要完整的对象映射器时，Unirest提供了轻量级的ON响应类型。

文件响应

有时您只想下载一个文件，或者将响应主体捕获到文件中。Unirest可以同时进行。只要告诉Unirest你想把文件放在哪里。

下载进度监控

如果你想上传大文件，你可能需要给用户提供一些时间进度条。您可以通过提供PgresMonitor来监控此进度。

客户证书

如果需要使用自定义客户端证书来调用服务，可以为unirest提供自定义密钥库。您可以传递密钥库对象或有效的PKCS#12密钥库文件的路径。

寻呼请求

有时，服务会提供分页请求。这样做的方法还没有标准化，但是Unirest证明了一种跟踪页面直到所有页面都用完的机制。您必须提供两个功能来选择下一页。第一种是以所需的格式获取HttpResponse，第二种是在next之前从响应中提取链接。结果是页面列表的HttpResponse。

unirest java软件特色

1.允许用户将自定义的SSLContext注入到Config中，以确保安全性。

2.在下列情况下允许调用自定义

在请求之前

请求后

当发生致命的连接错误时。

3.将对org.json的依赖替换为gson支持的与org.json接口匹配的本地kong.unirest库。

4.添加一个全新的返回类型:(asBytes()和异步版本)将返回一个原始的byte []数组。

5.引入一个新的HttpStatus常量类来引用Http响应代码。

6.切换ApacheClient以使用Apache的驱逐监视器，而不是自定义监视器。

7.为内置对象映射器添加对各种Java DateTime类型的本机默认支持。所有类型都将被序列化为ISO-8601。来自json的解析将尝试各种ISO变体。

支持的类型:

ZonedDateTime

LocalDateTime

当地时间

日历

时期

学习课程

使用Maven安装:

要求

因此，您可能想知道如何使用Unirest使在Java中创建请求变得更容易。这是一个基本的开机自检请求，将解释一切:

当作为[类型]()发出的请求被调用时，可能的类型包括Json、Stng、对象空和文件。

路线参数

有时您希望向L添加动态参数。您可以通过向L添加占位符并使用uteParam函数设置路由参数来轻松实现这一点，例如:

占位符{水果}将被替换为苹果。

占位符的格式就像使用大括号一样简单:{custom_name}

所有参数值都将为您进行L编码。

默认l

您可以将默认的基本L配置为用于所有不包含完整L的请求..

此配置将导致GET到“http://homestar.com/runner”

查询参数

可以逐个建立查询字符串参数。

同样，所有参数值都将被L编码。

您也可以将查询字符串作为数组和映射传递:

页眉

您可以使用此标头方法添加请求标头。

基本认证

Unirest公开快捷方式，以便在需要时执行基本身份验证。Unirest处理基本编码部分。确保你总是通过HTTPS做到这一点！

实体组织

您可以轻松地将实体对象发布为整个实体。这是大多数REST服务的默认行为。

除非您另外指定，否则默认内容类型值是文本/纯文本；字符集=UTF-8

还可以使用配置的对象映射器发布序列化的对象。(有关实现的详细信息，请参见对象映射器。Unirest自带默认映射器，可以将流行的谷歌Gson库序列化为json。

对象映射器

Unirest根据流行的ON库(Jackson和GSON)提供了一些不同的对象映射器。这些可以包括传统或阴影罐:

或者对象ON解析中的错误。

你不能总是得到你想要的。有时，您从Web服务获得的结果并没有反映出您期望的结果。当这发生在asObject或asJson请求中时，结果主体将为空，但是响应对象将包含ParsingException，这使您能够获取错误和原始主体以供执行。

映射错误对象

有时，使用REST API时，服务会返回可以解决的错误对象。可以选择映射到POJO什么的。

在没有对象映射器的情况下，将一种正文类型映射到另一种正文类型。

如果不想提供对象映射器的完整实现，可以使用简单的函数来映射响应。

unirest java常见问题

升级到Unirest 3.0

Unirest 3的主要区别在于，以谷歌Gson为引擎的org.json接口的洁净室实现取代了org.json依赖。

什么事？为什么呢？

这是由与org.json许可证的冲突引起的，该许可证要求“软件是用于正义的，而不是邪恶的”。虽然很多人正确地认为这是愚蠢的，法律不能强制执行，但是很多组织，比如Eclipse、Debian、Apache都是不允许使用的。

为什么不改用org.json的谷歌实现呢？

几个原因:

已经好几年没有执行了，不再匹配org.json签名。

这会导致很多项目禁止的类路径冲突。

我们希望Unirest能够扩展到org.json之外，提供对象映射等更高级的原生功能。

为什么是Gson而不是杰克逊？

Gson在精神和方法签名上最接近org.json，因此被认为采用速度更快。

它小，成熟，只有一个依赖性。

与其他项目相比，杰克逊的冲突要少得多，而杰克逊则受欢迎且复杂得多。

这是怎么做到的？

实现是在不查看org.json类内部的情况下完成的。这是通过编写大量的单元测试来记录行为和方法签名，并简单地更改测试来使用项目自己的类和Google Gson来实现的。