README.md

java-util

A collection of high-performance Java utilities designed to enhance standard Java functionality. These utilities focus on:

• Memory efficiency and performance optimization
• Thread-safety and concurrent operations
• Enhanced collection implementations
• Simplified common programming tasks
• Deep object graph operations

Available on Maven Central. This library has no dependencies on other libraries for runtime. The.jarfile is 414K and works with JDK 1.8 through JDK 23. The .jar file classes are version 52 (JDK 1.8)

Compatibility

JPMS (Java Platform Module System)

This library is fully compatible with JPMS, commonly known as Java Modules. It includes a module-info.class file that specifies module dependencies and exports.

OSGi

This library also supports OSGi environments. It comes with pre-configured OSGi metadata in the MANIFEST.MF file, ensuring easy integration into any OSGi-based application.

Both of these features ensure that our library can be seamlessly integrated into modular Java applications, providing robust dependency management and encapsulation.

---

To include in your project:

Gradle

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

Maven

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

---

java-util

Sets

• CompactSet - Memory-efficient Set that dynamically adapts its storage structure based on size
• CaseInsensitiveSet - Set implementation with case-insensitive String handling
• ConcurrentSet - Thread-safe Set supporting null elements
• ConcurrentNavigableSetNullSafe - Thread-safe NavigableSet supporting null elements

Maps

• CompactMap - Memory-efficient Map that dynamically adapts its storage structure based on size
• CaseInsensitiveMap - Map implementation with case-insensitive String keys
• LRUCache - Thread-safe Least Recently Used cache with configurable eviction strategies
• TTLCache - Thread-safe Time-To-Live cache with optional size limits
• TrackingMap - Map that monitors key access patterns for optimization
• ConcurrentHashMapNullSafe - Thread-safe HashMap supporting null keys and values
• ConcurrentNavigableMapNullSafe - Thread-safe NavigableMap supporting null keys and values

Lists

• ConcurrentList - Thread-safe List implementation with flexible wrapping options

Utilities

• ArrayUtilities - Comprehensive array manipulation operations
• ByteUtilities - Byte array and hexadecimal conversion utilities
• ClassUtilities - Class relationship and reflection helper methods
• Converter - Robust type conversion system
• DateUtilities - Advanced date parsing and manipulation
• DeepEquals - Recursive object graph comparison
• IOUtilities - Enhanced I/O operations and streaming utilities
• EncryptionUtilities - Simplified encryption and checksum operations
• Executor - Streamlined system command execution
• GraphComparator - Object graph difference detection and synchronization
• MathUtilities - Extended mathematical operations
• ReflectionUtils - Optimized reflection operations
• StringUtilities - Extended String manipulation operations
• SystemUtilities - System and environment interaction utilities
• Traverser - Configurable object graph traversal
• UniqueIdGenerator - Distributed-safe unique identifier generation

View detailed documentation

See changelog.md for revision history.

---

By: John DeRegnaucourt and Kenny Partlow