Package co.mindus.ip2location
Origin and sharing. The library is shared with another Mindus server product under the same package name. The two copies are maintained separately: this copy targets Java 25 and carries no reference to any host server. Everything host-specific - logging, settings, the cluster index, the administration UI - reaches it through the interfaces IEventLogger, IThreadFactory and the IP2LocationService.Builder; the IIZI integration lives in com.iizix.server.geo.ip2location.
Layers. IP2LocationManager (singleton, hot-swap, recovery, status listeners) over IP2LocationService (downloads, scheduler, thread-safe lookups) over IP2Location (the BIN file reader). EventLogManager and IP2LocationEventLog are the two event logs (pipe-delimited text and JSON lines with session counters).
Third-party material. The BIN reader's field position tables and binary search follow the upstream IP2Location Java component (com.ip2location, version 8.13.0, MIT licence, Copyright (c) 2025-2026 IP2Location). The IP2Location LITE data the service downloads is licensed separately by IP2Location with attribution requirements; the download token is the operator's own.
- Author:
- Christopher Mindus
- ClassDescriptionEnumeration of available IP2Location LITE database types.Manages the IP2Location event log file.Represents a single event entry in the log.Types of events that can be logged.Log levels for events.Statistics about the event log.Immutable result object containing geolocation data for an IP address lookup.Builder for creating
GeoLocationinstances.Enumeration of possible lookup result statuses.Event logger interface for IP2Location components integrated with a host application server and its logging framework.Callback interface for asynchronous service initialization.Low-level reader for IP2Location BIN database files.Manages event and error logging for IP2Location service.Event category for classification.Event severity level.Represents a single log entry.Singleton manager for IP2Location services with hot-swap reconfiguration support.High-level service for IP geolocation lookups with automatic database updates.Builder for creatingIP2LocationServiceinstances.Low-level result object from IP2Location BIN database queries.Listener interface for receiving status updates fromIP2LocationServiceandIP2LocationManager.Categories of errors that can occur in the IP2Location service.Factory interface for creating threads used by IP2Location components.Configuration for automatic recovery behavior in IP2Location services.Builder for creatingRecoveryConfiginstances.Actions to take when recovery conditions are met.