Class HttpHeaders (1.41.8)

Version 1.41.8

• 1.45.0 (latest)
• 1.44.2
• 1.43.2
• 1.42.3
• 1.41.8

public class HttpHeaders extends GenericData

Stores HTTP headers used in an HTTP request or response, as defined in Header Field Definitions.

null is not allowed as a name or value of a header. Names are case-insensitive.

Implementation is not thread-safe.

Inheritance

Object > AbstractMap > GenericData > HttpHeaders

Inherited Members

GenericData.clone()

GenericData.entrySet()

GenericData.equals(Object)

GenericData.get(Object)

GenericData.getClassInfo()

GenericData.getUnknownKeys()

GenericData.hashCode()

GenericData.put(String,Object)

GenericData.putAll(Map<? extends String,?>)

GenericData.remove(Object)

GenericData.set(String,Object)

GenericData.setUnknownKeys(Map<String,Object>)

GenericData.toString()

Object.finalize()

Object.getClass()

Object.notify()

Object.notifyAll()

Object.wait()

Object.wait(long)

Object.wait(long,int)

AbstractMap.clear()

AbstractMap.containsKey(Object)

AbstractMap.containsValue(Object)

AbstractMap.isEmpty()

AbstractMap.keySet()

AbstractMap.put(K,V)

AbstractMap.putAll(Map<? extends K,? extends V>)

AbstractMap.size()

AbstractMap.values()

Static Methods

serializeHeadersForMultipartRequests(HttpHeaders headers, StringBuilder logbuf, Logger logger, Writer writer)

public static void serializeHeadersForMultipartRequests(HttpHeaders headers, StringBuilder logbuf, Logger logger, Writer writer)

Serializes headers to an Writer for Multi-part requests.

Parameters

Name	Description
headers	HttpHeaders HTTP headers
logbuf	StringBuilder log buffer or null for none
logger	Logger logger or null for none. Logger must be specified if log buffer is specified
writer	Writer Writer where HTTP headers will be serialized to or null for none

Exceptions

Type	Description
IOException

Constructors

HttpHeaders()

public HttpHeaders()

Methods

addWarning(String warning)

public HttpHeaders addWarning(String warning)

Adds the "Warning" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
warning	String

Returns

Type	Description
HttpHeaders

clone()

public HttpHeaders clone()

Makes a "deep" clone of the generic data, in which the clone is completely independent of the original.

Returns

Type	Description
HttpHeaders

Overrides

GenericData.clone()

fromHttpHeaders(HttpHeaders headers)

public final void fromHttpHeaders(HttpHeaders headers)

Puts all headers of the HttpHeaders object into this HttpHeaders object.

Parameter

Name	Description
headers	HttpHeaders HttpHeaders from where the headers are taken

fromHttpResponse(LowLevelHttpResponse response, StringBuilder logger)

public final void fromHttpResponse(LowLevelHttpResponse response, StringBuilder logger)

Puts all headers of the LowLevelHttpResponse into this HttpHeaders object.

Parameters

Name	Description
response	LowLevelHttpResponse Response from which the headers are copied
logger	StringBuilder StringBuilder to which logging output is added or null to disable logging

Exceptions

Type	Description
IOException

getAccept()

public final String getAccept()

Returns the first "Accept" header or null for none.

Returns

Type	Description
String

getAcceptEncoding()

public final String getAcceptEncoding()

Returns the first "Accept-Encoding" header or null for none.

Returns

Type	Description
String

getAge()

public final Long getAge()

Returns the first "Age" header or null for none.

Returns

Type	Description
Long

getAuthenticate()

public final String getAuthenticate()

Returns the first "WWW-Authenticate" header or null for none.

Returns

Type	Description
String

getAuthenticateAsList()

public final List<String> getAuthenticateAsList()

Returns all "WWW-Authenticate" headers or null for none.

Returns

Type	Description
List<String>

getAuthorization()

public final String getAuthorization()

Returns the first "Authorization" header or null for none.

Returns

Type	Description
String

getAuthorizationAsList()

public final List<String> getAuthorizationAsList()

Returns all "Authorization" headers or null for none.

Returns

Type	Description
List<String>

getCacheControl()

public final String getCacheControl()

Returns the first "Cache-Control" header or null for none.

Returns

Type	Description
String

getContentEncoding()

public final String getContentEncoding()

Returns the first "Content-Encoding" header or null for none.

Returns

Type	Description
String

getContentLength()

public final Long getContentLength()

Returns the first "Content-Length" header or null for none.

Returns

Type	Description
Long

getContentMD5()

public final String getContentMD5()

Returns the first "Content-MD5" header or null for none.

Returns

Type	Description
String

getContentRange()

public final String getContentRange()

Returns the first "Content-Range" header or null for none.

Returns

Type	Description
String

getContentType()

public final String getContentType()

Returns the first "Content-Type" header or null for none.

Returns

Type	Description
String

getCookie()

public final String getCookie()

Returns the first "Cookie" header or null for none.

See Cookie Specification.

Returns

Type	Description
String

getDate()

public final String getDate()

Returns the first "Date" header or null for none.

Returns

Type	Description
String

getETag()

public final String getETag()

Returns the first "ETag" header or null for none.

Returns

Type	Description
String

getExpires()

public final String getExpires()

Returns the first "Expires" header or null for none.

Returns

Type	Description
String

getFirstHeaderStringValue(String name)

public String getFirstHeaderStringValue(String name)

Returns the first header string value for the given header name.

Parameter

Name	Description
name	String header name (may be any case)

Returns

Type	Description
String	first header string value or null if not found

getHeaderStringValues(String name)

public List<String> getHeaderStringValues(String name)

Returns an unmodifiable list of the header string values for the given header name.

Parameter

Name	Description
name	String header name (may be any case)

Returns

Type	Description
List<String>	header string values or empty if not found

getIfMatch()

public final String getIfMatch()

Returns the first "If-Match" header or null for none.

Returns

Type	Description
String

getIfModifiedSince()

public final String getIfModifiedSince()

Returns the first "If-Modified-Since" header or null for none.

Returns

Type	Description
String

getIfNoneMatch()

public final String getIfNoneMatch()

Returns the first "If-None-Match" header or null for none.

Returns

Type	Description
String

getIfRange()

public final String getIfRange()

Returns the first "If-Range" header or null for none.

Returns

Type	Description
String

getIfUnmodifiedSince()

public final String getIfUnmodifiedSince()

Returns the first "If-Unmodified-Since" header or null for none.

Returns

Type	Description
String

getLastModified()

public final String getLastModified()

Returns the first "Last-Modified" header or null for none.

Returns

Type	Description
String

getLocation()

public final String getLocation()

Returns the first "Location" header or null for none.

Returns

Type	Description
String

getMimeVersion()

public final String getMimeVersion()

Returns the first "MIME-Version" header or null for none.

Returns

Type	Description
String

getRange()

public final String getRange()

Returns the first "Range" header or null for none.

Returns

Type	Description
String

getRetryAfter()

public final String getRetryAfter()

Returns the first "Retry-After" header or null for none.

Returns

Type	Description
String

getUserAgent()

public final String getUserAgent()

Returns the first "User-Agent" header or null for none.

Returns

Type	Description
String

getWarning()

public final List<String> getWarning()

Returns all "Warning" headers or null for none.

Returns

Type	Description
List<String>

set(String fieldName, Object value)

public HttpHeaders set(String fieldName, Object value)

Sets the given field value (may be null) for the given field name. Any existing value for the field will be overwritten. It may be more slightly more efficient than #put(String, Object) because it avoids accessing the field's original value.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameters

Name	Description
fieldName	String
value	Object

Returns

Type	Description
HttpHeaders

Overrides

GenericData.set(String fieldName, Object value)

setAccept(String accept)

public HttpHeaders setAccept(String accept)

Sets the "Accept" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
accept	String

Returns

Type	Description
HttpHeaders

setAcceptEncoding(String acceptEncoding)

public HttpHeaders setAcceptEncoding(String acceptEncoding)

Sets the "Accept-Encoding" header or null for none.

By default, this is "gzip".

Parameter

Name	Description
acceptEncoding	String

Returns

Type	Description
HttpHeaders

setAge(Long age)

public HttpHeaders setAge(Long age)

Sets the "Age" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
age	Long

Returns

Type	Description
HttpHeaders

setAuthenticate(String authenticate)

public HttpHeaders setAuthenticate(String authenticate)

Sets the "WWW-Authenticate" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
authenticate	String

Returns

Type	Description
HttpHeaders

setAuthorization(String authorization)

public HttpHeaders setAuthorization(String authorization)

Sets the "Authorization" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
authorization	String

Returns

Type	Description
HttpHeaders

setAuthorization(List<String> authorization)

public HttpHeaders setAuthorization(List<String> authorization)

Sets the "Authorization" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
authorization	List<String>

Returns

Type	Description
HttpHeaders

setBasicAuthentication(String username, String password)

public HttpHeaders setBasicAuthentication(String username, String password)

Sets the #authorization header as specified in Basic Authentication Scheme.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameters

Name	Description
username	String
password	String

Returns

Type	Description
HttpHeaders

setCacheControl(String cacheControl)

public HttpHeaders setCacheControl(String cacheControl)

Sets the "Cache-Control" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
cacheControl	String

Returns

Type	Description
HttpHeaders

setContentEncoding(String contentEncoding)

public HttpHeaders setContentEncoding(String contentEncoding)

Sets the "Content-Encoding" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
contentEncoding	String

Returns

Type	Description
HttpHeaders

setContentLength(Long contentLength)

public HttpHeaders setContentLength(Long contentLength)

Sets the "Content-Length" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
contentLength	Long

Returns

Type	Description
HttpHeaders

setContentMD5(String contentMD5)

public HttpHeaders setContentMD5(String contentMD5)

Sets the "Content-MD5" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
contentMD5	String

Returns

Type	Description
HttpHeaders

setContentRange(String contentRange)

public HttpHeaders setContentRange(String contentRange)

Sets the "Content-Range" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
contentRange	String

Returns

Type	Description
HttpHeaders

setContentType(String contentType)

public HttpHeaders setContentType(String contentType)

Sets the "Content-Type" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
contentType	String

Returns

Type	Description
HttpHeaders

setCookie(String cookie)

public HttpHeaders setCookie(String cookie)

Sets the "Cookie" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
cookie	String

Returns

Type	Description
HttpHeaders

setDate(String date)

public HttpHeaders setDate(String date)

Sets the "Date" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
date	String

Returns

Type	Description
HttpHeaders

setETag(String etag)

public HttpHeaders setETag(String etag)

Sets the "ETag" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
etag	String

Returns

Type	Description
HttpHeaders

setExpires(String expires)

public HttpHeaders setExpires(String expires)

Sets the "Expires" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
expires	String

Returns

Type	Description
HttpHeaders

setIfMatch(String ifMatch)

public HttpHeaders setIfMatch(String ifMatch)

Sets the "If-Match" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
ifMatch	String

Returns

Type	Description
HttpHeaders

setIfModifiedSince(String ifModifiedSince)

public HttpHeaders setIfModifiedSince(String ifModifiedSince)

Sets the "If-Modified-Since" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
ifModifiedSince	String

Returns

Type	Description
HttpHeaders

setIfNoneMatch(String ifNoneMatch)

public HttpHeaders setIfNoneMatch(String ifNoneMatch)

Sets the "If-None-Match" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
ifNoneMatch	String

Returns

Type	Description
HttpHeaders

setIfRange(String ifRange)

public HttpHeaders setIfRange(String ifRange)

Sets the "If-Range" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
ifRange	String

Returns

Type	Description
HttpHeaders

setIfUnmodifiedSince(String ifUnmodifiedSince)

public HttpHeaders setIfUnmodifiedSince(String ifUnmodifiedSince)

Sets the "If-Unmodified-Since" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
ifUnmodifiedSince	String

Returns

Type	Description
HttpHeaders

setLastModified(String lastModified)

public HttpHeaders setLastModified(String lastModified)

Sets the "Last-Modified" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
lastModified	String

Returns

Type	Description
HttpHeaders

setLocation(String location)

public HttpHeaders setLocation(String location)

Sets the "Location" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
location	String

Returns

Type	Description
HttpHeaders

setMimeVersion(String mimeVersion)

public HttpHeaders setMimeVersion(String mimeVersion)

Sets the "MIME-Version" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
mimeVersion	String

Returns

Type	Description
HttpHeaders

setRange(String range)

public HttpHeaders setRange(String range)

Sets the "Range" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
range	String

Returns

Type	Description
HttpHeaders

setRetryAfter(String retryAfter)

public HttpHeaders setRetryAfter(String retryAfter)

Sets the "Retry-After" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
retryAfter	String

Returns

Type	Description
HttpHeaders

setUserAgent(String userAgent)

public HttpHeaders setUserAgent(String userAgent)

Sets the "User-Agent" header or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter

Name	Description
userAgent	String

Returns

Type	Description
HttpHeaders