为什么我选择'golly”框架来构建我的下一个基于 Golang 的 REST API？-Golang-PHP中文网

为什么我选择'golly”框架来构建我的下一个基于 Golang 的 REST API？

Mary-Kate Olsen

发布： 2024-10-24 06:18:30

原创

344 人浏览过

为什么选择Go（Golang）进行服务器端开发？

选择 Go (Golang) 进行服务器端开发通常是由其关键优势驱动的：

性能：Go 的并发模型基于 Goroutine 和 Channel，可以同时高效处理多个任务，非常适合高性能服务器应用。
简单性：该语言的设计简单易读，语法简约。这使得维护变得更容易，即使对于大型项目也是如此。
快速编译和执行：Go 直接编译为机器代码，与 Python 或 Node.js 等解释性语言相比，执行速度更快。
可扩展性：Go 内置的并发性和轻量级特性使其成为构建可处理大量请求的可扩展服务的不错选择。
强大的标准库：Go 附带了强大的标准库，特别是用于构建网络服务、处理 HTTP 和管理并发，减少对外部依赖的需求。

这些因素使 Go 非常适合现代服务器端应用程序，特别是当性能和可扩展性很重要时。

如何在 Golang 中构建 REST API 服务器？

有很多框架可以在 Golang 中构建 REST API 服务器，例如 Gin、Gorrilla-Mux 等等。

我们将使用一个新的框架 golly，它提供了一套全面的工具来构建您的 Golang 应用程序。

让我们深入了解实施

我们想要构建的所需 API

GET /api/v1/users
POST /api/v1/users
PUT /api/v1/users/:id
DELETE /api/v1/users/:id

登录后复制

一旦我们定义了所需的 API，我们就开始启动 go 项目。使用以下命令：-

mkdir my-go-server
cd my-go-server
go mod init rest_server

go get oss.nandlabs.io/golly

登录后复制

执行上述操作后，您应该能够看到如下所示的文件夹结构

Why I chose

现在我们可以开始创建我们想要的服务器结构

创建一个 main.go 文件，其中包含 main()，即 golang 应用程序的入口点

package main

import "rest_server/server"

func main() {
        // create the instance of your server
    srv := server.NewServer()
        // start your server
    srv.Start()
}

登录后复制

创建一个 /server/server.go 文件，其中包含您的服务器配置

package server

import (
    "rest_server/handlers"
    "rest_server/store"

    "oss.nandlabs.io/golly/lifecycle"
    "oss.nandlabs.io/golly/rest/server"
)

type Server struct {
    store *store.Store
}

func NewServer() *Server {
    return &Server{
        store: store.NewStore(),
    }
}

func (s *Server) Start() {
    // register the router by creating the server object
    restServer, err := server.Default()
    if err != nil {
        panic(err)
    }

    // Add path prefix if you want
    restServer.Opts().PathPrefix = "/api/v1"

    // register routes
    restServer.Get("/users", handlers.GetUsers)
    restServer.Post("/users", handlers.AddUser)
    restServer.Put("/users/:id", handlers.UpdateUser)
    restServer.Delete("/users/:id", handlers.DeleteUser)

    // create the http.Server object and register the router as Handler
    // provide the necessary configurations such as PORT, ReadTimeout, WriteTimeout...
    manager := lifecycle.NewSimpleComponentManager()

    // Register the server
    manager.Register(restServer)

    // start the server
    manager.StartAndWait()
}

登录后复制

您想要实现的应用程序结构如下

Why I chose

在 /store/store.go 下创建一个内存存储以测试您的 CRUD 操作。

package store

import "rest_server/models"

type Store struct {
    data map[string]models.Item
}

var initStore *Store

func NewStore() *Store {
    initStore = &Store{data: make(map[string]models.Item)}
    return initStore
}

func GetStore() *Store {
    return initStore
}

func (s *Store) GetAll() []models.Item {
    items := []models.Item{}
    for _, item := range s.data {
        items = append(items, item)
    }
    return items
}

func (s *Store) GetById(id string) (item models.Item, exists bool) {
    item, exists = s.data[id]
    return
}

func (s *Store) Put(id string, item models.Item) {
    s.data[id] = item
}

func (s *Store) Delete(id string) {
    delete(s.data, id)
}

登录后复制

这指的是 /models/item.go 下的模型

GET /api/v1/users
POST /api/v1/users
PUT /api/v1/users/:id
DELETE /api/v1/users/:id

登录后复制

处理程序将包含 /server/server.go 下定义的每个端点的处理程序。

/handlers/AddUser.go 的一个这样的实现如下

mkdir my-go-server
cd my-go-server
go mod init rest_server

go get oss.nandlabs.io/golly

登录后复制

类似地，您可以使用所需的逻辑创建其他处理程序。

完整示例可以在此 github 存储库中找到

创建服务器后，您可以使用以下命令启动服务器

package main

import "rest_server/server"

func main() {
        // create the instance of your server
    srv := server.NewServer()
        // start your server
    srv.Start()
}

登录后复制

输出应如下所示

Why I chose
您可以看到注册的端点以及服务器的启动位置。