Package net.javacrumbs.jsonunit.spring

Class WebTestClientJsonMatcher

java.lang.Object
net.javacrumbs.jsonunit.spring.WebTestClientJsonMatcher
public class WebTestClientJsonMatcher extends Object
Matcher compatible with Spring TestWebClient.

Sample usage:

client.get().uri(path).accept(MediaType.APPLICATION_JSON).exchange().expectBody() .consumeWith(json().isEqualTo(CORRECT_JSON));

  • Method Summary

    Modifier and Type
    Method
    Description
    WebTestClientJsonMatcher
    ignoring(@NotNull String ignorePlaceholder)
    Sets the placeholder that can be used to ignore values.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isAbsent()
    Fails if the node exists.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isArray()
    Fails if the selected JSON is not an Array or is not present.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isEqualTo(@Nullable Object expected)
    Compares JSON for equality.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isFalse()
    Fails if selected JSON is not false.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isNotEqualTo(@Nullable Object expected)
    Fails if compared documents are equal.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isNotNull()
    Fails if selected JSON is null.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isNull()
    Fails if selected JSON is not null.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isObject()
    Fails if the selected JSON is not an Object or is not present.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isPresent()
    Fails if the node is missing.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isString()
    Fails if the selected JSON is not a String or is not present.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isStringEqualTo(@Nullable String expected)
    Fails if the selected JSON is not a String or is not present or the value is not equal to expected value.
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    isTrue()
    Fails if selected JSON is not true.
    static WebTestClientJsonMatcher
    json()
     
    Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>>
    matches(@NotNull org.hamcrest.Matcher<?> matcher)
    Matches the node using Hamcrest matcher.
    WebTestClientJsonMatcher
    node(String newPath)
    Creates a matcher object that only compares given node.
    WebTestClientJsonMatcher
    when(@NotNull net.javacrumbs.jsonunit.core.Option firstOption, @NotNull net.javacrumbs.jsonunit.core.Option... otherOptions)
    Sets options changing comparison behavior.
    WebTestClientJsonMatcher
    withDifferenceListener(@NotNull net.javacrumbs.jsonunit.core.listener.DifferenceListener differenceListener)
     
    WebTestClientJsonMatcher
    withTolerance(double tolerance)
    Sets the tolerance for floating number comparison.
    WebTestClientJsonMatcher
    withTolerance(@Nullable BigDecimal tolerance)
    Sets the tolerance for floating number comparison.

    Methods inherited from class java.lang.Object

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

  • Method Details

    • json

      public static WebTestClientJsonMatcher json()

    • node

      @NotNull public WebTestClientJsonMatcher node(String newPath)
      Creates a matcher object that only compares given node. The path is denoted by JSON path, for example.

      this.mockMvc.perform(get("/sample").accept(MediaType.APPLICATION_JSON)).andExpect(json().node("root.test[0]").isEqualTo("1"));

      Parameters:
      newPath -
      Returns:
      object comparing only node given by path.

    • ignoring

      @NotNull public WebTestClientJsonMatcher ignoring(@NotNull @NotNull String ignorePlaceholder)
      Sets the placeholder that can be used to ignore values. The default value is ${json-unit.ignore}

    • withTolerance

      @NotNull public WebTestClientJsonMatcher withTolerance(double tolerance)
      Sets the tolerance for floating number comparison. If set to null, requires exact match of the values. For example, if set to 0.01, ignores all differences lower than 0.01, so 1 and 0.9999 are considered equal.

    • withTolerance

      @NotNull public WebTestClientJsonMatcher withTolerance(@Nullable @Nullable BigDecimal tolerance)
      Sets the tolerance for floating number comparison. If set to null, requires exact match of the values. For example, if set to 0.01, ignores all differences lower than 0.01, so 1 and 0.9999 are considered equal.

    • withDifferenceListener

      @NotNull public WebTestClientJsonMatcher withDifferenceListener(@NotNull @NotNull net.javacrumbs.jsonunit.core.listener.DifferenceListener differenceListener)

    • when

      @NotNull public WebTestClientJsonMatcher when(@NotNull @NotNull net.javacrumbs.jsonunit.core.Option firstOption, @NotNull @NotNull net.javacrumbs.jsonunit.core.Option... otherOptions)
      Sets options changing comparison behavior. For more details see Option
      See Also:
      • Option

    • isEqualTo

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isEqualTo(@Nullable @Nullable Object expected)
      Compares JSON for equality. The expected object is converted to JSON before comparison. Ignores order of sibling nodes and whitespaces.

      Please note that if you pass a String, it's parsed as JSON which can lead to an unexpected behavior. If you pass in "1" it is parsed as a JSON containing integer 1. If you compare it with a string it fails due to a different type. If you want to pass in real string you have to quote it "\"1\"" or use isStringEqualTo(String).

      If the string parameter is not a valid JSON, it is quoted automatically.

      Parameters:
      expected -
      Returns:
      this object.
      See Also:

    • isStringEqualTo

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isStringEqualTo(@Nullable @Nullable String expected)
      Fails if the selected JSON is not a String or is not present or the value is not equal to expected value.

    • isNotEqualTo

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isNotEqualTo(@Nullable @Nullable Object expected)
      Fails if compared documents are equal. The expected object is converted to JSON before comparison. Ignores order of sibling nodes and whitespaces.

    • isAbsent

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isAbsent()
      Fails if the node exists.

    • isPresent

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isPresent()
      Fails if the node is missing.

    • isArray

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isArray()
      Fails if the selected JSON is not an Array or is not present.

    • isObject

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isObject()
      Fails if the selected JSON is not an Object or is not present.

    • isString

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isString()
      Fails if the selected JSON is not a String or is not present.

    • isNull

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isNull()
      Fails if selected JSON is not null.

    • isNotNull

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isNotNull()
      Fails if selected JSON is null.

    • matches

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> matches(@NotNull @NotNull org.hamcrest.Matcher<?> matcher)
      Matches the node using Hamcrest matcher.

      • Numbers are mapped to BigDecimal
      • Arrays are mapped to a Collection
      • Objects are mapped to a map so you can use json(Part)Equals or a Map matcher
      Parameters:
      matcher -
      Returns:

    • isTrue

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isTrue()
      Fails if selected JSON is not true.

    • isFalse

      @NotNull public Consumer<org.springframework.test.web.reactive.server.EntityExchangeResult<byte[]>> isFalse()
      Fails if selected JSON is not false.