Go语言进阶之Go语言高性能Web框架Iris项目实战-项目结构优化EP05
liuian 2025-05-09 20:03 36 浏览
前文再续，上一回我们完成了用户管理模块的CURD(增删改查)功能，功能层面，无甚大观，但有一个结构性的缺陷显而易见，那就是项目结构过度耦合，项目的耦合性(Coupling)，也叫耦合度，进而言之，模块之间的关系，是对项目结构中各模块间相互联系紧密程度的一种量化。耦合的强弱取决于模块间调用的复杂性、调用模块之间的方式以及通过函数或者方法传送数据对象的多少。模块间的耦合度是指模块之间的依赖关系，包括包含关系、控制关系、调用关系、数据传递关系以及依赖关系。项目模块的相互依赖越多，其耦合性越强，同时表明其独立性越差，愈加难以维护。
项目结构优化
目前IrisBlog项目的问题就是独立性太差，截至目前为止，项目结构如下：
.
├── README.md
├── assets
│ ├── css
│ │ └── style.css
│ └── js
│ ├── axios.js
│ └── vue.js
├── favicon.ico
├── go.mod
├── go.sum
├── main.go
├── model
│ └── model.go
├── mytool
│ └── mytool.go
├── tmp
│ └── runner-build
└── views
├── admin
│ └── user.html
├── index.html
└── test.html一望而知，前端页面(views)以及静态文件(assets)的工程化尚可，不再需要进行分层操作，但是在后端，虽然模型层(model.go)和工具层(mytool.go)已经分离出主模块，但主要业务代码还是集中在入口文件main.go中：
package main
import (
"IrisBlog/model"
"IrisBlog/mytool"
"fmt"
"github.com/jinzhu/gorm"
_ "github.com/jinzhu/gorm/dialects/mysql"
"github.com/kataras/iris/v12"
)
func main() {
db, err := gorm.Open("mysql", "root:root@(localhost)/irisblog?charset=utf8mb4&parseTime=True&loc=Local")
if err != nil {
fmt.Println(err)
panic("无法连接数据库")
}
fmt.Println("连接数据库成功")
//单数模式
db.SingularTable(true)
// 创建默认表
db.AutoMigrate(&model.User{})
// 逻辑结束后关闭数据库
defer func() {
_ = db.Close()
}()
app := newApp(db)
app.HandleDir("/assets", iris.Dir("./assets"))
app.Favicon("./favicon.ico")
app.Listen(":5000")
}
func newApp(db *gorm.DB) *iris.Application {
app := iris.New()
tmpl := iris.HTML("./views", ".html")
// Set custom delimeters.
tmpl.Delims("${", "}")
// Enable re-build on local template files changes.
tmpl.Reload(true)
app.RegisterView(tmpl)
app.Delete("/admin/user_action/", func(ctx iris.Context) {
ID := ctx.URLParamIntDefault("id", 0)
db.Delete(&model.User{}, ID)
ret := map[string]string{
"errcode": "0",
"msg": "删除用户成功",
}
ctx.JSON(ret)
})
app.Put("/admin/user_action/", func(ctx iris.Context) {
ID := ctx.PostValue("id")
Password := ctx.PostValue("password")
user := &model.User{}
db.First(&user, ID)
user.Password = mytool.Make_password(Password)
db.Save(&user)
ret := map[string]string{
"errcode": "0",
"msg": "更新密码成功",
}
ctx.JSON(ret)
})
app.Post("/admin/user_action/", func(ctx iris.Context) {
username := ctx.PostValue("username")
password := ctx.PostValue("password")
fmt.Println(username, password)
md5str := mytool.Make_password(password)
user := &model.User{Username: username, Password: md5str}
res := db.Create(user)
if res.Error != nil {
fmt.Println(res.Error)
ret := map[string]string{
"errcode": "1",
"msg": "用户名不能重复",
}
ctx.JSON(ret)
return
}
ret := map[string]string{
"errcode": "0",
"msg": "ok",
}
ctx.JSON(ret)
})
return app
}入口文件main.go承载了太多业务，既需要负责数据库结构体的创建，又得操心模板的渲染和接口逻辑的编写，说白了：泥沙俱下，沉渣泛起。
事实上，像这样把所有代码都堆到一个文件中，还会带来协作问题，比如，当你花了一整天的时间，好不容易完成了一段业务逻辑，也通过了本地测试，准备第二天提交线上测试，但是第二天上班时却发现这个逻辑莫名其妙地开始报错了，这通常是因为有同事在你走后修改了你编写或者依赖的那个模块，归根结底，并不完全是协作的问题，项目结构也是因素之一。
多个研发同时修改了同一个源代码文件。虽然在规模相对较小、人员较少的项目中，这种问题或许并不严重，但是随着项目的增长，研发人员的增加，这种每天早上刚上班时都要经历一遍的痛苦就会越来越多，甚至会严重到让有的团队在长达数周的时间内都不能发布一个稳定的项目版本，因为每个人都在不停地修改自己的代码，以适应其他人所提交的变更，周而复始，恶性循环。
所以我们必须把业务单独抽离出来，比如用户管理其实是后台模块功能，只有特定的管理员才可能在其页面进行操作，所以我们可以单独创建一个控制层：
mkdir handler
cd hanler随后编写后台控制逻辑admin.go:
package handler
import (
"github.com/kataras/iris/v12"
)
//用户管理页面模板
func Admin_user_page(ctx iris.Context) {
ctx.View("/admin/user.html")
}这里把用户管理页面的解析函数单独抽离在handler包中，注意函数的首字母要进行大写处理，因为首字母小写函数是私有函数，只能在包内使用，无法被别的包调用。
随后改造入口文件main.go逻辑:
app.Get("/admin/user/", handler.Admin_user_page)路由匹配时，只需要引入handler包中的Admin_user_page函数就可以了。
随后，对路由进行分组优化，同属一个业务的模块绑定在同一个分组中：
adminhandler := app.Party("/admin")
{
adminhandler.Use(iris.Compression)
adminhandler.Get("/user/", handler.Admin_user_page)
adminhandler.Get("/userlist/", handler.Admin_userlist)
adminhandler.Delete("/user_action/", handler.Admin_userdel)
adminhandler.Put("/user_action/", handler.Admin_userupdate)
adminhandler.Post("/user_action/", handler.Admin_useradd)
}如此，业务和路由解析就彻底分开了，结构体创建函数也清爽了不少：
func newApp(db *gorm.DB) *iris.Application {
app := iris.New()
tmpl := iris.HTML("./views", ".html")
tmpl.Delims("${", "}")
tmpl.Reload(true)
app.RegisterView(tmpl)
adminhandler := app.Party("/admin")
{
adminhandler.Use(iris.Compression)
adminhandler.Get("/user/", handler.Admin_user_page)
adminhandler.Get("/userlist/", handler.Admin_userlist)
adminhandler.Delete("/user_action/", handler.Admin_userdel)
adminhandler.Put("/user_action/", handler.Admin_userupdate)
adminhandler.Post("/user_action/", handler.Admin_useradd)
}
return app
}数据层结构优化
业务层进行了拆分，但是数据层还集成在入口文件中main.go:
package main
import (
"IrisBlog/handler"
"IrisBlog/model"
"fmt"
"github.com/jinzhu/gorm"
_ "github.com/jinzhu/gorm/dialects/mysql"
"github.com/kataras/iris/v12"
)
func main() {
db, err := gorm.Open("mysql", "root:root@(localhost)/irisblog?charset=utf8mb4&parseTime=True&loc=Local")
if err != nil {
fmt.Println(err)
panic("无法连接数据库")
}
fmt.Println("连接数据库成功")
//单数模式
db.SingularTable(true)
// 创建默认表
db.AutoMigrate(&model.User{})
// 逻辑结束后关闭数据库
defer func() {
_ = db.Close()
}()
app := newApp(db)
app.HandleDir("/assets", iris.Dir("./assets"))
app.Favicon("./favicon.ico")
app.Listen(":5000")
}这里的含义是，一旦进入入口逻辑，就立刻初始化数据库，随后执行业务代码，当业务执行完毕后，利用延迟函数defer关闭数据库链接。
这种逻辑的弊端是，一旦数据库服务挂掉，整个项目服务也会受影响，再者，很多纯静态化页面并不需要数据库链接，每一次都链接数据库，显然是画蛇添足。
所以单独建立数据包：
mkdir database
cd database建立数据层逻辑database.go:
package database
import (
"IrisBlog/model"
"fmt"
"github.com/jinzhu/gorm"
_ "github.com/jinzhu/gorm/dialects/mysql"
)
func Db() *gorm.DB {
db, err := gorm.Open("mysql", "root:root@(localhost)/irisblog?charset=utf8mb4&parseTime=True&loc=Local")
if err != nil {
fmt.Println(err)
panic("无法连接数据库")
}
fmt.Println("连接数据库成功")
//单数模式
db.SingularTable(true)
// 创建默认表
db.AutoMigrate(&model.User{})
return db
}这里我们构建函数Db()，它返回一个数据库操作的结构体指针，专门用来执行数据库操作，需要注意的是，删除函数内之前的延后defer关闭链接函数，否则链接在函数体内就关闭了，调用方就无法使用数据库了。
调用上，直接调用database包中的Db()，就可以直接使用数据库指针了：
//用户列表接口
func Admin_userlist(ctx iris.Context) {
db := database.Db()
var users []model.User
res := db.Find(&users)
// 逻辑结束后关闭数据库
defer func() {
_ = db.Close()
}()
ctx.JSON(res)
}随后，继续优化入口文件：
package main
import (
"IrisBlog/handler"
"github.com/kataras/iris/v12"
)
func main() {
app := newApp()
app.HandleDir("/assets", iris.Dir("./assets"))
app.Favicon("./favicon.ico")
app.Listen(":5000")
}
func newApp() *iris.Application {
app := iris.New()
tmpl := iris.HTML("./views", ".html")
tmpl.Delims("${", "}")
tmpl.Reload(true)
app.RegisterView(tmpl)
adminhandler := app.Party("/admin")
{
adminhandler.Use(iris.Compression)
adminhandler.Get("/user/", handler.Admin_user_page)
adminhandler.Get("/userlist/", handler.Admin_userlist)
adminhandler.Delete("/user_action/", handler.Admin_userdel)
adminhandler.Put("/user_action/", handler.Admin_userupdate)
adminhandler.Post("/user_action/", handler.Admin_useradd)
}
}这里优化了main函数，使其逻辑更加简明和清晰。
最后，优化数据层逻辑database.go:
package database
import (
"IrisBlog/model"
"fmt"
"github.com/jinzhu/gorm"
_ "github.com/jinzhu/gorm/dialects/mysql"
_ "github.com/jinzhu/gorm/dialects/sqlite"
)
const db_type int = 1
func sqlite3() *gorm.DB {
db, err := gorm.Open("sqlite3", "/tmp/IrisBlog.db")
if err != nil {
fmt.Println(err)
panic("无法连接数据库")
}
fmt.Println("连接sqlite3数据库成功")
return db
}
func mysql() *gorm.DB {
db, err := gorm.Open("mysql", "root:root@(localhost)/irisblog?charset=utf8mb4&parseTime=True&loc=Local")
if err != nil {
fmt.Println(err)
panic("无法连接数据库")
}
fmt.Println("连接mysql数据库成功")
return db
}
func Db() *gorm.DB {
switch db_type {
case 0:
db := mysql()
//单数模式
db.SingularTable(true)
// 创建默认表
db.AutoMigrate(&model.User{})
return db
case 1:
db := sqlite3()
//单数模式
db.SingularTable(true)
// 创建默认表
db.AutoMigrate(&model.User{})
return db
default:
panic("未知的数据库")
}
}这里我们分别封装mysql和sqlite3数据库指针函数，然后通过switch语句来根据不同的开发环境而进行切换和控制。
至此，项目结构的首次结构性优化就完成了，优化后的结构如下：
├── README.md
├── assets
│ ├── css
│ │ └── style.css
│ └── js
│ ├── axios.js
│ └── vue.js
├── database
│ └── database.go
├── favicon.ico
├── go.mod
├── go.sum
├── handler
│ └── admin.go
├── main.go
├── model
│ └── model.go
├── mytool
│ └── mytool.go
├── tmp
│ └── runner-build
└── views
├── admin
│ └── user.html
├── index.html
└── test.html结语
为什么我们一开始不直接采用低耦合高内聚的项目架构？因为别人的经验并不是我们的经验，只有真正经历过才是真实的开发经验，项目开发没有标准答案，只有选择，然后承担后果，只有尝试过苦涩的果实之后，下一次才会做出正确的选择。该项目已开源在Github：
https://github.com/zcxey2911/IrisBlog ，与君共觞，和君共勉。
相关推荐
- 服务器重装系统（服务器重装系统按什么键）
-
进入服务器之后选择清除系统重新安装即可如果确实忘记了服务器电脑密码，可以尝试使用重装系统的方式来解决问题。首先需要准备一个可启动的系统安装盘或U盘，然后在服务器开机时进入BIOS设置，将启动设备设为安...
- win11下载一半可以取消吗（win11下载两次）
-
1.首先回到桌面，右键单击鼠标开始win徽标，右击菜单点击运行，或者直接WIN+R组合键。 2.跳出运行对话框，输入services.msc并单击OK按钮。3.转到服务列表，找到Windowsup...
- windows7怎么进入bios（windows7怎么进入管理员界面）
-
1、开机时按F2键或者DEL键，进入BIOS系统；注：机器型号不同，进入BIOS的按键可能有所不同，具体可参看左下角的屏幕提示。2、选择Security选项卡，选择SecureBoot，按回车键——...
- 截图快捷键ctrl加什么电脑截图
-
ctrl+alt+a是qq的截图快捷键；台式电脑还可以使用的截图方式：方法一：按PrtScSysRq键，然后在文档中右击选择粘贴就可以看见截图，将截图另存为即可获得截图；方法二：按win+PrtScS...
-
- ios官方网站（苏州晶体公司ios官方网站）
-
方法/步骤1，点击下方的【safari】图标。2，搜索苹果官网，点击进入3，进入苹果的页面，点击左上角二道横4.查询苹果的相关产品。1.打开苹果官网：http://www.apple.com.cn/并点击页面右上角的技术支持选项。2.选择您...
-
2025-11-10 09:55 liuian
- 手机突然无法识别u盘（手机突然无法识别u盘怎么办呢）
-
1、手机不支持OTG功能，所以将U盘连接到手机后，手机无法识别U盘的内容，因此显示不了；这种情况只能换台支持OTG功能的手机来连接U盘才行。2、手机支持OTG功能，但是使用的OTG线质量有问题导致无...
- windows10更新不了一直重试（window10一直更新失败）
-
可能是以下几个原因导致的：1.可能是硬盘剩余空间太少或者碎片太多，队伍用文件进行清理并清理碎片即可。2.可能是windows10版本不支持软件进行运行。3.没有权限，打开相应的权限后重启即可情况说明你...
-
- 联想笔记本怎么进入安全模式
-
联想笔记本电脑进入安全模式的方法如下：1、第一步，按下【windows+R】，打开【运行】，输入【msconfig】后，点击【确定】。2、第二步，打开【系统配置】窗口后，点击【引导】。3、第三步，勾选【安全引导】后，选择需要的安全模式，通常...
-
2025-11-10 08:05 liuian
- winxp升级包下载（xp 升级）
-
题主你好，XP系统要升级成WIN7很简单，方法如下：1，下载win7系统iso镜像到本地硬盘，右键使用WinRAR等工具解压出来2，将最大的win7.gho文件和Onekeyghost工具放到同一目...
- windows 7电脑配置要求（windows7电脑配置要求）
-
官方推荐最低配置：处理器：1GHz32位或者64位处理器内存：1GB及以上显卡：支持DirectX9128M及以上（开启AERO效果）硬盘空间：32位16G以上（主分区，NTFS格式）...
- ie主页被360锁定不能修改（ie浏览器首页被锁定360导航怎么取消百度知道）
-
法一、点击开始，运行，键入msconfig点击“确定”，在弹出的窗口中切换到“启动”选项卡，禁用可疑程序启动项。法二、1、打开360安全卫士进入“更多”；2、主页防护；3、在打开的对话框中进行设...
- 镜像文件是干嘛的（镜像文件有什么用）
-
所谓镜像文件其实和ZIP压缩包类似，它将特定的一系列文件按照一定的格式制作成单一的文件，以方便用户下载和使用，例如一个测试版的操作系统、游戏等。镜像文件不仅具有ZIP压缩包的“合成”功能，它最重要的特...
- office免安装版（office免安装版什么意思）
-
1先打开安装程序输入安装序列号KEY，进行安装，在弹出来的界面里我们选择自定义安装；2在【文件位置】选项中选择好文件位置，一般大点的软件我们选择C盘以外的位置安装，可以直接点浏览选择，也可以直接将现有...
- 一周热门
- 最近发表
- 标签列表
-
- python判断字典是否为空 (50)
- crontab每周一执行 (48)
- aes和des区别 (43)
- bash脚本和shell脚本的区别 (35)
- canvas库 (33)
- dataframe筛选满足条件的行 (35)
- gitlab日志 (33)
- lua xpcall (36)
- blob转json (33)
- python判断是否在列表中 (34)
- python html转pdf (36)
- 安装指定版本npm (37)
- idea搜索jar包内容 (33)
- css鼠标悬停出现隐藏的文字 (34)
- linux nacos启动命令 (33)
- gitlab 日志 (36)
- adb pull (37)
- python判断元素在不在列表里 (34)
- python 字典删除元素 (34)
- vscode切换git分支 (35)
- python bytes转16进制 (35)
- grep前后几行 (34)
- hashmap转list (35)
- c++ 字符串查找 (35)
- mysql刷新权限 (34)