Location>code7788 >text

What's New in Solon 3.0: Getting to Know HttpUtils

Popularity：170 ℃/2024-10-15 15:59:30

Solon 3.0 introduces a small plugin called HttpUtils, which is a simple synchronized HTTP client based on URLConnection adaptation (also supports switching to OkHttp adaptation). This makes writing HTTP client code more intuitive and easier to read.

  • When using URLConnection adaptation (size around 40KB). Default
  • When using OkHttp adaptation (size is around 3.1MB). When the okhttp package is introduced, it automatically switches to okhttp adaptation.

I. Request operation

  • HEAD request and return status code
int code = ("http://localhost:8080/hello").head();
  • GET request and return body string
String body = ("http://localhost:8080/hello").get();
  • GET request and return body as bean
//for Bean
Book book = ("http://localhost:8080/book?bookId=1")
                     .getAs();

II. Submission operations

PUT, PATCH, DELETE Data submission, same as POST.

  • POST request and return body stirng (x-www-form-urlencoded)
//x-www-form-urlencoded
String body = ("http://localhost:8080/hello")
                       .data("name","world")
                       .post();
  • POST request and return body stirng (form-data)
//form-data
String body = ("http://localhost:8080/hello")
                       .data("name","world")
                       .post(true); // useMultipart
                       
                       
//form-data :: upload-file
String body = ("http://localhost:8080/hello")
                       .data("name", new File("/data/"))
                       .post(true); // useMultipart
  • POST request and return body stirng (body-raw)
//body-json
String body = ("http://localhost:8080/hello")
                       .bodyOfJson("{\"name\":\"world\"}")
                       .post();
  • POST request and return body as bean (body-raw)
//for Bean
Result body = ("http://localhost:8080/book")
                       .bodyOfBean(book) //will specify contentType via serializer; defaults to json serializer
                       .postAs();


//for Bean generic type
Result<User> body = ("http://localhost:8080/book")
                       .bodyOfBean(book)
                       .postAs(new Result<User>(){}.getClass()); //Build the generic type via a temporary class (or something else)

III. Advanced operations

Get the full response (to close when you run out)

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

Configure the serializer. Defaults to json, e.g. change to fury; or define your own.

FuryBytesSerializer serializer = new FuryBytesSerializer();

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

IV. Summary

A few small advantages of HttpUtils:

  • Simple API! It's also small.
  • Support for automatic serialization (uses the solon serializer interface specification; adapted serialization plugins can be used directly)
  • Support for generalizations
<Previous Next>