Hutool 3.9 _best_ 📌
The Hutool project has long been a favorite among Java developers for its philosophy of "small yet complete." While the ecosystem has moved toward newer major versions, Hutool 3.x, and specifically version 3.9, represents a significant milestone in the library’s history. It served as a bridge between the early utility sets and the highly modularized powerhouse Hutool is today.
In this article, we’ll dive into why Hutool 3.9 remains a point of interest for legacy systems and how it simplified Java development before the widespread adoption of Java 11+. What is Hutool 3.9?
Hutool is a comprehensive Java tool class library that reduces code volume by wrapping common JDK functions into simpler, more readable methods. Version 3.9 was one of the final polished releases of the 3.x branch, focusing on stability and expanding the utility of core modules like I/O, cryptography, and reflection.
At its core, Hutool 3.9 is designed to handle the "boring" parts of Java—checking for nulls, converting strings to dates, and reading files—so developers can focus on business logic. Key Modules in the 3.9 Release
Hutool 3.9 is categorized into several distinct modules, allowing developers to include only what they need:
Hutool-core: The backbone of the library. It includes the StrUtil (String utilities), DateUtil (Date/Time manipulation), and IoUtil.
Hutool-crypto: Simplifies symmetric and asymmetric encryption (AES, DES, RSA) and hashing (MD5, SHA).
Hutool-http: A lightweight HTTP client that makes sending GET and POST requests as simple as one line of code.
Hutool-json: A simple JSON parser and generator that doesn't require heavy dependencies like Jackson or Gson.
Hutool-db: A thin wrapper over JDBC that makes database operations feel more like using an ORM without the overhead. Notable Features of Version 3.9 1. Enhanced Date Handling (DateUtil)
Before the Java 8 java.time API was fully embraced by the community, Hutool’s DateUtil was a lifesaver. In 3.9, the library offered robust parsing of almost any date string format without requiring a pre-defined pattern. 2. Fluent HTTP Requests
Hutool-http in 3.9 allowed for "fluent" API calls. Instead of configuring a HttpURLConnection manually, you could simply write: String result = HttpUtil.get("https://example.com"); Use code with caution. 3. Simplified File Operations
Reading a file into a list of strings or writing a byte array to a file was reduced from dozens of lines of boilerplate (with FileInputStream and buffers) to a single FileUtil call. Why Version 3.9 Matters Today Hutool 3.9
While the current version of Hutool is 5.x+, many enterprise projects running on Java 7 or 8 still rely on the 3.9 architecture. It is known for its:
Zero Dependencies: The core library doesn't drag in a mess of other JAR files.
Low Learning Curve: The method names are intuitive (e.g., isBlank, isEmpty, unzip).
Legacy Support: It is one of the most stable versions for older environments where upgrading to Hutool 5.x (which requires Java 8+) might cause compatibility issues. How to Include Hutool 3.9 in Your Project
If you are maintaining a project that requires this specific version, you can add it via Maven:
Hutool 3.9 stands as a testament to the "Toolbox" philosophy. It transformed Java from a verbose, boilerplate-heavy language into something that felt modern and rapid. Whether you're maintaining a legacy app or studying the evolution of Java utility libraries, version 3.9 is a classic example of developer-centric design.
Hutool 3.0.9 (likely what you mean by 3.9) is a foundational version of the popular Java tool library. It focuses on reducing boilerplate code by providing a comprehensive suite of static utility methods. Core Strengths of Hutool 3.x
Zero Dependencies: It is designed to be lightweight, avoiding "jar hell" by not forcing other libraries into your project.
Swiss Army Knife Approach: It covers everything from basic string manipulation to complex file I/O and encryption.
Static Utilities: Most functions are accessed via simple static calls (e.g., DateUtil.now()), making your code highly readable. Key Modules in this Version
Core: Handles basic tasks like StrUtil (string handling), ClassUtil (reflection), and ArrayUtil. The Hutool project has long been a favorite
DateUtil: Simplifies the notoriously clunky Java date/time API.
IoUtil & FileUtil: Streamlines reading, writing, and copying files or streams.
HttpUtil: A simple, functional HTTP client for sending GET and POST requests.
CryptoUtil: Easy-to-use wrappers for MD5, SHA, AES, and DES encryption. JsonUtil: Basic JSON parsing and generation. Maven Dependency If you are using Maven, add this to your pom.xml:
(Note: Version 3.x used the com.xiaoleilu group ID; modern versions 4.x+ use cn.hutool.)
Hutool is a comprehensive Java tool library that simplifies coding by providing static method encapsulations for common development tasks. While the project is currently in the 5.x and 6.x release cycles, version 3.9 was a significant older release focusing on expanding its core utility modules. Key Components of Hutool
Hutool is designed to reduce the need for a generic util package in projects, offering modules for nearly every aspect of Java development:
Core (hutool-core): Includes Bean operations, date handling, and various basic utilities.
Date & Time: Powerful methods for formatting, parsing, and extracting time components.
Collection Operations: Concise methods for filtering and transforming lists and sets.
File & IO: Simplified reading, writing, copying, and deleting files. Feature: FileWatcher with Chainable Callbacks /** * Enhanced
Encryption (hutool-crypto): Symmetric and asymmetric algorithms like MD5 and SHA256.
Network & HTTP: Tools for HTTP clients and socket communication. Hutool 3.9 Specifics
The 3.x branch (including 3.9) laid the groundwork for the modern library's philosophy of being "sweet"—making Java as elegant as a functional language. It primarily improved stability in its JDBC (hutool-db) and Excel (hutool-poi) handling.
For modern projects, it is highly recommended to use the latest versions (5.x or 6.x) found on Maven Central or GitHub for better compatibility with Java 8 and above. hutool/README-EN.md at v5-master - GitHub
Based on the version number 3.9, you are referring to a specific point in the history of the Hutool Java utility library (which has since evolved into the 5.x and 6.x versions). Hutool is a widely used open-source Java toolkit in the Chinese software development community and beyond, designed to simplify common programming tasks.
Below is a structured technical white paper developed for Hutool version 3.9. This paper is written in an academic/professional style, suitable for presentation at a software engineering conference or internal technical review.
Feature: FileWatcher with Chainable Callbacks
/** * Enhanced File Watcher with reactive callbacks and pattern matching * Solves: Watching multiple files/folders with different handlers */ public class FileWatcherPro// Watch directory with pattern matching public static WatchBuilder of(Path dir) return new WatchBuilder(dir); public static class WatchBuilder private final Map<Path, Set<WatchEvent.Kind<?>>> watches = new HashMap<>(); private final Map<String, FileHandler> patternHandlers = new LinkedHashMap<>(); // Chainable: watch specific file pattern public WatchBuilder onFiles(String globPattern, FileHandler handler) patternHandlers.put(globPattern, handler); return this; // Chainable: watch with multiple event types public WatchBuilder on(Path file, WatchEvent.Kind<?>... events) watches.computeIfAbsent(file, k -> new HashSet<>()) .addAll(Arrays.asList(events)); return this; // Start watching with virtual thread support (Java 21+) public void start() // Implementation using Hutool's WatchUtil WatchUtil.createModify(dir, (path, event) -> patternHandlers.entrySet().stream() .filter(e -> FileUtil.pathEquals(path, e.getKey())) .findFirst() .ifPresent(e -> e.getValue().onChange(path, event)); ); @FunctionalInterface public interface FileHandler void onChange(Path path, WatchEvent.Kind<?> event);
2.1 Core Modules
The 3.9 release structure is defined by the cn.hutool.core root package, segmented into:
util: General utilities (String, Array, Collection).io: File operations, stream handling, and file type detection.crypto: Symmetric/Asymmetric encryption and digest algorithms.http: A self-contained HTTP client implementation.json: A lightweight JSON parser and serializer.
Example Use Cases
Testing & verification
- Run unit tests and integration tests.
- Smoke test common utilities: string, date, io, json, crypto.
- Validate behavior in staging before production rollout.
Abstract
In the landscape of Java enterprise development, boilerplate code and repetitive utility implementation remain significant hurdles to rapid application development. While Apache Commons and Google Guava provide robust solutions, they often introduce complex dependency trees or steep learning curves for simple tasks. This paper introduces Hutool 3.9, a comprehensive, lightweight utility library designed to encapsulate common Java operations into a coherent, developer-friendly API. We analyze the architectural improvements introduced in version 3.9, specifically focusing on the stabilization of the HttpUtil client, enhanced encryption utilities, and the modular design philosophy. Comparative analysis suggests that Hutool 3.9 significantly reduces code verbosity and improves maintenance efficiency in standard web applications.
String Manipulation
import cn.hutool.core.util.StrUtil;
public class StringExample
public static void main(String[] args)
String text = " Hello, World! ";
String trimmedText = StrUtil.trim(text);
System.out.println("Trimmed text: " + trimmedText);
String[] splitText = StrUtil.split(text, ",");
System.out.println("Split text: " + splitText);
3.3 File and I/O Enhancements (FileUtil, IoUtil)
Version 3.9 improved file handling capabilities, specifically addressing:
- File Type Detection: Magic number detection independent of file extensions.
- Stream Copy: Optimized buffered stream copying to prevent memory leaks during large file transfers.
- Watch Service: Wrappers around the NIO
WatchServicefor simple file system monitoring.
Hutool 3.9: A Comprehensive Overview
Hutool is a popular Java library used for various utility tasks, such as encryption, decryption, string manipulation, and more. The latest version, Hutool 3.9, brings exciting new features and improvements. In this piece, we'll dive into the key aspects of Hutool 3.9 and explore its capabilities.