4.1.0

• Fixed unbounded off-heap memory growth when initializing the reader in
  FileMode.MEMORY. The previous implementation read the database via
  FileChannel.read() into a heap buffer, which causes the JDK to cache
  temporary direct ByteBuffers in per-thread storage
  (sun.nio.ch.Util.BufferCache). Repeated initialization across different
  threads could grow this cache without bound. The reader now uses
  FileInputStream for MEMORY mode, which bypasses the cache.
  FileMode.MEMORY_MAPPED was unaffected.
• Fixed a latent short-read bug in the multi-chunk FileMode.MEMORY
  load path introduced in 4.0.0. FileChannel.read(ByteBuffer) is not
  contractually obligated to fully fill the destination buffer; a
  short read could have caused silent truncation of an in-memory
  database. Affects databases larger than ~2GB (the default chunk
  size). The new chunked read loop retries until each chunk is fully
  populated.

4.0.2

• Fixed a bug where enums with @MaxMindDbCreator would throw
  ConstructorNotFoundException when the data was stored via a pointer
  in the database. This commonly occurred with deduplicated data in larger
  databases. Reported by Fabrice Bacchella. GitHub #644 in GeoIP2-java.
• Improved error messages when constructor invocation fails. The error now
  correctly identifies null values being passed to primitive parameters
  instead of reporting misleading boxed/primitive type mismatches.

4.0.1

• DecodedValue is now a public class again, allowing custom NodeCache
  implementations to be created. The class was inadvertently made
  package-private in 4.0.0. Reported by Alexandros Leventakis. GitHub #321.

4.0.0

This is a major release with several breaking changes. Please see
UPGRADING.md for detailed migration instructions.

• Java 17 or greater is now required.
• Added support for MaxMind DB files larger than 2GB. The library now uses
  an internal Buffer abstraction that can handle databases exceeding the
  2GB ByteBuffer limit. Files under 2GB continue to use a single ByteBuffer
  for optimal performance. Requested by nonetallt. GitHub #154. Fixed by
  Silvano Cerza. GitHub #289.
• Metadata.getBuildDate() has been replaced with buildTime(), which returns
  java.time.Instant instead of java.util.Date. The instant represents the
  database build time in UTC.
• DatabaseRecord, Metadata, Network, and internal DecodedValue classes
  have been converted to records. The following API changes were made:
  • DatabaseRecord.getData() and DatabaseRecord.getNetwork() have been
    replaced with record accessor methods data() and network().
  • Simple getter methods on Metadata (e.g., getBinaryFormatMajorVersion(),
    getDatabaseType(), etc.) have been replaced with their corresponding record
    accessor methods (e.g., binaryFormatMajorVersion(), databaseType(), etc.).
  • Network.getNetworkAddress() and Network.getPrefixLength() have been
    replaced with record accessor methods networkAddress() and prefixLength().
  • Removed the legacy DatabaseRecord(T, InetAddress, int) constructor; pass a
    Network when constructing records manually.
• Deserialization improvements:
  • If no constructor is annotated with @MaxMindDbConstructor, records now
    use their canonical constructor automatically. For non‑record classes with
    a single public constructor, that constructor is used by default.
  • @MaxMindDbParameter annotations are now optional when parameter names
    match field names in the database: for records, component names are used;
    for classes, Java parameter names are used (when compiled with
    -parameters). Annotations still take precedence when present.
  • Added @MaxMindDbIpAddress and @MaxMindDbNetwork annotations to inject
    the lookup IP address and resulting network into constructors. Annotation
    metadata is cached per type to avoid repeated reflection overhead.

3.2.0

• First release using Central Portal instead of Legacy OSSRH.
• Improve internal uses of types and other code cleanups. Pull requests
  by Philippe Marschall. GitHub #246, #247, #248, and #249.

3.1.1

• When handling a deserialization exception, the decoder now avoids
  throwing a NullPointerException when one of the constructor arguments
  is null. Reported by Keith Massey. GitHub #164.

3.1.0

• Reader supports iterating over the whole database or within a network.

3.0.0

• Java 11 or greater is now required.
• This library is now a Java module.

2.1.0

• Messages for DeserializationException have been improved, and the cause
  is included, if any. Moreover, the message provides detail about the involved
  types, if the exception is caused by an IllegalArgumentException.

2.0.0

• No changes since 2.0.0-rc2.