org.springframework.http

Interface ResponseEntity.HeadersBuilder<B extends ResponseEntity.HeadersBuilder<B>>

Type Parameters:

B - the builder subclass

All Known Subinterfaces:

ResponseEntity.BodyBuilder

All Known Implementing Classes:

ResponseEntity.DefaultBuilder

Enclosing class:

ResponseEntity<T>

public static interface ResponseEntity.HeadersBuilder<B extends ResponseEntity.HeadersBuilder<B>>

Defines a builder that adds headers to the response entity.

Since:

4.1

Method Summary

Modifier and Type	Method and Description
B	allow(HttpMethod... allowedMethods) Set the set of allowed HTTP methods, as specified by the Allow header.
ResponseEntity<java.lang.Void>	build() Build the response entity with no body.
B	cacheControl(CacheControl cacheControl) Set the caching directives for the resource, as specified by the Cache-Control header.
B	eTag(java.lang.String eTag) Set the entity tag of the body, as specified by the ETag header.
B	header(java.lang.String headerName, java.lang.String... headerValues) Add the given, single header value under the given name.
B	headers(HttpHeaders headers) Copy the given headers into the entity's headers map.
B	lastModified(long lastModified) Set the time the resource was last changed, as specified by the Last-Modified header.
B	location(java.net.URI location) Set the location of a resource, as specified by the Location header.

Method Detail

header

B header(java.lang.String headerName,
         java.lang.String... headerValues)

Add the given, single header value under the given name.

Parameters:

headerName - the header name

headerValues - the header value(s)

Returns:

this builder

See Also:

HttpHeaders.add(String, String)

headers

B headers(HttpHeaders headers)

Copy the given headers into the entity's headers map.

Parameters:

headers - the existing HttpHeaders to copy from

Returns:

this builder

Since:

4.1.2

See Also:

HttpHeaders.add(String, String)

allow

B allow(HttpMethod... allowedMethods)

Set the set of allowed HTTP methods, as specified by the Allow header.

Parameters:

allowedMethods - the allowed methods

Returns:

this builder

See Also:

HttpHeaders.setAllow(Set)

eTag

B eTag(java.lang.String eTag)

Set the entity tag of the body, as specified by the ETag header.

Parameters:

eTag - the new entity tag

Returns:

this builder

See Also:

HttpHeaders.setETag(String)

lastModified

B lastModified(long lastModified)

Set the time the resource was last changed, as specified by the Last-Modified header.

The date should be specified as the number of milliseconds since January 1, 1970 GMT.

Parameters:

lastModified - the last modified date

Returns:

this builder

See Also:

HttpHeaders.setLastModified(long)

location

B location(java.net.URI location)

Set the location of a resource, as specified by the Location header.

Parameters:

location - the location

Returns:

this builder

See Also:

HttpHeaders.setLocation(URI)

cacheControl

B cacheControl(CacheControl cacheControl)

Set the caching directives for the resource, as specified by the Cache-Control header.

A CacheControl instance can be built like CacheControl.maxAge(3600).cachePublic().noTransform().

Parameters:

cacheControl - the instance that builds cache related HTTP response headers

Returns:

this builder

Since:

4.2

See Also:

RFC-7234 Section 5.2

build

ResponseEntity<java.lang.Void> build()

Build the response entity with no body.

Returns:

the response entity

See Also:

ResponseEntity.BodyBuilder.body(Object)