Menggunakan Framework Express di NodeJS
Sebelum membahas tentang Express di NodeJS kita singgung sedikit mengenai NPM di NodeJS. Apa itu NPM ? NPM adalah Node Paket Manajer yang digunakan untuk mengelola paket Javascript dalam lingkup NodeJS. Dengan menggunakan NPM pengembang dapat menginstall paket pihak ketiga, mengelola dependensi dan melakukan otomasi berbagai task development pada NodeJS. NPM juga memudahkan kita untuk menemukan, mengunduh dan memasang paket Javascript yang dibutuhkan dalam proyek NodeJS.
Menggunakan NPM di NodeJS
NPM dapat digunakan sebagai satu perintah yang dijalankan dari konsol atau terminal. Namum dapat juga mengeksekusi sekumpulan perintah yang disimpan dalam format JSON. Berikut adalah contoh penggunaan NPM dengan 1 perintah melalui Command Prompt Windows atau Terminal pada teks editor yang digunakan.
Contoh diatas membuat sebuah folder dengan nama aplikasiku, kemudian masuk ke folder yang baru dibuat dan selanjutnya memberikan perintah : npm init. Hasilnya pada folder yang baru dibuat tersebut akan dibuatkan sebuah file JSON dengan nama package.json.
Adapun isi file json tersebut sesuai dengan input (masukan) yang kita berikan misalnya :
{
"name": "aplikasiku",
"version": "1.0.0",
"description": "Aplikasi Saya",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "",
"license": "ISC"
}
Menginstall Express di NodeJS
Sekarang mari kita install framework Express di NodeJS dengan menggunakan NPM. Berikan perintah
npm install express
File package.json bertambah 1 baris key dependencies yang berisi objek dengan key express.
{
"name": "aplikasiku",
"version": "1.0.0",
"description": "Aplikasi Saya",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "",
"license": "ISC",
"dependencies": {
"express": "^4.19.2"
}
}
Sekarang coba buat file index.js seperti pada contoh kode berikut :
const express = require("express");
const app = express();
const port = 8000;
app.get("/", (req, res) => {
res.send("Halo dunia !");
});
app.listen(port, () => {
console.log(`Server aktif pada port ${port}!`);
});
Eksekusi file index.js dengan perintah :
node index.js
Hasilnya :
>node index.js
Server aktif pada port 8000!
Perhatikan : Gunakan Ctrl-C untuk menon-aktifkan (shutdown) server
Jika kita membuka browser lalu mengarahkannya ke alamat http://localhost:8000 maka akan tampil teks Halo dunia ! sebagaimana yang dibuat pada kode program diatas. Mari kita bahas baris-baris kode tersebut.
const express = require("express");
const app = express();
Jika diperhatikan, kedua baris ini sebenarnya menggantikan perintah var http = require("http") pada contoh di materi Cara Gampang Belajar NodeJS Express: Pengenalan dan Instalasi. Setelah menggunakan Express, kita sebaiknya tidak lagi menggunakan modul http bawaan dari NodeJS melainkan menggunakan menggunakan modul express.
app.get("/", (req, res) => {
res.send("Halo dunia !");
});
app.get() pada baris diatas hanya merespon permintaan HTTP Get pada alamat "/" atau halaman utama dari web site. Sebagai contoh, jika server aktif di http://localhost:8000 maka app.get() hanya dieksekusi jika user membuka http://localhost:8000. Selain itu misalnya http://localhost:8000/daftar tidak akan dilayani oleh fungsi / method tersebut.
app.listen(port, () => {
console.log(`Server aktif pada port ${port}!`);
});
Perintah diatas adalah untuk mengaktifkan server pada port yang telah didefinikasi di variabel port sebelumnya. Ini sama dengan eksekusi method http.createServer() pada NodeJS standar.
Dengan penjelasan tersebut semoga kita bisa memahami dasar penggunaan modul Express pada NodeJS. Jika belum paham sebaiknya dibaca dan dicoba lagi kode programnya. Usahakan untuk tidak Copy-Paste supaya terbiasa dengan gaya pemrograman Javascript di NodeJS dan Express.
Dependensi Pengembangan / Development Dependencies
Sebelumnya kita sudah melihat satu tambahan item pada package.json setelah menginstal modul Express. Sekarang kita akan sedikit membahas tentang Dependensi Pengembangan.
Apa itu Development Dependencies dalam NodeJS ?
Development Dependecies atau dependensi pengembangan adalah paket-paket atau modul yang digunakan sebagai alat pengembangan dan hanya dibutuhkan untuk keperluan pengembangan aplikasi. Paket-paket ini tidak akan disertakan dalam aplikasi yang berjalan.
Sebagai contoh mari kita coba menggunakan paket ESLint yang berguna untuk membantu mendeteksi kesalahan, memastikan code style sesuai dengan kesepakatan, dan juga dapat membantu mengoptimalkan kode. Tentu saja untuk saat ini kita belum benar-benar membutuhkannya, tujuan kami ini hanya ingin memberikan contoh sebuah Development Depencies.
Untuk menginstal paket ESLint perintah yang diberikan adalah :
npm install eslint --save-dev
Apabila perintah tersebut berhasil dieksekusi, maka pada file package.json akan bertambah 1 item objek dengan key devDependencies
"devDependencies": {
"eslint": "^9.4.0"
}
Baiklah, itulah contoh devDepencies, dan agar tidak makin bingung sementara kita tinggalkan saja dulu bagaimana cara mengeksekusi dan kapan melakukannya.
Menginstall Kerangka Express di NodeJS
Kita sudah mempelajari cara instal dan cara menggunakan express di NodeJS, akan tetapi yang kita lakukan tersebut baru modul-modulnya saja, padahal Express merupakan salah satu Framework untuk mengembangkan aplikasi NodeJS dan juga yang paling banyak digunakan.
Sekarang mari kita instal kerangka Express di NodeJS dengan menggunakan Express Application Generator yaitu sebuah alat (tool) yang disediakan oleh Express untuk membangun kerangka Express di NodeJS. Ketik perintah ini di Command Prompt atau Powershell sebaiknya gunakan hak sebagai Administrator karena express-generator akan membuat beberapa folder.
npm install express-generator -g
Untuk membuat sebuah aplikasi dengan nama halodunia, kita bisa memberikan perintah :
express halodunia
Hasilnya seperti pada gambar diatas, yaitu beberapa folder yang merupakan kerangka pengembangan aplikasi NodeJS dengan Express yang kita inginkan. Disana juga sudah disiapkan beberapa file dan pada folder utamanya terdapat file app.js dan package.json
Jika kita buka file package.json isinya
{
"name": "halodunia",
"version": "0.0.0",
"private": true,
"scripts": {
"start": "node ./bin/www"
},
"dependencies": {
"cookie-parser": "~1.4.4",
"debug": "~2.6.9",
"express": "~4.16.1",
"http-errors": "~1.6.3",
"jade": "~1.11.0",
"morgan": "~1.9.1"
}
}
Baiklah, pada saat membuat aplikasi halodunia dengan Express, kita diminta melakukan :
Sekarang pindah ke folder halodunia, kemudian ketik perintah :
npm install
Kemudian coba jalankan perintah selanjutnya :
SET DEBUG=halodunia:* | npm start
> halodunia@0.0.0 start
> node ./bin/www
Sekarang server sudah aktif di port 3000, sesuai yang dideklarasikan pada file www.js di folder bin
var port = normalizePort(process.env.PORT || '3000');
Selamat sekarang anda sudah bisa mulai berlatih membuat aplikasi server dengan menggunakan framework Express NodeJS. Jika anda programmer pemula, cobalah untuk mengubah hal-hal kecil misalnya mengganti port, mengulangi langkah-langkah pembuatan kerangka kerja Express agar menjadi ingat dan terbiasa.
Materi lainnya :
