ユーティリティ#

jimble-util には移送元から持ってきた道具が 約 28,000 行入っています。 ここは地図です。網羅ではなく「よく使うもの」と「引っかかるところ」を並べます。

Data#

io.jimble.util.data.Data は LinkedHashMap<String, Object> の派生です。 リクエストも SELECT の結果も JSON もこれで扱います（リクエストとレスポンス）。

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 の値は列（Column）で読み書きします。列版はテーブル名のネストを辿ります。

JSON#

自前実装です（Jackson も 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"));

型変換#

Convertor.convert(conf, src, 変換先.class) が入口です。 Bean ↔ Data ↔ Map ↔ List ↔ プリミティブが同じ1本を通ります。 data.convert(new MyBean()) も中身は同じものです。

HTTP クライアント#

JDK の HttpClient の薄いラッパで、メソッドごとにクラスがあります。

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

if (res.isError) {
	Log.error(res.errorException, "取得に失敗しました");
	return;
}

Data json = res.getContentJson();

• POST は HttpPostExecutor。addBodyForm(name, value) / setBodyJson(data)
• ファイルを1つでも足すと multipart になります（addBodyForm(name, file, contentType)）
• プロキシは setProxy(new HttpProxy(host, port, id, pass))
• 例外を投げません。isError を見てください（DB と同じ流儀）

CSV#

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

1行ずつ読みます（全部メモリに載せません）。書くほうは CsvWriter#writeLine(Object...)。

XML#

XmlParser.parse(file) で XmlData の木にします（全部メモリに載ります）。 組み立ては XmlBuilder.build(xmlData)。

ハッシュと暗号#

DB に置く key-value#

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

そのほか#