Advanced Feature Pack

NioFlow includes multiple opt-in features designed for small teams operating production services without heavy platform infrastructure. These capabilities handle resilience, observability, and developer experience natively within the framework.

01

ChaosMiddleware

Controlled fault injection to simulate real-world networking issues and validate frontend resilience.

app.use( new ChaosMiddleware() .latency(200, 0.10) .error(500, 0.05) .drop(0.01) );
  • Guarded by NIOFLOW_CHAOS_ENABLED=true.
  • Logs each injected fault with route and path.
02

Per-route Observability

Granular protection and telemetry for individual endpoints using a fluent API.

app.get("/api/orders", ordersController::list) .timeout(2000) .rateLimit(50, 10_000);
  • Per-route request/error counters and sliding p50/p95/p99 latency tracking.
  • Route-scoped timeout and rate limit enforcement.
03

Request Hedging

Tail-latency reduction for critical reads by speculatively firing a backup execution.

app.get("/api/search", searchController::search) .hedge(100);
  • Fires a backup execution when primary crosses threshold (e.g., 100ms).
  • Returns first successful completion to the client.
04

Circuit Breaker

Prevent cascading failures to downstream services with automatic fast-failing.

app.group("/api/downstream", group -> { group.use(new CircuitBreakerMiddleware() .threshold(0.5) .windowSize(20) .cooldown(10_000)); group.get("/inventory", inventoryController::read); });
  • CLOSED: requests flow normally.
  • OPEN: requests are immediately rejected with 503 and Retry-After.
  • HALF_OPEN: one trial request is allowed through to test recovery.
  • v1.4.0 Improvement: Uses AtomicReference with CAS transitions for absolute thread safety.
05

Request Replay

Fast debugging by replaying recent recorded requests through the current live pipeline.

app.enableReplay(50);
  • Guarded by NIOFLOW_REPLAY_ENABLED=true.
  • v1.4.0 Security: Replay endpoints are now protected by AuthMiddleware by default. Access requires a valid JWT.
  • Sensitive headers (Auth, Cookies, API Keys) are stripped before storage.
06

Hot Reload

Near-instant developer feedback with automatic recompilation on file changes.

NioFlowApp.enableHotReload(DemoApplication.class, args);
  • Guarded by NIOFLOW_WATCH=true.
  • Monitors source directory and restarts via child process.
07

NioFlow CLI (NPM)

A Node.js powered tool to scaffold, run, and manage Java projects with a modern developer experience.

# Fast scaffolding and management nioflow new my-app nioflow run nioflow dev
  • Zero-configuration scaffolding with Maven Wrapper integration.
  • Single-command project execution and hot-reloading.
  • Installable globally via npm install -g @jhanvi857/nioflow-cli.
PreviousDatabase + EnvNextOperations + Deployment