Tutorial Dasar Cara Membuat Rest Apı Dengan Menggunakan Express, Typescript, Dan Postgresql

Berikut adalah tutorial dasar tentang cara membuat REST API dengan menggunakan Express, TypeScript, dan PostgreSQL:

# Prasyarat

- Node.js dan npm terinstal
- PostgreSQL terinstal dan berjalan
- Editor kode (mis. VSCode)
- Terminal atau command prompt

# Langkah-langkah

Langkah 1:

Inisialisasi Proyek Buat folder baru untuk proyek dan inisialisasi dengan `npm`: bash mkdir express-typescript-api cd express-typescript-api npm init -y

Langkah 2:

Instalasi *Dependencies* Instal dependensi yang diperlukan: bash npm install express pg promise dotenv npm install --save-dev typescript ts-node @types/node @types/express @types/pg nodemon

Langkah 3:

Konfigurasi TypeScript Buat berkas `tsconfig.json` untuk mengonfigurasi TypeScript: json { "compilerOptions": { "target": "es6", "module": "commonjs", "rootDir": "./src", "outDir": "./build", "esModuleInterop": true, "strict": true, "skipLibCheck": true }, "include": ["src/**/*"], "exclude": ["node_modules"] }

Langkah 4:

Konfigurasi Environment dan Database Buat berkas `.env` untuk menyimpan konfigurasi yang sensitif seperti kredensial database: DB_HOST=localhost DB_USER=myuser DB_PASS=mypassword DB_NAME=mydatabase PORT=3000 Buat koneksi dan konfigurasi database dalam folder `src`: typescript // src/db.ts import { Pool } from 'pg'; import dotenv from 'dotenv'; dotenv.config(); const pool = new Pool({ host: process.env.DB_HOST, user: process.env.DB_USER, password: process.env.DB_PASS, database: process.env.DB_NAME, }); export default pool;

Langkah 5:

Membuat Server Express dengan TypeScript Buat file `index.ts` sebagai entry point aplikasi Anda: typescript // src/index.ts import express, { Request, Response } from 'express'; import dotenv from 'dotenv'; import pool from './db'; dotenv.config(); const app = express(); const PORT = process.env.PORT || 3000; app.use(express.json()); // Middleware untuk parsing JSON // Endpoint untuk tes app.get('/', (req: Request, res: Response) => { res.json({ message: "Welcome to Express TypeScript API!" }); }); app.listen(PORT, () => { console.log(`Server is running on port ${PORT}`); });

Langkah 6:

Buat Endpoint REST API Tambahkan endpoint CRUD untuk resource Anda (misalnya, Users): typescript // src/users.ts import { Request, Response, Router } from 'express'; import pool from './db'; const router = Router(); // Mendapatkan semua user router.get('/users', async (req: Request, res: Response) => { try { const { rows } = await pool.query('SELECT * FROM users'); res.json(rows); } catch (error) { res.status(500).json({ error: error.message }); } }); // Menambahkan user baru router.post('/users', async (req: Request, res: Response) => { try { const { name, email } = req.body; const { rows } = await pool.query('INSERT INTO users (name, email) VALUES ($1, $2) RETURNING *', [name, email]); res.json(rows[0]); } catch (error) { res.status(500).json({ error: error.message }); } }); // ... Tambahkan endpoint untuk PUT dan DELETE ... export default router; Tambahkan route ini ke server Express Anda di `index.ts`: typescript // src/index.ts // ... code ... import usersRouter from './users'; // ... code ... app.use('/api', usersRouter); // ... code ...

Langkah 7:

Menjalankan Server Tambahkan script `start` dan `dev` ke dalam `package.json`: json "scripts": { "start": "tsc && node build/index.js", "dev": "nodemon src/index.ts" } Untuk menjalankan server Anda dalam mode pengembangan, gunakan perintah: bash npm run dev Server Anda sekarang akan berjalan di `http://localhost:3000/` dan akan secara otomatis melakukan restart saat terjadi perubahan pada file TypeScript.

Catatan Penting

- Pastikan bahwa PostgreSQL Anda sudah terkonfigurasi dengan benar dan tabel yang diperlukan sudah dibuat.
- Pastikan kredensial dalam `.env` sesuai dengan konfigurasi PostgreSQL Anda.
- Anda perlu menambahkan penanganan error yang lebih baik dan middleware lain jika diperlukan, seperti otentikasi dan pengelolaan CORS.
- Selalu berhati-hati dengan keamanan, terutama saat menangani data sensitif.
- Untuk produksi, pertimbangkan untuk transpile TypeScript terlebih dahulu dengan `tsc` dan jalankan output JavaScript dengan Node.js.