org.springframework.test.web.client.match

Class MockRestRequestMatchers

java.lang.Object

org.springframework.test.web.client.match.MockRestRequestMatchers

public abstract class MockRestRequestMatchers
extends java.lang.Object

Static, factory methods for RequestMatcher classes. Typically used to provide input for MockRestServiceServer.expect(RequestMatcher).

Eclipse users: Consider adding this class as a Java editor favorite. To navigate, open the Preferences and type "favorites".

Since:

3.2

Author:

Craig Walls, Rossen Stoyanchev

Constructor Summary

Constructors

Constructor and Description
MockRestRequestMatchers()

Method Summary

Modifier and Type	Method and Description
static RequestMatcher	anything() Match to any request.
private static void	assertHeaderValueCount(java.lang.String name, HttpHeaders headers, int expectedCount)
static ContentRequestMatchers	content() Access to request body matchers.
static RequestMatcher	header(java.lang.String name, <any>... matchers) Assert request header values with the given Hamcrest matcher.
static <T> RequestMatcher	jsonPath(java.lang.String expression, <any> matcher) Access to request body matchers using a JSONPath expression to inspect a specific subset of the body and a Hamcrest match for asserting the value found at the JSON path.
static JsonPathRequestMatchers	jsonPath(java.lang.String expression, java.lang.Object... args) Access to request body matchers using a JSONPath expression to inspect a specific subset of the body.
static RequestMatcher	method(HttpMethod method) Assert the HttpMethod of the request.
static RequestMatcher	requestTo(<any> matcher) Assert the request URI string with the given matcher.
static XpathRequestMatchers	xpath(java.lang.String expression, java.util.Map<java.lang.String,java.lang.String> namespaces, java.lang.Object... args) Access to response body matchers using an XPath to inspect a specific subset of the body.
static XpathRequestMatchers	xpath(java.lang.String expression, java.lang.Object... args) Access to request body matchers using an XPath to inspect a specific subset of the body.

Methods inherited from class java.lang.Object

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

Constructor Detail

MockRestRequestMatchers

public MockRestRequestMatchers()

Method Detail

anything

public static RequestMatcher anything()

Match to any request.

requestTo

public static RequestMatcher requestTo(<any> matcher)

Assert the request URI string with the given matcher.

Parameters:

matcher - String matcher for the expected URI

Returns:

the request matcher

method

public static RequestMatcher method(HttpMethod method)

Assert the HttpMethod of the request.

Parameters:

method - the HTTP method

Returns:

the request matcher

header

public static RequestMatcher header(java.lang.String name,
                                    <any>... matchers)

Assert request header values with the given Hamcrest matcher.

assertHeaderValueCount

private static void assertHeaderValueCount(java.lang.String name,
                                           HttpHeaders headers,
                                           int expectedCount)

content

public static ContentRequestMatchers content()

Access to request body matchers.

jsonPath

public static JsonPathRequestMatchers jsonPath(java.lang.String expression,
                                               java.lang.Object... args)

Access to request body matchers using a JSONPath expression to inspect a specific subset of the body. The JSON path expression can be a parameterized string using formatting specifiers as defined in String.format(String, Object...).

Parameters:

expression - the JSON path optionally parameterized with arguments

args - arguments to parameterize the JSON path expression with

jsonPath

public static <T> RequestMatcher jsonPath(java.lang.String expression,
                                          <any> matcher)

Access to request body matchers using a JSONPath expression to inspect a specific subset of the body and a Hamcrest match for asserting the value found at the JSON path.

Parameters:

expression - the JSON path expression

matcher - a matcher for the value expected at the JSON path

xpath

public static XpathRequestMatchers xpath(java.lang.String expression,
                                         java.lang.Object... args)
                                  throws javax.xml.xpath.XPathExpressionException

Access to request body matchers using an XPath to inspect a specific subset of the body. The XPath expression can be a parameterized string using formatting specifiers as defined in String.format(String, Object...).

Parameters:

expression - the XPath optionally parameterized with arguments

args - arguments to parameterize the XPath expression with

Throws:

javax.xml.xpath.XPathExpressionException

xpath

public static XpathRequestMatchers xpath(java.lang.String expression,
                                         java.util.Map<java.lang.String,java.lang.String> namespaces,
                                         java.lang.Object... args)
                                  throws javax.xml.xpath.XPathExpressionException

Access to response body matchers using an XPath to inspect a specific subset of the body. The XPath expression can be a parameterized string using formatting specifiers as defined in String.format(String, Object...).

Parameters:

expression - the XPath optionally parameterized with arguments

namespaces - namespaces referenced in the XPath expression

args - arguments to parameterize the XPath expression with

Throws:

javax.xml.xpath.XPathExpressionException