Panduan praktis dan terstruktur mengenai panduan react tanstack query: insert data ke api (usemutation) (part 6) berstandar enterprise. Pelajari konsep, implementasi kode modern, dan tips arsitektur enterprise siap produksi.
Selamat datang di seri tutorial engineering SiHubung! Pada artikel ini, kita akan membedah secara komprehensif implementasi Panduan React Tanstack Query: Insert Data Ke Api (Usemutation) (Part 6) Berstandar Enterprise dengan standar kode bersih (clean code), performa tinggi, dan arsitektur siap produksi.
Membangun aplikasi web di era modern memerlukan pondasi yang kokoh. Framework modern memberikan fleksibilitas luar biasa bagi developer untuk menghadirkan fitur kompleks secara cepat tanpa mengabaikan aspek keamanan dan keandalan sistem.
Tahapan Implementasi & Walkthrough Kode
Berikut adalah langkah demi langkah teknis yang dapat Anda ikuti langsung pada codebase Anda:
Tahap 1: Penulisan Kode & Konfigurasi
//import hook useState
import { useState } from "react";
//import hook useNavigate
import { useNavigate } from "react-router";
//import hook useMutation
import { useMutation } from "@tanstack/react-query";
//import service Api
import Api from "../../api";
const ProductCreate = () => {
// State for image, title, description, price, stock and errors
const [image, setImage] = useState(null);
const [title, setTitle] = useState("");
const [description, setDescription] = useState("");
const [price, setPrice] = useState("");
const [stock, setStock] = useState("");
const [errors, setErrors] = useState({});
// Initialize useNavigate
const navigate = useNavigate();
// Function to handle file change
const handleFileChange = (e) => {
if (e.target.files && e.target.files[0]) {
setImage(e.target.files[0]);
}
};
// Initialize useMutation
const mutationProduct = useMutation({
//mutation function
mutationFn: async (formData) => {
// Call the API to store the product
const response = await Api.post("/api/products", formData);
return response.data;
},
onSuccess: () => {
// Redirect to the product index page
navigate("/products");
},
onError: (error) => {
// set errors if there is an error
setErrors(error.response.data);
},
});
// Function to handle form submission
const storeProduct = (e) => {
e.preventDefault();
//initialize formData
const formData = new FormData();
//append data to formData
if (image) formData.append("image", image);
formData.append("title", title);
formData.append("description", description);
formData.append("price", price);
formData.append("stock", stock);
// Call the mutationProduct function
mutationProduct.mutate(formData);
};
return (
<div className="container mt-5">
<div className="row">
<div className="col-md-12">
<div className="card border-0 rounded-3 shadow">
<div className="card-body">
<form onSubmit={storeProduct}>
{/* Input image */}
<div className="mb-3">
<label className="form-label fw-bold">Image</label>
<input type="file" onChange={handleFileChange} className="form-control" />
{errors.image && <div className="alert alert-danger mt-2">{errors.image[0]}</div>}
</div>
{/* Input title */}
<div className="mb-3">
<label className="form-label fw-bold">Title</label>
<input
type="text"
className="form-control"
onChange={(e) => setTitle(e.target.value)}
placeholder="Title Product"
/>
{errors.title && <div className="alert alert-danger mt-2">{errors.title[0]}</div>}
</div>
{/* Input description */}
<div className="mb-3">
<label className="form-label fw-bold">Description</label>
<textarea
className="form-control"
onChange={(e) => setDescription(e.target.value)}
rows={5}
placeholder="Description Product"
/>
{errors.description && (
<div className="alert alert-danger mt-2">{errors.description[0]}</div>
)}
</div>
{/* Input price & stock */}
<div className="row">
<div className="col-md-6">
<div className="mb-3">
<label className="form-label fw-bold">Price</label>
<input
type="number"
className="form-control"
onChange={(e) => setPrice(e.target.value)}
placeholder="Price Product"
/>
{errors.price && (
<div className="alert alert-danger mt-2">{errors.price[0]}</div>
)}
</div>
</div>
<div className="col-md-6">
<div className="mb-3">
<label className="form-label fw-bold">Stock</label>
<input
type="number"
className="form-control"
onChange={(e) => setStock(e.target.value)}
placeholder="Stock Product"
/>
{errors.stock && (
<div className="alert alert-danger mt-2">{errors.stock[0]}</div>
)}
</div>
</div>
</div>
<button
type="submit"
className="btn btn-md btn-primary rounded-5 shadow border-0"
disabled={mutationProduct.isPending}
>
{mutationProduct.isPending ? "Saving..." : "Save"}
</button>
</form>
</div>
</div>
</div>
</div>
</div>
);
};
export default ProductCreate;Tahap 2: Penulisan Kode & Konfigurasi
//import hook useState
import { useState } from "react";Tahap 3: Penulisan Kode & Konfigurasi
//import hook useNavigate
import { useNavigate } from "react-router";Tahap 4: Penulisan Kode & Konfigurasi
//import hook useMutation
import { useMutation } from "@tanstack/react-query";Tahap 5: Penulisan Kode & Konfigurasi
//import service Api
import Api from "../../api";Tahap 6: Penulisan Kode & Konfigurasi
// State for image, title, description, price, stock and errors
const [image, setImage] = useState(null);
const [title, setTitle] = useState("");
const [description, setDescription] = useState("");
const [price, setPrice] = useState("");
const [stock, setStock] = useState("");
const [errors, setErrors] = useState({});Tahap 7: Penulisan Kode & Konfigurasi
// Initialize useNavigate
const navigate = useNavigate();Tahap 8: Penulisan Kode & Konfigurasi
<input type="file" onChange={handleFileChange} className="form-control" />Tahap 9: Penulisan Kode & Konfigurasi
// Function to handle file change
const handleFileChange = (e) => {
if (e.target.files && e.target.files[0]) {
setImage(e.target.files[0]);
}
};Tahap 10: Penulisan Kode & Konfigurasi
// Initialize useMutation
const mutationProduct = useMutation({
//...
})Tahap 11: Penulisan Kode & Konfigurasi
//mutation function
mutationFn: async (formData) => {
// Call the API to store the product
const response = await Api.post("/api/products", formData);
return response.data;
},Tahap 12: Penulisan Kode & Konfigurasi
onSuccess: () => {
// Redirect to the product index page
navigate("/products");
},Tahap 13: Penulisan Kode & Konfigurasi
onError: (error) => {
// set errors if there is an error
setErrors(error.response.data);
},Tahap 14: Penulisan Kode & Konfigurasi
<form onSubmit={storeProduct}>
//...
</form>Tahap 15: Penulisan Kode & Konfigurasi
const storeProduct = (e) => {
//...
}Tahap 16: Penulisan Kode & Konfigurasi
//initialize formData
const formData = new FormData();
//append data to formData
if (image) formData.append("image", image);
formData.append("title", title);
formData.append("description", description);
formData.append("price", price);
formData.append("stock", stock);Tahap 17: Penulisan Kode & Konfigurasi
// Call the mutationProduct function
mutationProduct.mutate(formData);Tahap 18: Penulisan Kode & Konfigurasi
// Import React Router
import { Routes, Route } from "react-router";
// Import view HomePage
import Home from "../views/home";
//import view ProductIndex
import ProductIndex from "../views/products/index";
// Import view ProductCreate
import ProductCreate from "../views/products/create";
// Definisikan component dengan (Functional Component)
const RoutesIndex = () => {
return (
<Routes>
{/* Route untuk halaman utama */}
<Route path="/" element={<Home />} />
{/* Route untuk halaman produk */}
<Route path="/products" element={<ProductIndex />} />
{/* Route untuk halaman tambah produk */}
<Route path="/products/create" element={<ProductCreate />} />
</Routes>
);
};
export default RoutesIndex;Tahap 19: Penulisan Kode & Konfigurasi
// Import view ProductCreate
import ProductCreate from "../views/products/create";Tahap 20: Penulisan Kode & Konfigurasi
{/* Route untuk halaman create product */}
<Route path="/products/create" element={<ProductCreate />} />
💡 Tips Rekayasa Perangkat Lunak (SiHubung Engineering Best Practice)
Selalu gunakan pendekatan deklaratif, validasi input seawal mungkin di boundary layer, dan lakukan logging terstruktur untuk memudahkan observability ketika sistem dijalankan di lingkungan cloud produksi.
Kesimpulan
Dengan mengikuti langkah-langkah terstruktur di atas, implementasi modul Anda akan jauh lebih rapi, aman dari bug umum, serta siap diskalakan ke lingkungan produksi.
Nantikan artikel tutorial praktis lainnya seputar fullstack development, microservices, dan otomasi AI di Blog Engineering SiHubung. Selamat mencoba!
