ch.ralscha.extdirectspring.bean

Class ExtDirectResponseBuilder

java.lang.Object

ch.ralscha.extdirectspring.bean.ExtDirectResponseBuilder

public class ExtDirectResponseBuilder
extends Object

An utility class that helps building the response for a FORM_POST method. The response is written directly into the ServletResponse.getOutputStream() with buildAndWrite().

Author:

Ralph Schaer

Constructor Summary

Constructors

Constructor and Description
ExtDirectResponseBuilder(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Creates a builder that builds and writes the response of a FORM_POST method.

Method Summary

Methods

Modifier and Type	Method and Description
ExtDirectResponseBuilder	addErrors(org.springframework.validation.BindingResult bindingResult) Adds an "errors" property in the response if there are any errors in the bindingResult.
ExtDirectResponseBuilder	addErrors(Locale locale, org.springframework.context.MessageSource messageSource, org.springframework.validation.BindingResult bindingResult) Adds an "errors" property in the response if there are any errors in the bindingResult.
ExtDirectResponseBuilder	addResultProperty(String key, Object value) Add additional property to the response.
void	buildAndWrite() Builds and writes the response into the OutputStream of HttpServletResponse.
static ExtDirectResponseBuilder	create(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Creates a builder instance.
ExtDirectResponseBuilder	setException(Exception exception) Creates an "exception" response.
ExtDirectResponseBuilder	setSuccess(boolean flag) Sets success flag to the provided parameter.
ExtDirectResponseBuilder	successful() Sets success flag to true.
ExtDirectResponseBuilder	unsuccessful() Sets success flag to false.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExtDirectResponseBuilder

public ExtDirectResponseBuilder(javax.servlet.http.HttpServletRequest request,
                        javax.servlet.http.HttpServletResponse response)

Creates a builder that builds and writes the response of a FORM_POST method. Sets the successful flag to true, can be changed with the successful() and unsuccessful() methods.

Parameters:

request - the current http servlet request object

response - the current http servlet response object

Method Detail

create

public static ExtDirectResponseBuilder create(javax.servlet.http.HttpServletRequest request,
                              javax.servlet.http.HttpServletResponse response)

Creates a builder instance.

Parameters:

request - the current http servlet request object

response - the current http servlet response object

Returns:

the created builder instance

See Also:

ExtDirectResponseBuilder(HttpServletRequest, HttpServletResponse)

setException

public ExtDirectResponseBuilder setException(Exception exception)

Creates an "exception" response. Calls BaseResponse.setType(String) with a value of "exception". Calls BaseResponse.setMessage(String) and BaseResponse.setWhere(String) according to the Configuration. This is a method primarly used for implementations of HandlerExceptionResolver.

Parameters:

exception - the exception that was thrown.

Returns:

this instance

addErrors

public ExtDirectResponseBuilder addErrors(org.springframework.validation.BindingResult bindingResult)

Adds an "errors" property in the response if there are any errors in the bindingResult. Sets the success flag to false if there are errors.

Parameters:

bindingResult -

Returns:

this instance

addErrors

public ExtDirectResponseBuilder addErrors(Locale locale,
                                 org.springframework.context.MessageSource messageSource,
                                 org.springframework.validation.BindingResult bindingResult)

Adds an "errors" property in the response if there are any errors in the bindingResult. Sets the success flag to false if there are errors.

Parameters:

locale -

messageSource -

bindingResult -

Returns:

this instance

addResultProperty

public ExtDirectResponseBuilder addResultProperty(String key,
                                         Object value)

Add additional property to the response.

Parameters:

key - the key of the property

value - the value of this property

Returns:

this instance

successful

public ExtDirectResponseBuilder successful()

Sets success flag to true.

Returns:

this instance

unsuccessful

public ExtDirectResponseBuilder unsuccessful()

Sets success flag to false.

Returns:

this instance

setSuccess

public ExtDirectResponseBuilder setSuccess(boolean flag)

Sets success flag to the provided parameter.

Parameters:

flag - the new success value

Returns:

this instance

buildAndWrite

public void buildAndWrite()

Builds and writes the response into the OutputStream of HttpServletResponse. This methods has to be called at the end of a FORM_POST method.