跳转到主要内容

标签(标签)

资源精选(342) Go开发(108) Go语言(103) Go(99) angular(82) LLM(75) 大语言模型(63) 人工智能(53) 前端开发(50) LangChain(43) golang(43) 机器学习(39) Go工程师(38) Go程序员(38) Go开发者(36) React(33) Go基础(29) Python(24) Vue(22) Web开发(20) Web技术(19) 精选资源(19) 深度学习(19) Java(18) ChatGTP(17) Cookie(16) android(16) 前端框架(13) JavaScript(13) Next.js(12) 安卓(11) 聊天机器人(10) typescript(10) 资料精选(10) NLP(10) 第三方Cookie(9) Redwoodjs(9) LLMOps(9) Go语言中级开发(9) 自然语言处理(9) PostgreSQL(9) 区块链(9) mlops(9) 安全(9) 全栈开发(8) ChatGPT(8) OpenAI(8) Linux(8) AI(8) GraphQL(8) iOS(8) 软件架构(7) Go语言高级开发(7) AWS(7) C++(7) 数据科学(7) whisper(6) Prisma(6) 隐私保护(6) RAG(6) JSON(6) DevOps(6) 数据可视化(6) wasm(6) 计算机视觉(6) 算法(6) Rust(6) 微服务(6) 隐私沙盒(5) FedCM(5) 语音识别(5) Angular开发(5) 快速应用开发(5) 提示工程(5) Agent(5) LLaMA(5) 低代码开发(5) Go测试(5) gorm(5) REST API(5) 推荐系统(5) WebAssembly(5) GameDev(5) CMS(5) CSS(5) machine-learning(5) 机器人(5) 游戏开发(5) Blockchain(5) Web安全(5) Kotlin(5) 低代码平台(5) 机器学习资源(5) Go资源(5) Nodejs(5) PHP(5) Swift(5) 智能体(4) devin(4) Blitz(4) javascript框架(4) Redwood(4) GDPR(4) 生成式人工智能(4) Angular16(4) Alpaca(4) 编程语言(4) SAML(4) JWT(4) JSON处理(4) Go并发(4) kafka(4) 移动开发(4) 移动应用(4) security(4) 隐私(4) spring-boot(4) 物联网(4) nextjs(4) 网络安全(4) API(4) Ruby(4) 信息安全(4) flutter(4) 专家智能体(3) Chrome(3) CHIPS(3) 3PC(3) SSE(3) 人工智能软件工程师(3) LLM Agent(3) Remix(3) Ubuntu(3) GPT4All(3) 软件开发(3) 问答系统(3) 开发工具(3) 最佳实践(3) RxJS(3) SSR(3) Node.js(3) Dolly(3) 移动应用开发(3) 低代码(3) IAM(3) Web框架(3) CORS(3) 基准测试(3) Go语言数据库开发(3) Oauth2(3) 并发(3) 主题(3) Theme(3) earth(3) nginx(3) 软件工程(3) azure(3) keycloak(3) 生产力工具(3) gpt3(3) 工作流(3) C(3) jupyter(3) 认证(3) prometheus(3) GAN(3) Spring(3) 逆向工程(3) 应用安全(3) Docker(3) Django(3) R(3) .NET(3) 大数据(3) Hacking(3) 渗透测试(3) C++资源(3) Mac(3) 微信小程序(3) Python资源(3) JHipster(3) 大型语言模型(2) 语言模型(2) 可穿戴设备(2) JDK(2) SQL(2) Apache(2) Hashicorp Vault(2) Spring Cloud Vault(2) Go语言Web开发(2) Go测试工程师(2) WebSocket(2) 容器化(2) AES(2) 加密(2) 输入验证(2) ORM(2) Fiber(2) Postgres(2) Gorilla Mux(2) Go数据库开发(2) 模块(2) 泛型(2) 指针(2) HTTP(2) PostgreSQL开发(2) Vault(2) K8s(2) Spring boot(2) R语言(2) 深度学习资源(2) 半监督学习(2) semi-supervised-learning(2) architecture(2) 普罗米修斯(2) 嵌入模型(2) productivity(2) 编码(2) Qt(2) 前端(2) Rust语言(2) NeRF(2) 神经辐射场(2) 元宇宙(2) CPP(2) 数据分析(2) spark(2) 流处理(2) Ionic(2) 人体姿势估计(2) human-pose-estimation(2) 视频处理(2) deep-learning(2) kotlin语言(2) kotlin开发(2) burp(2) Chatbot(2) npm(2) quantum(2) OCR(2) 游戏(2) game(2) 内容管理系统(2) MySQL(2) python-books(2) pentest(2) opengl(2) IDE(2) 漏洞赏金(2) Web(2) 知识图谱(2) PyTorch(2) 数据库(2) reverse-engineering(2) 数据工程(2) swift开发(2) rest(2) robotics(2) ios-animation(2) 知识蒸馏(2) 安卓开发(2) nestjs(2) solidity(2) 爬虫(2) 面试(2) 容器(2) C++精选(2) 人工智能资源(2) Machine Learning(2) 备忘单(2) 编程书籍(2) angular资源(2) 速查表(2) cheatsheets(2) SecOps(2) mlops资源(2) R资源(2) DDD(2) 架构设计模式(2) 量化(2) Hacking资源(2) 强化学习(2) flask(2) 设计(2) 性能(2) Sysadmin(2) 系统管理员(2) Java资源(2) 机器学习精选(2) android资源(2) android-UI(2) Mac资源(2) iOS资源(2) Vue资源(2) flutter资源(2) JavaScript精选(2) JavaScript资源(2) Rust开发(2) deeplearning(2) RAD(2)

golang

Introduction

If you’re a Node.js developer who wants to learn Golang. Maybe Fiber is the right choice for you. You may recognize that Fiber is inspired by the Node.js framework — but it is written in Go.

We’ll look at Fiber’s features and components, including routing, and context, in this post. Finally, we should be able to use these features to create a demo application that interacts with PostgreSQL.

Prerequisites

We should have at least a basic understanding of the Go programming language in order to follow along with this tutorial. Knowing a little bit of Express could also help to quickly understand Fiber from an architectural perspective.

Also, make sure you have the Postgres for your operating system, which you can get here. You can also install any Postgres GUI client. We’ll be using PGAdmin4 in this article, which you can install alongside the Postgres installer.

You should also make sure that you have the latest version of Go installed on your computer.

Let’s Code

Initialize our project:

go mod init github.com/[YourGithubAccount]/[YourProjectName]
// example
go mod init github.com/adhtanjung/go_rest_api

Here is a screenshot of our project directory:

folder structure

In today’s example we are going to install only these dependencies, which are as follows:

go get github.com/gofiber/fiber/v2
go get github.com/google/uuid
go get github.com/lib/pq
go get github.com/joho/godotenv
go get -u gorm.io/gorm

ENV

Now let’s start by fill in our .env file, our .env file contains our secrets required for our database connection.

DB_HOST=localhost
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=
DB_NAME=postgres

Config

Setup our config/config.go

package configimport (
 "fmt"
 "os"
 "github.com/joho/godotenv"
)// Config func to get env value from key ---
func Config(key string) string {
 // load .env file
 err := godotenv.Load(".env")
 if err != nil {
  fmt.Print("Error loading .env file")
 }
 return os.Getenv(key)}

Main.go

Setup our main.go file:

package mainimport (
 "github.com/adhtanjung/go_rest_api/database"
 "github.com/adhtanjung/go_rest_api/router"
 "github.com/gofiber/fiber/v2"
 "github.com/gofiber/fiber/v2/middleware/cors"
 "github.com/gofiber/fiber/v2/middleware/logger"
 _ "github.com/lib/pq"
)func main() {
 database.Connect() app := fiber.New() app.Use(logger.New()) app.Use(cors.New()) router.SetupRoutes(app) // handle unavailable route
 app.Use(func(c *fiber.Ctx) error {
  return c.SendStatus(404) // => 404 "Not Found"
 }) app.Listen(":8080")
}

Database

Next database/database.go:

package databaseimport (
 "fmt"
 "log"
 "os"
 "strconv"
 "gorm.io/driver/postgres"
 "github.com/adhtanjung/go_rest_api/config"
 "github.com/adhtanjung/go_rest_api/model"
 "gorm.io/gorm"
 "gorm.io/gorm/logger"
)// Database instance
type Dbinstance struct {
 Db *gorm.DB
}var DB Dbinstance// Connect function
func Connect() {
 p := config.Config("DB_PORT")
 // because our config function returns a string, we are parsing our      str to int here
 port, err := strconv.ParseUint(p, 10, 32) if err != nil {
  fmt.Println("Error parsing str to int")
 } dsn := fmt.Sprintf("host=%s user=%s password=%s dbname=%s port=%d sslmode=disable TimeZone=Asia/Shanghai", config.Config("DB_HOST"), config.Config("DB_USER"), config.Config("DB_PASSWORD"),  config.Config("DB_NAME"), port) db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{
  Logger: logger.Default.LogMode(logger.Info),
 }) if err != nil {
  log.Fatal("Failed to connect to database. \n", err)
  os.Exit(2)
 } log.Println("Connected")
 db.Logger = logger.Default.LogMode(logger.Info)
 log.Println("running migrations")
 db.AutoMigrate(&model.User{}) DB = Dbinstance{
  Db: db,
 }
}

Models

Defining our Model, which will have a total of 4 properties:

/model/user.go

package modelimport (
 "github.com/google/uuid"
 "gorm.io/gorm"
)// User struct
type User struct {
 gorm.Model
 ID       uuid.UUID `gorm:"type:uuid;"`
 Username string    `json:"username"`
 Email    string    `json:"email"`
 Password string    `json:"password"`
}// Users struct
type Users struct {
 Users []User `json:"users"`
}func (user *User) BeforeCreate(tx *gorm.DB) (err error) {
 // UUID version 4
 user.ID = uuid.New()
 return
}

Route

router/route.go

package routerimport (
 "github.com/adhtanjung/go_rest_api/handler"
 "github.com/gofiber/fiber/v2"
)// SetupRoutes func
func SetupRoutes(app *fiber.App) {
 // grouping
 api := app.Group("/api")
 v1 := api.Group("/user") // routes
 v1.Get("/", handler.GetAllUsers)
 v1.Get("/:id", handler.GetSingleUser)
 v1.Post("/", handler.CreateUser)
 v1.Put("/:id", handler.UpdateUser)
 v1.Delete("/:id", handler.DeleteUserByID)
}

Handler

handler/handler.go

package handlerimport (
 "github.com/adhtanjung/go_rest_api/database"
 "github.com/adhtanjung/go_rest_api/model"
 "github.com/gofiber/fiber/v2"
 "github.com/google/uuid"
)

Create a User

//Create a user
 func CreateUser(c *fiber.Ctx) error {
  db := database.DB.Db
  user := new(model.User) // Store the body in the user and return error if encountered
  err := c.BodyParser(user)
  if err != nil {
   return c.Status(500).JSON(fiber.Map{"status": "error", "message":  "Something's wrong with your input", "data": err})
  } err = db.Create(&user).Error
  if err != nil {
   return c.Status(500).JSON(fiber.Map{"status": "error", "message":  "Could not create user", "data": err})
  } // Return the created user
  return c.Status(201).JSON(fiber.Map{"status": "success", "message":  "User has created", "data": user})
 }

Get All Users

// Get All Users from db
func GetAllUsers(c *fiber.Ctx) error {
 db := database.DB.Db
 var users []model.User// find all users in the database
 db.Find(&users)// If no user found, return an error
 if len(users) == 0 {
  return c.Status(404).JSON(fiber.Map{"status": "error", "message": "Users not found", "data": nil})
 }// return users
 return c.Status(200).JSON(fiber.Map{"status": "sucess", "message": "Users Found", "data": users})
}

Get Single User

// GetSingleUser from db
func GetSingleUser(c *fiber.Ctx) error {
 db := database.DB.Db// get id params
 id := c.Params("id")var user model.User// find single user in the database by id
 db.Find(&user, "id = ?", id)if user.ID == uuid.Nil {
  return c.Status(404).JSON(fiber.Map{"status": "error", "message": "User not found", "data": nil})
 }return c.Status(200).JSON(fiber.Map{"status": "success", "message": "User Found", "data": user})
}

Update a user

// update a user in db
func UpdateUser(c *fiber.Ctx) error {
 type updateUser struct {
  Username string `json:"username"`
 }db := database.DB.Dbvar user model.User// get id params
 id := c.Params("id")// find single user in the database by id
 db.Find(&user, "id = ?", id)if user.ID == uuid.Nil {
  return c.Status(404).JSON(fiber.Map{"status": "error", "message": "User not found", "data": nil})
 }var updateUserData updateUser
 err := c.BodyParser(&updateUserData)
 if err != nil {
  return c.Status(500).JSON(fiber.Map{"status": "error", "message": "Something's wrong with your input", "data": err})
 }user.Username = updateUserData.Username// Save the Changes
 db.Save(&user)// Return the updated user
 return c.Status(200).JSON(fiber.Map{"status": "success", "message": "users Found", "data": user})}

Delete a user

// delete user in db by ID
func DeleteUserByID(c *fiber.Ctx) error {
 db := database.DB.Db
 var user model.User// get id params
 id := c.Params("id")// find single user in the database by id
 db.Find(&user, "id = ?", id)if user.ID == uuid.Nil {
  return c.Status(404).JSON(fiber.Map{"status": "error", "message": "User not found", "data": nil})}err := db.Delete(&user, "id = ?", id).Errorif err != nil {
  return c.Status(404).JSON(fiber.Map{"status": "error", "message": "Failed to delete user", "data": nil})
 }return c.Status(200).JSON(fiber.Map{"status": "success", "message": "User deleted"})
}

Run the app

go run main.go

GORM provides auto migration as we can see in our code, so every time we run the app, GORM will automatically migrate your schema, to keep your schema up to date.

gorm auto migration

In addition, a POSTMAN collection is available if you intend to test our API.

Postman examples:

create

create user

getAll

get all users

getSingle

get single user

update

udpate user by id

delete

delete user by id

*Soft Delete in GORM

If a model has a DeletedAt field, it will get a soft delete ability automatically! When calling Delete, the record will not be permanently removed from the database; rather, the DeletedAt‘s value will be set to the current time.

PgAdmin

visualizing our data with PgAdmin

If you’re facing an error with the uuid_generate_v4() you can run this query on your PGAdmin4 like this:

Select Servers>PostgreSQL14>Databases>postgres[or any databases]>Schemas>Tables> Right-click on it>Query Tool

PgAdmin Query Tool

Copy and paste this query, then run it by pressing execute button or press f5

CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
Query Editor

Conclusion

As always, I hope you found it interesting. More details about the project can be found here.

I hope you have a great day!

What’s Next

You have now created a web API in Go from scratch. You learned about Go, Fiber, GORM, and Postgres. We have walked through a basic setup, and you can grow your API into a full-fledged web application.

  • Add JWT based authentication
  • Add Swagger API documentation.