Listen up, I just had to drop this because somebody had to fix the mess.
-
Because the official library is outdated and poorly designed.
-
I opened the official BunnyCDN Java library, glanced at it for a few seconds, and couldn't believe what I was seeing. It felt like a very early-intern project that never got reviewed.
- The main class extends
Exception. Yes, the whole library is basically an exception. - Every single method throws raw
Exception. - Uses
Static LinkedList<String>for crawling files. Thread-safety? Not considered. - Calls
Collections.reverse(Arrays.asList(...))as if copied from an old forum post. - Manual URL encoding done by hand.
- Overall style: rushed, unstructured, and prone to errors.
- The main class extends
In short, the official library is poorly structured and not suitable for modern development.
Official BunnyCDN Java Storage Library (for reference): https://github.com/BunnyWay/BunnyCDN.Java.Storage
I wrote this library to provide a clean, modern, well-thought-out implementation that fits 2026 standards instead of outdated practices.
- Clean architecture with proper interfaces and implementations.
- Typed exception hierarchy (BunnyException) instead of throwing random Exception.
- Region configuration with predefined constants.
- Streaming uploads and downloads.
- Upload, download and delete operations.
- Blazing fast
BunnyHttpClientpowered byOkHttpJava HttpClient (java.net.http). - Java 17+ modern toolchain.
- One-line install via Maven Central.
- Single-region storage client
- Multi-region storage client
- Spring Boot auto configuration
Unlike the official BunnyCDN Java library, this project is published on Maven Central.
Instead of manually downloading a random JAR from GitHub and praying it works, you can install it with a single dependency.
Earlier versions of this library used OkHttp as the HTTP client.
However, one of the goals of this project is to keep external dependencies to a minimum and avoid unnecessary dependency chains.
Since Java already provides a built-in HTTP client (java.net.http.HttpClient) starting from Java 11, adding OkHttp would only introduce an extra dependency for functionality that already exists in the JDK.
The project is organized into a small set of focused modules.
| Module | Description |
|---|---|
| core | Main BunnyNet client implementation |
| spring | Spring Boot auto-configuration and integration |
The core module contains the full BunnyNet client implementation including:
- Single storage client
- Multi storage client
- HTTP client
- DTO models
- Region configuration
- Exception hierarchy
The spring module provides Spring Boot auto-configuration for the client.
Spring Boot Integration ↓ Storage Clients (Single / Multi) ↓ Core ↓ BunnyHttpClient ↓ Bunny Storage API
| Feature | Official BunnyCDN Java Library | BunnyNet Unofficial |
|---|---|---|
| Modern Java API | ❌ | ✅ |
| Clean architecture | ❌ | ✅ |
| DTO request/response model | ❌ | ✅ |
| Typed exceptions | ❌ | ✅ |
| Region configuration | ❌ | ✅ |
| Single storage client | ✅ | |
| Multi-region storage support | ❌ | ✅ |
| Spring Boot integration | ❌ | ✅ |
| Modular project structure | ❌ | ✅ |
| Maven Central publishing | ❌ | ✅ |
| Java 17+ toolchain | ❌ | ✅ |
| Active development | ❌ | ✅ |
If you find this project useful, you can support development here:
☕ Buy me a coffee https://buymeacoffee.com/darkrange6s