json4jsoup: JSON parser for jsoup (Java HTML Parser)

jsoup is a Java library for working with real-world HTML. It provides a very convenient API for extracting and manipulating data, using the best of DOM, CSS, and jquery-like methods.

See jsoup.org for downloads and the full API documentation, cookbook.

json4jsoup is a powerful JSON RFC 4627, 7158, RFC 7159 parser for jsoup. It can consume almost every text as JSON and convert it internally to an XML-tree.

All JSON elements are converted one-to-one into three XML tags (obj, arr, val), XML comment section, (very rare and with many details) "unk" tag and two main attributes (id, class).

Compatible with all versions of jsoup since 1.12.1. No extra dependencies!

example.json

/*
I am here: src\test\resources/example.json **/
{projects: [
	{
		project_name = 'Google Gson',
		'url': "https://github.com/google/gson",
		"rating": 4.956,
		"contributors": [{
				first_name: Jesse,,,, ' last  name ': "'Wilson ' ",
				"home_page": "https://medium.com/@swankjesse"
			}]
	},{
		"project_name" => jsoup

		"url": "https://jsoup.org";,;,;

		"rating"=5e10,
		'contributors': [
			{
				"first_name" = "Jonathan", "last_name" => "Hedley",
"home_page": "https://jhy.io"
			},{///2nd OBJ in Array
				"first_name": "Andrej", "last_name": "Fink";;; " home
     page ": " https://github.com/
  magicprinc ";
			}
		]
	}
]}

java

Document doc = Jsoup.parse(exampleJson, "UTF-8", "", JsonTreeBuilder.jsonParser());
assert "Fink".equals(doc.select("#contributors obj:eq(1) #last_name").text());
assert "jsoup".equals(doc.select("#projects #project_name.str.unquoted").text());
//
assertEquals("<arr><val class=\"bool\">true</val><val class=\"bool\">true</val></arr>", JsonTreeBuilder.jsonToXml("[true, true]"));

**internal XML tree 1 (with class metadata) **

<!--
I am here: src\test\resources/example.json *-->
<obj>
 <arr id="projects">
  <obj>
   <val id="project_name" class="apos quoted str"> Google Gson </val>
   <val id="url" class="quot quoted str"> https://github.com/google/gson </val>
   <val id="rating" class="unquoted num"> 4.956 </val>
   
   <arr id="contributors">
    <obj>
     <val id="first_name" class="unquoted str"> Jesse </val>
     <val id=" last  name " class="quot quoted str"> 'Wilson '  </val>
     <val id="home_page" class="quot quoted str"> https://medium.com/@swankjesse </val>
    </obj>
   </arr>
  </obj>
  
  <obj>
   <val id="project_name" class="unquoted str"> jsoup </val>
   <val id="url" class="quot quoted str"> https://jsoup.org </val>
   <val id="rating" class="unquoted num"> 5e10 </val>
   
   <arr id="contributors">
    <obj>
     <val id="first_name" class="quot quoted str"> Jonathan </val>
     <val id="last_name" class="quot quoted str"> Hedley </val>
     <val id="home_page" class="quot quoted str"> https://jhy.io </val>
    </obj>
    
    <obj>
     <!--/2nd OBJ in Array-->
     <val id="first_name" class="quot quoted str"> Andrej </val>
     <val id="last_name" class="quot quoted str"> Fink </val>
     <val id=" home
     page " class="quot quoted str"> https://github.com/
  magicprinc  </val>
    </obj>
   </arr>
  </obj>
 </arr>
</obj>

or

Document doc = Jsoup.parse(exampleJson, "UTF-8", "", JsonTreeBuilder.jsonParser(false));//no extra info in attrs

**internal XML tree 2 (no metadata) **

<!--
I am here: src\test\resources/example.json *-->
<obj><arr id="projects">
  <obj>
   <val id="project_name">Google Gson</val>
   <val id="url">https://github.com/google/gson</val>
   <val id="rating">4.956</val>
   <arr id="contributors">
    <obj>
     <val id="first_name">Jesse</val>
     <val id=" last  name ">'Wilson ' </val>
     <val id="home_page">https://medium.com/@swankjesse</val>
    </obj>
   </arr>
  </obj>
  
  <obj>
   <val id="project_name">jsoup</val>
   <val id="url">https://jsoup.org</val>
   <val id="rating">5e10</val>
   <arr id="contributors">
    <obj>
     <val id="first_name">Jonathan</val>
     <val id="last_name">Hedley</val><val id="home_page">https://jhy.io</val>
    </obj>
    <obj><!--/2nd OBJ in Array-->
     <val id="first_name">Andrej</val>
     <val id="last_name">Fink</val><val id=" home
     page "> https://github.com/
  magicprinc </val>
    </obj>
   </arr>
  </obj>
</arr></obj>

More examples are available in 135 unit-tests in org.jsoup.parser.JsonTreeBuilderTest.

Simple example: ExampleTest

Download

dependencies {
  implementation 'com.github.magicprinc:jsoup.json:1.17.1'
}