```rust use burner::{Server, Request, Response, RouterService}; // Import into scope
// Create the server let mut server = Server::new();
// Create a route controller clojure let controller = |req: &Request, res: &mut Response| { // Set the HTTP status code to be 200 OK, default is 404 res.status(200); };
// Register controller on server to be triggered by a request to path / and method: GET let path = "/"; server.get(path, Box::new(controller));
// Start the server on port let PORT = 6789; server.listen(PORT); ```
You can also have dynamic paths with route parameters in the path.
To specify a route parameters in the path use a colon followed by the name of the variable, e.g, /users/:userid.
The parameter will be available on the request object with: req.route_params.get("userid")
Header variables are also available on the request object. Tokens and other meta data are often store here.
The parameter will be available on the request object with: req.headers.get("HEADER_KEY")
Request Body can be accessed by request.body, e.g: let user_name: &str = req.body['name']
res.json(json: &Value) for json data using serde_json::Value
or
res.send(msg: &str) for sending string messages.
res.json and res.send sets the status code to 200 automatically. To override it call
res.status(status: u32) after res.send or res.json.
Nested routing is also possible. Router objects acts as building blocks and can be composed together by calling .mount on the parent Router with the child Router. Server extends (rust doesnt support inheritance, but Router and Server are implementing the same trait which is kind of similar to interfaces in other languages). So every method on Router is also available on Server. Server will always act as the root router from which all requests will first be directed to.
An example app that leverages nested Routers.
```rust
use burner::{Server, Request, Response, Router, RouterService}; // Import into scope
// Initialize server and routers let mut server = Server::new(); let mut userrouter = Router::new(); let mut postrouter = Router::new();
let getUser = |req: &Request, res: &mut Response| { println!("Get user controller"); };
let createUser = |req: &Request, res: &mut Response| { println!("Create user controller"); };
user_router .get("/:userId", Box::new(getUser)); // Will be accessible at path: /users/:userId .post("/", Box::new(createUser)); // Will be accessible at path: /users
let getPost = |req: &Request, res: &mut Response| { println!("Get post controller"); };
let createPost = |req: &Request, res: &mut Response| { println!("Create post controller"); };
post_router .get("/:postId", Box::new(getPost)); // Will be accessible at path: /posts/:postId .post("/", Box::new(createPost)); // Will be accessible at path: /posts
let userrouterpathprefix = "/users"; let postrouterpathprefix = "/posts";
// Mount routers into server (parent router) server .mount(userrouterpathprefix, userrouter); .mount(postrouterpathprefix, postrouter); // To create additional nesting just mount other routers on userrouter or postrouter or some other router
// Start server let port = 6789; server.listen(port); ```