Package org.springframework.web.servlet.mvc.condition

Class ParamsRequestCondition

java.lang.Object
org.springframework.web.servlet.mvc.condition.AbstractRequestCondition<ParamsRequestCondition>
org.springframework.web.servlet.mvc.condition.ParamsRequestCondition
All Implemented Interfaces:
RequestCondition<ParamsRequestCondition>
public final class ParamsRequestCondition extends AbstractRequestCondition<ParamsRequestCondition>
A logical conjunction (' && ') request condition that matches a request against a set parameter expressions with syntax defined in RequestMapping.params().
Since:
3.1
Author:
Arjen Poutsma, Rossen Stoyanchev

  • Constructor Details

    • ParamsRequestCondition

      public ParamsRequestCondition(String... params)
      Create a new instance from the given param expressions.
      Parameters:
      params - expressions with syntax defined in RequestMapping.params(); if 0, the condition will match to every request.

  • Method Details

    • getExpressions

      public Set<NameValueExpression<String>> getExpressions()
      Return the contained request parameter expressions.

    • getContent

      protected Collection<org.springframework.web.servlet.mvc.condition.ParamsRequestCondition.ParamExpression> getContent()
      Description copied from class: AbstractRequestCondition
      Return the discrete items a request condition is composed of.

      For example URL patterns, HTTP request methods, param expressions, etc.

      Specified by:
      getContent in class AbstractRequestCondition<ParamsRequestCondition>
      Returns:
      a collection of objects (never null)

    • getToStringInfix

      protected String getToStringInfix()
      Description copied from class: AbstractRequestCondition
      The notation to use when printing discrete items of content.

      For example " || " for URL patterns or " && " for param expressions.

      Specified by:
      getToStringInfix in class AbstractRequestCondition<ParamsRequestCondition>

    • combine

      public ParamsRequestCondition combine(ParamsRequestCondition other)
      Returns a new instance with the union of the param expressions from "this" and the "other" instance.
      Parameters:
      other - the condition to combine with.
      Returns:
      a request condition instance that is the result of combining the two condition instances.

    • getMatchingCondition

      @Nullable public ParamsRequestCondition getMatchingCondition(HttpServletRequest request)
      Returns "this" instance if the request matches all param expressions; or null otherwise.
      Returns:
      a condition instance in case of a match or null otherwise.

    • compareTo

      public int compareTo(ParamsRequestCondition other, HttpServletRequest request)
      Compare to another condition based on parameter expressions. A condition is considered to be a more specific match, if it has:
      1. A greater number of expressions.
      2. A greater number of non-negated expressions with a concrete value.

      It is assumed that both instances have been obtained via getMatchingCondition(HttpServletRequest) and each instance contains the matching parameter expressions only or is otherwise empty.