Minggu, 03 September 2017

Tutorial RESTFul Web Service Menggunakan NodeJS

By Berbagi Ilmu • September 03, 2017 • 1 Comments

Tutorial RESTFul Web Service Menggunakan NodeJS

 - Setelah sebelumnya kita telah membuat RESTFul Web Service Menggunakan Java Murni untuk menampilkan "Hello World" (baca : RESTFul Web Service Java Murni ), kini kita akan melangkah lebih jauh lagi. Tutorial berikut ini akan menjelaskan cara membangun RESTFul WebService menggunakan NodeJS.  Ada 2 contoh yang akan dibahas pada tutorial berikut, yaitu contoh sederhana (menampilkan tulisan “Hello World”) dan contoh program lainnya (CRUD).



1.      Download dan install MongoDB di https://www.mongodb.org/ , NodeJS, dan Postman
2.      Setelah terinstal, daftar akun anda ke Postman (bisa via gmail).
3.      Lalu kita mensetting database MongoDB
a.       Buat folder baru (terserah di local disk mana), misal D:\mongodb\data
b.      Buka Command Promp, ketikan lokasi tempat terinstalnya MongoDB yang sebelumnnya telah di instal.
Misal :  C:\Program Files\MongoDB\Server\3.4\bin>
c.       Selanjutnya kita ketikan :
C:\Program Files\MongoDB\Server\3.4\bin>mongod.exe--dbpathD:\mongodb\data  (D:\mongodb\data  = adalah folder yang sebelumnya kita buat)
Jika berhasil, maka akan ditampilkan seperti berikut :
4.      Setelah langkah diatas, saatnya kita membuat project Hello World.
5.      Adapun struktur file yang akan kita buat dalam project kali ini adalah sebagai berikut:
        -- app/
        ----- controller/
        ------- userController.js
        ----- models/
        ------- user.js
        ----- routes.js
        -- node_modules/
        -- package.json
        -- app.js
6.  Selanjutnya kita mempersiapkan dependency yang akan kita gunakan dalam project ini. Buat file package.json
a.       Buka notepad / notepad++
b.      Ketikan kode program berikut :
{
 "name" : "node-api",
 "main" : "app.js",
 "description" : "Belajar membuat REST API dengan node js",
 "private": true,
 "dependencies": {
   "express": "~4.0.0",
   "mongoose": "~3.6.13",
   "body-parser": "~1.0.1"
 }
}

c.       Simpan kode tersebut dengan nama package.json
      7.    Setelah itu kita install dependency tersebut dengan perintah dibawah ini menggunakan cmd.
                    npm install
           Dengan melakukan perintah npm install kita akan mendapati folder node_modules dimana ini adalah       berisi file - file dependency dari yang telah kita definisikan di file package.json
     8.   Langkah selanjutnya, kita akan membuat setting server dengan menggunakan port 3000. Pastikan port  3000 terpakai. Atau kita juga dapat menggunakan port 8080.
      9.    Kita buat file app.js dengan kode program berikut :
// Basic configuration
var express = require('express');
var app = express();
var bodyParser = require('body-parser');
var mongoose = require('mongoose');
var port = process.env.PORT || 3000;

// connect to database mongodb
mongoose.connect('mongodb://localhost:27017/db_wildan');

// Configure app to use bodyParser()
app.use(bodyParser.urlencoded({extended: true}));
app.use(bodyParser.json());

// REGISTER ROUTES
var apiRouter = require('./app/routers.js')(app, express);
app.use('/api/wildan', apiRouter);

// START THE SERVER
app.listen(port);
console.log('Server http://localhost:' + port);
            Maksud dari kode tersebut adalah
a.  Base Configuration, berfungsi untuk mengimport semua data depedency yang akan kita gunakan, dan juga untuk mengatur port server kita.
b.      Connect to Database MongoDB, untuk mengTur koneksi database mongodb. Dalam contoh ini, nama databasenya adalah db_wildan.
c.     Configure app to use bodyParser(), digunakan utnuk mengambil data yang akan di input user.
d.   REGISTER ROUTES, digunakan untuk menetapkan url yang akan kita pakai, misalnya : http://localhost:3000/api/wildan/
e.    START THE SERVER, digunakan utk menjalankan server dengan port yang kta setting di Base Configuration.
      10.   Setting Routes. Kita buat file dengannama routers.js di dalam forlder app/
      11.     Tuliskan kode program berikut ini pada file routers.js :
var express = require('express');
var user = require('./controller/userController');
module.exports = function(app, express) {
var router = express();

router.route('/')
 .get(user.hello);
return router;
};
12.    Selanjutnya, kita akan membuat sebuah model yang akan digunakan untuk pengelolaan data kita nantinya. Kita buat file dengan nama user.js di dalam folder models/.
13.   Tuliskan kode program berikut kedalam file user.js :
var mongoose = require('mongoose');
var Schema = mongoose.Schema;
14.  Lalu kita membuat Controller yang digunakan untuk menghendel fungsi pengolahan data. Untuk contoh : Hello World ini, kita akan menggunakan baca data saja.
15.  Kita buat file baru dengan nama userController.js didalam folder controller/. Dan tuliskan kode program berikut ini :

var User = require('./../models/user'); // membaca file user.js di folder models
exports.hello = function(req, res){
 //User.findOne(req.params.name, function(err, user){
 //if (err)
 res.send('Hello World Wildan! ');
 //res.json(user);
 //});
};
16.   Langkah terakhir adalah menjalankannya. Buka cmd baru, lalu masuk ke folder yang telah kita bikin sebelumnya (D:\mongodb\data>)dan tambahkan node app.js. Enter.
Setelah itu, buka postman dan masukan ke url :  http://localhost:3000/api/wildan/
Jika berhasil maka akan tampil tulisan Hello World Wildan!


Selesai ...... :D Semoga bermanfaat
Karya : Wildan A Nasrullah

1 komentar: