org.codehaus.groovy.grails.commons

Class DefaultGrailsControllerClass

java.lang.Object

org.codehaus.groovy.grails.commons.AbstractGrailsClass

org.codehaus.groovy.grails.commons.AbstractInjectableGrailsClass

org.codehaus.groovy.grails.commons.DefaultGrailsControllerClass

All Implemented Interfaces:

GrailsClass, GrailsControllerClass, InjectableGrailsClass, GrailsApplicationAware, org.springframework.beans.factory.Aware

public class DefaultGrailsControllerClass
extends AbstractInjectableGrailsClass
implements GrailsControllerClass

Evaluates the conventions contained within controllers to perform auto-configuration.

Since:

0.1

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ALLOWED_HTTP_METHODS_PROPERTY
static java.lang.String	CONTROLLER

Fields inherited from class org.codehaus.groovy.grails.commons.AbstractGrailsClass

grailsApplication

Fields inherited from interface org.codehaus.groovy.grails.commons.GrailsControllerClass

AFTER_INTERCEPTOR, BEFORE_INTERCEPTOR, INDEX_ACTION, NAMESPACE_PROPERTY, VIEW

Constructor Summary

Constructors

Constructor and Description
DefaultGrailsControllerClass(java.lang.Class<?> clazz)

Method Summary

Modifier and Type	Method and Description
protected boolean	doCheckIsHttpMethodAllowedForAction(groovy.lang.GroovyObject controller, java.lang.String httpMethod, java.lang.String actionName)
groovy.lang.Closure	getAfterInterceptor(groovy.lang.GroovyObject controller) Retrieves the after interceptor for the specified controller instance.
groovy.lang.Closure	getBeforeInterceptor(groovy.lang.GroovyObject controller) Retrieves the before interceptor for the specified controller instance.
java.util.Set	getCommandObjectActions() Deprecated. This method is deprecated and will be removed in a future version of Grails
java.util.Set	getCommandObjectClasses() Deprecated. This method is deprecated and will be removed in a future version of Grails
java.lang.String	getDefaultAction() Returns the default action for this Controller.
java.util.Map<java.lang.String,groovy.lang.Closure>	getFlows() Returns a map of the flows for this controller.
java.lang.String	getMethodActionName(java.lang.String uri) Returns a closure property name for a specific URI or null if the URI does not map to a closure.
java.lang.String	getNamespace()
java.lang.String[]	getURIs() Gets the list of all possible URI's available in this controller.
java.lang.String	getViewByName(java.lang.String viewName) Retrieves the view name for the specified closure name.
java.lang.String	getViewByURI(java.lang.String uri) Retrieves the view name for the specified URI.
void	initialize() Initialize the controller class
boolean	isFlowAction(java.lang.String actionName) Returns true if the given action name is a flow action.
boolean	isHttpMethodAllowedForAction(groovy.lang.GroovyObject controller, java.lang.String httpMethod, java.lang.String actionName) Checks to see if an action is accessible via a particular http method.
boolean	isInterceptedAfter(groovy.lang.GroovyObject controller, java.lang.String action) Checks whether the specified action is intercepted after for the specified controller instance.
boolean	isInterceptedBefore(groovy.lang.GroovyObject controller, java.lang.String action) Checks whether the specified action is intercepted for the specified controller instance.
boolean	mapsToURI(java.lang.String uri) Tests if a controller maps to a given URI.
void	registerMapping(java.lang.String actionName) Registers a new mapping onto this controller for the given actionName.
void	setDefaultActionName(java.lang.String defaultActionName) Sets the name of the default action.

Methods inherited from class org.codehaus.groovy.grails.commons.AbstractInjectableGrailsClass

byName, byType, getAvailable

Methods inherited from class org.codehaus.groovy.grails.commons.AbstractGrailsClass

getClazz, getFullName, getGrailsApplication, getLogicalPropertyName, getMetaClass, getName, getNaturalName, getPackageName, getPropertyDescriptors, getPropertyName, getPropertyOrStaticPropertyOrFieldValue, getPropertyType, getPropertyValue, getPropertyValue, getPropertyValueObject, getReference, getReferenceInstance, getShortName, getStaticPropertyValue, hasMetaMethod, hasMetaMethod, hasMetaProperty, hasProperty, isAbstract, isActionMethod, isReadableProperty, newInstance, setGrailsApplication, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.codehaus.groovy.grails.commons.InjectableGrailsClass

byName, byType, getAvailable

Methods inherited from interface org.codehaus.groovy.grails.commons.GrailsClass

getClazz, getFullName, getGrailsApplication, getLogicalPropertyName, getMetaClass, getName, getNaturalName, getPackageName, getPropertyName, getPropertyValue, getPropertyValue, getReference, getReferenceInstance, getShortName, hasProperty, isAbstract, newInstance

Methods inherited from interface org.codehaus.groovy.grails.plugins.support.aware.GrailsApplicationAware

setGrailsApplication

Field Detail

CONTROLLER

public static final java.lang.String CONTROLLER

See Also:

Constant Field Values

ALLOWED_HTTP_METHODS_PROPERTY

public static final java.lang.String ALLOWED_HTTP_METHODS_PROPERTY

See Also:

Constant Field Values

Constructor Detail

DefaultGrailsControllerClass

public DefaultGrailsControllerClass(java.lang.Class<?> clazz)

Method Detail

setDefaultActionName

public void setDefaultActionName(java.lang.String defaultActionName)

Description copied from interface: GrailsControllerClass

Sets the name of the default action.

Specified by:

setDefaultActionName in interface GrailsControllerClass

Parameters:

defaultActionName - The default action name

initialize

public void initialize()

Description copied from interface: GrailsControllerClass

Initialize the controller class

Specified by:

initialize in interface GrailsControllerClass

getURIs

public java.lang.String[] getURIs()

Description copied from interface: GrailsControllerClass

Gets the list of all possible URI's available in this controller.

Specified by:

getURIs in interface GrailsControllerClass

Returns:

list of all possible URI's

mapsToURI

public boolean mapsToURI(java.lang.String uri)

Description copied from interface: GrailsControllerClass

Tests if a controller maps to a given URI.

Specified by:

mapsToURI in interface GrailsControllerClass

Returns:

true if controller maps to URI

getViewByURI

public java.lang.String getViewByURI(java.lang.String uri)

Description copied from interface: GrailsControllerClass

Retrieves the view name for the specified URI.

Specified by:

getViewByURI in interface GrailsControllerClass

Parameters:

uri - the name of URI

Returns:

the view name of null if not found

getMethodActionName

public java.lang.String getMethodActionName(java.lang.String uri)

Description copied from interface: GrailsControllerClass

Returns a closure property name for a specific URI or null if the URI does not map to a closure.

Specified by:

getMethodActionName in interface GrailsControllerClass

Parameters:

uri - the URI of the request

Returns:

the closure property name mapped to the URI or null is no closure was found

getViewByName

public java.lang.String getViewByName(java.lang.String viewName)

Description copied from interface: GrailsControllerClass

Retrieves the view name for the specified closure name.

Specified by:

getViewByName in interface GrailsControllerClass

Parameters:

viewName - The name of the closure

Returns:

The view for the specified closure action

isInterceptedBefore

public boolean isInterceptedBefore(groovy.lang.GroovyObject controller,
                                   java.lang.String action)

Description copied from interface: GrailsControllerClass

Checks whether the specified action is intercepted for the specified controller instance.

Specified by:

isInterceptedBefore in interface GrailsControllerClass

Parameters:

controller - The instance of the controller

action - The action to check

Returns:

true if it is intercepted

isHttpMethodAllowedForAction

public boolean isHttpMethodAllowedForAction(groovy.lang.GroovyObject controller,
                                            java.lang.String httpMethod,
                                            java.lang.String actionName)

Description copied from interface: GrailsControllerClass

Checks to see if an action is accessible via a particular http method.

Specified by:

isHttpMethodAllowedForAction in interface GrailsControllerClass

Parameters:

controller - The instance of the controller

httpMethod - The http request method

actionName - The action to check

Returns:

true if the action is accessible via the specified http method

doCheckIsHttpMethodAllowedForAction

protected boolean doCheckIsHttpMethodAllowedForAction(groovy.lang.GroovyObject controller,
                                                      java.lang.String httpMethod,
                                                      java.lang.String actionName)

isInterceptedAfter

public boolean isInterceptedAfter(groovy.lang.GroovyObject controller,
                                  java.lang.String action)

Description copied from interface: GrailsControllerClass

Checks whether the specified action is intercepted after for the specified controller instance.

Specified by:

isInterceptedAfter in interface GrailsControllerClass

Parameters:

controller - The controller instance

action - The action to check

Returns:

true if it is intercepted

getBeforeInterceptor

public groovy.lang.Closure getBeforeInterceptor(groovy.lang.GroovyObject controller)

Description copied from interface: GrailsControllerClass

Retrieves the before interceptor for the specified controller instance.

Specified by:

getBeforeInterceptor in interface GrailsControllerClass

Parameters:

controller - The controller instance

Returns:

The before interceptor as a Closure or null if non exists

getAfterInterceptor

public groovy.lang.Closure getAfterInterceptor(groovy.lang.GroovyObject controller)

Description copied from interface: GrailsControllerClass

Retrieves the after interceptor for the specified controller instance.

Specified by:

getAfterInterceptor in interface GrailsControllerClass

Parameters:

controller - The controller instance

Returns:

The after interceptor as a Closure or null if non exists

getCommandObjectActions

@Deprecated
public java.util.Set getCommandObjectActions()

Deprecated. This method is deprecated and will be removed in a future version of Grails

Specified by:

getCommandObjectActions in interface GrailsControllerClass

Returns:

EMPTY_SET until the method is removed

getCommandObjectClasses

@Deprecated
public java.util.Set getCommandObjectClasses()

Deprecated. This method is deprecated and will be removed in a future version of Grails

Specified by:

getCommandObjectClasses in interface GrailsControllerClass

Returns:

EMPTY_SET until the method is removed

getFlows

public java.util.Map<java.lang.String,groovy.lang.Closure> getFlows()

Description copied from interface: GrailsControllerClass

Returns a map of the flows for this controller. A flow is an action that ends with the convention "Flow". The keys in the map are the flow ids which are the text before the "Flow" suffix. For example a flow called "bookFlow" would have a key of "book"

The values within the Map are Groovy closures (@see groovy.lang.Closure) which represent the flow definition

Specified by:

getFlows in interface GrailsControllerClass

Returns:

A Map of flows for this controller

isFlowAction

public boolean isFlowAction(java.lang.String actionName)

Description copied from interface: GrailsControllerClass

Returns true if the given action name is a flow action.

Specified by:

isFlowAction in interface GrailsControllerClass

Parameters:

actionName - The name of the action

Returns:

true if it is a flow action

getDefaultAction

public java.lang.String getDefaultAction()

Description copied from interface: GrailsControllerClass

Returns the default action for this Controller.

Specified by:

getDefaultAction in interface GrailsControllerClass

Returns:

The default action

getNamespace

public java.lang.String getNamespace()

Specified by:

getNamespace in interface GrailsControllerClass

Returns:

the namespace of this controller, null if none was specified

registerMapping

public void registerMapping(java.lang.String actionName)

Description copied from interface: GrailsControllerClass

Registers a new mapping onto this controller for the given actionName.

Specified by:

registerMapping in interface GrailsControllerClass

Parameters:

actionName - The actionName