Solon 3.0 新特性:HttpUtils 了解一下

Solon 3.0 引入一个叫 HttpUtils 小插件,这是一个简单的同步 HTTP 客户端,基于 URLConnection 适配(也支持切换为 OkHttp 适配)。使得编写 HTTP 客户端代码更加直观和易于阅读。

  • 使用 URLConnection 适配时(大小为 40KB 左右)。默认
  • 使用 OkHttp 适配时(大小为 3.1MB 左右)。当引入 okhttp 包时,自动切换为 okhttp 适配。

一、请求操作

  • HEAD 请求并返回 status code
int code = HttpUtils.http("http://localhost:8080/hello").head(); 
  • GET 请求并返回 body string
String body = HttpUtils.http("http://localhost:8080/hello").get(); 
  • GET 请求并返回 body as bean
//for Bean Book book = HttpUtils.http("http://localhost:8080/book?bookId=1")                      .getAs(Book.class); 

二、提交操作

PUT、PATCH、DELETE 数据提交,与 POST 相同。

  • POST 请求并返回 body stirng (x-www-form-urlencoded)
//x-www-form-urlencoded String body = HttpUtils.http("http://localhost:8080/hello")                        .data("name","world")                        .post(); 
  • POST 请求并返回 body stirng (form-data)
//form-data String body = HttpUtils.http("http://localhost:8080/hello")                        .data("name","world")                        .post(true); // useMultipart                                                 //form-data :: upload-file String body = HttpUtils.http("http://localhost:8080/hello")                        .data("name", new File("/data/demo.jpg"))                        .post(true); // useMultipart 
  • POST 请求并返回 body stirng (body-raw)
//body-json String body = HttpUtils.http("http://localhost:8080/hello")                        .bodyOfJson("{"name":"world"}")                        .post(); 
  • POST 请求并返回 body as bean (body-raw)
//for Bean Result body = HttpUtils.http("http://localhost:8080/book")                        .bodyOfBean(book) //会通过 serializer 指定 contentType;默认为 json serializer                        .postAs(Result.class);                                                 //for Bean generic type Result<User> body = HttpUtils.http("http://localhost:8080/book")                        .bodyOfBean(book)                        .postAs(new Result<User>(){}.getClass()); //通过临时类构建泛型(或别的方式) 

三、高级操作

获取完整的响应(用完要关闭)

try(HttpResponse resp = HttpUtils.http("http://localhost:8080/hello").data("name","world").exec("POST")) {     int code = resp.code();     String head = resp.header("Demo-Header");     String body = resp.bodyAsString();     Books body = resp.bodyAsBean(Books.class); } 

配置序列化器。默认为 json,比如改为 fury;或者自己定义。

FuryBytesSerializer serializer = new FuryBytesSerializer();  Result body = HttpUtils.http("http://localhost:8080/book")                        .serializer(serializer)                        .bodyOfBean(book)                        .postAs(Result.class); 

四、总结

HttpUtils 的几个小优点:

  • 简单的 API。主要就是简单!也很小巧。
  • 支持自动序列化(使用了 solon serializer 接口规范;已适配的序列化插件可直接用)
  • 支持泛型
发表评论

相关文章