Package com.linecorp.armeria.common

Class HttpResponseBuilder

java.lang.Object

com.linecorp.armeria.common.HttpResponseBuilder

@UnstableApi
public final class HttpResponseBuilder
extends Object

Builds a new HttpResponse.

Method Summary

Modifier and Type	Method	Description
HttpResponseBuilder	badGateway()	Sets 502 Bad Gateway to the status of this response.
HttpResponseBuilder	badRequest()	Sets 400 Bad Request to the status of this response.
HttpResponse	build()	Builds the response.
HttpResponseBuilder	content(MediaType contentType, byte[] content)	Sets the content for this response.
HttpResponseBuilder	content(MediaType contentType, HttpData content)	Sets the content for this response.
HttpResponseBuilder	content(MediaType contentType, CharSequence content)	Sets the content for this response.
HttpResponseBuilder	content(MediaType contentType, String content)	Sets the content for this response.
HttpResponseBuilder	content(MediaType contentType, String format, Object... content)	Sets the content for this response.
HttpResponseBuilder	content(MediaType contentType, org.reactivestreams.Publisher<? extends HttpData> content)	Sets the Publisher for this response.
HttpResponseBuilder	content(String content)	Sets the content as UTF_8 for this response.
HttpResponseBuilder	content(String format, Object... content)	Sets the content as UTF_8 for this response.
HttpResponseBuilder	contentJson(Object content)	Sets the content for this response.
HttpResponseBuilder	created()	Sets 201 Created to the status of this response.
HttpResponseBuilder	forbidden()	Sets 403 Forbidden to the status of this response.
HttpResponseBuilder	header(CharSequence name, Object value)	Adds a header to this response.
HttpResponseBuilder	headers(Iterable<? extends Map.Entry<? extends CharSequence,String>> headers)	Adds multiple headers to this response.
HttpResponseBuilder	internalServerError()	Sets 500 Internal Server Error to the status of this response.
HttpResponseBuilder	movedPermanently()	Sets 301 Moved Permanently to the status of this response.
HttpResponseBuilder	notFound()	Sets 404 Not Found to the status of this response.
HttpResponseBuilder	ok()	Sets 200 OK to the status of this response.
HttpResponseBuilder	status(int statusCode)	Sets the status for this response.
HttpResponseBuilder	status(HttpStatus status)	Sets the status for this response.
HttpResponseBuilder	trailers(Iterable<? extends Map.Entry<? extends CharSequence,String>> trailers)	Adds HTTP trailers to this response.
HttpResponseBuilder	unauthorized()	Sets 401 Unauthorized to the status of this response.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

status

public HttpResponseBuilder status(int statusCode)

Sets the status for this response.

status

public HttpResponseBuilder status(HttpStatus status)

Sets the status for this response.

ok

public HttpResponseBuilder ok()

Sets 200 OK to the status of this response.

created

public HttpResponseBuilder created()

Sets 201 Created to the status of this response.

movedPermanently

public HttpResponseBuilder movedPermanently()

Sets 301 Moved Permanently to the status of this response.

badRequest

public HttpResponseBuilder badRequest()

Sets 400 Bad Request to the status of this response.

unauthorized

public HttpResponseBuilder unauthorized()

Sets 401 Unauthorized to the status of this response.

forbidden

public HttpResponseBuilder forbidden()

Sets 403 Forbidden to the status of this response.

notFound

public HttpResponseBuilder notFound()

Sets 404 Not Found to the status of this response.

internalServerError

public HttpResponseBuilder internalServerError()

Sets 500 Internal Server Error to the status of this response.

badGateway

public HttpResponseBuilder badGateway()

Sets 502 Bad Gateway to the status of this response.

content

public HttpResponseBuilder content(String content)

Sets the content as UTF_8 for this response.

content

public HttpResponseBuilder content(MediaType contentType,
 CharSequence content)

Sets the content for this response.

content

public HttpResponseBuilder content(MediaType contentType,
 String content)

Sets the content for this response.

content

@FormatMethod
public HttpResponseBuilder content(@FormatString
 String format,
 Object... content)

Sets the content as UTF_8 for this response. The content is formatted by String.format(Locale, String, Object...) with English locale.

content

@FormatMethod
public HttpResponseBuilder content(MediaType contentType,
 @FormatString
 String format,
 Object... content)

Sets the content for this response. The content is formatted by String.format(Locale, String, Object...) with English locale.

content

public HttpResponseBuilder content(MediaType contentType,
 byte[] content)

Sets the content for this response. The content will be wrapped using HttpData.wrap(byte[]), so any changes made to content will be reflected in the response.

content

public HttpResponseBuilder content(MediaType contentType,
 HttpData content)

Sets the content for this response.

content

public HttpResponseBuilder content(MediaType contentType,
 org.reactivestreams.Publisher<? extends HttpData> content)

Sets the Publisher for this response.

contentJson

public HttpResponseBuilder contentJson(Object content)

Sets the content for this response. The content is converted into JSON format using the default ObjectMapper.

header

public HttpResponseBuilder header(CharSequence name,
 Object value)

Adds a header to this response. For example:

 HttpResponse.builder()
             .ok()
             .content("Hello, Armeria")
             .header("Server", "foo")
             .build();
 

headers

public HttpResponseBuilder headers(Iterable<? extends Map.Entry<? extends CharSequence,String>> headers)

Adds multiple headers to this response. For example:

 HttpResponse.builder()
             .ok()
             .content("Hello, Armeria")
             .headers(HttpHeaders.of("x-test-header", "foo", "Server", "baz"))
             .build();
 

See Also:

• HttpHeaders

trailers

public HttpResponseBuilder trailers(Iterable<? extends Map.Entry<? extends CharSequence,String>> trailers)

Adds HTTP trailers to this response.

build

public HttpResponse build()

Builds the response.