How lionsoul2014/ip2region works
ip2region combines an offline IPv4/IPv6 localization library with tools for managing its xdb data. The main user workflow is to submit an IP address to a language binding, search an xdb database, and receive region information. Separately, maker tools generate and maintain xdb from source IP data, including processing, editing, deduplication, and compression. The README documents broad language support; source excerpts are uneven, so some binding and maker relationships are shown only at the documented subsystem level.
Main entry points: binding Query bindings · Ip2Region.java Java service · searcher.go Go searcher · Searcher.java Java searcher
Components 16
IP lookup
- Query bindings
binding - Go CLI
binding/golang/main.go - Go service
binding/golang/service - Java service
binding/java/src/main/java/org/lionsoul/ip2region/service/Ip2Region.java - C# searcher
binding/csharp/IP2Region.Net/XDB/Searcher.cs
Query internals
- Go searcher
binding/golang/xdb/searcher.go - Java searcher
binding/java/src/main/java/org/lionsoul/ip2region/xdb/Searcher.java - Cache configuration
binding/java/src/main/java/org/lionsoul/ip2region/service/Config.java - xdb database
Data management
- Maker commands
maker/golang/main.go - Edit and process
maker/golang/cmd - xdb generation
maker/python/xdb/maker.py
Language clients
- Other bindings
binding
Other components
- Application
- Source IP data
- Region result
Connections 19
- Application → Query bindings: submits IP
README.md - Query bindings → Go CLI: uses binding
binding/golang/main.go - Go CLI → Go service: creates service
binding/golang/main.go - Go service → Go searcher: uses searcher
binding/golang/service/searcher_pool.go - Query bindings → Java service: uses binding
binding/java/src/main/java/org/lionsoul/ip2region/SearcherTest.java - Java service → Java searcher: calls searcher
binding/java/src/main/java/org/lionsoul/ip2region/service/Ip2Region.java - Java service → Cache configuration: uses config
binding/java/src/main/java/org/lionsoul/ip2region/service/Ip2Region.java - Query bindings → C# searcher: uses binding
binding/csharp/IP2Region.Net/Extensions/ServiceCollectionExtensions.cs - Query bindings → Other bindings: offers clients
README.md - Go searcher → xdb database: reads xdb
- Java searcher → xdb database: reads xdb
binding/java/src/main/java/org/lionsoul/ip2region/xdb/Searcher.java - C# searcher → xdb database: reads xdb
- Java searcher → Region result: returns region
binding/java/src/main/java/org/lionsoul/ip2region/xdb/Searcher.java - Go searcher → Region result: returns region
- Source IP data → Maker commands: provides input
README.md - Maker commands → Edit and process: dispatches commands
maker/golang/main.go - Maker commands → xdb generation: dispatches generation
maker/golang/main.go - xdb generation → xdb database: generates xdb
README.md - Edit and process → Source IP data: updates source