Java HTTP Client¶
The user guide to zlink-http-client. It lets handlers inside the server framework and tools outside the mesh
call external HTTP APIs in the zlink call-builder form. The five languages share one semantics, and
chapters 01–11 of this guide are generated from a common source shared by all five.
| Order | Document | Content |
|---|---|---|
| 1 | HTTP Client Overview | When to use it and what it does not take on |
| 2 | Installation and the First Request | Installing the package, one client, a first typed response |
| 3 | Making Requests | Method, path, query, header, per-request timeout |
| 4 | Request Body | JSON, form, multipart and the exclusivity rule |
| 5 | Handling Responses | Typed, raw, body only, compressed responses |
| 6 | Authentication, TLS and Proxy | Basic/Bearer, trusted certificates, mTLS, proxy |
| 7 | Streaming | Download sink and chunked upload |
| 8 | Client and Request Lifetime | builder → client → terminator, option table, execution model |
| 9 | Redirect, Retry and Cookie | Follow rules, backoff, cookie jar semantics |
| 10 | Response Rules | Path per status, decode, size limit, decompression |
| 11 | Error Handling | The five error kinds and the retry decision |
The file number identifies the same chapter regardless of language.
Related Documents¶
- Server guide: Java Server Guide
- Stream Connector guide: Java Stream Connector