Reference

Compact reference for key APIs, middleware hooks, and utility functions.

Core App API

nioflow-app-api
1NioFlowApp app = new NioFlowApp();
2
3app.get(String path, Handler handler);
4app.post(String path, Handler handler);
5app.put(String path, Handler handler);
6app.delete(String path, Handler handler);
7
8app.group(String prefix, GroupConfig config);
9app.exception(Class<? extends Throwable> type, ExceptionHandler handler);
10app.onError(GlobalErrorHandler handler);
11
12app.listen(int port);

Context API

context-methods
1String value = ctx.pathParam("id");
2String query = ctx.queryParam("q");
3String auth = ctx.header("Authorization");
4
5MyBody body = ctx.body(MyBody.class);
6
7ctx.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());
4
5// 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);
3
4String 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"));