org.springframework.test.web.servlet.result

Class JsonPathResultMatchers

java.lang.Object

org.springframework.test.web.servlet.result.JsonPathResultMatchers

public class JsonPathResultMatchers
extends Object

Factory for assertions on the response content using JsonPath expressions.

An instance of this class is typically accessed via MockMvcResultMatchers.jsonPath(String, Matcher) or MockMvcResultMatchers.jsonPath(String, Object...).

Since:

3.2

Author:

Rossen Stoyanchev

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JsonPathResultMatchers(String expression, Object... args) Protected constructor.

Method Summary

Modifier and Type	Method and Description
ResultMatcher	doesNotExist() Evaluate the JSON path expression against the response content and assert that a value does not exist at the given path.
ResultMatcher	exists() Evaluate the JSON path expression against the response content and assert that a non-null value exists at the given path.
ResultMatcher	isArray() Evaluate the JSON path expression against the response content and assert that the result is an array.
<T> ResultMatcher	value(org.hamcrest.Matcher<T> matcher) Evaluate the JSON path expression against the response content and assert the resulting value with the given Hamcrest Matcher.
ResultMatcher	value(Object expectedValue) Evaluate the JSON path expression against the response content and assert that the result is equal to the supplied value.

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonPathResultMatchers

protected JsonPathResultMatchers(String expression,
                                 Object... args)

Protected constructor.

Use MockMvcResultMatchers.jsonPath(String, Object...) or MockMvcResultMatchers.jsonPath(String, Matcher).

Parameters:

expression - the JsonPath expression; never null or empty

args - arguments to parameterize the JsonPath expression with, using formatting specifiers defined in String.format(String, Object...)

Method Detail

value

public <T> ResultMatcher value(org.hamcrest.Matcher<T> matcher)

Evaluate the JSON path expression against the response content and assert the resulting value with the given Hamcrest Matcher.

value

public ResultMatcher value(Object expectedValue)

Evaluate the JSON path expression against the response content and assert that the result is equal to the supplied value.

exists

public ResultMatcher exists()

Evaluate the JSON path expression against the response content and assert that a non-null value exists at the given path.

If the JSON path expression is not definite, this method asserts that the value at the given path is not empty.

doesNotExist

public ResultMatcher doesNotExist()

Evaluate the JSON path expression against the response content and assert that a value does not exist at the given path.

If the JSON path expression is not definite, this method asserts that the value at the given path is empty.

isArray

public ResultMatcher isArray()

Evaluate the JSON path expression against the response content and assert that the result is an array.