org.appfuse.webapp.controller

Class BaseFormController

java.lang.Object

org.appfuse.webapp.controller.BaseFormController

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.web.context.ServletContextAware

public class BaseFormController
extends Object
implements org.springframework.web.context.ServletContextAware

Implementation of SimpleFormController that contains convenience methods for subclasses. For example, getting the current user and saving messages/errors. This class is intended to be a base class for all Form controllers.

View Source

Author:

Matt Raible

Field Summary

Fields

Modifier and Type	Field and Description
protected String	cancelView
protected org.apache.commons.logging.Log	log
static String	MESSAGES_KEY
protected String	successView

Constructor Summary

Constructors

Constructor and Description
BaseFormController()

Method Summary

Methods

Modifier and Type	Method and Description
String	getCancelView()
Map	getConfiguration() Convenience method to get the Configuration HashMap from the servlet context.
protected javax.servlet.ServletContext	getServletContext()
String	getSuccessView()
String	getText(String msgKey, Locale locale) Convenience method for getting a i18n key's value.
String	getText(String msgKey, Object[] args, Locale locale) Convenience method for getting a i18n key's value with arguments.
String	getText(String msgKey, String arg, Locale locale) Convenient method for getting a i18n key's value with a single string argument.
protected void	initBinder(javax.servlet.http.HttpServletRequest request, org.springframework.web.bind.ServletRequestDataBinder binder) Set up a custom property editor for converting form inputs to real objects
void	saveError(javax.servlet.http.HttpServletRequest request, String error)
void	saveMessage(javax.servlet.http.HttpServletRequest request, String msg)
BaseFormController	setCancelView(String cancelView)
void	setMessages(org.springframework.context.MessageSource messageSource)
void	setServletContext(javax.servlet.ServletContext servletContext)
BaseFormController	setSuccessView(String successView)

Methods inherited from class java.lang.Object

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

Field Detail

log

protected final transient org.apache.commons.logging.Log log

MESSAGES_KEY

public static final String MESSAGES_KEY

See Also:

Constant Field Values

cancelView

protected String cancelView

successView

protected String successView

Constructor Detail

BaseFormController

public BaseFormController()

Method Detail

setMessages

@Autowired
public void setMessages(org.springframework.context.MessageSource messageSource)

saveError

public void saveError(javax.servlet.http.HttpServletRequest request,
             String error)

saveMessage

public void saveMessage(javax.servlet.http.HttpServletRequest request,
               String msg)

getText

public String getText(String msgKey,
             Locale locale)

Convenience method for getting a i18n key's value. Calling getMessageSourceAccessor() is used because the RequestContext variable is not set in unit tests b/c there's no DispatchServlet Request.

Parameters:

msgKey -

locale - the current locale

Returns:

getText

public String getText(String msgKey,
             String arg,
             Locale locale)

Convenient method for getting a i18n key's value with a single string argument.

Parameters:

msgKey -

arg -

locale - the current locale

Returns:

getText

public String getText(String msgKey,
             Object[] args,
             Locale locale)

Convenience method for getting a i18n key's value with arguments.

Parameters:

msgKey -

args -

locale - the current locale

Returns:

getConfiguration

public Map getConfiguration()

Convenience method to get the Configuration HashMap from the servlet context.

Returns:

the user's populated form from the session

initBinder

@InitBinder
protected void initBinder(javax.servlet.http.HttpServletRequest request,
                         org.springframework.web.bind.ServletRequestDataBinder binder)

Set up a custom property editor for converting form inputs to real objects

Parameters:

request - the current request

binder - the data binder

setCancelView

public final BaseFormController setCancelView(String cancelView)

getCancelView

public final String getCancelView()

getSuccessView

public final String getSuccessView()

setSuccessView

public final BaseFormController setSuccessView(String successView)

setServletContext

public void setServletContext(javax.servlet.ServletContext servletContext)

Specified by:

setServletContext in interface org.springframework.web.context.ServletContextAware

getServletContext

protected javax.servlet.ServletContext getServletContext()