JSONassert
Write JSON unit tests in less code. Great for testing REST interfaces.
Summary
Write JSON tests as if you are comparing a string. Under the covers, JSONassert converts your string into a JSON object and compares the logical structure and data with the actual JSON. When strict is set to false (recommended), it forgives reordering data and extending results (as long as all the expected elements are there), making tests less brittle.
Supported test frameworks:
Examples
In JSONassert you write and maintain something like this:
JSONObject data = getRESTData("/friends/367.json");
String expected = "{friends:[{id:123,name:\"Corby Page\"},{id:456,name:\"Carter Page\"}]}";
JSONAssert.assertEquals(expected, data, false);
instead of all this:
JSONObject data = getRESTData("/friends/367.json");
Assert.assertTrue(data.has("friends"));
Object friendsObject = data.get("friends");
Assert.assertTrue(friendsObject instanceof JSONArray);
JSONArray friends = (JSONArray) friendsObject;
Assert.assertEquals(2, data.length());
JSONObject friend1Obj = friends.getJSONObject(data.get(0));
Assert.true(friend1Obj.has("id"));
Assert.true(friend1Obj.has("name"));
JSONObject friend2Obj = friends.getJSONObject(data.get(1));
Assert.true(friend2Obj.has("id"));
Assert.true(friend2Obj.has("name"));
if ("Carter Page".equals(friend1Obj.getString("name"))) {
Assert.assertEquals(123, friend1Obj.getInt("id"));
Assert.assertEquals("Corby Page", friend2Obj.getString("name"));
Assert.assertEquals(456, friend2Obj.getInt("id"));
}
else if ("Corby Page".equals(friend1Obj.getString("name"))) {
Assert.assertEquals(456, friend1Obj.getInt("id"));
Assert.assertEquals("Carter Page", friend2Obj.getString("name"));
Assert.assertEquals(123, friend2Obj.getInt("id"));
}
else {
Assert.fail("Expected either Carter or Corby, Got: " + friend1Obj.getString("name"));
}
Error Messages
We tried to make error messages easy to understand. This is really important, since it gets hard for the eye to pick out the difference, particularly in long JSON strings. For example:
String expected = "{id:1,name:\"Joe\",friends:[{id:2,name:\"Pat\",pets:[\"dog\"]},{id:3,name:\"Sue\",pets:[\"bird\",\"fish\"]}],pets:[]}";
String actual = "{id:1,name:\"Joe\",friends:[{id:2,name:\"Pat\",pets:[\"dog\"]},{id:3,name:\"Sue\",pets:[\"cat\",\"fish\"]}],pets:[]}"
JSONAssert.assertEquals(expected, actual, false);
returns the following:
friends[id=3].pets[]: Expected bird, but not found ; friends[id=3].pets[]: Contains cat, but not expected
Which tells you that the pets array under the friend where id=3 was supposed to contain "bird", but had "cat" instead. (Maybe the cat ate the bird?)
QuickStart
To use, download the JAR or add the following to your project's pom.xml:
<dependency>
<groupId>org.skyscreamer</groupId>
<artifactId>jsonassert</artifactId>
<version>1.5.0</version>
<scope>test</scope>
</dependency>
Write tests like this:
JSONAssert.assertEquals(expectedJSONString, actualJSON, strictMode);
Who uses JSONassert?
- yoga - A relational REST framework
- hamcrest-json - Hamcrest matchers for comparing JSON documents
- Mule ESB
- GroupDocs
- Shazam
- Thucydides
org.json
This implementation uses a clean-room implementation of the org.json library implemented for the Android system, released under the Apache 2.0 license. See com.vaadin.external.google:android-json That jar does not include the org.json.JSONString interface, so a new implementation of that interface is added to this source.
59 Sep 17, 2022
719 Dec 29, 2022
81 Nov 7, 2022
1.3k Dec 30, 2022
5.9k Jan 5, 2023
1 Nov 9, 2021
0 Mar 18, 2022
14 Jan 4, 2023
11 Jan 3, 2022
2 Apr 12, 2022
5 Aug 21, 2019
835 Jan 2, 2023
21.7k Jan 8, 2023
454 Dec 31, 2022
3.2k Dec 18, 2022
8.7k Dec 31, 2022
25.1k Dec 31, 2022
510 Dec 30, 2022
100 Jan 1, 2023