net.javacrumbs.jsonunit.fluent

Class JsonFluentAssert

java.lang.Object

net.javacrumbs.jsonunit.fluent.JsonFluentAssert

Direct Known Subclasses:

JsonAssert

public class JsonFluentAssert
extends Object

Contains JSON related fluent assertions inspired by FEST or AssertJ. Typical usage is:

assertThatJson("{\"test\":1}").isEqualTo("{\"test\":2}"); assertThatJson("{\"test\":1}").hasSameStructureAs("{\"test\":21}"); assertThatJson("{\"root\":{\"test\":1}}").node("root.test").isEqualTo("2");

Please note that the method name is assertThatJson and not assertThat. The reason is that we need to accept String parameter and do not want to override standard FEST or AssertJ assertThat(String) method.

All the methods accept Objects as parameters. The supported types are:

1. Jackson JsonNode
2. Numbers, booleans and any other type parseable by Jackson's ObjectMapper.convertValue
3. String is parsed as JSON. For expected values the string is quoted if it contains obviously invalid JSON.
4. Reader similarly to String
5. null as null Node

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JsonFluentAssert(Object actual)
protected	JsonFluentAssert(Object actual, String path, String description, String ignorePlaceholder)

Method Summary

Methods

Modifier and Type	Method and Description
JsonFluentAssert	as(String description) Sets the description of this object.
static JsonFluentAssert	assertThatJson(Object json) Creates a new instance of JsonFluentAssert.
JsonFluentAssert	describedAs(String description) Sets the description of this object.
JsonFluentAssert	hasSameStructureAs(Object expected) Compares JSON structure.
JsonFluentAssert	ignoring(String ignorePlaceholder) Sets the placeholder that can be used to ignore values.
JsonFluentAssert	isEqualTo(Object expected) Compares JSON for equality.
JsonFluentAssert	isNotEqualTo(Object expected) Fails if compared documents are equal.
JsonFluentAssert	node(String path) Creates an assert object that only compares given node.

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonFluentAssert

protected JsonFluentAssert(Object actual,
                String path,
                String description,
                String ignorePlaceholder)

JsonFluentAssert

protected JsonFluentAssert(Object actual)

Method Detail

assertThatJson

public static JsonFluentAssert assertThatJson(Object json)

Creates a new instance of JsonFluentAssert. It is not called assertThat to not clash with StringAssert. The json parameter is converted to JSON using ObjectMapper.

Parameters:

json -

Returns:

new JsonFluentAssert object.

isEqualTo

public JsonFluentAssert isEqualTo(Object expected)

Compares JSON for equality. The expected object is converted to JSON before comparison. Ignores order of sibling nodes and whitespaces.

Parameters:

expected -

Returns:

this object.

isNotEqualTo

public JsonFluentAssert isNotEqualTo(Object expected)

Fails if compared documents are equal. The expected object is converted to JSON before comparison. Ignores order of sibling nodes and whitespaces.

Parameters:

expected -

Returns:

this object.

hasSameStructureAs

public JsonFluentAssert hasSameStructureAs(Object expected)

Compares JSON structure. Ignores values, only compares shape of the document and key names.

Parameters:

expected -

Returns:

this object.

node

public JsonFluentAssert node(String path)

Creates an assert object that only compares given node. The path is denoted by JSON path, for example.

assertThatJson("{\"root\":{\"test\":[1,2,3]}}").node("root.test[0]").isEqualTo("1");

Parameters:

path -

Returns:

object comparing only node given by path.

as

public JsonFluentAssert as(String description)

Sets the description of this object.

Parameters:

description -

Returns:

describedAs

public JsonFluentAssert describedAs(String description)

Sets the description of this object.

Parameters:

description -

Returns:

ignoring

public JsonFluentAssert ignoring(String ignorePlaceholder)

Sets the placeholder that can be used to ignore values. The default value is ${json-unit.ignore}

Parameters:

ignorePlaceholder -

Returns: