UriTemplate (Apache Tomcat 9.0.120 API Documentation)
Description: declaration: package: org.apache.tomcat.websocket.server, class: UriTemplate

# Class UriTemplate

java.lang.Object
org.apache.tomcat.websocket.server.UriTemplate

public class UriTemplate extends Object
Extracts path parameters from URIs used to create web socket connections using the URI template defined for the associated Endpoint.

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `UriTemplate(String path)`
  Creates a new UriTemplate from the given path.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `String`
  `getNormalizedPath()`
  Returns the normalized path with numeric parameter indices.
  `int`
  `getSegmentCount()`
  Returns the number of path segments.
  `boolean`
  `hasParameters()`
  Returns whether this template contains path parameters.
  `Map<String,String>`
  `match(UriTemplate candidate)`
  Matches this template against a candidate URI path.

  ### Methods inherited from class Object

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

- ## Constructor Details

  - ### UriTemplate

    public UriTemplate(String path) throws DeploymentException
    Creates a new UriTemplate from the given path.
    Parameters:
      `path` - the URI template path
    Throws:
      `DeploymentException` - if the path is invalid

- ## Method Details

  - ### match

    public Map<String,String> match(UriTemplate candidate)
    Matches this template against a candidate URI path.
    Parameters:
      `candidate` - the candidate URI path
    Returns:
      the path parameters if matched, or null

  - ### hasParameters

    public boolean hasParameters()
    Returns whether this template contains path parameters.
    Returns:
      true if there are parameters

  - ### getSegmentCount

    public int getSegmentCount()
    Returns the number of path segments.
    Returns:
      the segment count

  - ### getNormalizedPath

    public String getNormalizedPath()
    Returns the normalized path with numeric parameter indices.
    Returns:
      the normalized path