4.103.0

java-util 4.103.0

Maven Central: com.cedarsoftware:java-util:4.103.0

Highlights

New APIs

• com.cedarsoftware.util.internal.VectorizedArrays — exposes equalsRange / mismatchRange / compareRange for both char[] and byte[]. Dispatches at runtime to JDK 9+ SIMD-vectorized Arrays.* intrinsics, with hand-rolled loop fallbacks for JDK 8. Resolution happens once at class load via MethodHandles, so per-call cost is a static-field read + invokeExact. Internal package for now; promoted to public API once the contract stabilizes.
• Converter.convert(String, byte[].class) (and transitively String → ByteBuffer) performs multi-format detection — stringified JSON number arrays, spaced hex, unspaced hex (length ≥ 8, catches CAFEBABE/DEADBEEF magic numbers, compact UUIDs, SHA hashes), URL-safe Base64, then standard Base64. Tightness rules prevent short tokens like "DATA"/"ABCD" from being mis-classified and let them fall through to the historical charset path.
• MapConversions.toByteArray (and refactored toByteBuffer) handles the wrapped-form contract {"@type":"<type>","value":"<base64>"}. Strict Base64 decode first to preserve round-trip for short blobs; falls through to general Converter dispatch on failure. Enables clean round-trip of the wrapped form that JsonGenerator.writeBinary emits in json-io 4.103.0.

Performance

• Cycle-tracking IdentityHashMap allocation deferred to first-need across ArrayConversions.arrayToArray / collectionToArray and CollectionConversions.arrayToCollection / collectionToCollection — and skipped entirely for primitive-target conversions (primitive arrays can't form cycles). Profiling showed ~560 ms of accumulated allocation+put cost in arrayToArray alone.
• ClassUtilities.newInstance() — cached constructor plans now fast-invoke non-varargs constructors when supplied arguments are already in constructor-parameter order and directly assignable, bypassing matcher allocations on repeated positional construction. No-arg cached construction reuses the empty argument-shape key and skips argument matching. Plan-cache entries retain constructor parameter metadata, avoiding repeated Constructor.getParameters() calls.

Build

• Test-scope dependency bumps — junit-jupiter 5.14.3 → 5.14.4; agrona 1.22.0 → 1.23.1 (still JDK 8 compatible).
• Registered the JDK 9+ standard @apiNote / @implSpec / @implNote tags with maven-javadoc-plugin so the tool no longer emits "unknown tag" warnings.

Full changelog: https://github.com/jdereg/java-util/blob/master/changelog.md

4.102.0

java-util 4.102.0

Maven Central: com.cedarsoftware:java-util:4.102.0

Highlights

Performance

• Vendored Werner Randelshofer's FastDoubleParser (MIT, Java 8) under com.cedarsoftware.util.fastdoubleparser. Eisel-Lemire algorithm for Double/Float; recursive-multiplication for BigDecimal/BigInteger. 2-4× faster than Double.parseDouble; 5-50× faster than new BigInteger(String) on 100+ digit values. Keeps java-util dependency-free (mirrors Jackson's vendoring choice).
• MathUtilities — added 20 fast number-parsing entry points (parseDouble/parseFloat/parseBigDecimal/parseBigInteger × CharSequence/char[]/char[]+offset+length/byte[]/byte[]+offset+length). The char[]/byte[] overloads avoid intermediate String materialization. Converter StringConversions routes through them, so Converter.convert(String, Double.class) and analogous calls pick up the speedup transparently.
• DateUtilities — two regex hot-path fixes: cached security-config getters now use a volatile tri-state instead of System.getProperty(...) per parse (removes the synchronized Hashtable lock); per-Pattern thread-local Matcher reuse instead of pattern.matcher(input) per call. Together: ~2.7s self-time eliminated on JsonPerformanceTest.
• RegexUtilities.SafeMatchResult — replaced eager group extraction with a lazy MatchResult snapshot. Unaccessed capturing groups no longer allocate a String per call. ~840ms of JsonPerformanceTest wall time recovered.
• FastReader — added borrowed-slice fast paths readUntilBorrowed(...) and readLineBorrowed(...) for callers that can consume directly from the internal buffer. Existing delimiter semantics preserved; falls back cleanly to copying APIs when pushback is active or the token crosses a buffer boundary.

Correctness

• FastReader.readUntilBorrowed() now clamps its scan boundary by available buffer length instead of computing pos + maxLen (which could overflow on very large maxLen with a non-zero buffer position).
• FastReader.BufferSlice — added assertion-checked release() lifecycle for borrowed slices. Callers must release before the next read/pushback/close; outstanding borrows fail fast under -ea. Production behavior unchanged.

Build

• jackson-databind test dependency bumped 2.21.2 → 2.21.3 (test-scope only).

Full changelog: https://github.com/jdereg/java-util/blob/master/changelog.md

4.101.0

java-util 4.101.0

Maven Central: com.cedarsoftware:java-util:4.101.0

Highlights

New APIs

• ClassValueMap.getByClass(Class) — typed fast-path lookup that skips the instanceof Class guard in get(Object), compiling to a near-direct ClassValue.get(type) call. Converted 30+ hot-path call sites across ClassUtilities, Converter.ClassPairMap, MultiKeyMap, TypeUtilities, Unsafe, CompactMap, and CollectionHandling.
• ClassValueSet.containsClass(Class) — parallel typed fast path on the Set side. Skips the null check and instanceof Class guard in contains(Object). Converted 9 hot-path call sites in MultiKeyMap (flatten/hash/equals paths) and ClassUtilities.SECURITY_CHECK_CACHE.
• ReflectionUtils.getDirectClassAnnotation(Class, Class) — strict JDK-semantics companion to getClassAnnotation. Matches Class.getAnnotation(Class) exactly (respects @Inherited, never walks interfaces), for identity-tied annotations like @Entity, @JsonNaming, @IoNaming.
• StringUtilities.getChars(String, int) + getChars(String) — SIMD bulk-copy helpers for hot-path charAt-loop replacements.

Performance

• Converter — refactored 4 internal caches (CONVERSION_DB, FULL_CONVERSION_CACHE, USER_DB, cacheInheritancePairs) from Map<ConversionPair, V> to nested ClassValueMap<ClassValueMap<V>>, eliminating per-lookup ConversionPair allocation from every convert() call. ConversionPair is gone from the JFR hot-path allocation top-5.
• Converter.USER_DB — dropped redundant instanceId from cache keys (legacy from an earlier static design).
• FastReader.readUntil / readLine — 30% reduction in GETFIELD field accesses on the common path (scan-loop local hoisting, elided unconditional PUTFIELD writes, refill moved to loop top).
• FastReader.readLine(char[], int, int) — ~22% self-time reduction via explicit CSE hoisting of b[scanPos].
• StringUtilities — SIMD-intrinsic String.getChars() bulk-copy pattern applied to levenshteinDistance, damerauLevenshteinDistance, and decode(String) (hex). Loop-invariant chars hoisted out of the Levenshtein inner loops.

Correctness

• ClassValueMap — marked cachedEntrySet, cachedValues, cachedUnmodifiableView volatile to close a latent DCL publication race.
• ReflectionUtils.getAllConstructorsInternal() — added deterministic tie-breaker to constructor sort (fixes ~30% intermittent failure rate in ClassUtilitiesVarargsArrayStoreTest under JaCoCo).

Security

• ReflectionUtils.isTrustedCaller() — stack walk no longer misidentifies java-util's own internal cache infrastructure as a trusted caller. Previous prefix-match allowed external callers to bypass dangerous-class blocking on paths routed through cache-populating lambdas.

Build

• JaCoCo code coverage plugin wired in permanently. Reports auto-generated on every mvn test at target/site/jacoco/.

Testing

• 19,964 tests total — +380 new coverage tests across EncryptionUtilities, ReflectionUtils, UrlUtilities, IOUtilities, DeepEquals, MultiKeyMap, ClassUtilities, plus new ClassValueMapTest and ClassValueSetTest entries for the typed fast paths.

Full changelog: https://github.com/jdereg/java-util/blob/master/changelog.md

4.100.0

What's Changed

• BUG FIX: Fixed unbounded memory leak in Converter.FULL_CONVERSION_CACHE. Each short-lived Converter instance (e.g., one per JsonIo.toJava() call) cached inheritance-resolved conversions keyed by its unique instanceId in a static ConcurrentHashMap. When the instance was GC'd, its entries remained forever. In production under sustained load, this grew to 1GB+. Fix: cache resolved conversions at the shared level (instanceId=0L) when no user-added conversions exist; skip static caching otherwise. The cache is now bounded by the number of unique (source, target) type pairs, not by the number of Converter instances created.

• PERFORMANCE: Optimized Converter.getCachedConverter() to skip the now-unnecessary instance-specific lookup, eliminating a wasted ConversionPair allocation per call.

• Updated test dependencies: JUnit 5.14.2→5.14.3, Jackson 2.21.1→2.21.2

4.99.0

4.99.0 - 2026-03-28

• FEATURE: New StringUtilities.getChars(String s) — public API that returns a ThreadLocal char[] buffer populated via String.getChars() (SIMD-optimized bulk copy). Callers can replace str.charAt(i) loops with direct buf[i] array access.
• PERFORMANCE: StringUtilities.hashCodeIgnoreCase(String) — uses StringUtilities.getChars() into a ThreadLocal char[] buffer, then hashes from the array directly. CaseInsensitiveMap GET improved 70-75%, PUT improved 48-52%, and MIXED-CASE GET improved 68% on 100K entries.
• PERFORMANCE: New FastReader.readLine(char[] dest, int off, int maxLen) — dedicated line-reading method optimized for TOON's line-oriented parsing. Combines scanning, copying, and line-ending consumption into a single call. JFR shows TOON line-reading improved 28%.
• PERFORMANCE: FastReader.readUntil() pushback drain loop now uses a local variable for pushbackPosition, avoiding load/store through this on each iteration. JFR shows 14.8% reduction in FastReader CPU share.
• PERFORMANCE: FastReader.readUntil() replaced Math.min() with inline ternary in tight buffer-scan loop. JFR confirmed 3.5% wall-clock improvement.
• PERFORMANCE: FastReader.readUntil() now caches this.limit into a local variable after fill(). JFR shows readUntil self-time dropped ~15%.
• PERFORMANCE: FastReader.fill() extracted core I/O into refill() which uses a local int n for the in.read() result, reducing PUTFIELD/GETFIELD overhead.

4.98.0

Changes

• PERFORMANCE: CaseInsensitiveMap.get(), containsKey(), and remove() now use a ThreadLocal<LookupKey> for String key lookups on hash-based backings (HashMap, LinkedHashMap, ConcurrentHashMap), eliminating per-call CaseInsensitiveString allocation. This removes the single largest remaining allocation cost center (403 JFR samples). LookupKey is a lightweight mutable object reused via ThreadLocal, with bidirectional equals support for both HashMap and ConcurrentHashMap lookup directions. SortedMap backings continue to use CaseInsensitiveString since they require Comparable keys.
• PERFORMANCE: CaseInsensitiveMap now overrides size() and isEmpty() to delegate directly to the backing map, bypassing the AbstractMap.size() → entrySet().size() indirection chain (168 JFR samples eliminated).
• PERFORMANCE: CaseInsensitiveMap internal fields changed from private to package-private to eliminate JVM synthetic accessor methods generated for anonymous inner class access (40 JFR samples eliminated).
• PERFORMANCE: StringUtilities.hashCodeIgnoreCase() now inlines the case-fold logic directly into the hash loop, ensuring C2 JIT compiles the entire loop as a single compilation unit.
• PERFORMANCE: StringUtilities.foldCaseForHash() branch ordering optimized to check c <= 'Z' first, partitioning ASCII so uppercase and lowercase each take only two comparisons.
• BUG FIX: ConverterDurationToOffsetDateTimeTest used the current system timezone offset to compute expected values, but the conversion target is the epoch (1970). Fixed to compute the offset at the actual target instant.
• TESTING: Added ToonRoundTripTest — 46 parameterized tests verifying all Converter-supported types round-trip through TOON format.
• TESTING: Added ConverterDurationToOffsetDateTimeTest — verifies Duration → OffsetDateTime conversion across multiple scenarios.

Maven:

<dependency>
  <groupId>com.cedarsoftware</groupId>
  <artifactId>java-util</artifactId>
  <version>4.98.0</version>
</dependency>

4.97.0

Changes

• PERFORMANCE: FastReader.readUntil() now splits the inner loop into a read-only delimiter scan followed by a bulk System.arraycopy, allowing the JIT to optimize the tight scan loop independently from memory writes.
• PERFORMANCE: FastReader.readUntil() scan loop now uses a do-while with a single array access per iteration and hoists position assignment above the delimiter check to eliminate a duplicate write.

Maven:

<dependency>
  <groupId>com.cedarsoftware</groupId>
  <artifactId>java-util</artifactId>
  <version>4.97.0</version>
</dependency>

4.96.0

Bug Fix

• ClassUtilities.trySetAccessible() no longer caches successful setAccessible(true) results. The WeakHashMap-based cache uses equals() for lookup, but Field.equals() matches by declaring class, name, and type — not identity. When getDeclaredFields() was called with different predicates, the JVM returned different Field instances for the same logical field; the cache returned TRUE for the second instance without ever calling setAccessible(true) on it, leaving it inaccessible. This caused Traverser to silently skip inaccessible fields, breaking GraphComparator.applyDelta(). Only failures (FALSE) are now cached to avoid expensive repeated exceptions on JPMS-sealed modules.

Install

Maven

<dependency>
  <groupId>com.cedarsoftware</groupId>
  <artifactId>java-util</artifactId>
  <version>4.96.0</version>
</dependency>

Gradle

implementation 'com.cedarsoftware:java-util:4.96.0'