Reference
Compact reference for key APIs, middleware hooks, and utility functions.
Core App API
nioflow-app-api
1NioFlowApp app = new NioFlowApp();23app.get(String path, Handler handler);4app.post(String path, Handler handler);5app.put(String path, Handler handler);6app.delete(String path, Handler handler);78app.group(String prefix, GroupConfig config);9app.exception(Class<? extends Throwable> type, ExceptionHandler handler);10app.onError(GlobalErrorHandler handler);1112app.listen(int port);
Context API
context-methods
1String value = ctx.pathParam("id");2String query = ctx.queryParam("q");3String auth = ctx.header("Authorization");45MyBody body = ctx.body(MyBody.class);67ctx.status(200);8ctx.header("X-Trace-Id", "abc");9ctx.json(java.util.Map.of("ok", true));10ctx.send("plain text");
Middleware Chain
middleware-order
1app.use(new RequestLoggerMiddleware());2app.use(new RateLimitMiddleware());3app.use(new AuthMiddleware());45// order matters: logger -> rate limit -> auth -> route handler
Auth Utilities
auth-utils
1String hash = PasswordHasher.hash("secret-password");2boolean ok = PasswordHasher.verify("secret-password", hash);34String token = JwtProvider.generateToken("user@example.com", "USER");5var claims = JwtProvider.validateToken(token);
HTTP Status Utilities
http-status
1ctx.status(HttpStatus.OK).json(java.util.Map.of("status", "ok"));2ctx.status(HttpStatus.CREATED).json(java.util.Map.of("id", 1));3ctx.status(HttpStatus.BAD_REQUEST).json(java.util.Map.of("error", "invalid"));4ctx.status(HttpStatus.UNAUTHORIZED).json(java.util.Map.of("error", "auth required"));