org.bonitasoft.web.extension.rest

Class RestApiResponseBuilder

java.lang.Object

org.bonitasoft.console.common.server.page.RestApiResponseBuilder

org.bonitasoft.web.extension.rest.RestApiResponseBuilder

public class RestApiResponseBuilder
extends RestApiResponseBuilder

Build a RestApiResponse specifying response body, status and other HTTP attributes.

Field Summary

Fields inherited from class org.bonitasoft.console.common.server.page.RestApiResponseBuilder

additionalCookies, additionalHeaders, characterSet, httpStatus, mediaType, response

Constructor Summary

Constructors

Constructor and Description
RestApiResponseBuilder()

Method Summary

Modifier and Type	Method and Description
RestApiResponse	build()
RestApiResponseBuilder	withAdditionalCookie(javax.servlet.http.Cookie cookie) Adds a cookie to the HTTP response
RestApiResponseBuilder	withAdditionalHeader(String name, String value) Adds a header in the HTTP response
RestApiResponseBuilder	withCharacterSet(String characterSet) Set the character set of the HTTP response.
RestApiResponseBuilder	withContentRange(int pageIndex, int pageSize) When returning a paged result, sets the start index and the page size.
RestApiResponseBuilder	withContentRange(int pageIndex, int pageSize, long totalSize) When returning a paged result, sets the start index, the page size and the total size.
RestApiResponseBuilder	withMediaType(String mediaType) Set the media type of the HTTP response body.
RestApiResponseBuilder	withResponse(Serializable response) Set the body of the response
RestApiResponseBuilder	withResponseStatus(int httpStatus) Set the HTTP status of the response.

Methods inherited from class java.lang.Object

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

Constructor Detail

RestApiResponseBuilder

public RestApiResponseBuilder()

Method Detail

withResponse

public RestApiResponseBuilder withResponse(Serializable response)

Set the body of the response

Overrides:

withResponse in class RestApiResponseBuilder

Parameters:

response - the response body

withResponseStatus

public RestApiResponseBuilder withResponseStatus(int httpStatus)

Set the HTTP status of the response. By default, OK status (200) is set.

Overrides:

withResponseStatus in class RestApiResponseBuilder

Parameters:

httpStatus - the HTTP status of the response

See Also:

HttpServletResponse

withAdditionalHeader

public RestApiResponseBuilder withAdditionalHeader(String name,
                                                   String value)

Adds a header in the HTTP response

Overrides:

withAdditionalHeader in class RestApiResponseBuilder

Parameters:

name - the name of the header to add in the response.

value - the value for this header

See Also:

HttpHeaders

withAdditionalCookie

public RestApiResponseBuilder withAdditionalCookie(javax.servlet.http.Cookie cookie)

Adds a cookie to the HTTP response

Overrides:

withAdditionalCookie in class RestApiResponseBuilder

Parameters:

cookie - the Cookie to add to the response

withCharacterSet

public RestApiResponseBuilder withCharacterSet(String characterSet)

Set the character set of the HTTP response. By default UTF-8 is set.

Overrides:

withCharacterSet in class RestApiResponseBuilder

Parameters:

characterSet - the name of the character set

See Also:

Charset

withMediaType

public RestApiResponseBuilder withMediaType(String mediaType)

Set the media type of the HTTP response body. By default "application/json" is set.

Overrides:

withMediaType in class RestApiResponseBuilder

Parameters:

mediaType - the media type to set.

See Also:

Registered media types

withContentRange

public RestApiResponseBuilder withContentRange(int pageIndex,
                                               int pageSize)

When returning a paged result, sets the start index and the page size. Setting content range overrides the Content-Range header of the response.

Parameters:

pageIndex - the start index of the returned page.

pageSize - the size of the returned page.

Returns:

the RestApiResponseBuilder

withContentRange

public RestApiResponseBuilder withContentRange(int pageIndex,
                                               int pageSize,
                                               long totalSize)

When returning a paged result, sets the start index, the page size and the total size. Setting content range overrides the Content-Range header of the response.

Parameters:

pageIndex - the start index of the returned page.

pageSize - the size of the returned page.

totalSize - the total size of the requested entity.

Returns:

the RestApiResponseBuilder

build

public RestApiResponse build()

Overrides:

build in class RestApiResponseBuilder

Returns:

the RestApiResponse response