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

Direct Known Subclasses:

FileUploadController, SignupController, UserFormController

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

protected String	cancelView
protected org.apache.commons.logging.Log	log
protected MailEngine	mailEngine
protected org.springframework.mail.SimpleMailMessage	message
static String	MESSAGES_KEY
protected String	successView
protected String	templateName

Constructor Summary

BaseFormController()

Method Summary

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.
UserManager	getUserManager()
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)
protected void	sendUserMessage(org.appfuse.model.User user, String msg, String url) Convenience message to send messages to users, includes app URL as footer.
BaseFormController	setCancelView(String cancelView)
void	setMailEngine(MailEngine mailEngine)
void	setMessage(org.springframework.mail.SimpleMailMessage message)
void	setMessages(org.springframework.context.MessageSource messageSource)
void	setServletContext(javax.servlet.ServletContext servletContext)
BaseFormController	setSuccessView(String successView)
void	setTemplateName(String templateName)
void	setUserManager(UserManager userManager)

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

mailEngine

protected MailEngine mailEngine

message

protected org.springframework.mail.SimpleMailMessage message

templateName

protected String templateName

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)

setUserManager

@Autowired
public void setUserManager(UserManager userManager)

getUserManager

public UserManager getUserManager()

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

sendUserMessage

protected void sendUserMessage(org.appfuse.model.User user,
                               String msg,
                               String url)

Convenience message to send messages to users, includes app URL as footer.

Parameters:

user - the user to send a message to.

msg - the message to send.

url - the URL of the application.

setMailEngine

@Autowired
public void setMailEngine(MailEngine mailEngine)

setMessage

@Autowired
public void setMessage(org.springframework.mail.SimpleMailMessage message)

setTemplateName

public void setTemplateName(String templateName)

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()