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 接口规范;已适配的序列化插件可直接用)
- 支持泛型