JSONassert

JSONassert

简介

用更少的代码编写JSON单元测试。非常适合用来测试REST接口

JSON代码测试就像比较字符串。 JSONassert将字符串转换为JSON对象，并将逻辑结构和数据与实际JSON进行比较。 当strict（严格模式）设置为false（推荐设置）时，它会允许数据重排序以及结果可扩展（只要对比的JSON包含了所有预期JSON的所有字段），从而使测试不那么脆弱。

支持的测试框架：

JUnit

JSONassert当前版本为1.5.0

示例

使用JSONassert，你可以编写并维护以下代码：

JSONObject data = getRESTData("/friends/367.json");
String expected = "{friends:[{id:123,name:\"Corby Page\"},{id:456,name:\"Carter Page\"}]}";
JSONAssert.assertEquals(expected, data, false);

而不用这样：

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"));
}

报错消息

JSONassert的报错消息简洁明了，尤其在对比很长的JSON串时，你可以不用肉眼逐行查错，例如在以下代码中：

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);

其返回结果：

friends[id=3].pets[]: Expected bird, but not found ; friends[id=3</