Note | ||
---|---|---|
| ||
As of July 25th, 2023, there is a content freeze on this page. |
The quickest way to "test out" a PJS module to see how things work is to create it as a Express Route (web service), and call it using a browser.
...
In the following example, we'll create a web service to pass in a customer number = 1234, and get back the customer nameĀ for that customer number.
- Navigate to the workspace "pjstips".
- Click New/Javascript File.
- Enter the code below. Click Save As, and save as pjstips_02_1.js. Note that this is very simple code, as an example. You can do anything you want here (e.g. use various PJS API's such as pjs.define(), call pjs.query() to get data, use pjs.call() to call an IBMi program, etc).
Code Block language js title pjstips_02_1.js function app(req, res) { // When a PJS module is called as an Express Route (web service), two objects // are passed to the module. // 1. The "request" object, named as "req" here. You can use another name if you want. // 2. The "response" object, named as "res" here. You can use another name if you want. // Put this module in debug and call it from a browser. Then examine the "req" and "res" objects passed in, // to see all the good stuff they contain. var custno = req.query.custno; // input parm specified as query string parameter, e.g. ?custno=1234 var name = `Customer_name_${custno}`; // get output customer name from input customer number // In this example, we'll use function res.send() to send back the "response" as a text message. res.send(`test from pjstips_02_1.js; custno = ${custno}; name = ${name}`); } exports.run = app;
- In the Files tree, right-click on newly-created file pjstips_02_1.js, and click Properties. Mark the file as an Express Route, using HTTP method of "GET", with the Route Path as shown below.
...