org.codehaus.groovy.grails.plugins.web.api
Class ControllersApi

java.lang.Object
  org.codehaus.groovy.grails.plugins.web.api.CommonWebApi
      org.codehaus.groovy.grails.plugins.web.api.ControllersApi

All Implemented Interfaces:

java.io.Serializable, org.codehaus.groovy.grails.plugins.support.aware.GrailsApplicationAware, org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware, org.springframework.web.context.ServletContextAware

public class ControllersApi
extends org.codehaus.groovy.grails.plugins.web.api.CommonWebApi
implements java.io.Serializable

API for each controller in a Grails application.

Since:

2.0

See Also:

Serialized Form

Constructor Summary

ControllersApi()

ControllersApi(org.codehaus.groovy.grails.plugins.GrailsPluginManager pluginManager)

Method Summary

java.lang.Object	bindData(java.lang.Object instance, java.lang.Object target, java.lang.Object args)
java.lang.Object	bindData(java.lang.Object instance, java.lang.Object target, java.lang.Object args, java.util.List disallowed)
java.lang.Object	bindData(java.lang.Object instance, java.lang.Object target, java.lang.Object args, java.util.List disallowed, java.lang.String filter)
java.lang.Object	bindData(java.lang.Object instance, java.lang.Object target, java.lang.Object args, java.util.Map includeExclude)
java.lang.Object	bindData(java.lang.Object instance, java.lang.Object target, java.lang.Object args, java.util.Map includeExclude, java.lang.String filter)
java.lang.Object	bindData(java.lang.Object instance, java.lang.Object target, java.lang.Object args, java.lang.String filter)
java.lang.Object	chain(java.lang.Object instance, java.util.Map args) Invokes the chain method for the given arguments
java.lang.String	forward(java.lang.Object instance, java.util.Map params) Forwards a request for the given parameters using the RequestDispatchers forward method
java.lang.String	getActionUri(java.lang.Object instance) Returns the URI of the currently executing action
java.util.Map	getChainModel(java.lang.Object instance) Obtains the chain model which is used to chain request attributes from one request to the next via flash scope
java.lang.String	getControllerUri(java.lang.Object instance) Returns the URI of the currently executing controller
org.springframework.validation.Errors	getErrors(java.lang.Object instance) Obtains the errors instance for the current controller
org.springframework.web.servlet.ModelAndView	getModelAndView(java.lang.Object instance) Obtains the ModelAndView for the currently executing controller
static org.springframework.context.ApplicationContext	getStaticApplicationContext()
java.lang.String	getTemplateUri(java.lang.Object instance, java.lang.String name) Obtains a URI of a template by name
java.lang.String	getViewUri(java.lang.Object instance, java.lang.String name) Obtains a URI of a view by name
boolean	hasErrors(java.lang.Object instance) Return true if there are an errors
void	header(java.lang.Object instance, java.lang.String headerName, java.lang.Object headerValue) Sets a response header for the given name and value
static void	initialize(java.lang.Object instance) Constructor used by controllers
java.lang.Object	redirect(java.lang.Object instance, java.util.Map args) Redirects for the given arguments.
java.lang.Object	render(java.lang.Object instance, groovy.lang.Closure c)
java.lang.Object	render(java.lang.Object instance, java.util.Map args)
java.lang.Object	render(java.lang.Object instance, java.util.Map args, groovy.lang.Closure c)
java.lang.Object	render(java.lang.Object instance, java.lang.Object o)
java.lang.Object	render(java.lang.Object instance, java.lang.String txt)
void	setErrors(java.lang.Object instance, org.springframework.validation.Errors errors) Sets the errors instance of the current controller
void	setGspEncoding(java.lang.String gspEncoding)
void	setLinkGenerator(org.codehaus.groovy.grails.web.mapping.LinkGenerator linkGenerator)
void	setModelAndView(java.lang.Object instance, org.springframework.web.servlet.ModelAndView mav) Sets the ModelAndView of the current controller
void	setRedirectListeners(java.util.Collection<org.codehaus.groovy.grails.web.servlet.mvc.RedirectEventListener> redirectListeners)
void	setUseJessionId(boolean useJessionId)
java.lang.Object	withForm(java.lang.Object instance, groovy.lang.Closure callable) Used the synchronizer token pattern to avoid duplicate form submissions

Methods inherited from class org.codehaus.groovy.grails.plugins.web.api.CommonWebApi

getActionName, getApplicationContext, getControllerName, getFlash, getGrailsApplication, getGrailsAttributes, getParams, getPluginContextPath, getRequest, getResponse, getServletContext, getSession, getWebRequest, setApplicationContext, setGrailsApplication, setServletContext

Methods inherited from class java.lang.Object

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

Constructor Detail

ControllersApi

public ControllersApi()

ControllersApi

public ControllersApi(org.codehaus.groovy.grails.plugins.GrailsPluginManager pluginManager)

Method Detail

getStaticApplicationContext

public static org.springframework.context.ApplicationContext getStaticApplicationContext()

setGspEncoding

public void setGspEncoding(java.lang.String gspEncoding)

setRedirectListeners

public void setRedirectListeners(java.util.Collection<org.codehaus.groovy.grails.web.servlet.mvc.RedirectEventListener> redirectListeners)

setUseJessionId

public void setUseJessionId(boolean useJessionId)

setLinkGenerator

public void setLinkGenerator(org.codehaus.groovy.grails.web.mapping.LinkGenerator linkGenerator)

initialize

public static void initialize(java.lang.Object instance)

Constructor used by controllers

Parameters:

instance - The instance

getActionUri

public java.lang.String getActionUri(java.lang.Object instance)

Returns the URI of the currently executing action

Returns:

The action URI

getControllerUri

public java.lang.String getControllerUri(java.lang.Object instance)

Returns the URI of the currently executing controller

Returns:

The controller URI

getTemplateUri

public java.lang.String getTemplateUri(java.lang.Object instance,
                                       java.lang.String name)

Obtains a URI of a template by name

Parameters:

name - The name of the template

Returns:

The template URI

getViewUri

public java.lang.String getViewUri(java.lang.Object instance,
                                   java.lang.String name)

Obtains a URI of a view by name

Parameters:

name - The name of the view

Returns:

The template URI

setErrors

public void setErrors(java.lang.Object instance,
                      org.springframework.validation.Errors errors)

Sets the errors instance of the current controller

Parameters:

errors - The error instance

getErrors

public org.springframework.validation.Errors getErrors(java.lang.Object instance)

Obtains the errors instance for the current controller

Returns:

The Errors instance

setModelAndView

public void setModelAndView(java.lang.Object instance,
                            org.springframework.web.servlet.ModelAndView mav)

Sets the ModelAndView of the current controller

Parameters:

mav - The ModelAndView

getModelAndView

public org.springframework.web.servlet.ModelAndView getModelAndView(java.lang.Object instance)

Obtains the ModelAndView for the currently executing controller

Returns:

The ModelAndView

getChainModel

public java.util.Map getChainModel(java.lang.Object instance)

Obtains the chain model which is used to chain request attributes from one request to the next via flash scope

Returns:

The chainModel

hasErrors

public boolean hasErrors(java.lang.Object instance)

Return true if there are an errors

Returns:

True if there are errors

redirect

public java.lang.Object redirect(java.lang.Object instance,
                                 java.util.Map args)

Redirects for the given arguments.

Parameters:

args - The arguments

Returns:

null

chain

public java.lang.Object chain(java.lang.Object instance,
                              java.util.Map args)

Invokes the chain method for the given arguments

Parameters:

instance - The instance

args - The arguments

Returns:

Result of the redirect call

render

public java.lang.Object render(java.lang.Object instance,
                               java.lang.Object o)

render

public java.lang.Object render(java.lang.Object instance,
                               java.lang.String txt)

render

public java.lang.Object render(java.lang.Object instance,
                               java.util.Map args)

render

public java.lang.Object render(java.lang.Object instance,
                               groovy.lang.Closure c)

render

public java.lang.Object render(java.lang.Object instance,
                               java.util.Map args,
                               groovy.lang.Closure c)

bindData

public java.lang.Object bindData(java.lang.Object instance,
                                 java.lang.Object target,
                                 java.lang.Object args)

bindData

public java.lang.Object bindData(java.lang.Object instance,
                                 java.lang.Object target,
                                 java.lang.Object args,
                                 java.util.List disallowed)

bindData

public java.lang.Object bindData(java.lang.Object instance,
                                 java.lang.Object target,
                                 java.lang.Object args,
                                 java.util.List disallowed,
                                 java.lang.String filter)

bindData

public java.lang.Object bindData(java.lang.Object instance,
                                 java.lang.Object target,
                                 java.lang.Object args,
                                 java.util.Map includeExclude)

bindData

public java.lang.Object bindData(java.lang.Object instance,
                                 java.lang.Object target,
                                 java.lang.Object args,
                                 java.util.Map includeExclude,
                                 java.lang.String filter)

bindData

public java.lang.Object bindData(java.lang.Object instance,
                                 java.lang.Object target,
                                 java.lang.Object args,
                                 java.lang.String filter)

header

public void header(java.lang.Object instance,
                   java.lang.String headerName,
                   java.lang.Object headerValue)

Sets a response header for the given name and value

Parameters:

instance - The instance

headerName - The header name

headerValue - The header value

withForm

public java.lang.Object withForm(java.lang.Object instance,
                                 groovy.lang.Closure callable)

Used the synchronizer token pattern to avoid duplicate form submissions

Parameters:

instance - The instance

callable - The closure to execute

Returns:

The result of the closure execution

forward

public java.lang.String forward(java.lang.Object instance,
                                java.util.Map params)

Forwards a request for the given parameters using the RequestDispatchers forward method

Parameters:

instance - The instance

params - The parameters

Returns:

The forwarded URL