JsonUnit is a library that simplifies JSON comparison in tests.
There are several different APIs you can use. They all have more or less the same features, just the usage is slightly different.
This is brand new API which combines power of JsonUnit and AssertJ. If you are not sure, which API to use, pick this one.
import static net.javacrumbs.jsonunit.assertj.JsonAssertions.assertThatJson;
import static net.javacrumbs.jsonunit.assertj.JsonAssertions.json;
...
// compares two JSON documents (note lenient parsing of expected value)
assertThatJson("{\"a\":1, \"b\":2}").isEqualTo("{b:2, a:1}");
// objects are automatically serialized before comparison
assertThatJson(jsonObject).isEqualTo("{\n\"test\": 1\n}");
// AssertJ map assertions (numbers are converted to BigDecimals)
assertThatJson("{\"a\":1}").isObject().containsEntry("a", BigDecimal.valueOf(1));
// Type placeholders
assertThatJson("{\"a\":1, \"b\": {\"c\" :3}}")
.isObject().containsValue(json("{\"c\" :\"${json-unit.any-number}\"}"));
// AssertJ array assertion
assertThatJson("{\"a\":[{\"b\": 1}, {\"c\": 1}, {\"d\": 1}]}")
.node("a").isArray().contains(json("{\"c\": 1}"));
// Can ignore array order
assertThatJson("{\"a\":[{\"b\": 1}, {\"c\": 1}, {\"d\": 1}]}")
.when(Option.IGNORING_ARRAY_ORDER).node("a").isArray()
.isEqualTo(json("[{\"c\": 1}, {\"b\": 1} ,{\"d\": 1}]"));
// custom matcher
assertThatJson("{\"test\":-1}")
.withConfiguration(c -> c.withMatcher("positive", greaterThan(valueOf(0))))
.isEqualTo("{\"test\": \"${json-unit.matches:positive}\"}");
// and
assertThatJson("{\"test\":{\"a\":1, \"b\":2, \"c\":3}}").and(
a -> a.node("test.a").isEqualTo(1),
a -> a.node("test.b").isEqualTo(2)
);
// JsonPath support
assertThatJson(json)
.inPath("$.store.book")
.isArray()
.contains(json(
" {\n" +
" \"category\": \"reference\",\n" +
" \"author\": \"Nigel Rees\",\n" +
" \"title\": \"Sayings of the Century\",\n" +
" \"price\": 8.96\n" +
" }"
));
// "true" is valid JSON so it gets parsed to primitive `true`
// Have to wrap it to JsonAssertions.value() in order to make sure it's not parsed
assertThatJson("{\"root\":[\"true\"]}").node("root").isArray().containsExactly(value("true"));
It's recommended to use JsonAssertions.json()
if you want to parse expected value as JSON and
JsonAssertions.value()
if you want to use the value as is.
To use AssertJ integration, import
<dependency>
<groupId>net.javacrumbs.json-unit</groupId>
<artifactId>json-unit-assertj</artifactId>
<version>2.11.1</version>
<scope>test</scope>
</dependency>
For more examples see the tests.
Fluent assertions were inspired by FEST and AssertJ. This API was created before AssertJ become so popular so it does not depend on it. I would recommend to use AssertJ integration described above.
import static net.javacrumbs.jsonunit.fluent.JsonFluentAssert.assertThatJson;
...
// compares entire documents
assertThatJson("{\"test\":1}").isEqualTo("{\"test\":2}");
// compares only parts of the document
assertThatJson("{\"test1\":2, \"test2\":1}")
.node("test1").isEqualTo(2)
.node("test2").isEqualTo(2);
// compare node indexed from start of array
assertThatJson("{\"root\":{\"test\":[1,2,3]}}")
.node("root.test[0]").isEqualTo(1);
// compare node indexed from end of array
assertThatJson("{\"root\":{\"test\":[1,2,3]}}")
.node("root.test[-1]").isEqualTo(3);
// compares only the structure
assertThatJson("{\"test\":1}")
// Options have to be specified before the assertion
.when(IGNORING_VALUES)
.isEqualTo("{\"test\":21}");
// ignores a value
assertThatJson("{\"test\":1}").isEqualTo("{\"test\":\"${json-unit.ignore}\"}");
// ignores extra fields
assertThatJson("{\"test\":{\"a\":1, \"b\":2, \"c\":3}}")
// Options have to be specified before the assertion
.when(IGNORING_EXTRA_FIELDS)
.isEqualTo("{\"test\":{\"b\":2}}");
// array length comparison
assertThatJson("{\"test\":[1,2,3]}").node("test")
.isArray().ofLength(2);
// array contains node
assertThatJson("{\"test\":[{\"id\":36},{\"id\":37}]}").node("test")
.isArray().thatContains("{\"id\":37}");
// using Hamcrest matcher
assertThatJson("{\"test\":\"one\"}").node("test")
.matches(equalTo("one"));
// Numbers sent to matchers are BigDecimals.
assertThatJson("{\"test\":[{\"value\":1},{\"value\":2},{\"value\":3}]}")
.node("test")
.matches(everyItem(jsonPartMatches("value", lessThanOrEqualTo(BigDecimal.valueOf(4)))));
It is possible to combine fluent assertions with hamcrest matchers using matches
method. For example
assertThatJson("{\"test\":[1,2,3]}").node("test").matches(hasItem(valueOf(1)));
assertThatJson("{\"test\":[{\"value\":1},{\"value\":2},{\"value\":3}]}")
.node("test")
.matches(everyItem(jsonPartMatches("value", lessThanOrEqualTo(valueOf(4)))));
To use import
<dependency>
<groupId>net.javacrumbs.json-unit</groupId>
<artifactId>json-unit-fluent</artifactId>
<version>2.11.1</version>
<scope>test</scope>
</dependency>
For more examples see the tests.
You use Hamcrest matchers in the following way
import static net.javacrumbs.jsonunit.JsonMatchers.*;
import static org.junit.Assert.*;
import static net.javacrumbs.jsonunit.core.util.ResourceUtils.resource;
...
assertThat("{\"test\":1}", jsonEquals("{\"test\": 1}"));
assertThat("{\"test\":1}", jsonPartEquals("test", 1));
assertThat("{\"test\":[1, 2, 3]}", jsonPartEquals("test[0]", 1));
assertThat("{\"test\":{\"a\":1, \"b\":2, \"c\":3}}",
jsonEquals("{\"test\":{\"b\":2}}").when(IGNORING_EXTRA_FIELDS));
// Can use other Hamcrest matchers too
assertThat("{\"test\":1}", jsonPartMatches("test", is(valueOf(1))))
assertThat("{\"test\":1}", jsonEquals(resource("test.json")));
To use import
<dependency>
<groupId>net.javacrumbs.json-unit</groupId>
<artifactId>json-unit</artifactId>
<version>2.11.1</version>
<scope>test</scope>
</dependency>
For more examples see the tests.
JsonUnit supports Spring MVC test assertions. For example
import static net.javacrumbs.jsonunit.spring.JsonUnitResultMatchers.json;
...
this.mockMvc.perform(get("/sample").andExpect(
json().isEqualTo("{\"result\":{\"string\":\"stringValue\", \"array\":[1, 2, 3],\"decimal\":1.00001}}")
);
this.mockMvc.perform(get("/sample").andExpect(
json().node("result.string2").isAbsent()
);
this.mockMvc.perform(get("/sample").andExpect(
json().node("result.array").when(Option.IGNORING_ARRAY_ORDER).isEqualTo(new int[]{3, 2, 1})
);
this.mockMvc.perform(get("/sample").andExpect(
json().node("result.array").matches(everyItem(lessThanOrEqualTo(valueOf(4))))
);
To use import
<dependency>
<groupId>net.javacrumbs.json-unit</groupId>
<artifactId>json-unit-spring</artifactId>
<version>2.11.1</version>
<scope>test</scope>
</dependency>
For more examples see the tests.
import static net.javacrumbs.jsonunit.spring.JsonUnitRequestMatchers.json;
...
mockServer.expect(requestTo(URI))
.andExpect(json().isEqualTo(json))
.andRespond(withSuccess(jsonResponse, MediaType.APPLICATION_JSON_UTF8));
To use import
<dependency>
<groupId>net.javacrumbs.json-unit</groupId>
<artifactId>json-unit-spring</artifactId>
<version>2.11.1</version>
<scope>test</scope>
</dependency>
This is old, JUnit-like API, for those of us who love traditions and do not like fluent APIs.
import static net.javacrumbs.jsonunit.JsonAssert.*;
import static net.javacrumbs.jsonunit.core.Option.*;
...
// compares two JSON documents
assertJsonEquals("{\"test\":1}", "{\n\"test\": 1\n}");
// objects are automatically serialized before comparison
assertJsonEquals(jsonObject, "{\n\"test\": 1\n}");
// compares only part
assertJsonPartEquals("2", "{\"test\":[{\"value\":1},{\"value\":2}]}",
"test[1].value");
// extra options can be specified
assertJsonEquals("{\"test\":{\"a\":1}}",
"{\"test\":{\"a\":1, \"b\": null}}",
when(TREATING_NULL_AS_ABSENT));
// compares only the structure, not the values
assertJsonEquals("[{\"test\":1}, {\"test\":2}]",
"[{\n\"test\": 1\n}, {\"TEST\": 4}]", when(IGNORING_VALUES))
// Lenient parsing of expected value
assertJsonEquals("{//Look ma, no quotation marks\n test:'value'}",
"{\n\"test\": \"value\"\n}");
To use import
<dependency>
<groupId>net.javacrumbs.json-unit</groupId>
<artifactId>json-unit</artifactId>
<version>2.11.1</version>
<scope>test</scope>
</dependency>
For more examples see the tests.
JsonUnit support all this features regardless of API you use.
You can use JsonPath navigation together with JsonUnit. It has native support in AssertJ integration so you can do something like this:
assertThatJson(json)
.inPath("$.store.book")
.isArray()
.contains(json(
" {\n" +
" \"category\": \"reference\",\n" +
" \"author\": \"Nigel Rees\",\n" +
" \"title\": \"Sayings of the Century\",\n" +
" \"price\": 8.96\n" +
" }"
));
For other API styles you have to first import JsonPath support module
<dependency>
<groupId>net.javacrumbs.json-unit</groupId>
<artifactId>json-unit-json-path</artifactId>
<version>2.11.1</version>
<scope>test</scope>
</dependency>
and then use instead of actual value
import static net.javacrumbs.jsonunit.jsonpath.JsonPathAdapter.inPath;
...
assertThatJson(inPath(json, "$.store.book[*].author"))
.when(Option.IGNORING_ARRAY_ORDER)
.isEqualTo("['J. R. R. Tolkien', 'Nigel Rees', 'Evelyn Waugh', 'Herman Melville']");
Sometimes you need to ignore certain values when comparing. It is possible to use ${json-unit.ignore}
or #{json-unit.ignore}
placeholder like this
assertJsonEquals("{\"test\":\"${json-unit.ignore}\"}",
"{\n\"test\": {\"object\" : {\"another\" : 1}}}");
Please note that the assertion will fail if the test
element is missing in the actual value.
If the element needs to be ignored completely you can use ${json-unit.ignore-element}
placeholder.
assertThatJson("{\"root\":{\"test\":1, \"ignored\": null}}")
.isEqualTo("{\"root\":{\"test\":1, \"ignored\": \"${json-unit.ignore-element}\"}}");
The assertion will not fail if the element is missing in the actual value.
whenIgnoringPaths
configuration option makes JsonUnit ignore the specified paths in the actual value. If the path
matches, it's completely ignored. It may be missing, null or have any value. Also when(paths(...), thenIgnore()
can be used.
// AssertJ style
assertThatJson("{\"root\":{\"test\":1, \"ignored\": 1}}")
.whenIgnoringPaths("root.ignored"))
.isEqualTo("{\"root\":{\"test\":1}}");
// Hamcrest matcher
assertThat(
"{\"root\":{\"test\":1, \"ignored\": 2}}",
jsonEquals("{\"root\":{\"test\":1, \"ignored\": 1}}").whenIgnoringPaths("root.ignored")
);
Array index placeholder
// standard assert
assertJsonEquals(
"[{\"a\":1, \"b\":0},{\"a\":1, \"b\":0}]",
"[{\"a\":1, \"b\":2},{\"a\":1, \"b\":3}]",
JsonAssert.whenIgnoringPaths("[*].b")
);
Please note, that if you use JsonPath, you should start the path to be ignored by $
Also note that whenIgnoringPaths
method supports full JsonPath syntax only in AssertJ API, all the other flavors support only
exact path or array index placeholder as described above.
It is also possible to use regular expressions to compare string values
assertJsonEquals("{\"test\": \"${json-unit.regex}[A-Z]+\"}",
"{\"test\": \"ABCD\"}");
If you want to assert just a type, but you do not care about the exact value, you can use any-* placeholder like this
assertThatJson("{\"test\":\"value\"}")
.isEqualTo("{test:'${json-unit.any-string}'}");
assertThatJson("{\"test\":true}")
.isEqualTo("{\"test\":\"${json-unit.any-boolean}\"}");
assertThatJson("{\"test\":1.1}")
.isEqualTo("{\"test\":\"${json-unit.any-number}\"}");
You can also use hash instead of string #{json-unit.any-string}
for example if you are using language with string interpolation
like Kotlin.
In some special cases you might want to use your own matcher in the expected document.
assertJsonEquals(
"{\"test\": \"${json-unit.matches:positive}\"}",
"{\"test\":1}",
JsonAssert.withMatcher("positive", greaterThan(valueOf(0)))
);
In even more special cases, you might want to parametrize your matcher.
Matcher<?> divisionMatcher = new DivisionMatcher();
assertJsonEquals(
"{test: '${json-unit.matches:isDivisibleBy}3'}",
"{\"test\":5}",
JsonAssert.withMatcher("isDivisibleBy", divisionMatcher)
);
private static class DivisionMatcher extends BaseMatcher<Object> implements ParametrizedMatcher {
private BigDecimal param;
public boolean matches(Object item) {
return ((BigDecimal)item).remainder(param).compareTo(ZERO) == 0;
}
public void describeTo(Description description) {
description.appendValue(param);
}
@Override
public void describeMismatch(Object item, Description description) {
description.appendText("It is not divisible by ").appendValue(param);
}
public void setParameter(String parameter) {
this.param = new BigDecimal(parameter);
}
}
There are multiple options how you can configure the comparison
TREATING_NULL_AS_ABSENT - fields with null values are equivalent to absent fields. For example, this test passes
assertJsonEquals("{\"test\":{\"a\":1}}",
"{\"test\":{\"a\":1, \"b\": null, \"c\": null}}",
when(TREATING_NULL_AS_ABSENT));
IGNORING_ARRAY_ORDER - ignores order in arrays
assertJsonEquals("{\"test\":[1,2,3]}",
"{\"test\":[3,2,1]}",
when(IGNORING_ARRAY_ORDER));
IGNORING_EXTRA_ARRAY_ITEMS - ignores unexpected array items
assertJsonEquals("{\"test\":[1,2,3]}",
"{\"test\":[1,2,3,4]}",
when(IGNORING_EXTRA_ARRAY_ITEMS));
assertJsonEquals("{\"test\":[1,2,3]}",
"{\"test\":[5,5,4,4,3,3,2,2,1,1]}",
when(IGNORING_EXTRA_ARRAY_ITEMS, IGNORING_ARRAY_ORDER));
IGNORING_EXTRA_FIELDS - ignores extra fields in the compared value
assertThatJson("{\"test\":{\"a\":1, \"b\":2, \"c\":3}}")
.when(IGNORING_EXTRA_FIELDS)
.isEqualTo("{\"test\":{\"b\":2}}");
IGNORE_VALUES - ignores values and compares only types
assertJsonEquals("{\"test\":{\"a\":1,\"b\":2,\"c\":3}}",
"{\"test\":{\"a\":3,\"b\":2,\"c\":1}}",
when(IGNORING_VALUES));
It is possible to combine options.
assertJsonEquals("{\"test\":[{\"key\":1},{\"key\":2},{\"key\":3}]}",
"{\"test\":[{\"key\":3},{\"key\":2, \"extraField\":2},{\"key\":1}]}",
when(IGNORING_ARRAY_ORDER, IGNORING_EXTRA_FIELDS));
In Hamcrest assertion you can set the option like this
assertThat("{\"test\":{\"a\":1, \"b\":2, \"c\":3}}",
jsonEquals("{\"test\":{\"b\":2}}").when(IGNORING_EXTRA_FIELDS));
You can define options locally (for specific paths) by using when(path(...), then(...))
:
// ignore array order for [*].a
// AssertJ
assertThatJson("{\"test\":{\"a\":1,\"b\":2,\"c\":3}}").when(paths("test.c"), then(IGNORING_VALUES))
.isEqualTo("{\"test\":{\"a\":1,\"b\":2,\"c\":4}}");
// Vintage
assertJsonEquals("[{\"a\": [1,2,3]}, {\"a\": [4,5,6]}]", "[{\"a\": [2,1,3]}, {\"a\": [6,4,5]}]",
when(path("[*].a"), then(IGNORING_ARRAY_ORDER)));
// ignore array order everywhere but [*].a
assertJsonEquals("[{\"a\": [1,2,3]}, {\"a\": [4,5,6]}]", "[{\"a\": [4,5,6]}, {\"a\": [1,2,3]}]",
when(IGNORING_ARRAY_ORDER).when(path("[*].a"), thenNot(IGNORING_ARRAY_ORDER)));
// ignore extra fields in the object obj
assertJsonEquals("{\"obj\":{\"a1\":1}}", "{\"obj\":{\"a1\":1,\"a2\":2}}",
when(path("obj"), then(IGNORING_EXTRA_FIELDS)));
// ignore extra array items in the array
assertJsonEquals("{\"array\":[1,2]}", "{\"array\":[1,2,3]}",
when(path("array"), then(IGNORING_EXTRA_ARRAY_ITEMS)));
// Hamcrest
assertThat("{\"test\":{\"a\":1,\"b\":2,\"c\":3}}",
jsonEquals("{\"test\":{\"a\":1,\"b\":2,\"c\":4}}").when(path("test.c"), then(IGNORING_VALUES)));
Note that TREATING_NULL_AS_ABSENT and IGNORING_VALUES require exact paths to ignored fields:
// ignoring number and str
assertJsonEquals("{\"number\":1,\"str\":\"string\"}", "{\"number\":2,\"str\":\"string2\"}",
when(paths("a", "b"), then(IGNORING_VALUES)));
// treat null B as absent B
assertJsonEquals("{\"A\":1}", "{\"A\":1,\"B\":null}",
when(path("B"), then(TREATING_NULL_AS_ABSENT)));
All other options require paths to objects or arrays where values or order should be ignored.
You can use negative numbers to index arrays form the end
assertThatJson("{\"root\":{\"test\":[1,2,3]}}")
.node("root.test[-1]").isEqualTo(3);
Numbers are by default compared in the following way:
- If the type differs, the number is different. So 1 and 1.0 are different (int vs. float). This does not apply when Moshi is used since it parses all numbers as Doubles.
- Floating number comparison is exact
You can change this behavior by setting tolerance
assertJsonEquals("1", "\n1.009\n", withTolerance(0.01));
or for fluent assertions
assertThatJson("{\"test\":1.00001}").node("test").withTolerance(0.001).isEqualTo(1);
Or you can use Hamcrest matcher
import static java.math.BigDecimal.valueOf;
...
assertThatJson("{\"test\":1.10001}").node("test")
.matches(closeTo(valueOf(1.1), valueOf(0.001)));
Sometimes you have dots in JSON element names and you need to address those elements. It is possible to escape dots like this
assertThatJson("{\"name.with.dot\": \"value\"}").node("name\\.with\\.dot").isStringEqualTo("value");
Writing JSON string in Java is huge pain. JsonUnit parses expected values leniently so you do not have to quote keys and you can use single quotes instead of double quotes. Please note that the actual value being compared is parsed in strict mode.
assertThatJson("{\"a\":\"1\", \"b\":2}").isEqualTo("{b:2, a:'1'}");
If you need to customize Jacson 2 Object Mapper, you can do using SPI.
Implement net.javacrumbs.jsonunit.providers.Jackson2ObjectMapperProvider
.
public class Java8ObjectMapperProvider implements Jackson2ObjectMapperProvider {
private final ObjectMapper mapper;
private final ObjectMapper lenientMapper;
public Java8ObjectMapperProvider() {
mapper = new ObjectMapper().registerModule(new JavaTimeModule());
mapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);
lenientMapper = new ObjectMapper().registerModule(new JavaTimeModule());
lenientMapper.configure(JsonParser.Feature.ALLOW_UNQUOTED_FIELD_NAMES, true);
lenientMapper.configure(JsonParser.Feature.ALLOW_COMMENTS, true);
lenientMapper.configure(JsonParser.Feature.ALLOW_SINGLE_QUOTES, true);
}
@Override
public ObjectMapper getObjectMapper(boolean lenient) {
return lenient ? lenientMapper : mapper;
}
}
and register it in META-INF/services/net.javacrumbs.jsonunit.providers.Jackson2ObjectMapperProvider
.
See this example.
Although the differences are printed out by the assert statement, sometimes you use JsonUnit with other libraries like
Jadler that do not print the differences between documents. In such case, you can switch on the
logging. JsonUnit uses SLF4J. The only thing you need to do is to configure your logging
framework to log net.javacrumbs.jsonunit.difference
on DEBUG level.
JsonUnit is trying to cleverly match which JSON library to use. In case you need to change the default behavior, you can use
json-unit.libraries system property. For example -Djson-unit.libraries=jackson2,gson
or System.setProperty("json-unit.libraries", "jackson2");
. Supported values are gson, json.org, moshi, jackson2
JsonUnit is licensed under Apache 2.0 licence.
- Parse content as UTF-8 in Spring MVC test if not specified otherwise #212
- Fix Kotlin 'Inaccessible type' warning in when-path (@Vladiatro)
- Load resources as UTF-8 (@bencampion)
- Support for PathOptions
- AssertJ - support for chaining assertions in the same root
- Support for json-path in AssertJ
whenIgnoringPaths
- Hamcrest upgraded to 2.1
- AssertJ dependency upgraded to 3.12.3 (requires AssertJ > 3.10.0)
- hamcrest-core dependency marked as required
- #185 JsonUnitRequestMatchers for client-side REST testing
- Support for array (non)emptiness in Fluent assert
- Support for Johnzon (requires 1.1.12) (thanks to elexx)
- Ignoring paths even when present in expected value #182
- Fixed AssertionErrors messages in MultipleFailuresError #181
- Path with backspaces matching fixed #176
- ${json-unit.ignore-elements} introduced
- Array comparison optimization
- Fix bug and performance issues in array comparison
- Performance optimizations
- Introduced JsonAssertions.value()
- Fixed AssertJ withFailMessage
- Support for Jackson 2 ObjectMapper customization
- Some AbstractObjectAssert marked as unsupported
- Using opentest4j
- Refactored exception reporting
- Better exception reporting
- Fixed invalid Automatic-Module-Name
- Fixed missing node handling with JsonPath
- Fixed some complex AsserJ comaprisons
- Fixed #144 (AssertJ object handling)
- Support for # instead of $ in placeholders
- More expressive Spring assertions (isNull, isNotNull, isTrue, isFalse)
- AssertJ - fix bug with '%' in error message
- Removed support for Jackson 1
- Support for and() in AssertJ assert
- asNumber() in AssertJ added
- Allow description before inPath() in AssertJ
- Fixed JsonPath bug #132
- Fixed AssertJ number comparison with Jackson 2 #130
- Fixed AssertJ asString() #131
- Depends on Java 8
- Some deprecated APis removed
- Introduces AssertJ module
- Introduces JsonPath module
Please do not hesitate to report issues.
- Introduced DifferenceContext into DifferenceListener
- Introduced DifferenceListener
- Array comparison reports extra/missing elements when comparing with array order preserved.
- Fixed error in JsonFluentAssert.ofLength error message
- Fixed matcher handling when comparing arrays #111
- [*] placeholder works even when ignoring array order
- Fixing matcher pattern
- Fixing NPE when accessing element of nonexistent array
- Support for [*] placeholder in ignored path
- Better array comparison and error messages
- IDE friendly error messages
- isStringEqualTo is chainable (thanks to @gsson)
- Dropped support of Java 5
- Automatic module names added
- Support for Jackson BinaryNode
- Support for ignoring paths whenIgnoringPaths()
- Support for parametres in custom matchers ${json-unit.matches:matcherName}param
- Support for custom matchers ${json-unit.matches:matcherName}
- Support for Moshi
- Better diff reporting for unordered arrays with single difference
- Negative array indexes added (thanks roxspring)
- isArray().thatContains(...) fluent assert added
- Resource reading helper added
- System property to specify JSON libraries to be used
- Array pattern accepts non-word characters
- isAbsent and isPresent checks take TREAT_NULL_AS_ABSENT into account
- Dependency on slf4j made optional
- Preferring org.json library to process JSONArray
- Support for org.json library
- Fix: Element out of array bounds is treated as missing
- Support for any-* placeholders
- Single quote values in expected String allowed
- Lenient parsing of expected values
- Option setting methods made deprecated if called after assertion in JsonFluentAssert
- JsonFluentAssert constructors made private. Please file an issue if you need them.
- Added support for IGNORING_EXTRA_ARRAY_ITEMS
- Made compatible with Jackson 1.4
- OSGi support thanks to @amergey
- Support for Spring MVC tests assertions
- Gson nodes are not reconverted
- Added support for Hamcrest matchers
- Fixed handling of empty value in the expected parameter
- Support for dot in node name
- Added isObject method to fluent assertions
- Jackson 1 is preferred if the serialized class contains Jackson1 annotation
- Added support for regular expressions
- isStringEqualTo() added to fluent assertions
- isArray added to fluent assertions
- One runtime now supports Jackson 1.x, Jackson 2.x and Gson
- Internal JsonUnit class changed in backwards incompatible way
- Options renamed
- assertJsonNot* asserts added
- Support for online configuration in Hamcrest and standard asserts added
- Error messages changed a bit when comparing structures
- Refactoring of internal classes
- Support for ignoring array order
- Support for ignoring values
- Support for ignoring extra fields
- Treat null as absent added
- Absence/presence tests added
- Path to array in root fixed
- Numeric comparison tolerance added
- jsonStringEquals and jsonStringPartEquals added
- Generics in JsonMatchers fixed
- Simplified API
- Invalid JSONs in String comparison quoted
- Runtime incompatible (compile-time compatible) changes
- Switched to Jackson 2.x
- Fluent JsonAssert renamed to JsonFluentAssert
- Fluent assertions made framework independent.
- Switched from FEST to AssertJ
- Modules refactored
- Added support for FEST assert
- Logging categories changed
- Added logging
- Ignore placeholder "${json-unit.ignore}" added
- Text differences are closed in quotes
- Matchers added
- Made Java 5 compatible
- assertJsonPartStructureEquals added
- assertJsonPartEquals added
- Better error messages in case of different types
- Support for array types and other oddities in root
- Support for nulls