org.codehaus.groovy.grails.web.mapping
Interface UrlMappingsHolder

public interface UrlMappingsHolder

Main entry point of Grails URL mapping mechanism. This interface defines methods to match URLs and create reverse mappings based on the UrlMapping instances the implementor contains.

Since:

0.5

Field Summary

static java.lang.String

BEAN_ID

Method Summary

java.util.List	getExcludePatterns() Retrieves the held Exclude Pattern instances as a list, could be null if there is no exclude
UrlCreator	getReverseMapping(java.lang.String controller, java.lang.String action, java.util.Map params) Retrieves the best guess of a URI for the given controller, action and parameters
UrlCreator	getReverseMappingNoDefault(java.lang.String controller, java.lang.String action, java.util.Map params) Retrieves the best guess of a URI for the given controller, action and parameters or null if non could be found.
UrlMapping[]	getUrlMappings() Retrieves the held UrlMapping instances as an array
UrlMappingInfo	match(java.lang.String uri) Match and return the first UrlMappingInfo instance possible
UrlMappingInfo[]	matchAll(java.lang.String uri) Matches all possible UrlMappingInfo instances to the given URI and returns them all
UrlMappingInfo[]	matchAll(java.lang.String uri, java.lang.String httpMethod) Match all possible UrlMappingInfo instances to the given URI and HTTP method
UrlMappingInfo	matchStatusCode(int responseCode) Match and return the first UrlMappingInfo instance possible
UrlMappingInfo	matchStatusCode(int responseCode, java.lang.Throwable e) Match and return for first UrlMappingInfo for the give response code and exception

Field Detail

BEAN_ID

static final java.lang.String BEAN_ID

See Also:

Constant Field Values

Method Detail

getUrlMappings

UrlMapping[] getUrlMappings()

Retrieves the held UrlMapping instances as an array

Returns:

An array of UrlMapping instances

getExcludePatterns

java.util.List getExcludePatterns()

Retrieves the held Exclude Pattern instances as a list, could be null if there is no exclude

Returns:

An list of String

getReverseMapping

UrlCreator getReverseMapping(java.lang.String controller,
                             java.lang.String action,
                             java.util.Map params)

Retrieves the best guess of a URI for the given controller, action and parameters

Parameters:

controller - The name of the controller

action - The name of the action or null

params - The parameters or null

Returns:

A URI for the given arguments

getReverseMappingNoDefault

UrlCreator getReverseMappingNoDefault(java.lang.String controller,
                                      java.lang.String action,
                                      java.util.Map params)

Retrieves the best guess of a URI for the given controller, action and parameters or null if non could be found.

Parameters:

controller - The name of the controller

action - The name of the action or null

params - The parameters or null

Returns:

A URI for the given arguments

match

UrlMappingInfo match(java.lang.String uri)

Match and return the first UrlMappingInfo instance possible

Parameters:

uri - The URI to match

Returns:

A UrlMappingInfo or null

matchAll

UrlMappingInfo[] matchAll(java.lang.String uri)

Matches all possible UrlMappingInfo instances to the given URI and returns them all

Parameters:

uri - The URI to match

Returns:

An array of 0 or many UrlMappngInfo instances

matchAll

UrlMappingInfo[] matchAll(java.lang.String uri,
                          java.lang.String httpMethod)

Match all possible UrlMappingInfo instances to the given URI and HTTP method

Parameters:

uri - The URI to match

httpMethod - The HTTP method (GET,POST,PUT,DELETE etc.)

Returns:

An array of 0 or many UrlMappingInfo instances

matchStatusCode

UrlMappingInfo matchStatusCode(int responseCode)

Match and return the first UrlMappingInfo instance possible

Parameters:

responseCode - The responseCode to match

Returns:

A UrlMappingInfo or null

matchStatusCode

UrlMappingInfo matchStatusCode(int responseCode,
                               java.lang.Throwable e)

Match and return for first UrlMappingInfo for the give response code and exception

Parameters:

responseCode - The response code

e - The exception

Returns:

The UrlMappingInfo instance