`js
this.req.getParameter('id') // or this.req.getParameter('0')
// or
// this.inidReuqstData();
// this.requestData.parameters.id
`

$3

Example options for createRoute
`js
this.createRoute('get / #c:home.index', {cache: 5});
`

#### 📶 AbstractController properties:

| property | description |
|:-----------------|:---------------------------------------------|
| requestData | read request data |
| cookieData | read/write cookie |
| redirectType | "header" \| "meta" \| "js" (default meta) |
| format | default response content type default html |
| statusCode | default response http code number 200 |
| statusCodeText | default response http code string 200 OK |
| broker | link ServiceBroker molecular.js |
| req | link HttpRequest uWebsocket.js |
| res | link HttpResponse uWebsocket.js |

requestData or cookieData (The property objects are available after executing the this.initRequest() method inside the controller method)

#### 🕒 Performance Tracking
* .timer
* An instance of Timer used to measure request processing duration.
* .start() — Starts the timer.
* .stop() — Stops the timer. and Returns elapsed time in milliseconds.

$3

#### 🔐 JWT Methods:
* .initJWT(key, iat = false)
* Initializes the JWT utility with a secret key and whether to include issued-at time (iat).
* .getJWT()
* Returns the initialized JWT instance. Throws an error if not initialized.
* .createJwtToken(payload = {})
* Creates a JWT token from the provided payload.
* .extractJwtToken(token)
* Extracts and returns the decoded payload from a given JWT token.

#### 📥 Request Handling:

* .initRequest()
- Initializes requestData and cookieData objects for accessing request data and cookies. Also sets client-hints headers if enabled.
* .readBody()
- Reads the request body asynchronously. Returns a Promise.

#### 📤 Response Methods:
* .asJson(obj, httpCode = 200)
* Sends a JSON response with optional HTTP status code.

* .renderRaw({ view, httpCode, format })
* Renders raw content (string or HTML) with proper MIME type and HTTP status.

* .render({ template, params, httpCode, format })
* Renders an EJS template with given parameters and sends it as a response.

* .setStatus(httpCode)
* Sets the HTTP status code and its text representation.

* .writeHeader(key, value)
* Writes a custom header to the response.

* .setCorsHeaders()
* Sets CORS-related headers for cross-origin requests.

#### 🔁 Redirect Methods:
* .redirect(location, httpCode = 301)
* Performs a redirect using one of the following strategies:
* You can set the strategy in the redirectType property of the controller.
* REDIRECT_TYPE_META: Meta refresh redirect (HTML-based).
* REDIRECT_TYPE_JS: JavaScript-based redirect.
* REDIRECT_TYPE_HEADER: Standard HTTP Location header redirect.

$3

module.exports = class Home extends AbstractController {
/**
* Initialize request data and cookie handler
*/
async index() {
// Initialize requestData and cookieData
this.initRequest();
// 🔍 Read a cookie value, with fallback
const cookieValue = this.cookieData.get('my_cookievalue', String(Date.now() / or 1new Date() */ ));
// ✍️ Set/update the cookie with a new value
this.cookieData.set('my_cookievalue', cookieValue);
// 📤 Return current cookie value as response
return Current cookie value: ${cookieValue};
}
};
`
#### 📥 Get Request Data Example
`js
const { AbstractController } = require('node-moleculer-web');

module.exports = class Home extends AbstractController {
/**
* Handle GET request and return parsed request data
*/
async index() {
// Initialize request and cookie utilities
this.initRequest();
// Extract request data
const headers = this.requestData.headers; // All request headers
const ip = this.requestData.ip; // Client IP address
const query = this.requestData.query ?? {}; // Query parameters
const referer = this.requestData.referer; // Referrer URL
const currentUrl = this.requestData.url; // Current request URL
const userAgent = this.requestData.userAgent; // User-Agent string

// Return all data as JSON response
return this.asJson({
headers,
ip,
query,
referer,
currentUrl,
userAgent
}, 200);
}
};
`
#### 🔄 Call Another Microservice from Controller
`js
const { AbstractController } = require('node-moleculer-web');

module.exports = class Home extends AbstractController {
/**
* Calls another microservice and returns the result as JSON
*/
async index() {
try {
const data = await this.broker.call('service-name.action', {
email: 'test@example.com'
}) ?? {};
return this.asJson(data, 200);
} catch (error) {
return this.asJson({
error: error.message,
code: error.code || 500
}, error.code || 500);
}
}
};
`
#### 📥 Read POST Request Body Example
`js
const { AbstractController } = require('node-moleculer-web');

module.exports = class Home extends AbstractController {
/**
* Reads the request body and returns it as JSON
*/
async index() {
try {
const body = await this.readBody();
return this.asJson({ body }, 200);

} catch (error) {
return this.asJson({
error: 'Failed to read request body',
message: error.message
}, 400);
}
}
};
`

#### 🔐 JWT Usage Example — Create and Verify Tokens

`js
class Home extends AbstractController {
// create token
async index() {
this.initJWT('mykey');
const payload = {userId: 0, status: true};
const token = this.getJWT().create(payload)
return this.asJson({token}, 200);
}
// extract payload for token + validation (is payload not null then token valid)
async test() {
this.initRequest()
const token = this.requestData.query.token ?? '';
this.initJWT('mykey', false);
const payload = this.getJWT().extract(token)
return this.asJson({payload}, 200);
}
}
`

#### Extend rest service
* ! you still need to create an app server to use this example:
`js
const {HttpService} = require('node-moleculer-web');
const {Service} = require('moleculer');
class RestService extends Service {
constructor(broker) {
super(broker);
this.parseServiceSchema({
name: 'rest',
settings: {},
mixins: [
HttpService // add HttpService mixin
],
actions: {
hello: {
rest: 'GET /hello',
handler(ctx) {
return 'Hello1 API Gateway!'
}
},
hello2: {
rest: 'GET /hello2/:test1/:test2',
handler(ctx) {
// read request data for meta object
console.log('requestData', ctx.meta.requestData)
// read cookie
ctx.meta.cookieData.get('test', 0);
// write cookie
ctx.meta.cookieData.set('test', 2);
// write header
ctx.meta.headers['my-custom-header'] = 'lama';
return 'Hello2 API Gateway!'
}
},

testJson: {
rest: 'GET /hello3/test/json',
handler(ctx) {
return this.asJson(ctx, {
myvalue: 111
})
}
},

testRedirect: {
rest: 'GET /hello3/test/redirect',
handler(ctx) {
return this.redirect(ctx, 'https://google.com', 301, 'meta')
}
}

},
});
}
}
`

$3

server_name domain.com;

location / {
proxy_http_version 1.1;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-NginX-Proxy true;
proxy_pass http://127.0.0.1:3001;
proxy_redirect off;
}
}
`

NGNIX config if clustering is used

location / {
proxy_http_version 1.1;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-NginX-Proxy true;
proxy_pass http://node_apps;
proxy_redirect off;
}
}
`
cluster config moleculer.config.js
`js
module.exports = {
nodeID: 'DEMO',
transporter: "TCP",
registry: {
// type of call strategy for microservices
strategy: "RoundRobin",
// If set to true, then each webserver will use only its own micro-services
preferLocal: false,
},
logger: console
};
`

---

#### BZT Benchmark (install view docs https://gettaurus.org/)
run app
`bash
node tests/services/local.js
`
run strestest minimal logic
`bash
bzt tests/bzt-config.yaml
`

!bzt-test.png
`log
22:41:17 INFO: Test duration: 0:06:03
22:41:17 INFO: Samples count: 12909515, 0.00% failures
22:41:17 INFO: Average times: total 0.008, latency 0.008, connect 0.000
22:41:17 INFO: Percentiles:
+---------------+---------------+
| Percentile, % | Resp. Time, s |
+---------------+---------------+
| 0.0 | 0.0 |
| 50.0 | 0.006 |
| 90.0 | 0.016 |
| 95.0 | 0.018 |
| 99.0 | 0.025 |
| 99.9 | 0.038 |
| 100.0 | 0.058 |
+---------------+---------------+
22:41:17 INFO: Request label stats:
+---------------------------------------------------------------------------+--------+---------+--------+-------+
| label | status | succ | avg_rt | error |
+---------------------------------------------------------------------------+--------+---------+--------+-------+
| http://localhost:8080/bzt?id=39641&&hash=104bdfd40acf8d03e6b485e11b681fd4 | OK | 100.00% | 0.016 | |
| http://localhost:8080/bzt?id=39641&&hash=104bdfd40acf8d03e6b485e11b681fd5 | OK | 100.00% | 0.006 | |
| http://localhost:8080/bzt?id=39641&&hash=104bdfd40acf8d03e6b485e11b681fd6 | OK | 100.00% | 0.005 | |
| http://localhost:8080/bzt?id=39641&&hash=104bdfd40acf8d03e6b485e11b681fd7 | OK | 100.00% | 0.005 | |
| http://localhost:8080/bzt?id=39641&&hash=104bdfd40acf8d03e6b485e11b681fd8 | OK | 100.00% | 0.006 | |
+---------------------------------------------------------------------------+--------+---------+--------+-------+
``

---