使用gin+bootstrap开发一个简单的博客系统(开源),超详细讲解
运行服务路由实例监听端口运行服务router 路由====================================================================在 java spring 框架中,路由是通过注解的形式放在控制器上方的,java 中的注解比较强大,运行了 application 时候相当于 go 中注册了路由,并将路由绑定到了控制器,并进行了监听,要知道 g
-
运行服务
路由实例监听端口运行服务
====================================================================
在 java spring 框架中,路由是通过注解的形式放在控制器上方的,java 中的注解比较强大,运行了 application 时候相当于 go 中注册了路由,并将路由绑定到了控制器,并进行了监听,要知道 go 中路由的写明和绑定控制器需要程序员自己去写明
我的博客系统中所有的路由都是放在一个 go 的路由文件中,并且 package 是 router,其中主要做的 5 项操作
创建路由实例
要知道 gin 框架底层使用的就是 httprouter,所以通过 gin 框架的 gin 包可以产生一个默认的路由实例
r := gin.Default()
静态资源加载
使用 Static 函数来加载前端的静态资源
前端模版加载
使用 LoadHTMLGlob 函数来家在前端 html 模版,之所以没有使用view/*
的形式,是因为 view 包下面的 html 模版依据博客系统的模块进行了分类
r.LoadHTMLGlob("view/**/*")
中间件的使用
在路由注册之前需要声明使用的中间件,这样在执行某个路由之前,就会先执行一下中间件的操作。这里使用的中间件是 session 的中间件,写法如下:
// UseSession session 中间件
func UseSession() gin.HandlerFunc {
store := cookie.NewStore([]byte("loginUser"))
return sessions.Sessions("loginUser", store)
}
中间件都需要返回gin.HandlerFunc
,然后在 router 中通过如下方式完成中间件的声明
r.Use(middleware.UseSession())
值得注意的是通过 GET 或者 POST 注册路由的函数中第二个参数的类型也是gin.HandlerFunc
,注册路由时候第二个参数一般填写的是 controller 的函数名。中间件声明之后在 controller 中即可通过如下方式来保存用户 session 了
// c *gin.Context,s Session
s := sessions.Default(c)
// 保存用户 session
s.Set("loginUser", username)
路由注册
接下来我们来做 GET/POST 路由注册,依据 restful 规范,我们划分了一下模块,主要注册了以下几大类的路由
-
首页路由
-
注册页路由
-
登录页路由
-
文章相关页面路由
-
关于我页面路由
注册路由中传递的参数是路由名称和路由需要绑定的 controller 函数名,值得注意的是 controller 函数名是属于gin.HandlerFunc
类型。最后 InitRouter 函数返回*gin.Context
类型路由,供 main 函数调用
==================================================================
model 层主要存放了文章 model 和用户 model,包括其中的 struct 结构和操作各自 model 的基本数据库操作,比如说查询用户,依据 id 查询用户,查询文章总数,依据作者查询文章总数,分页查询文章总数…
User
// User 用户
type User struct {
Id int `json:"id" form:"id"`
Username string `json:"username" form:"username"`
Password string `json:"password" form:"password"`
Status int `json:"status" form:"status"`
CreateTime int64 `json:"createTime" form:"createTime"`
}
// 操作数据库
Article
// Article 文章
type Article struct {
Id int
Title string
Tags string
Short string
Content string
Author string
CreateTime int64
LastUpdateTime int64
}
// 操作数据库
====================================================================
service 层算是 controller 和 model 的一个中间层,如果 model 是用来封装对象,处理对象最基本数据库操作的话,service 则是基于业务对 model 数据库再做了一层封装,并且被 controller 层调用。此项目中对 controller 需要封装的一些操作数据的业务属性操作进行了进一步封装并写在 service 层
项目中 service 没有和 controller 一一对应存在,应为有的 controller 中实际没有做 service 的封装,所以没有对应的 service。项目中 service 包中的 go 文件统一用 service 作为后缀
=======================================================================
controller 层分为了好几个文件
-
article 文章
-
home 主页面
-
login 登录页
-
personal 关于我
-
register 注册页
-
session 处理登录态
GET
controller 中主要写的是访问路由绑定的各个 Controller 函数,其中有 GET 和 POST 类型的 controller 函数。其中对于 GET 类型函数多以 HTML 函数来渲染,如下
// HomeGet 首页
func HomeGet(c *gin.Context) {
// ...
// 返回 html
resp := gin.H{
"isLogin": isLogin,
"username": GetSession(c, "loginUser"),
"artNum": artNum,
}
c.HTML(http.StatusOK, "home.html", resp)
}
POST
对于 POST 类型函数多以 json 形式来进行响应
// LoginPost 登录请求
func LoginPost(c *gin.Context) {
// ...
// json 响应
resp = gin.H{
"code": 0,
"message": "登录成功,欢迎进入!",
}
c.JSON(http.StatusOK, resp)
}
=========================================================================
view 中模版界定符
因为前端 html 页面较多,所以在 view 包下进行了以下文件夹分类(依据页面模块分类),view 中存放的都是 html 页面,html 中使用了 go 的模版界定符,类似 JSP,同时也适用了 bootstrap v3框架等。虽然项目中使用了比较过时的 bootstrap 和 jquery 前端框架组建,但是对于 vue/react 大肆流行的今天,这些接近废弃的前端知识还是可以了解学习的(学习成本不会太高)
使用了模版界定符号,如下:
<!-- 导航条 -->
{{template "nav.html" .}}
<!-- 文章列表 -->
{{.listContent}}
view 中 bootstrap v3
也使用了 bootstrap v3 框架,项目中使用的是在线版本的,当然觉得感兴趣也可以使用高版本版本 bootstrap 框架,并且可以下载下来放在 static 中调用使用。下方为在线引用 bootstrap v3
<!-- 最新版本的 Bootstrap 核心 CSS 文件 -->
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/3.4.1/css/bootstrap.min.css"
integrity="sha384-HSMxcRTRxnN+Bdg0JdbxYKrThecOKuH5zCYotlSAcp1+c8xmyTe9GYg1l9a69psu" crossorigin="anonymous">
<!-- 可选的 Bootstrap 主题文件(一般不用引入) -->
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/3.4.1/css/bootstrap-theme.min.css"
integrity="sha384-6pzBo3FDv/PJ8r2KRkGHifhEocL+1X2rVCTTkUfGk7/0pbek5mMa1upzvWbrUbOZ" crossorigin="anonymous">
<!-- 最新的 Bootstrap 核心 JavaScript 文件 -->
<script src="https://stackpath.bootstrapcdn.com/bootstrap/3.4.1/js/bootstrap.min.js"
integrity="sha384-aJ21OjlMXNL5UyIl/XNwTMqvzeRMZH2w8c5cRVpzpU8Y5bApTppSuUkhZXN0VxHd"
crossorigin="anonymous"></script>
view 中 jquery 及插件
项目也是用了 jquery 及其插件,比如使用了 jquery 的校验插件
<!-- jq 在线压缩版 -->
<script src="https://code.jquery.com/jquery-3.1.1.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/jquery-validation@1.19.3/dist/jquery.validate.min.js"></script>
static 中 css
项目中的 css 作为统一 css,主要写的是校验的 css 样式,刚兴趣的同学可以把更多 html 通用的 css 样式放在其中
static 中 img
这里保存有项目中要使用的图片资源
static 中 js
其中主要写的是各个 html 页面的 js 操作,其实主要还是表单提交操作
=======================================================================
数据库着一层在 main 中被调用来初始化数据库,其中主要存在三类函数
数据库信息
数据库服务在本地,端口号用默认
-
数据库版本:mysql 5.7
-
用户名:root
-
密码:123456
-
地址是:localhost
-
端口号:3306(默认)
-
数据库名:gindemo
-
创建后存在数据表:user 和 article 表
Init 初始化数据库主函数
这里主要操作是数据库的连接和调用创建表的函数,这些创建表的函数,如果发现表已经存在,则不会创建表。连接数据库语句如下,下面有一些数据是封装在 config 中的,方便后续配置
// InitMysql 初始化 mysql 数据库
func InitMysql() {
if DB == nil {
DB, _ = sql.Open("mysql", config.DB_USER+":"+config.DB_PWD+"@tcp("+config.DB_ADD+":"+config.DB_PORT+")/"+config.DB_NAME)
}
}
建表函数
建表函数被 Init 初始化数据库总函数所调用,主要是创建 user 表的函数和创建 article 表的函数
对最基本数据库操作的封装
因为 golang 中 sql 包 select 语句可以直接查询,但是 insert/update/create/delete 语句则需要 Exec 函数去执行,所以对基本的 Exec 执行函数进行了封装,也对基本的查询语句做了最简单的封装,方便各个 model 来调用
===================================================================
因为注册需要填写用户和密码,但是直接把密码明文存入数据库有安全风险,所以打算把拿到的用户密码进行 md5 加密之后(go sdk 提供 md5 包)再存入数据库中,所以 util 在项目中存在一个加密函数,当然有朋友感兴趣也可以在 util 工具包中封装更多有意思的函数
// MD5 md5 算法加密
func MD5(str string) string {
return fmt.Sprintf("%x", md5.Sum([]byte(str)))
}
======================================================================
最后总结
ActiveMQ+Kafka+RabbitMQ学习笔记PDF
关于分布式,限流+缓存+缓存,这三大技术(包含:ZooKeeper+Nginx+MongoDB+memcached+Redis+ActiveMQ+Kafka+RabbitMQ)等等。这些相关的面试也好,还有手写以及学习的笔记PDF,都是啃透分布式技术必不可少的宝藏。以上的每一个专题每一个小分类都有相关的介绍,并且小编也已经将其整理成PDF啦
======================================================================
最后总结
ActiveMQ+Kafka+RabbitMQ学习笔记PDF
[外链图片转存中…(img-dYNkUSgt-1631106712322)]
[外链图片转存中…(img-5BBVMDmz-1631106712324)]
[外链图片转存中…(img-QZ6Wxr7A-1631106712325)]
[外链图片转存中…(img-UcceBowG-1631106712327)]
关于分布式,限流+缓存+缓存,这三大技术(包含:ZooKeeper+Nginx+MongoDB+memcached+Redis+ActiveMQ+Kafka+RabbitMQ)等等。这些相关的面试也好,还有手写以及学习的笔记PDF,都是啃透分布式技术必不可少的宝藏。以上的每一个专题每一个小分类都有相关的介绍,并且小编也已经将其整理成PDF啦

DAMO开发者矩阵,由阿里巴巴达摩院和中国互联网协会联合发起,致力于探讨最前沿的技术趋势与应用成果,搭建高质量的交流与分享平台,推动技术创新与产业应用链接,围绕“人工智能与新型计算”构建开放共享的开发者生态。
更多推荐
所有评论(0)