groovyx.net.http.package.html Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of http-builder Show documentation

A builder-style HTTP client API, including authentication, and extensible handling of common content-types such as JSON and XML. It is built on top of Apache's HttpClient.

There is a newer version: 0.7.1

Show newest version







HTTPBuilder provides a simple Groovy API for HTTP and REST client operations.
 It supports multiple callbacks based on response status code, and a mechanism
 to automatically parse and encode many common content-types such as XML, JSON,
 HTML, and plain text.  HTTPBuilder also supports easy configuration for common
 authentication mechanisms, and common content-encodings as well.


Package Specification


The primary class is {@link groovyx.net.http.HTTPBuilder HTTPBuilder}, which
  provides the most features and functionality.
  {@link groovyx.net.http.RESTClient RESTClient},
  {@link groovyx.net.http.AsyncHTTPBuilder AsyncHTTPBuilder} and
  {@link groovyx.net.http.HttpURLClient HttpURLClient} are variants provided
  for more specialized use cases.


{@link groovyx.net.http.URIBuilder URIBuilder} is used by HTTPBuilder classes
    for URL manipulation, but it may also be useful on its own.  The remaining
    classes provide supporting functions for HTTPBuilder and are probably only
    useful for customizing or extending HTTPBuilder functionality.


Related Documentation

For overviews, tutorials, examples, guides, and tool documentation, please see:

  Apache HttpClient
  Apache HttpCore


For content-type parser and encoder support, see:

  JSON-Lib
  NekoHTML





@author Tom Nichols
@see groovyx.net.http.HTTPBuilder
@see groovyx.net.http.RESTClient
@see groovyx.net.http.URIBuilder
@see groovyx.net.http.AsyncHTTPBuilder
@see groovyx.net.http.HttpURLClient