From d1e9b6e3bcff9ab9f151957f6ebe80812116ecd8 Mon Sep 17 00:00:00 2001 From: lion Date: Sat, 13 Sep 2025 00:37:51 +0800 Subject: [PATCH] Docs for the java maker with IPv6 supported --- maker/java/ReadMe.md | 30 +++++++++++++++++++----------- 1 file changed, 19 insertions(+), 11 deletions(-) diff --git a/maker/java/ReadMe.md b/maker/java/ReadMe.md index f96c112..dc5d0a8 100644 --- a/maker/java/ReadMe.md +++ b/maker/java/ReadMe.md @@ -11,25 +11,33 @@ mvn clean compile package # 数据生成 -通过 `java -jar ip2region-maker-{version}.jar` 来生成 ip2region.xdb 二进制文件： +通过 `java -jar ip2region-maker-{version}.jar` 来生成 xdb 二进制文件： ```bash -➜ java git:(java_xdb_maker) ✗ java -jar ./target/ip2region-maker-1.0.0.jar +➜ java git:(master) java -jar target/ip2region-maker-3.0.0.jar ip2region xdb maker java -jar ip2region-maker-{version}.jar [command options] options: - --src string source ip text file path - --dst string destination binary xdb file path + --src string source ip text file path + --dst string destination binary xdb file path + --version string IP version, options: ipv4/ipv6, specify this flag so you don't get confused + --field-list string field index list imploded with ',' eg: 0,1,2,3-6,7 + --log-level string set the log level, options: debug/info/warn/error ``` -例如，通过默认的 data/ip.merge.txt 原数据，在当前目录生成一个 ip2region.xdb 二进制文件： +例如，通过默认的 data/ipv4_source.txt 原始数据，在当前目录生成一个 IPv4 的 ip2region_v4.xdb 二进制文件： ```bash -➜ java git:(java_xdb_maker) ✗ java -jar ./target/ip2region-maker-1.0.0.jar --src=../../data/ip.merge.txt --dst=./ip2region.xdb -# 会看到一堆输出，最终会看到如下输出表示运行成功 +java -jar target/ip2region-maker-3.0.0.jar --src=../../data/ipv4_source.txt --dst=./ip2region_v4.xdb --version=ipv4 ... -2022-07-15 20:21:29 INFO org.lionsoul.ip2region.xdb.Maker try to write the vector index block ... -2022-07-15 20:21:29 INFO org.lionsoul.ip2region.xdb.Maker try to write the segment index ptr ... -2022-07-15 20:21:29 INFO org.lionsoul.ip2region.xdb.Maker write done, dataBlocks: 13804, indexBlocks: (683591, 720221), indexPtr: (982904, 11065984) -2022-07-15 20:21:29 INFO org.lionsoul.ip2region.MakerTest Done, elapsed: 50 s +2025-09-13 00:33:06 INFO org.lionsoul.ip2region.xdb.Maker write done, dataBlocks: 13827, indexBlocks: (683843, 720464), indexPtr: (955933, 11042415) +2025-09-13 00:33:06 INFO org.lionsoul.ip2region.MakerApp Done, elapsed: 2 s +``` + +例如，通过默认的 data/ipv6_source.txt 有原始据，在当前目录生成一个 IPv6 的 ip2region_v6.xdb 二进制文件： +```bash +java -jar target/ip2region-maker-3.0.0.jar --src=../../data/ipv6_source.txt --dst=./ip2region_v6.xdb --version=ipv6 +... +2025-09-13 00:35:34 INFO org.lionsoul.ip2region.xdb.Maker write done, dataBlocks: 120446, indexBlocks: (16789611, 16855074), indexPtr: (6585371, 647078145) +2025-09-13 00:35:34 INFO org.lionsoul.ip2region.MakerApp Done, elapsed: 67 s ``` 生成过程中数据字段自定义请参考 [xdb-v4文件生成#自定义数据字段](https://ip2region.net/doc/data/ipv4_xdb_make#field-list)