RegexUrlMapping (Grace Framework

org.grails.web.mapping.RegexUrlMapping

```
@SuppressWarnings("rawtypes")
public class RegexUrlMapping
extends AbstractUrlMapping
```
A UrlMapping implementation that takes a Grails URL pattern and turns it into a regex matcher so that URLs can be matched and information captured from the match.

A Grails URL pattern is not a regex, but is an extension to the form defined by Apache Ant and used by Spring AntPathMatcher. Unlike regular Ant paths Grails URL patterns allow for capturing groups in the form:

/blog/(*)/**

The parenthesis define a capturing group. This implementation transforms regular Ant paths into regular expressions that are able to use capturing groups

Authors:
Graeme Rocher
See Also:
org.springframework.util.AntPathMatcher
Since:
0.5

Field Summary

Fields
Modifiers	Name	Description
`static Pattern`	`DOUBLE_WILDCARD_PATTERN`
`static String`	`FORMAT_PARAMETER`
`static Pattern`	`OPTIONAL_EXTENSION_WILDCARD_PATTERN`

Inherited fields
Fields inherited from class	Fields
`class AbstractUrlMapping`	`actionName, constraints, controllerName, forwardURI, grailsApplication, httpMethod, mappingName, namespace, parameterValues, parseRequest, pluginIndex, pluginName, redirectInfo, servletContext, version, viewName`

Constructor Summary

Constructors
Constructor and description
`RegexUrlMapping(UrlMappingData data, URI uri, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)` Constructs a new RegexUrlMapping for the given pattern that maps to the specified URI
`RegexUrlMapping(UrlMappingData data, Object controllerName, Object actionName, Object namespace, Object pluginName, Object viewName, String httpMethod, String version, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)`
`RegexUrlMapping(Object redirectInfo, UrlMappingData data, Object controllerName, Object actionName, Object namespace, Object pluginName, Object viewName, String httpMethod, String version, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)` Constructs a new RegexUrlMapping for the given pattern, controller name, action name and constraints.

Methods Summary

Methods
Type Params	Return Type	Name and description
	`public Object`	`call(Object objects)`
	`public int`	`compareTo(Object o)` Compares this UrlMapping instance with the specified UrlMapping instance and deals with URL mapping precedence rules.
	`protected Pattern`	`convertToRegex(String url)` Converts a Grails URL provides via the UrlMappingData interface to a regular expression.
	`public String`	`createRelativeURL(String controller, String action, Map paramValues, String encoding)`
	`public String`	`createRelativeURL(String controller, String action, String pluginName, Map paramValues, String encoding)`
	`public String`	`createRelativeURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding)`
	`public String`	`createRelativeURL(String controller, String action, Map paramValues, String encoding, String fragment)`
	`public String`	`createRelativeURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding, String fragment)`
	`public String`	`createURL(Map paramValues, String encoding)` See Also: UrlMapping
	`public String`	`createURL(Map paramValues, String encoding, String fragment)`
	`public String`	`createURL(String controller, String action, Map paramValues, String encoding)`
	`public String`	`createURL(String controller, String action, String pluginName, Map parameterValues, String encoding)`
	`public String`	`createURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding)`
	`public String`	`createURL(String controller, String action, Map paramValues, String encoding, String fragment)`
	`public String`	`createURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding, String fragment)`
	`protected String`	`encode(String s, String encoding)`
	`public String[]`	`getLogicalMappings()`
	`public UrlMappingData`	`getUrlData()`
	`public UrlMappingInfo`	`match(String uri)` Matches the given URI and returns a DefaultUrlMappingInfo instance or null
	`public String`	`toString()`

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class AbstractUrlMapping`	`getActionName, getConstraints, getControllerName, getHttpMethod, getMappingName, getNamespace, getPluginIndex, getPluginName, getRedirectInfo, getVersion, getViewName, hasRuntimeVariable, isDefinedInPlugin, setMappingName, setParameterValues, setParseRequest, setPluginIndex`

- Field Detail
  - public static final Pattern DOUBLE_WILDCARD_PATTERN
  - public static final String FORMAT_PARAMETER
  - public static final Pattern OPTIONAL_EXTENSION_WILDCARD_PATTERN
- Constructor Detail
  - public RegexUrlMapping(UrlMappingData data, URI uri, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)
    
    Constructs a new RegexUrlMapping for the given pattern that maps to the specified URI
    Parameters:
    data - The pattern
    uri - The URI
    constraints - Any constraints etc.
    grailsApplication - The GrailsApplication instance
  - public RegexUrlMapping(UrlMappingData data, Object controllerName, Object actionName, Object namespace, Object pluginName, Object viewName, String httpMethod, String version, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)
  - public RegexUrlMapping(Object redirectInfo, UrlMappingData data, Object controllerName, Object actionName, Object namespace, Object pluginName, Object viewName, String httpMethod, String version, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)
    
    Constructs a new RegexUrlMapping for the given pattern, controller name, action name and constraints.
    Parameters:
    data - An instance of the UrlMappingData class that holds necessary information of the URL mapping
    controllerName - The name of the controller the URL maps to (required)
    actionName - The name of the action the URL maps to
    namespace - The controller namespace
    pluginName - The name of the plugin which provided the controller
    viewName - The name of the view as an alternative to the name of the action. If the action is specified it takes precedence over the view name during mapping
    httpMethod - The http method
    version - The version
    constraints - A list of ConstrainedProperty instances that relate to tokens in the URL
    grailsApplication - The Grails application
    See Also:
    ConstrainedProperty
- Method Detail
  - @Override
    public Object call(Object objects)
  - public int compareTo(Object o)
    
    Compares this UrlMapping instance with the specified UrlMapping instance and deals with URL mapping precedence rules. URL Mapping Precedence Order 1. Less wildcard tokens.
```
       /foo          <- match
       /foo/(*)
      /foo/(*)/bar/  <- match
      /foo/(*)/(*)
    2. More static tokens.
      /foo/(*)/bar   <- match
      /foo/(*)
 
```
    Parameters:
    o - An instance of the UrlMapping interface
    Returns:
    greater than 0 if this UrlMapping should match before the specified UrlMapping. 0 if they are equal or less than 0 if this UrlMapping should match after the given UrlMapping
  - protected Pattern convertToRegex(String url)
    
    Converts a Grails URL provides via the UrlMappingData interface to a regular expression.
    Parameters:
    url - The URL to convert
    Returns:
    A regex Pattern objet
  - public String createRelativeURL(String controller, String action, Map paramValues, String encoding)
  - public String createRelativeURL(String controller, String action, String pluginName, Map paramValues, String encoding)
  - public String createRelativeURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding)
  - public String createRelativeURL(String controller, String action, Map paramValues, String encoding, String fragment)
  - public String createRelativeURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding, String fragment)
  - public String createURL(Map paramValues, String encoding)
    
    See Also:
    UrlMapping
  - public String createURL(Map paramValues, String encoding, String fragment)
  - public String createURL(String controller, String action, Map paramValues, String encoding)
  - public String createURL(String controller, String action, String pluginName, Map parameterValues, String encoding)
  - public String createURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding)
  - public String createURL(String controller, String action, Map paramValues, String encoding, String fragment)
  - public String createURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding, String fragment)
  - protected String encode(String s, String encoding)
  - public String[] getLogicalMappings()
  - public UrlMappingData getUrlData()
  - public UrlMappingInfo match(String uri)
    
    Matches the given URI and returns a DefaultUrlMappingInfo instance or null
    Parameters:
    uri - The URI to match
    Returns:
    A UrlMappingInfo instance or null
    See Also:
    UrlMappingInfo
  - @Override
    public String toString()

Summary:
Field
Constructor
Method

| Detail:
Field
Constructor
Method

[Java] Class RegexUrlMapping

Field Summary

Constructor Summary

Methods Summary

Inherited Methods Summary

Field Detail

public static final Pattern DOUBLE_WILDCARD_PATTERN

public static final String FORMAT_PARAMETER

public static final Pattern OPTIONAL_EXTENSION_WILDCARD_PATTERN

Constructor Detail

public RegexUrlMapping(UrlMappingData data, URI uri, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)

public RegexUrlMapping(UrlMappingData data, Object controllerName, Object actionName, Object namespace, Object pluginName, Object viewName, String httpMethod, String version, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)

public RegexUrlMapping(Object redirectInfo, UrlMappingData data, Object controllerName, Object actionName, Object namespace, Object pluginName, Object viewName, String httpMethod, String version, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)

Method Detail

@Override
public Object call(Object objects)

public int compareTo(Object o)

protected Pattern convertToRegex(String url)

public String createRelativeURL(String controller, String action, Map paramValues, String encoding)

public String createRelativeURL(String controller, String action, String pluginName, Map paramValues, String encoding)

public String createRelativeURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding)

public String createRelativeURL(String controller, String action, Map paramValues, String encoding, String fragment)

public String createRelativeURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding, String fragment)

public String createURL(Map paramValues, String encoding)

public String createURL(Map paramValues, String encoding, String fragment)

public String createURL(String controller, String action, Map paramValues, String encoding)

public String createURL(String controller, String action, String pluginName, Map parameterValues, String encoding)

public String createURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding)

public String createURL(String controller, String action, Map paramValues, String encoding, String fragment)

public String createURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding, String fragment)

protected String encode(String s, String encoding)

public String[] getLogicalMappings()

public UrlMappingData getUrlData()

public UrlMappingInfo match(String uri)

@Override
public String toString()

[Java] Class RegexUrlMapping

Field Summary

Constructor Summary

Methods Summary

Inherited Methods Summary

Field Detail

public static final Pattern DOUBLE_WILDCARD_PATTERN

public static final String FORMAT_PARAMETER

public static final Pattern OPTIONAL_EXTENSION_WILDCARD_PATTERN

Constructor Detail

public RegexUrlMapping(UrlMappingData data, URI uri, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)

public RegexUrlMapping(UrlMappingData data, Object controllerName, Object actionName, Object namespace, Object pluginName, Object viewName, String httpMethod, String version, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)

public RegexUrlMapping(Object redirectInfo, UrlMappingData data, Object controllerName, Object actionName, Object namespace, Object pluginName, Object viewName, String httpMethod, String version, ConstrainedProperty[] constraints, GrailsApplication grailsApplication)

Method Detail

@Overridepublic Object call(Object objects)

public int compareTo(Object o)

protected Pattern convertToRegex(String url)

public String createRelativeURL(String controller, String action, Map paramValues, String encoding)

public String createRelativeURL(String controller, String action, String pluginName, Map paramValues, String encoding)

public String createRelativeURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding)

public String createRelativeURL(String controller, String action, Map paramValues, String encoding, String fragment)

public String createRelativeURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding, String fragment)

public String createURL(Map paramValues, String encoding)

public String createURL(Map paramValues, String encoding, String fragment)

public String createURL(String controller, String action, Map paramValues, String encoding)

public String createURL(String controller, String action, String pluginName, Map parameterValues, String encoding)

public String createURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding)

public String createURL(String controller, String action, Map paramValues, String encoding, String fragment)

public String createURL(String controller, String action, String namespace, String pluginName, Map paramValues, String encoding, String fragment)

protected String encode(String s, String encoding)

public String[] getLogicalMappings()

public UrlMappingData getUrlData()

public UrlMappingInfo match(String uri)

@Overridepublic String toString()

@Override
public Object call(Object objects)

@Override
public String toString()