chore: menambahkan penjelasan tentang net http package (#58)

* chore: menambahkan penjelasan tentang net http package

Signed-off-by: slowy07 <[email protected]>

* fix(SecSLL): error codacy

Signed-off-by: slowy07 <[email protected]>

* docs: update link

Signed-off-by: slowy07 <[email protected]>

---------

Signed-off-by: slowy07 <[email protected]>

Author: slowy07

utilities/net_http/README.md

@@ -0,0 +1,61 @@
+## net/http
+
+`net/http` adalah standard library bawaan Go yang digunakan untuk membangun aplikasi berbasis protokol HTTP. Tujuan antara lain:
+- Menangani request dari client seperti API atau browser
+- Mengirim request ke server lain
+- Middleware, routing dasar, header manipulation, cookie dan lain-lain.
+
+Ada dua bagian utama dalam `net/http`:
+
+1. Server Side
+Membuat server yang akan listen request dari client, yang terdiri dari
+- `http.Request` yang merepresentasikan request HTTP yang masuk
+- `http.ResponseWriter` yang nantinya akan digunakan dalam memberikan response ke client
+- `http.Handler` interface untuk menangani request dan response
+- `http.HandleFunc` untuk register handler yang berdasarkan dari path URL
+
+2. Client Side
+Digunakan untuk melakukan request ke server lain (contoh: `GET/POS` ke `API` eksternal), dalam component client side terdapat
+- `http.Get(url string)`, `http.Post(...)`
+- `http.Client{}` digunakan untuk konfigurasi custom request (seperti request, headers, dan lain-lain)
+
+## contoh implementasi
+
+Fungsi `homeHandler` yang akan dipanggil saat user mengakses `/`. dan mencatat response ke client.
+```go
+func homeHandler(rw http.ResponseWriter, req *http.Request) {
+    fmt.Fprintf(rw, "selamat datang di bellshade Golang !\n")
+}
+```
+
+Fungsi `aboutHandler` yang akan dipanggil sama seperti `homeHandler` tetapi bedanya dia digunakan untuk page lain misalnya `/about`
+```go
+func aboutHandler(rw http.ResponseWriter, req *http.Request) {
+    fmt.Printf(rw, "kita di page about - bellshade Golang\n")
+}
+```
+
+Fungsi `loggingMiddleware` adalah fungsi wrapping handler lain dan akan record log setiap request-request yang akan masuk
+```go
+func loggingMiddleware(hf http.HandlerFunc) http.HandlerFunc {
+    return func(rw http.ResponseWriter, req *http.Request) {
+        fmt.Printf("request sudah diterima: %s %s\n", rw.Method, req.URL.Path)
+        hf.ServeHTTP(rw, req)
+    }
+}
+```
+
+kita bisa mencoba dengan menggunakan fungsi `http.HandleFunc(...)` untuk menghubungkan URL path ke handler
+
+```go
+http.HandleFunc("/", loggingMiddleware(homeHandler))
+http.HandleFunc("/about", loggingMiddleware(aboutHandler))
+
+fmt.Println("server berjalan dengan http://localhost:8443")
+```
+ketika dijalankan output akan
+```
+server berjalan dengan http://localhost:8443
+```
+
+untuk source code dari package ini bisa lihat [disini](netHttp.go)

utilities/net_http/netHttp.go

@@ -0,0 +1,36 @@
+package nethttp
+
+import (
+	"fmt"
+	"net/http"
+)
+
+// fungsi handler function untuk routing `/`
+func homeHandler(w http.ResponseWriter, r *http.Request) {
+	fmt.Fprintf(w, "welcome di bellshade: home hadler\n")
+}
+
+// fungsi handler function untuk routing `/about`
+func aboutHandler(w http.ResponseWriter, r *http.Request) {
+	fmt.Fprintf(w, "about: bellshade golang \n")
+}
+
+// middleware sederhana yang digunakan untuk logging
+// setiap request
+func loggingMiddleware(next http.HandlerFunc) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		fmt.Printf("request diterima: %s %s\n", r.Method, r.URL.Path)
+		next.ServeHTTP(w, r)
+	}
+}
+
+func main() {
+	http.HandleFunc("/", loggingMiddleware(homeHandler))
+	http.HandleFunc("/about", loggingMiddleware(aboutHandler))
+	fmt.Println("server berjalan di http://localhost:8443")
+
+	err := http.ListenAndServeTLS(":8443", "cert.perm", "key.perm", nil)
+	if err != nil {
+		panic(err)
+	}
+}