Use the types and definitions of this artifact when you are tired of defining your own networking based basics, your own HTTP-status-code enumerations (HttpStatusCode or exceptions representing erroneous HTTP state, or if you are tired of cookie handling, Header-Field processing ... and so on:

This artifact provides various types such as Cookie, FormFields, HeaderFields or HttpMethod, which enable you to use such HTTP based structures in a native Java way while having a tool at hand to bridge back into the HTTP protocol world. HTTP related error codes are provided as exception types such as NotFoundException (404) or `InternalServerErrorException` (500).

Please note that the HttpBodyMap is most useful when you have to handle dynamic data structures. The HttpBodyMap type is a "dynamic" type in terms of it's structure being represented by paths'. When a data structure is parsed e.g. from JSON or XML, then the data structure's internal structure and values are reflected by according paths's and values in the HttpBodyMap. The HttpBodyMap is a kind of flat (no nested maps) representation of the according (nested) data structures. Implementations of the HttpClientRequest, HttpClientResponse, HttpServerRequest as well as HttpServerResponse types support the HttpBodyMap.

As another example, the BasicAuthCredentials make it ease to parse or create Basic-Auth Header-Fields.

Other interesting types and classes to mention are the Port enumeration, defining quite a few default ports or the MediaTypeFactory interface, which's implementations make marshaling and unmarshaling of your types from and to JSON, XML (and so on) an easy task.

Predefined MIME-Types are bundled in the MediaType enumeration, as of the information provided by the [`IANA`](, effective in October 2016.

See the [Javadoc]( for a full overview on this artifact.