快速開始構建一個簡單專案

奇蹟師發表於2021-08-20

前言

所有專案都是從一個檔案，一個 main 中開始的，可以根據以下步驟進行一個專案的初始化
專案地址

1.建立一個專案，同時執行 Hello world

package main

import "fmt"

func main {
    fmt.Println("hello world")
}

為什麼要執行一個 hello world？
- 如果連 main 中的 hello 都執行不了還怎麼執行一個大專案，可能是環境沒配置好

2.準備資料夾

project
    |- configs // 配置檔案應用位置
    |- pkg     // 包括介面在內的程式碼放在該目錄中
    |- utils // 工具類可以放在該檔案中
    |- inits     // 系統初始化，和程式管理配置
    |- README.md // 專案說明檔案
    |- main.go     // 主函式

3.準備好需要的第三方包

資料庫連線: github.com/jinzhu/gorm
路由連線: github.com/gin-gonic/gin
快取連線: github.com/gomodule/redigo/redis
訊息佇列連線: github.com/apache/rocketmq-client-go/v2
讀取配置: github.com/spf13/viper
日誌處理: github.com/sirupsen/logrus
錯誤處理: github.com/pkg/errors
測試斷言工具: github.com/stretchr/testify/assert

3.準備好專案配置檔案，推薦使用 .toml (或者 .yaml檔案)

檔案位置

projcet
    |- configs
            |- local.toml檔案

[http]
    port=":8080"
    read_timeout=60
    write_timeout=60
[database]
    host="127.0.0.1"
    dbname="postgres"
    user="postgres"
    password="123456"
    sslmode="disable"
[redis]
    host="127.0.0.1:6379"
    password=""
    max_idle=10
    max_active=10
[rocketmq]
    server = [
    "127.0.0.1:9876"
     ]

4.配置 log 日誌 (logrus)

檔案地址

project 
    |- utils
        |- logger
            |- log.go

package logger

import (
    "github.com/sirupsen/logrus"
    "os"
)

var (
    Log = logrus.New()
)

func init() {
    InitLogger()
}

func InitLogger() {
    // 日誌格式化為JSON而不是預設的ASCII
    Log.SetFormatter(&logrus.JSONFormatter{})
    // 輸出stdout而不是預設的stderr，也可以是一個檔案
    Log.SetOutput(os.Stdout)
    // 只記錄嚴重或以上警告
    Log.SetLevel(logrus.WarnLevel)
}

// New 用來建立新的 log 日誌
func New() *logrus.Logger {
    return Log
}

5.配置需要初始化的讀取專案配置(viper)資料庫(gorm)連線,快取連線(redigo),http初始化(gin),訊息佇列連線(rocketmq)

1.讀取配置檔案 (config.go)

檔案地址

project 
    |- inits
        |- config.go

package inits

import (
    "github.com/catbugdemo/project_order/utils/logger"
    "github.com/pkg/errors"
    "github.com/spf13/viper"
    "sync"
)

var (
    config *viper.Viper
    mu     sync.RWMutex
    log    = logger.New()
)

func init() {
    InitConfig()
}

func InitConfig() {
    v := viper.New()
    // 初始化配置資訊
    v.SetConfigName("local")
    v.SetConfigType("toml")

    // TODO 專案名稱進行配置
    v.AddConfigPath("$GOPATH/src/github.com/catbugdemo/project_order/configs")
    v.AddConfigPath("../configs")

    if err := ReadInConfig(v); err != nil {
        log.Fatalf("讀取配置失敗：%+v\n", err)
    }
    // 當配置改變是重新執行
    v.WatchConfig()

    config = v
}

// ReadInConfig 通過讀寫鎖保證內容穩定內容
func ReadInConfig(v *viper.Viper) error {
    mu.RLock()
    defer mu.RUnlock()
    if err := v.ReadInConfig(); err != nil {
        return errors.WithStack(err)
    }
    return nil
}

// GetConfig 獲取配置
func GetConfig() *viper.Viper {
    mu.RLock()
    defer mu.RUnlock()
    return config
}

2.初始化資料庫 (db.go)

檔案地址

project 
    |- inits
        |- db.go

package init

import (
    "fmt"
    "github.com/jinzhu/gorm"
    _ "github.com/jinzhu/gorm/dialects/postgres"

    "github.com/pkg/errors"
    "time"
)

var (
    db       *gorm.DB
    dbConfig *DbConfig
)

type DbConfig struct {
    Host     string `toml:"host"`
    DbName   string `toml:"dbname"`
    User     string `toml:"user"`
    Password string `toml:"password"`
    Sslmode  string `toml:"disable"`
}

func init() {
    InitDbConfig()
    InitDB()
}

func InitDbConfig() {
    c := GetConfig()

    dbConfig = &DbConfig{
        Host:     c.GetString("database.host"),
        DbName:   c.GetString("database.dbname"),
        User:     c.GetString("database.user"),
        Password: c.GetString("database.password"),
        Sslmode:  c.GetString("database.sslmode"),
    }
}

func InitDB() {

    params := fmt.Sprintf("host=%s user=%s dbname=%s sslmode=%s password=%s",
        dbConfig.Host,
        dbConfig.User,
        dbConfig.DbName,
        dbConfig.Sslmode,
        dbConfig.Password,
    )

    open, err := gorm.Open("postgres", params)
    if err != nil {
        log.Fatalf("連線資料庫失敗:%+v", errors.WithStack(err))
    }
    if err = open.DB().Ping(); err != nil {
        log.Fatalf("ping 資料庫失敗:%+v", errors.WithStack(err))
    }

    // 設定表不為複數
    open.SingularTable(true)
    // 設定列印日誌
    open.LogMode(true)
    // 設定可重複使用連線的最長時間
    open.DB().SetConnMaxLifetime(10 * time.Second)

    db = open
}

// 獲取資料庫
func DB() *gorm.DB {
    return db
}

3.初始化快取 (redis.go)

檔案地址

project 
    |- inits
        |- redis.go

package init

import (
    "github.com/gomodule/redigo/redis"
    "github.com/pkg/errors"
    "time"
)

var (
    pool        *redis.Pool
    redisConfig *RedisConfig
)

type RedisConfig struct {
    Host      string `toml:"host"`
    Password  string `toml:"passowrd"`
    MaxIdle   int    `toml:"max_idle"`
    MaxActive int    `toml:"max_active"`
    Db        string `toml:"db"`
}

func init() {
    InitRedisConfig()
    InitRedisPool()
}

// InitRedisConfig 初始化快取配置
func InitRedisConfig() {
    c := GetConfig()

    redisConfig = &RedisConfig{
        Host:      c.GetString("redis.host"),
        Password:  c.GetString("redis.password"),
        MaxIdle:   c.GetInt("redis.max_idle"),
        MaxActive: c.GetInt("redis.max_active"),
    }
}

// InitRedisPool 初始化快取池
func InitRedisPool() {
    pool = &redis.Pool{
        //最大閒置連線
        MaxIdle: redisConfig.MaxIdle,
        //最大活動數
        MaxActive: redisConfig.MaxActive,
        //資料庫連線
        Dial: func() (redis.Conn, error) {
            c, err := redis.Dial("tcp", redisConfig.Host)
            if err != nil {
                c.Close()
                log.Printf("fail to dial redis: %+v\n", errors.WithStack(err))
                return nil, err
            }
            //密碼認證
            if redisConfig.Password != "" {
                if _, err = c.Do("AUTH", redisConfig.Password); err != nil {
                    c.Close()
                    log.Printf("fail to auth redis: %+v\n", errors.WithStack(err))
                    return nil, err
                }
            }
            //redis 快取資料庫認證
            if redisConfig.Db != "" {
                if _, err = c.Do("SELECT", redisConfig.Db); err != nil {
                    c.Close()
                    log.Printf("fail to SELECT DB redis: %+v\n", errors.WithStack(err))
                    return nil, err
                }
            }
            return c, err
        },
        //測試連線是否正常
        TestOnBorrow: func(c redis.Conn, t time.Time) error {
            _, err := c.Do("PING")
            if err != nil {
                c.Close()
                log.Printf("fail to ping redis: %+v\n", err)
                return err
            }
            return nil
        },
    }
}

// Get 獲取快取連線
func Get() redis.Conn {
    return pool.Get()
}

4.介面連線 (http.go)

檔案地址

project 
    |- inits
        |- http.go
``

package inits

import (
    "github.com/gin-gonic/gin"
    "github.com/pkg/errors"
    "net/http"
    "time"
)

var (
    ginConfig *GinConfig
)

type GinConfig struct {
    Port         string `toml:"port"`
    ReadTimeout  int    `toml:"read_timeout"`
    WriteTimeout int    `toml:"write_timeout"`
}

func InitHttp() {
    InitGinConfig()
    InitGin()
}

func InitGinConfig() {
    c := GetConfig()
    ginConfig = &GinConfig{
        Port:         c.GetString("http.port"),
        ReadTimeout:  c.GetInt("http.read_timeout"),
        WriteTimeout: c.GetInt("http.write_timeout"),
    }
}

func InitGin() {
    router := gin.New()

    router.Use(gin.Logger(), gin.Recovery())

    router.GET("/version/", func(c *gin.Context) {
        c.JSON(200, gin.H{"version": "v1.0.0"})
    })

    s := &http.Server{
        Addr:         ginConfig.Port,
        Handler:      router,
        ReadTimeout:  time.Duration(ginConfig.ReadTimeout) * time.Second,
        WriteTimeout: time.Duration(ginConfig.WriteTimeout) * time.Second,
    }

    if err := s.ListenAndServe(); err != nil {
        if err == http.ErrServerClosed {
            log.Println("http: Server Close:%+v", errors.WithStack(err))
        }
        log.Fatalf("http開啟監聽服務失敗:%+v", errors.WithStack(err))
    }

}

5. 訊息佇列連線 (rocketmq.go)

檔案地址

project 
    |- inits
        |- rocketmq.go

6.簡單編寫 main.go

檔案地址

project 
    |- main.go

package main

import (
    "fmt"
    "github.com/catbugdemo/project_order/inits"
)

func main() {

    go inits.InitHttp()

    select {}
}

8.單元測試每個方法是否正確

9.開啟專案

執行 main.go
測試 version 埠 localhost:8080/version

結語

推薦第一次自己嘗試跟著寫，第二次自己寫一個新的作為自己的 project_order,第三次直接使用
感謝閱讀

本作品採用《CC 協議》，轉載必須註明作者和本文連結

從零開始構建一個webpack專案
2019-10-24
Web
嘗試從零開始構建我的商城 (一) :使用Abp vNext快速一個簡單的商城專案
2020-10-22
構建一個簡單的react-typescript專案
2017-10-20
ReactTypeScript
vue-cli快速構建專案簡單介紹
2017-04-16
Vue
[轉]：如何快速構建一個簡單的程式
2019-02-16
從零開始構建自己的第一個vue專案
2021-01-03
Vue
從零開始構建一個vue專案 --- webpack歷險記
2019-04-01
VueWeb
開始一個專案
2020-10-30
webpack快速構建專案
2021-09-09
Web
【從零開始寫一個簡單的ImageLoader框架】專案介紹
2016-08-12
框架
快速開始api開發（一）專案初始化
2022-08-19
API
用Java構建一個簡單的WebSocket聊天專案之新增HTTP介面排程
2019-01-04
JavaWebHTTP
JNPF快速開發平臺-簡單快速高效開發java專案
2020-10-10
Java
快速開啟你的第一個專案：TensorFlow專案架構模板
2018-02-06
架構
使用Beego構建一個web專案
2017-12-14
GoWeb
使用Dockerfile構建一個django專案
2024-03-14
DockerDjango
快速構建一個shell型別的簡單應用 quick-shell.js
2019-02-21
型別UIJS
從零開始React專案架構(一)
2018-06-06
React架構
【教程】如何從零開始構建深度學習專案？
2018-04-23
深度學習
webpack4.X 實戰（二）：從0開始搭建一個簡單的前端專案
2019-02-26
Web前端
一個簡單的構建React元件動畫方案
2019-04-11
React元件動畫
使用Vite快速構建前端React專案
2023-02-28
Vite前端React
使用webpack構建一個專案 (更新ing)
2019-03-28
Web
基於Grunt構建一個的專案
2017-02-12
更優雅快速的為你的專案構建一個PHP版本SDK
2021-05-04
PHP
使用React構建簡單專案步驟(Mac 環境)
2019-10-17
ReactMac
xmake入門，構建專案原來可以如此簡單
2019-03-01
從零開始搭建一個vue專案
2018-03-08
Vue
利用 Docker 構建一個簡單的 java 開發編譯環境
2021-01-01
DockerJava編譯
程式碼來構建一個簡單的compiler
2018-08-08
Compile
從零構建一個簡單的 Python 框架
2016-09-13
Python框架
Gradle快速構建Spring Boot專案
2018-06-14
GradleSpring Boot
使用vue構建一個自動建站專案
2019-03-04
Vue
如何快速搭建一個 “簡單模式” 的微服務架構
2018-08-23
模式微服務架構
一、快速構建Spring Boot專案【springboot記錄】
2019-03-19
Spring Boot
JavaWeb——從零開始構建一個客戶管理系統（一）
2020-10-25
JavaWeb
[Angularjs] 第一步開始一個專案
2014-03-23
AngularJS
用Java構建一個簡單的WebSocket聊天室
2018-12-28
JavaWeb

快速開始構建一個簡單專案

前言

1.建立一個專案，同時執行 Hello world

2.準備資料夾

3.準備好需要的第三方包

3.準備好專案配置檔案，推薦使用 .toml (或者 .yaml檔案)

4.配置 log 日誌 (logrus)

5.配置需要初始化的讀取專案配置(viper)資料庫(gorm)連線,快取連線(redigo),http初始化(gin),訊息佇列連線(rocketmq)

1.讀取配置檔案 (config.go)

2.初始化資料庫 (db.go)

3.初始化快取 (redis.go)

4.介面連線 (http.go)

5. 訊息佇列連線 (rocketmq.go)

6.簡單編寫 main.go

8.單元測試每個方法是否正確

9.開啟專案

結語

相關文章