Panduan praktis dan terstruktur mengenai panduan restful api golang: insert data ke dalam database (part 4) 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 Restful Api Golang: Insert Data Ke Dalam Database (Part 4) 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

package controllers

import (
	"errors"
	"net/http"
	"santrikoding/backend-api/models"

	"github.com/gin-gonic/gin"
	"github.com/go-playground/validator/v10"
)

// type validation post input
type ValidatePostInput struct {
	Title   string `json:"title" binding:"required"`
	Content string `json:"content" binding:"required"`
}

// type error message
type ErrorMsg struct {
	Field   string `json:"field"`
	Message string `json:"message"`
}

// function get error message
func GetErrorMsg(fe validator.FieldError) string {
	switch fe.Tag() {
	case "required":
		return "This field is required"
	}
	return "Unknown error"
}

// get all posts
func FindPosts(c *gin.Context) {

	//get data from database using model
	var posts []models.Post
	models.DB.Find(&posts)

	//return json
	c.JSON(200, gin.H{
		"success": true,
		"message": "Lists Data Posts",
		"data":    posts,
	})
}

// store a post
func StorePost(c *gin.Context) {
	//validate input
	var input ValidatePostInput
	if err := c.ShouldBindJSON(&input); err != nil {
		var ve validator.ValidationErrors
		if errors.As(err, &ve) {
			out := make([]ErrorMsg, len(ve))
			for i, fe := range ve {
				out[i] = ErrorMsg{fe.Field(), GetErrorMsg(fe)}
			}
			c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"errors": out})
		}
		return
	}

	//create post
	post := models.Post{
		Title:   input.Title,
		Content: input.Content,
	}
	models.DB.Create(&post)

	//return response json
	c.JSON(201, gin.H{
		"success": true,
		"message": "Post Created Successfully",
		"data":    post,
	})
}

Tahap 2: Penulisan Kode & Konfigurasi

import (
	"errors"
	"net/http"
	"santrikoding/backend-api/models"

	"github.com/gin-gonic/gin"
	"github.com/go-playground/validator/v10"
)

Tahap 3: Penulisan Kode & Konfigurasi

// type validation post input
type ValidatePostInput struct {
	Title   string `json:"title" binding:"required"`
	Content string `json:"content" binding:"required"`
}

Tahap 4: Penulisan Kode & Konfigurasi

// type error message
type ErrorMsg struct {
	Field   string `json:"field"`
	Message string `json:"message"`
}

Tahap 5: Penulisan Kode & Konfigurasi

// store a post
func StorePost(c *gin.Context) {

	//...
	
}

Tahap 6: Penulisan Kode & Konfigurasi

//validate input
var input ValidatePostInput

Tahap 7: Penulisan Kode & Konfigurasi

if err := c.ShouldBindJSON(&input); err != nil {

	//...

}

Tahap 8: Penulisan Kode & Konfigurasi

var ve validator.ValidationErrors
if errors.As(err, &ve) {
    out := make([]ErrorMsg, len(ve))
    for i, fe := range ve {
        out[i] = ErrorMsg{fe.Field(), getErrorMsg(fe)}
    }
    c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"errors": out})
}
return

Tahap 9: Penulisan Kode & Konfigurasi

//create post
post := models.Post{
    Title:   input.Title,
    Content: input.Content,
}

Tahap 10: Penulisan Kode & Konfigurasi

models.DB.Create(&post)

Tahap 11: Penulisan Kode & Konfigurasi

//return response json
c.JSON(201, gin.H{
    "success": true,
    "message": "Post Created Successfully",
    "data":    post,
})

Tahap 12: Penulisan Kode & Konfigurasi

package main

import (
	"santrikoding/backend-api/controllers"
	"santrikoding/backend-api/models"

	"github.com/gin-gonic/gin"
)

func main() {
	//inisialiasai Gin
	router := gin.Default()

	//panggil koneksi database
	models.ConnectDatabase()

	//membuat route dengan method GET
	router.GET("/", func(c *gin.Context) {

		//return response JSON
		c.JSON(200, gin.H{
			"message": "Hello World!",
		})
	})

	//membuat route get all posts
	router.GET("/api/posts", controllers.FindPosts)

	//membuat route store post
	router.POST("/api/posts", controllers.StorePost)

	//mulai server dengan port 3000
	router.Run(":3000")
}

Tahap 13: Penulisan Kode & Konfigurasi

//membuat route store post
router.POST("/api/posts", controllers.StorePost)

Tahap 14: Penulisan Kode & Konfigurasi

{
    "title": "",
    "content": ""
}

Tahap 15: Penulisan Kode & Konfigurasi

{
    "errors": [
        {
            "field": "Title",
            "message": "This field is required"
        },
        {
            "field": "Content",
            "message": "This field is required"
        }
    ]
}

Tahap 16: Penulisan Kode & Konfigurasi

{
    "title": "Belajar Restful API Golang",
    "content": "Di SantriKoding"
}

Tahap 17: Penulisan Kode & Konfigurasi

{
    "data": {
        "id": 1,
        "title": "Belajar Restful API Golang",
        "content": "Di SantriKoding"
    },
    "message": "Post Created Successfully",
    "success": true
}
💡 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!