Module 4: Introduction to Express.js

---

1. Express.js යනු කුමක්ද? 🚀

අපි 2 වන Module එකේදී Node.js හි `http` module එක භාවිතයෙන් web server එකක් සෑදුවා. එය සරල server එකක් සඳහා ප්‍රමාණවත් වුවත්, routes විශාල ප්‍රමාණයක්, database සම්බන්ධතා, user authentication වැනි සංකීර්ණ දේවල් සහිත විශාල application එකක් සෑදීමේදී `http` module එක පමණක් භාවිතා කිරීම ඉතා අපහසු සහ සංකීර්ණ වේ.

Express.js යනු මෙම ක්‍රියාවලිය ඉතා පහසු කරවන, Node.js සඳහා නිර්මාණය කරන ලද **web application framework** එකකි. එය Node.js මත ගොඩනගා ඇති අතර, web applications සහ APIs නිර්මාණය කිරීමට අවශ්‍ය මෙවලම් සහ features රාශියක් සපයයි.

Express.js හි ප්‍රධාන වාසි:

• Minimal and Unopinionated: Express මගින් ඔබට code ලිවිය යුතු ආකාරය ගැන දැඩි නීති පනවන්නේ නැත. එය ඔබට අවශ්‍ය පරිදි application එක ගොඩනැගීමට නිදහස ලබා දේ.
• Routing: විවිධ URL paths සහ HTTP methods (GET, POST, etc.) සඳහා ප්‍රතිචාර දැක්වීම ඉතා පහසු කරයි.
• Middleware: Request-response cycle එක අතරතුර විවිධ කාර්යයන් කිරීමට ඉඩ සලසන ප්‍රබල feature එකකි.
• Performance: ඉතා සැහැල්ලු (lightweight) සහ වේගවත් framework එකකි.

---

2. Express Install කර Setup කිරීම

Express යනු බාහිර package එකක් නිසා, එය npm භාවිතයෙන් අපේ project එකට install කරගත යුතුය.

1. ඔබේ project folder එකේ terminal එක open කර, npm init -y command එක මගින් `package.json` file එකක් සාදාගන්න.
2. දැන්, Express install කිරීමට පහත command එක run කරන්න:

npm install express

මෙමගින් Express package එක download වී `node_modules` folder එකට එකතු වන අතර, `package.json` file එකේ `dependencies` යටතේ ලැයිස්තුගත වේ.

"Hello World" Express App එක:

දැන් අපි `index.js` නමින් file එකක් සාදා, සරලම Express server එකක් ලියා බලමු.

// 1. Express module එක import කරගැනීම
const express = require('express');

// 2. Express application එකක් නිර්මාණය කරගැනීම
const app = express();

// 3. Server එක run විය යුතු port එක නියම කිරීම
const port = 3000;

// 4. GET request එකක් සඳහා route එකක් නිර්මාණය කිරීම
// '/' යනු homepage එකයි (root URL)
app.get('/', (req, res) => {
    // res.send() මගින් browser එකට response එකක් යැවීම
    res.send('Hello World with Express!');
});

// 5. Server එකට port එකෙන් listen කිරීමට සැලැස්වීම
app.listen(port, () => {
    console.log(`Server is running at http://localhost:${port}`);
});
        

Terminal එකේ node index.js ලෙස run කර, ඔබේ browser එකෙන් http://localhost:3000 වෙත පිවිසෙන්න. "Hello World with Express!" ලෙස ඔබට දිස්වනු ඇත. `http` module එකට වඩා Express සමඟ server එකක් සෑදීම කොතරම් පහසුදැයි බලන්න!

---

3. Routes නිර්මාණය කිරීම (GET, POST)

Routing යනු application එකක්, client (browser) එකකින් එවන συγκεκριμένη URL path (endpoint) එකකට සහ HTTP method (GET, POST වැනි) එකකට ප්‍රතිචාර දක්වන ආකාරය තීරණය කිරීමයි.

Routing හි මූලික ව්‍යුහය:

app.METHOD(PATH, HANDLER)

• `app` යනු Express instance එකයි.
• `METHOD` යනු HTTP request method එකයි (උදා: `get`, `post`, `put`, `delete`).
• `PATH` යනු server එකේ path එකයි (URL).
• `HANDLER` යනු route එකට request එකක් ආ විට ක්‍රියාත්මක වන function එකයි.

GET සහ POST Routes සඳහා උදාහරණ:

අපි අපේ `index.js` file එකට තවත් routes කිහිපයක් එකතු කරමු.

const express = require('express');
const app = express();
const port = 3000;

// Homepage Route (GET request)
app.get('/', (req, res) => {
    res.send('This is the Homepage!');
});

// About Page Route (GET request)
app.get('/about', (req, res) => {
    res.send('This is the About Page.');
});

// API Route - Get list of users (GET request)
app.get('/api/users', (req, res) => {
    // සාමාන්‍යයෙන් මෙතනදී database එකෙන් data අරන් JSON විදිහට යවනවා
    res.json([{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }]);
});

// Submit Form Route (POST request)
app.post('/submit-form', (req, res) => {
    res.send('Your data has been submitted!');
});

app.listen(port, () => {
    console.log(`Server is running at http://localhost:${port}`);
});
        

දැන් ඔබට browser එකෙන් http://localhost:3000/about සහ http://localhost:3000/api/users වෙත පිවිසීමෙන් එම routes ක්‍රියා කරන ආකාරය දැකගත හැක. POST request එකක් browser එකෙන් කෙලින්ම යැවිය නොහැකි නිසා, ඒ සඳහා Postman වැනි මෙවලමක් අවශ්‍ය වේ (ඒ ගැන ඉදිරි පාඩම් වලදී කතා කරමු).

---

4. Middleware Basics

Middleware යනු Express හි ඇති ඉතාම වැදගත් සහ ප්‍රබල සංකල්පයකි. සරලවම කිවහොත්, Middleware යනු request එකක් අපේ route handler එකට (අවසාන ගමනාන්තයට) ළඟා වීමට පෙර, ඒ අතරමගදී ක්‍රියාත්මක වන functions වේ.

සෑම middleware function එකකටම arguments 3ක් ලැබේ:

• `req` (Request object)
• `res` (Response object)
• `next` (ඊළඟ middleware function එකට control එක pass කරන function එක)

`next()` function එක ඉතා වැදගත් වේ. middleware function එකක වැඩ අවසන් වූ පසු, `next()` call නොකළහොත්, request එක එතන නැවතී, application එක freeze වනු ඇත.

සරල Logger Middleware එකක්:

අපේ server එකට එන සෑම request එකකම method එක (GET, POST) සහ URL එක console එකේ log කරන සරල middleware එකක් ලියා බලමු.

const express = require('express');
const app = express();
const port = 3000;

// Custom Logger Middleware
const logger = (req, res, next) => {
    console.log(`Request Method: ${req.method}, Request URL: ${req.originalUrl}`);
    next(); // ඊළඟ middleware එකට හෝ route handler එකට control එක pass කිරීම
};

// app.use() මගින් middleware එක application එකට යෙදීම
// මෙම middleware එක, මෙයට පහළින් ඇති සියලුම routes සඳහා ක්‍රියාත්මක වේ.
app.use(logger);

// Routes
app.get('/', (req, res) => {
    res.send('Homepage');
});

app.get('/about', (req, res) => {
    res.send('About Page');
});

app.listen(port, () => {
    console.log(`Server is running at http://localhost:${port}`);
});
        

දැන් server එක run කර, browser එකෙන් http://localhost:3000/ සහ http://localhost:3000/about වෙත පිවිසෙන්න. ඔබේ terminal එකේ පහත ආකාරයේ log පණිවිඩ දිස්වනු ඇත:

Request Method: GET, Request URL: /
Request Method: GET, Request URL: /about
        

Express හි `express.json()`, `express.urlencoded()` වැනි built-in middleware මෙන්ම, `cors`, `helmet` වැනි third-party middleware ද බහුලව භාවිතා වේ. ඒවා ගැන අපි ඉදිරියේදී ඉගෙන ගනිමු.

---

Go Back to Module 3 Go to Module 5