Interface Invocation.Builder

A client request invocation builder.
The builder, obtained via a call to one of the request(...)
methods on a resource target, provides methods for
preparing a client request invocation. Once the request is prepared
the invocation builder can be either used to build an Invocation
with a generic execution interface:

build

Build a request invocation using an arbitrary request method name and
request entity.

Parameters:

method - request method name.

entity - request entity, including it's full Variant information.
Any variant-related HTTP headers previously set (namely Content-Type,
Content-Language and Content-Encoding) will be overwritten using
the entity variant information.

buildPost

entity - request entity, including it's full Variant information.
Any variant-related HTTP headers previously set (namely Content-Type,
Content-Language and Content-Encoding) will be overwritten using
the entity variant information.

Returns:

invocation encapsulating the built POST request.

buildPut

entity - request entity, including it's full Variant information.
Any variant-related HTTP headers previously set (namely Content-Type,
Content-Language and Content-Encoding) will be overwritten using
the entity variant information.