RequestTemplate (feign-core 8.14.3 API)

java.lang.Object
- feign.RequestTemplate

All Implemented Interfaces:

java.io.Serializable
```
public final class RequestTemplate
extends java.lang.Object
implements java.io.Serializable
```
Builds a request to an http target. Not thread safe.

relationship to JAXRS 2.0

A combination of javax.ws.rs.client.WebTarget and javax.ws.rs.client.Invocation.Builder, ensuring you can modify any part of the request. However, this object is mutable, so needs to be guarded with the copy constructor.

See Also:
Serialized Form

Constructor Summary

Constructors
Constructor and Description

RequestTemplate()

RequestTemplate(RequestTemplate toCopy)

Constructors
Constructor and Description
`RequestTemplate()`
`RequestTemplate(RequestTemplate toCopy)`

Method Summary

Methods
Modifier and Type	Method and Description
`RequestTemplate`	`append(java.lang.CharSequence value)`
`byte[]`	`body()`
`RequestTemplate`	`body(byte[] bodyData, java.nio.charset.Charset charset)` replaces the `Util.CONTENT_LENGTH` header.
`RequestTemplate`	`body(java.lang.String bodyText)` replaces the `Util.CONTENT_LENGTH` header.
`java.lang.String`	`bodyTemplate()`
`RequestTemplate`	`bodyTemplate(java.lang.String bodyTemplate)` populated by `Body`
`java.nio.charset.Charset`	`charset()` The character set with which the body is encoded, or null if unknown or not applicable.
`boolean`	`decodeSlash()`
`RequestTemplate`	`decodeSlash(boolean decodeSlash)`
`static java.lang.String`	`expand(java.lang.String template, java.util.Map<java.lang.String,?> variables)` Expands a `template`, such as `username`, using the `variables` supplied.
`RequestTemplate`	`header(java.lang.String name, java.lang.Iterable<java.lang.String> values)`
`RequestTemplate`	`header(java.lang.String name, java.lang.String... values)` Replaces headers with the specified `configKey` with the `values` supplied.
`java.util.Map<java.lang.String,java.util.Collection<java.lang.String>>`	`headers()` Returns an immutable copy of the current headers.
`RequestTemplate`	`headers(java.util.Map<java.lang.String,java.util.Collection<java.lang.String>> headers)` Replaces all existing headers with the newly supplied headers.
`RequestTemplate`	`insert(int pos, java.lang.CharSequence value)`
`java.lang.String`	`method()`
`RequestTemplate`	`method(java.lang.String method)`
`java.util.Map<java.lang.String,java.util.Collection<java.lang.String>>`	`queries()` Returns an immutable copy of the url decoded queries.
`RequestTemplate`	`queries(java.util.Map<java.lang.String,java.util.Collection<java.lang.String>> queries)` Replaces all existing queries with the newly supplied url decoded queries.
`RequestTemplate`	`query(java.lang.String configKey, java.lang.Iterable<java.lang.String> values)`
`RequestTemplate`	`query(java.lang.String configKey, java.lang.String... values)` Replaces queries with the specified `configKey` with url decoded `values` supplied.
`java.lang.String`	`queryLine()`
`void`	`replaceQueryValues(java.util.Map<java.lang.String,?> unencoded)` Replaces query values which are templated with corresponding values from the `unencoded` map.
`Request`	`request()`
`RequestTemplate`	`resolve(java.util.Map<java.lang.String,?> unencoded)` Resolves any template parameters in the requests path, query, or headers against the supplied unencoded arguments.
`java.lang.String`	`toString()`
`java.lang.String`	`url()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - RequestTemplate
```
public RequestTemplate()
```
  - RequestTemplate
```
public RequestTemplate(RequestTemplate toCopy)
```
- Method Detail
  - expand
```
public static java.lang.String expand(java.lang.String template,
                      java.util.Map<java.lang.String,?> variables)
```
    Expands a template, such as username, using the variables supplied. Any unresolved parameters will remain.
    Note that if you'd like curly braces literally in the template, urlencode them first.
    
    Parameters:
    template - URI template that can be in level 1 RFC6570 form.
    variables - to the URI template
    
    Returns:
    expanded template, leaving any unresolved parameters literal
  - resolve
```
public RequestTemplate resolve(java.util.Map<java.lang.String,?> unencoded)
```
    Resolves any template parameters in the requests path, query, or headers against the supplied unencoded arguments.
    
    relationship to JAXRS 2.0
    
    This call is similar to javax.ws.rs.client.WebTarget.resolveTemplates(templateValues, true) , except that the template values apply to any part of the request, not just the URL
  - request
```
public Request request()
```
  - method
```
public RequestTemplate method(java.lang.String method)
```
  - method
```
public java.lang.String method()
```
  - decodeSlash
```
public RequestTemplate decodeSlash(boolean decodeSlash)
```
  - decodeSlash
```
public boolean decodeSlash()
```
  - append
```
public RequestTemplate append(java.lang.CharSequence value)
```
  - insert
```
public RequestTemplate insert(int pos,
                     java.lang.CharSequence value)
```
  - url
```
public java.lang.String url()
```
  - query
```
public RequestTemplate query(java.lang.String configKey,
                    java.lang.String... values)
```
    Replaces queries with the specified configKey with url decoded values supplied.
    When the value is null, all queries with the configKey are removed.
    
    relationship to JAXRS 2.0
    
    Like WebTarget.query, except the values can be templatized.
    ex.
```
 template.query("Signature", "{signature}");
 
```
    Parameters:
    configKey - the configKey of the query
    values - can be a single null to imply removing all values. Else no values are expected to be null.
    See Also:
    queries()
  - query
```
public RequestTemplate query(java.lang.String configKey,
                    java.lang.Iterable<java.lang.String> values)
```
  - queries
```
public RequestTemplate queries(java.util.Map<java.lang.String,java.util.Collection<java.lang.String>> queries)
```
    Replaces all existing queries with the newly supplied url decoded queries.
    
    relationship to JAXRS 2.0
    
    Like WebTarget.queries, except the values can be templatized.
    ex.
```
 template.queries(ImmutableMultimap.of("Signature", "{signature}"));
 
```
    Parameters:
    queries - if null, remove all queries. else value to replace all queries with.
    See Also:
    queries()
  - queries
```
public java.util.Map<java.lang.String,java.util.Collection<java.lang.String>> queries()
```
    Returns an immutable copy of the url decoded queries.
    
    See Also:
    Request.url()
  - header
```
public RequestTemplate header(java.lang.String name,
                     java.lang.String... values)
```
    Replaces headers with the specified configKey with the values supplied.
    When the value is null, all headers with the configKey are removed.
    
    relationship to JAXRS 2.0
    
    Like WebTarget.queries and javax.ws.rs.client.Invocation.Builder.header, except the values can be templatized.
    ex.
```
 template.query("X-Application-Version", "{version}");
 
```
    Parameters:
    name - the name of the header
    values - can be a single null to imply removing all values. Else no values are expected to be null.
    See Also:
    headers()
  - header
```
public RequestTemplate header(java.lang.String name,
                     java.lang.Iterable<java.lang.String> values)
```
  - headers
```
public RequestTemplate headers(java.util.Map<java.lang.String,java.util.Collection<java.lang.String>> headers)
```
    Replaces all existing headers with the newly supplied headers.
    
    relationship to JAXRS 2.0
    
    Like Invocation.Builder.headers(MultivaluedMap), except the values can be templatized.
    ex.
```
 template.headers(mapOf("X-Application-Version", asList("{version}")));
 
```
    Parameters:
    headers - if null, remove all headers. else value to replace all headers with.
    See Also:
    headers()
  - headers
```
public java.util.Map<java.lang.String,java.util.Collection<java.lang.String>> headers()
```
    Returns an immutable copy of the current headers.
    
    See Also:
    Request.headers()
  - body
```
public RequestTemplate body(byte[] bodyData,
                   java.nio.charset.Charset charset)
```
    replaces the Util.CONTENT_LENGTH header.
    Usually populated by an Encoder.
    
    See Also:
    Request.body()
  - body
```
public RequestTemplate body(java.lang.String bodyText)
```
    replaces the Util.CONTENT_LENGTH header.
    Usually populated by an Encoder.
    
    See Also:
    Request.body()
  - charset
```
public java.nio.charset.Charset charset()
```
    The character set with which the body is encoded, or null if unknown or not applicable. When this is present, you can use new String(req.body(), req.charset()) to access the body as a String.
  - body
```
public byte[] body()
```
    See Also:
    Request.body()
  - bodyTemplate
```
public RequestTemplate bodyTemplate(java.lang.String bodyTemplate)
```
    populated by Body
    
    See Also:
    Request.body()
  - bodyTemplate
```
public java.lang.String bodyTemplate()
```
    See Also:
    Request.body(), expand(String, Map)
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - replaceQueryValues
```
public void replaceQueryValues(java.util.Map<java.lang.String,?> unencoded)
```
    Replaces query values which are templated with corresponding values from the unencoded map. Any unresolved queries are removed.
  - queryLine
```
public java.lang.String queryLine()
```

Class RequestTemplate

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

RequestTemplate

RequestTemplate

Method Detail

expand

resolve

request

method

method

decodeSlash

decodeSlash

append

insert

url

query

query

queries

queries

header

header

headers

headers

body

body

charset

body

bodyTemplate

bodyTemplate

toString

replaceQueryValues

queryLine