Utilities#

jimble-util holds around 28,000 lines of tools brought over from the code this was ported from. This page is a map. Not an exhaustive list — what you use often, and where you get caught.

Data#

io.jimble.util.data.Data is a subclass of LinkedHashMap<String, Object>. Requests, SELECT results, and JSON are all handled with it (Request and response).

Data data = new Data();
data.putData(SITE_ID, 1L);
data.putData(SITE_NAME, "俺的まとめ");

Data site = data.getData("site");

assertEquals(1L, site.getLong("id"));
assertEquals("俺的まとめ", site.getString("name"));

DB values are read and written by column (Column). The column versions follow the table-name nesting.

JSON#

It is our own implementation (neither Jackson nor Gson).

Data nested = new Data();
nested.put("title", "記事タイトル");

Data data = new Data();
data.put("name", "俺的まとめ");
data.put("count", 3);
data.put("feed", nested);
data.put("tags", List.of("あ", "い"));

String json = data.getJsonString();
Data restored = Data.fromJsonString(json);

assertEquals("俺的まとめ", restored.getString("name"));
assertEquals(3, restored.getInt("count"));
assertEquals("記事タイトル", restored.getData("feed").getString("title"));
assertEquals(List.of("あ", "い"), restored.getStringList("tags"));

Type conversion#

Convertor.convert(conf, src, Target.class) is the way in. Bean ↔ Data ↔ Map ↔ List ↔ primitives all go down the same single path. data.convert(new MyBean()) is the same machinery underneath.

HTTP client#

A thin wrapper over the JDK's HttpClient, with a class per method.

HttpGetExecutor res = new HttpGetExecutor()
	.setUrl("https://example.com/api")
	.addHeader("Accept", "application/json")
	.setTimeout(5000)
	.execute();

if (res.isError) {
	Log.error(res.errorException, "could not fetch");
	return;
}

Data json = res.getContentJson();

• POST is HttpPostExecutor. addBodyForm(name, value) / setBodyJson(data)
• Add even one file and it becomes multipart (addBodyForm(name, file, contentType))
• The proxy is setProxy(new HttpProxy(host, port, id, pass))
• It does not throw. Check isError (the same style as the DB)

CSV#

try (CsvReader reader = new CsvReader(new File("in.csv"))) {
	while (reader.next()) {
		String name = reader.getString("name");
	}
}

It reads a line at a time (it does not put the whole file in memory). For writing, CsvWriter#writeLine(Object...).

XML#

XmlParser.parse(file) turns it into a tree of XmlData (all of it goes in memory). To build one, XmlBuilder.build(xmlData).

Hashing and encryption#

Key-value stored in the DB#

DBValue.set(db, "last_imported_at", "2026-09-07");
String value = DBValue.getString(db, "last_imported_at", "");

The rest#