Go語言中文網，致力于每日分享編碼、開源等知識，歡迎關注我，會有意想不到的收獲！

項目地址：https://github.com/EDDYCJY/go-gin-example

如果對你有所幫助，歡迎點個 Star

前言

一天，產品經理突然跟你說文章列表，沒有封面圖，不夠美觀，！)&￥*！&)#&￥*！加一個吧，幾分鐘的事

你打開你的程序，分析了一波寫了個清單：

• 優化配置結構(因為配置項越來越多)
• 抽離 原 logging 的 File 便于公用(logging、upload 各保有一份并不合適)
• 實現上傳圖片接口(需限制文件格式、大小)
• 修改文章接口(需支持封面地址參數)
• 增加 blog_article (文章)的數據庫字段
• 實現 http.FileServer

嗯，你發現要較優的話，需要調整部分的應用程序結構，因為功能越來越多，原本的設計也要跟上節奏

也就是在適當的時候，及時優化

優化配置結構

一、講解

在先前章節中，采用了直接讀取 KEY 的方式去存儲配置項，而本次需求中，需要增加圖片的配置項，總體就有些冗余了

我們采用以下解決方法：

• 映射結構體：使用 MapTo 來設置配置參數
• 配置統管：所有的配置項統管到 setting 中

映射結構體(示例)

在 go-ini 中可以采用 MapTo 的方式來映射結構體，例如：

在這段代碼中，可以注意 ServerSetting 取了地址，為什么 MapTo 必須地址入參呢？

在 MapTo 中 typ.Kind() == reflect.Ptr 約束了必須使用指針，否則會返回 cannot map to non-pointer struct 的錯誤。這個是表面原因

更往內探究，可以認為是 field.Set 的原因，當執行 val := reflect.ValueOf(v) ，函數通過傳遞 v 拷貝創建了 val，但是 val 的改變并不能更改原始的 v，要想 val 的更改能作用到 v，則必須傳遞 v 的地址

顯然 go-ini 里也是包含修改原始值這一項功能的，你覺得是什么原因呢？

配置統管

在先前的版本中，models 和 file 的配置是在自己的文件中解析的，而其他在 setting.go 中，因此我們需要將其在 setting 中統一接管

你可能會想，直接把兩者的配置項復制粘貼到 setting.go 的 init 中，一下子就完事了，搞那么麻煩？

但你在想想，先前的代碼中存在多個 init 函數，執行順序存在問題，無法達到我們的要求，你可以試試

(此處是一個基礎知識點)

在 Go 中，當存在多個 init 函數時，執行順序為：

• 相同包下的 init 函數：按照源文件編譯順序決定執行順序(默認按文件名排序)
• 不同包下的 init 函數：按照包導入的依賴關系決定先后順序

所以要避免多 init 的情況，盡量由程序把控初始化的先后順序

二、落實

修改配置文件

打開 conf/app.ini 將配置文件修改為大駝峰命名，另外我們增加了 5 個配置項用于上傳圖片的功能，4 個文件日志方面的配置項

[app]PageSize = 10JwtSecret = 233RuntimeRootPath = runtime/ImagePrefixUrl = http://127.0.0.1:8000ImageSavePath = upload/images/# MBImageMaxSize = 5ImageAllowExts = .jpg,.jpeg,.pngLogSavePath = logs/LogSaveName = logLogFileExt = logTimeFormat = 20060102[server]#debug or releaseRunMode = debugHttpPort = 8000ReadTimeout = 60WriteTimeout = 60[database]Type = mysqlUser = rootPassword = rootrootHost = 127.0.0.1:3306Name = blogTablePrefix = blog_

優化配置讀取及設置初始化順序

第一步

將散落在其他文件里的配置都刪掉，統一在 setting 中處理以及修改 init 函數為 Setup 方法

打開 pkg/setting/setting.go 文件，修改如下：

在這里，我們做了如下幾件事：

• 編寫與配置項保持一致的結構體(App、Server、Database)
• 使用 MapTo 將配置項映射到結構體上
• 對一些需特殊設置的配置項進行再賦值

需要你去做的事：

• 將 models.go、setting.go、pkg/logging/log.go 的 init 函數修改為 Setup 方法
• 將 models/models.go 獨立讀取的 DB 配置項刪除，改為統一讀取 setting
• 將 pkg/logging/file 獨立的 LOG 配置項刪除，改為統一讀取 setting

這幾項比較基礎，并沒有貼出來，我希望你可以自己動手，有問題的話可右拐 項目地址 https://github.com/EDDYCJY/go-gin-example

第二步

在這一步我們要設置初始化的流程，打開 main.go 文件，修改內容：

修改完畢后，就成功將多模塊的初始化函數放到啟動流程中了(先后順序也可以控制)

驗證

在這里為止，針對本需求的配置優化就完畢了，你需要執行 go run main.go 驗證一下你的功能是否正常哦

順帶留個基礎問題，大家可以思考下

ServerSetting.ReadTimeout = ServerSetting.ReadTimeout * time.SecondServerSetting.WriteTimeout = ServerSetting.ReadTimeout * time.Second

若將 setting.go 文件中的這兩行刪除，會出現什么問題，為什么呢？

抽離 File

在先前版本中，在 logging/file.go 中使用到了 os 的一些方法，我們通過前期規劃發現，這部分在上傳圖片功能中可以復用

第一步

在 pkg 目錄下新建 file/file.go ，寫入文件內容如下：

在這里我們一共封裝了 7個 方法

• GetSize：獲取文件大小
• GetExt：獲取文件后綴
• CheckExist：檢查文件是否存在
• CheckPermission：檢查文件權限
• IsNotExistMkDir：如果不存在則新建文件夾
• MkDir：新建文件夾
• Open：打開文件

在這里我們用到了 mime/multipart 包，它主要實現了 MIME 的 multipart 解析，主要適用于 HTTP 和常見瀏覽器生成的 multipart 主體

multipart 又是什么，rfc2388 的 multipart/form-data 了解一下 https://tools.ietf.org/html/rfc2388

第二步

我們在第一步已經將 file 重新封裝了一層，在這一步我們將原先 logging 包的方法都修改掉

1、打開 pkg/logging/file.go 文件，修改文件內容：

我們將引用都改為了 file/file.go 包里的方法

2、打開 pkg/logging/log.go 文件，修改文件內容:

由于原方法形參改變了，因此 openLogFile 也需要調整

實現上傳圖片接口

這一小節，我們開始實現上次圖片相關的一些方法和功能

首先需要在 blog_article 中增加字段 cover_image_url，格式為 varchar(255) DEFAULT '' COMMENT '封面圖片地址'

第零步

一般不會直接將上傳的圖片名暴露出來，因此我們對圖片名進行 MD5 來達到這個效果

在 util 目錄下新建 md5.go，寫入文件內容：

第一步

在先前我們已經把底層方法給封裝好了，實質這一步為封裝 image 的處理邏輯

在 pkg 目錄下新建 upload/image.go 文件，寫入文件內容：

在這里我們實現了 7 個方法，如下：

• GetImageFullUrl：獲取圖片完整訪問URL
• GetImageName：獲取圖片名稱
• GetImagePath：獲取圖片路徑
• GetImageFullPath：獲取圖片完整路徑
• CheckImageExt：檢查圖片后綴
• CheckImageSize：檢查圖片大小
• CheckImage：檢查圖片

這里基本是對底層代碼的二次封裝，為了更靈活的處理一些圖片特有的邏輯，并且方便修改，不直接對外暴露下層

第二步

這一步將編寫上傳圖片的業務邏輯，在 routers/api 目錄下 新建 upload.go 文件，寫入文件內容:

所涉及的錯誤碼(需在 pkg/e/code.go、msg.go 添加)：

// 保存圖片失敗ERROR_UPLOAD_SAVE_IMAGE_FAIL = 30001// 檢查圖片失敗ERROR_UPLOAD_CHECK_IMAGE_FAIL = 30002// 校驗圖片錯誤，圖片格式或大小有問題ERROR_UPLOAD_CHECK_IMAGE_FORMAT = 30003

在這一大段的業務邏輯中，我們做了如下事情：

• c.Request.FormFile：獲取上傳的圖片(返回提供的表單鍵的第一個文件)
• CheckImageExt、CheckImageSize檢查圖片大小，檢查圖片后綴
• CheckImage：檢查上傳圖片所需(權限、文件夾)
• SaveUploadedFile：保存圖片

總的來說，就是 入參 -> 檢查 -》 保存 的應用流程

第三步

打開 routers/router.go 文件，增加路由 r.POST("/upload

總結

以上是生活随笔為你收集整理的gin 怎么通过 post 发送结构体_Go Web 框架 Gin 实践12—优化配置结构及实现图片上传...的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。