org.codehaus.groovy.grails.web.mapping

Class AbstractUrlMapping

java.lang.Object

org.codehaus.groovy.grails.web.mapping.AbstractUrlMapping

All Implemented Interfaces:

java.lang.Comparable, UrlCreator, UrlMapping

Direct Known Subclasses:

RegexUrlMapping, ResponseCodeUrlMapping

public abstract class AbstractUrlMapping
extends java.lang.Object
implements UrlMapping

Abstract UrlMapping implementation that provides common basic functionality.

Since:

0.5.5

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.Object	actionName
protected org.codehaus.groovy.grails.validation.ConstrainedProperty[]	constraints
protected java.lang.Object	controllerName
protected java.lang.Object	forwardURI
protected java.lang.String	httpMethod
protected java.lang.String	mappingName
protected java.lang.Object	namespace
protected java.util.Map	parameterValues
protected boolean	parseRequest
protected java.lang.Object	pluginName
protected java.lang.Object	redirectInfo
protected boolean	restful
protected javax.servlet.ServletContext	servletContext
protected java.lang.String	version
protected java.lang.Object	viewName

Fields inherited from interface org.codehaus.groovy.grails.web.mapping.UrlMapping

ACTION, AMPERSAND, ANY_HTTP_METHOD, ANY_VERSION, CAPTURED_DOUBLE_WILDCARD, CAPTURED_WILDCARD, CONTROLLER, DOUBLE_WILDCARD, HTTP_METHOD, NAMESPACE, OPTIONAL_EXTENSION_WILDCARD, PLUGIN, QUESTION_MARK, REDIRECT_INFO, SLASH, URI, VERSION, WILDCARD

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractUrlMapping(java.lang.Object viewName, org.codehaus.groovy.grails.validation.ConstrainedProperty[] constraints, javax.servlet.ServletContext servletContext)
	AbstractUrlMapping(java.lang.Object redirectInfo, java.lang.Object controllerName, java.lang.Object actionName, java.lang.Object namespace, java.lang.Object pluginName, java.lang.Object viewName, org.codehaus.groovy.grails.validation.ConstrainedProperty[] constraints, javax.servlet.ServletContext servletContext) Base constructor required to construct a UrlMapping instance
protected	AbstractUrlMapping(java.net.URI uri, org.codehaus.groovy.grails.validation.ConstrainedProperty[] constraints, javax.servlet.ServletContext servletContext)

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	getActionName() Retrieves the action name which is either a groovy.lang.Closure that evaluates the action name at runtime or a java.lang.String that represents the action name
org.codehaus.groovy.grails.validation.ConstrainedProperty[]	getConstraints() The constraints the apply to this UrlMapping.
java.lang.Object	getControllerName() Retrieves the controller name which is either a groovy.lang.Closure that evaluates the controller name at runtime or a java.lang.String that represents the controller name
java.lang.String	getHttpMethod() The HTTP method this URL mapping applies to.
java.lang.String	getMappingName() The name of the mapping in case of named URL mapping
java.lang.Object	getNamespace()
java.lang.Object	getPluginName() The name of the plugin this URL mapping relates to, if any
java.lang.Object	getRedirectInfo() The redirect information should be a String or a Map.
java.lang.String	getVersion()
java.lang.Object	getViewName() Returns the name of the view to map to
boolean	hasRuntimeVariable(java.lang.String name) Whether the mapping has a runtime variable with the given name such as "/$foo"
boolean	isRestfulMapping()
void	setMappingName(java.lang.String name) Sets the name of the URL mapping
void	setParameterValues(java.util.Map parameterValues) Sets any parameter values that should be populated into the request
void	setParseRequest(boolean shouldParse) Sets whether this UrlMapping should parse the request
void	setRestfulMapping(boolean isREST)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.codehaus.groovy.grails.web.mapping.UrlMapping

getUrlData, match

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface org.codehaus.groovy.grails.web.mapping.UrlCreator

createRelativeURL, createRelativeURL, createRelativeURL, createRelativeURL, createRelativeURL, createURL, createURL, createURL, createURL, createURL, createURL, createURL

Field Detail

constraints

protected final org.codehaus.groovy.grails.validation.ConstrainedProperty[] constraints

controllerName

protected java.lang.Object controllerName

actionName

protected java.lang.Object actionName

namespace

protected java.lang.Object namespace

pluginName

protected java.lang.Object pluginName

viewName

protected java.lang.Object viewName

forwardURI

protected java.lang.Object forwardURI

redirectInfo

protected java.lang.Object redirectInfo

servletContext

protected javax.servlet.ServletContext servletContext

parameterValues

protected java.util.Map parameterValues

parseRequest

protected boolean parseRequest

mappingName

protected java.lang.String mappingName

restful

protected boolean restful

httpMethod

protected java.lang.String httpMethod

version

protected java.lang.String version

Constructor Detail

AbstractUrlMapping

public AbstractUrlMapping(java.lang.Object redirectInfo,
                  java.lang.Object controllerName,
                  java.lang.Object actionName,
                  java.lang.Object namespace,
                  java.lang.Object pluginName,
                  java.lang.Object viewName,
                  org.codehaus.groovy.grails.validation.ConstrainedProperty[] constraints,
                  javax.servlet.ServletContext servletContext)

Base constructor required to construct a UrlMapping instance

Parameters:

controllerName - The name of the controller

actionName - The name of the action

constraints - Any constraints that apply to the mapping

servletContext -

AbstractUrlMapping

protected AbstractUrlMapping(java.lang.Object viewName,
                  org.codehaus.groovy.grails.validation.ConstrainedProperty[] constraints,
                  javax.servlet.ServletContext servletContext)

AbstractUrlMapping

protected AbstractUrlMapping(java.net.URI uri,
                  org.codehaus.groovy.grails.validation.ConstrainedProperty[] constraints,
                  javax.servlet.ServletContext servletContext)

Method Detail

getHttpMethod

public java.lang.String getHttpMethod()

Description copied from interface: UrlMapping

The HTTP method this URL mapping applies to. Will be null for all HTTP methods

Specified by:

getHttpMethod in interface UrlMapping

Returns:

The HTTP method

getVersion

public java.lang.String getVersion()

Specified by:

getVersion in interface UrlMapping

Returns:

The version of the URL mapping. Used for versioning of REST services

getConstraints

public org.codehaus.groovy.grails.validation.ConstrainedProperty[] getConstraints()

Description copied from interface: UrlMapping

The constraints the apply to this UrlMapping. Each constraint maps to a GString token in a URL mapping in order. For example consider the URL:

 
     /blog/$author/$title/$year?/$month?/$day?
 

This results in 5 ConstrainedProperty instances called author, title, year, month and day

Specified by:

getConstraints in interface UrlMapping

Returns:

An array containing the ConstrainedProperty objects of this URLMapping

See Also:

UrlMapping.getConstraints()

getControllerName

public java.lang.Object getControllerName()

Description copied from interface: UrlMapping

Retrieves the controller name which is either a groovy.lang.Closure that evaluates the controller name at runtime or a java.lang.String that represents the controller name

Specified by:

getControllerName in interface UrlMapping

Returns:

The controller name as a Closure or String

See Also:

UrlMapping.getControllerName()

getActionName

public java.lang.Object getActionName()

Description copied from interface: UrlMapping

Retrieves the action name which is either a groovy.lang.Closure that evaluates the action name at runtime or a java.lang.String that represents the action name

Specified by:

getActionName in interface UrlMapping

Returns:

The action name as a Closure or String

See Also:

UrlMapping.getActionName()

getPluginName

public java.lang.Object getPluginName()

Description copied from interface: UrlMapping

The name of the plugin this URL mapping relates to, if any

Specified by:

getPluginName in interface UrlMapping

Returns:

The plugin name

getNamespace

public java.lang.Object getNamespace()

Specified by:

getNamespace in interface UrlMapping

Returns:

the name of the controller namespace

getViewName

public java.lang.Object getViewName()

Description copied from interface: UrlMapping

Returns the name of the view to map to

Specified by:

getViewName in interface UrlMapping

Returns:

The view name

See Also:

UrlMapping.getViewName()

setParameterValues

public void setParameterValues(java.util.Map parameterValues)

Description copied from interface: UrlMapping

Sets any parameter values that should be populated into the request

Specified by:

setParameterValues in interface UrlMapping

Parameters:

parameterValues - The parameter values to set

setParseRequest

public void setParseRequest(boolean shouldParse)

Description copied from interface: UrlMapping

Sets whether this UrlMapping should parse the request

Specified by:

setParseRequest in interface UrlMapping

Parameters:

shouldParse - True if it should

getMappingName

public java.lang.String getMappingName()

Description copied from interface: UrlMapping

The name of the mapping in case of named URL mapping

Specified by:

getMappingName in interface UrlMapping

Returns:

The mapping name

setMappingName

public void setMappingName(java.lang.String name)

Description copied from interface: UrlMapping

Sets the name of the URL mapping

Specified by:

setMappingName in interface UrlMapping

Parameters:

name - The name of the URL mapping

setRestfulMapping

public void setRestfulMapping(boolean isREST)

Specified by:

setRestfulMapping in interface UrlMapping

Parameters:

isREST - Set whether this is a RESTful mapping

isRestfulMapping

public boolean isRestfulMapping()

Specified by:

isRestfulMapping in interface UrlMapping

Returns:

Whether this is a RESTful mapping

hasRuntimeVariable

public boolean hasRuntimeVariable(java.lang.String name)

Description copied from interface: UrlMapping

Whether the mapping has a runtime variable with the given name such as "/$foo"

Specified by:

hasRuntimeVariable in interface UrlMapping

Parameters:

name - The name of the variable

Returns:

true if the mapping has the variable

getRedirectInfo

public java.lang.Object getRedirectInfo()

Description copied from interface: UrlMapping

The redirect information should be a String or a Map. If it is a String that string is the URI to redirect to. If it is a Map, that Map may contain any entries supported as arguments to the dynamic redirect(Map) method on a controller.

Specified by:

getRedirectInfo in interface UrlMapping

Returns:

redirect information for this url mapping