Convert CacheKey to record

Converts the CacheKey class to use Java 17 records, reducing boilerplate
and improving memory layout. Updates all getter method calls to use
record accessors and adds proper Javadoc for record parameters.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: oschwald

src/main/java/com/maxmind/db/CacheKey.java

@@ -6,61 +6,9 @@
  * of the value.
  *
  * @param <T> the type of value
+ * @param offset the offset of the value in the database file
+ * @param cls the class of the value
+ * @param type the type of the value
  */
-public final class CacheKey<T> {
-    private final int offset;
-    private final Class<T> cls;
-    private final java.lang.reflect.Type type;
-
-    CacheKey(int offset, Class<T> cls, java.lang.reflect.Type type) {
-        this.offset = offset;
-        this.cls = cls;
-        this.type = type;
-    }
-
-    int getOffset() {
-        return this.offset;
-    }
-
-    Class<T> getCls() {
-        return this.cls;
-    }
-
-    java.lang.reflect.Type getType() {
-        return this.type;
-    }
-
-    @Override
-    public boolean equals(Object o) {
-        if (o == null) {
-            return false;
-        }
-
-        CacheKey other = (CacheKey) o;
-
-        if (this.offset != other.offset) {
-            return false;
-        }
-
-        if (this.cls == null) {
-            if (other.cls != null) {
-                return false;
-            }
-        } else if (!this.cls.equals(other.cls)) {
-            return false;
-        }
-
-        if (this.type == null) {
-            return other.type == null;
-        }
-        return this.type.equals(other.type);
-    }
-
-    @Override
-    public int hashCode() {
-        int result = offset;
-        result = 31 * result + (cls == null ? 0 : cls.hashCode());
-        result = 31 * result + (type == null ? 0 : type.hashCode());
-        return result;
-    }
+public record CacheKey<T>(int offset, Class<T> cls, java.lang.reflect.Type type) {
 }

src/main/java/com/maxmind/db/Decoder.java

@@ -73,16 +73,16 @@ <T> T decode(int offset, Class<T> cls) throws IOException {
     }
 
     private <T> DecodedValue decode(CacheKey<T> key) throws IOException {
-        int offset = key.getOffset();
+        int offset = key.offset();
         if (offset >= this.buffer.capacity()) {
             throw new InvalidDatabaseException(
                 "The MaxMind DB file's data section contains bad data: "
                     + "pointer larger than the database.");
         }
 
         this.buffer.position(offset);
-        Class<T> cls = key.getCls();
-        return decode(cls, key.getType());
+        Class<T> cls = key.cls();
+        return decode(cls, key.type());
     }
 
     private <T> DecodedValue decode(Class<T> cls, java.lang.reflect.Type genericType)