Utils

General-purpose utility library providing binary I/O stream abstractions with zero-copy byte array data input/output, compression utilities, and common helpers for arrays, characters, classes, numbers, primitives, strings, and system operations. Also includes mutable wrapper types, a stopwatch timer, and date formatting.

Important

This library requires Java 21 or later. It depends on collections and is published via JitPack.

Table of Contents

• Features
• Getting Started
  • Prerequisites
  • Installation
• Usage
  • Binary I/O Streams
  • Compression
  • Utility Classes
  • Mutable Wrappers
  • Stopwatch
• Project Structure
• Building
• Contributing
• License

Features

• Zero-copy binary I/O - ByteArrayDataInput and ByteArrayDataOutput for efficient byte array serialization without intermediate copies
• Compression - Compression utility for data compression/decompression with custom exception handling
• Array utilities - ArrayUtil for common array operations
• Character utilities - CharUtil for character inspection and manipulation
• Class utilities - ClassUtil for reflective class operations
• Number utilities - NumberUtil for numeric parsing and validation
• Primitive utilities - PrimitiveUtil for boxing/unboxing and type checks
• String utilities - StringUtil for string manipulation and formatting
• System utilities - SystemUtil for system-level operations
• Regex utilities - RegexUtil for pattern matching helpers
• Range type - Range for representing bounded numeric intervals
• Mutable wrappers - MutableInt, MutableLong, MutableDouble, MutableFloat, MutableByte, MutableShort, MutableBoolean for pass-by-reference semantics
• Timing - Stopwatch for measuring elapsed time
• Date formatting - SimpleDate for straightforward date operations
• Exception utilities - ExceptionUtil for exception handling helpers
• Logging utilities - LogUtil for logging convenience methods

Getting Started

Prerequisites

Requirement	Version	Notes
Java	21+	Required
Gradle	9.4+	Included via wrapper
Git	2.x+	For cloning the repository

Installation

Add the JitPack repository and dependency to your build.gradle.kts:

repositories {
    maven(url = "https://jitpack.io")
}

dependencies {
    implementation("com.github.simplified-dev:utils:master-SNAPSHOT")
}

Note

This library transitively depends on collections. JitPack resolves it automatically.

Groovy DSL

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.simplified-dev:utils:master-SNAPSHOT'
}

Maven

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.github.simplified-dev</groupId>
    <artifactId>utils</artifactId>
    <version>master-SNAPSHOT</version>
</dependency>

Usage

Binary I/O Streams

Zero-copy byte array reading and writing:

import dev.simplified.stream.ByteArrayDataOutput;
import dev.simplified.stream.ByteArrayDataInput;

// Write data
ByteArrayDataOutput output = new ByteArrayDataOutput();
output.writeInt(42);
output.writeUTF("hello");
byte[] bytes = output.toByteArray();

// Read data
ByteArrayDataInput input = new ByteArrayDataInput(bytes);
int number = input.readInt();
String text = input.readUTF();

Compression

Compress and decompress byte arrays:

import dev.simplified.stream.Compression;

byte[] compressed = Compression.compress(data);
byte[] decompressed = Compression.decompress(compressed);

Utility Classes

Common helpers for everyday operations:

import dev.simplified.util.StringUtil;
import dev.simplified.util.NumberUtil;
import dev.simplified.util.ArrayUtil;

// String operations
boolean empty = StringUtil.isEmpty(value);

// Number parsing
int parsed = NumberUtil.parseInt(text, defaultValue);

// Array operations
String[] merged = ArrayUtil.merge(first, second);

Mutable Wrappers

Pass-by-reference semantics for primitives:

import dev.simplified.util.mutable.MutableInt;

MutableInt counter = new MutableInt(0);
counter.increment();
int value = counter.get();

Stopwatch

Measure elapsed time:

import dev.simplified.util.time.Stopwatch;

Stopwatch stopwatch = Stopwatch.start();
// ... perform work ...
long elapsedMs = stopwatch.elapsedMillis();

Project Structure

utils/
├── src/
│   ├── main/java/dev/simplified/
│   │   ├── stream/
│   │   │   ├── ByteArrayDataInput.java     # Zero-copy byte array reading
│   │   │   ├── ByteArrayDataOutput.java    # Zero-copy byte array writing
│   │   │   ├── Compression.java            # Data compression/decompression
│   │   │   └── exception/
│   │   │       └── CompressionException.java
│   │   └── util/
│   │       ├── ArrayUtil.java              # Array operations
│   │       ├── CharUtil.java               # Character utilities
│   │       ├── ClassUtil.java              # Reflective class operations
│   │       ├── ExceptionUtil.java          # Exception handling helpers
│   │       ├── LogUtil.java                # Logging convenience methods
│   │       ├── NumberUtil.java             # Numeric parsing and validation
│   │       ├── PrimitiveUtil.java          # Boxing/unboxing, type checks
│   │       ├── Range.java                  # Bounded numeric intervals
│   │       ├── RegexUtil.java              # Pattern matching helpers
│   │       ├── StringUtil.java             # String manipulation
│   │       ├── SystemUtil.java             # System-level operations
│   │       ├── mutable/                    # Mutable, MutableInt, MutableLong,
│   │       │                               # MutableDouble, MutableFloat,
│   │       │                               # MutableByte, MutableShort, MutableBoolean
│   │       └── time/
│   │           ├── SimpleDate.java         # Date formatting
│   │           └── Stopwatch.java          # Elapsed time measurement
│   └── test/java/                          # JUnit 5 tests
├── build.gradle.kts
├── settings.gradle.kts
└── LICENSE.md

Building

Build the project using the Gradle wrapper:

./gradlew build

Run tests:

./gradlew test

Contributing

See CONTRIBUTING.md for development setup, code style guidelines, and how to submit a pull request.

License

This project is licensed under the Apache License 2.0 - see LICENSE.md for the full text.