Package: grails.web.mapping

## [Java] 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 implementer contains.

  Authors:
    Graeme Rocher
  Since:
    0.5

- - ### Field Summary

    Fields
    Modifiers | Name | Description
    --- | --- | ---
    `java.lang.String` | `BEAN_ID` |

  - ### Methods Summary

    Methods
    Type Params | Return Type | Name and description
    --- | --- | ---
    `` | `java.util.Set<org.springframework.http.HttpMethod>` | `allowedMethods(java.lang.String uri)` Return the allowed HTTP methods for the given URI
    `` | `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.lang.String pluginName, java.util.Map params)` Retrieves the best guess of a URI for the given controller, action and parameters
    `` | `UrlCreator` | `getReverseMapping(java.lang.String controller, java.lang.String action, java.lang.String namespace, java.lang.String pluginName, java.lang.String httpMethod, java.util.Map params)` Retrieves the best guess of a URI for the given controller, action and parameters
    `` | `UrlCreator` | `getReverseMapping(java.lang.String controller, java.lang.String action, java.lang.String namespace, java.lang.String pluginName, java.lang.String httpMethod, java.lang.String version, java.util.Map params)` Retrieves the best guess of a URI for the given controller, action and parameters
    `` | `UrlCreator` | `getReverseMapping(java.lang.String controller, java.lang.String action, java.lang.String namespace, java.lang.String pluginName, java.util.Map params)` Retrieves the best guess of a URI for the given controller, action and parameters
    `` | `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.
    `` | `UrlCreator` | `getReverseMappingNoDefault(java.lang.String controller, java.lang.String action, java.lang.String namespace, java.lang.String pluginName, java.lang.String httpMethod, 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.
    `` | `UrlCreator` | `getReverseMappingNoDefault(java.lang.String controller, java.lang.String action, java.lang.String namespace, java.lang.String pluginName, java.lang.String httpMethod, java.lang.String version, 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[]` | `matchAll(java.lang.String uri, java.lang.String httpMethod, java.lang.String version)` Match all possible UrlMappingInfo instances to the given URI and HTTP method
    `` | `UrlMappingInfo[]` | `matchAll(java.lang.String uri, org.springframework.http.HttpMethod httpMethod)` Match all possible UrlMappingInfo instances to the given URI and HTTP method
    `` | `UrlMappingInfo[]` | `matchAll(java.lang.String uri, org.springframework.http.HttpMethod httpMethod, java.lang.String version)` 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

    - #### public java.lang.String BEAN_ID

  - ### Method Detail

    - #### public java.util.Set<org.springframework.http.HttpMethod> allowedMethods(java.lang.String uri)

      Return the allowed HTTP methods for the given URI

      Parameters:
        `uri` - The URI
      Returns:
        The allowed methods

    - #### @java.lang.SuppressWarnings("rawtypes") public 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

    - #### @java.lang.SuppressWarnings("rawtypes") public UrlCreator getReverseMapping(java.lang.String controller, java.lang.String action, java.lang.String pluginName, 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
        `pluginName` - the name of the plugin which provides the controller
        `params` - The parameters or null
      Returns:
        A URI for the given arguments

    - #### @java.lang.SuppressWarnings("rawtypes") public UrlCreator getReverseMapping(java.lang.String controller, java.lang.String action, java.lang.String namespace, java.lang.String pluginName, java.lang.String httpMethod, 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
        `namespace` - The controller namespace
        `pluginName` - the name of the plugin which provides the controller
        `httpMethod` - The HTTP method to reverse map
        `params` - The parameters or null
      Returns:
        A URI for the given arguments

    - #### @java.lang.SuppressWarnings("rawtypes") public UrlCreator getReverseMapping(java.lang.String controller, java.lang.String action, java.lang.String namespace, java.lang.String pluginName, java.lang.String httpMethod, java.lang.String version, 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
        `namespace` - The controller namespace
        `pluginName` - the name of the plugin which provides the controller
        `httpMethod` - The HTTP method to reverse map
        `version` - The version of the mapping
        `params` - The parameters or null
      Returns:
        A URI for the given arguments

    - #### @java.lang.SuppressWarnings("rawtypes") public UrlCreator getReverseMapping(java.lang.String controller, java.lang.String action, java.lang.String namespace, java.lang.String pluginName, 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
        `namespace` - The controller namespace or null
        `pluginName` - the name of the plugin which provides the controller
        `params` - The parameters or null
      Returns:
        A URI for the given arguments

    - #### @java.lang.SuppressWarnings("rawtypes") public 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

    - #### @java.lang.SuppressWarnings("rawtypes") public 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

    - #### @java.lang.SuppressWarnings("rawtypes") public UrlCreator getReverseMappingNoDefault(java.lang.String controller, java.lang.String action, java.lang.String namespace, java.lang.String pluginName, java.lang.String httpMethod, 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
        `namespace` - The controller namespace or null
        `pluginName` - the name of the plugin which provides the controller
        `httpMethod` - the HTTP method
        `params` - The parameters or null
      Returns:
        A URI for the given arguments

    - #### @java.lang.SuppressWarnings("rawtypes") public UrlCreator getReverseMappingNoDefault(java.lang.String controller, java.lang.String action, java.lang.String namespace, java.lang.String pluginName, java.lang.String httpMethod, java.lang.String version, 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
        `namespace` - The controller namespace or null
        `pluginName` - the name of the plugin which provides the controller
        `httpMethod` - the HTTP method
        `params` - The parameters or null
      Returns:
        A URI for the given arguments

    - #### public UrlMapping[] getUrlMappings()

      Retrieves the held UrlMapping instances as an array

      Returns:
        An array of UrlMapping instances

    - #### public 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

    - #### public 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

    - #### public 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

    - #### public UrlMappingInfo[] matchAll(java.lang.String uri, java.lang.String httpMethod, java.lang.String version)

      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.)
        `version` - The version of the API
      Returns:
        An array of 0 or many UrlMappingInfo instances

    - #### public UrlMappingInfo[] matchAll(java.lang.String uri, org.springframework.http.HttpMethod 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

    - #### public UrlMappingInfo[] matchAll(java.lang.String uri, org.springframework.http.HttpMethod httpMethod, java.lang.String version)

      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.)
        `version` - The version
      Returns:
        An array of 0 or many UrlMappingInfo instances

    - #### public UrlMappingInfo matchStatusCode(int responseCode)

      Match and return the first UrlMappingInfo instance possible

      Parameters:
        `responseCode` - The responseCode to match
      Returns:
        A UrlMappingInfo or null

    - #### public 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