Golang实现博客(一)

Narcissus 收录于 Golang

2021-09-03 约 5356 字预计阅读 11 分钟

基础准备

1、热加载

air是Go语言的热加载工具，它可以监听文件或目录的变化，自动编译，重启程序。大大提高开发期的工作效率。

安装使用air工具

在项目的根目录下使用命令go get -u github.com/cosmtrek/air进行安装，此时在go.mod文件中会自动生成模块依赖。

注意：在Go Modules第三方依赖管理模式下，使用go get -u 地址来下载安装第三方依赖。

使用air init会在根目录下生成一份配置文件，可以配置项目根目录，临时文件目录，编译和执行的命令等。
使用air命令就可以运行程序，后续会自动编译，启动程序，并监听当前目录中的文件修改。

2、Web 一些散知识点

http.HandleFunc("/", handler)里传参的/意味着任意路径。
可以通过WriterHeader()来设置响应的状态码。常见的有(StatusNotFound 404:页面没找到等)可以通过文档查看。

路由和中间件

1、路由

ServeMux和Handler

Go语言中处理HTTP请求主要跟两个东西有关：ServeMux和Handler。

ServeMux本质上是一个HTTP请求的路由器(或者叫多路复用器，Multiplexor)。他把收到的请求与一组预先定义的URL路径列表做对比，然后在匹配到路径的时候调用关联的处理器（Handler）。

http.ListenAndServe(addr string, handler Handler)中handler通常是nil,此种情况下会使用DefaultServeMux

http.ServeMux的对比其他第三方路由优缺点

优点：

标准库意味着随着Go打包安装，无须另行安装
测试充分；稳定、兼容性强
简单、高效

缺点：

缺少web开发常见的特性
在复杂的项目中使用，需要写更多的代码。

常见的第三方路由有HttpRouter、gorilla/mux。HttpRouter是目前速度最快的路由器，且被框架Gin所采用。

路由解析规则

精准匹配指路由只会匹配准确指定的规则。
长度优先匹配一般用在静态路由上（不支持动态元素如正则和URL路径参数），优先匹配字符数较多的规则。

以下面的为例：

使用长度优先匹配规则的http.ServeMux会把除了/about这个匹配的以外的所有URI都是用defaultHandler来处理。

使用精准匹配的gorilla/mux会把以上两个规则精准匹配到两个链接，/为首页，/about为关于，除此之外都是404未找到。

2、依赖管理Go Modules

弃用GOPATH

Go Modules出现的目的之一就是为了解决GOPATH的问题。

在GOPATH时代，Go源码必须放置在GOPATH/src下，抛弃GOPATH的好处就是能下任意地方创建Go项目。另外，GOPATH有非常落后的依赖管理系统。因为在执行go get时无法传达任何版本信息。无法保证所有人的依赖版本都一致。

Go Modules日常使用

初始化

新项目，使用go mod init初始化生成go.mod文件。

Go Proxy

国内访问外网受限，一般需要配合Go Proxy使用，防止go get获取源码包时花费时间过长。安装package的原则是先拉最新的release tag，若无tag则拉最新的commit。

使用go env -w ...来修改Go相关的环境变量。

go.mod

每一次的go get会同时修改go.mod和go.sum文件。查看 go.mod代码：

几个参数：

module —– 我们的项目在Go Module里也算一个Module
go —– 指定了版本要求，最低1.15
require —– 项目所需依赖

go.sum

go.sum文件保存着依赖包的版本和哈希值。直接依赖包、间接依赖包的哈希值都会被保存。

indirect

回到go.mod中，可以看到require区块里有// indirect字样：此标志标明这个依赖包还未被使用，如果在代码的某个地方import到的话，这个标志会自动去除。

go mod tidy命令

此命令做整理依赖使用，执行时会把未使用的module移除掉。

源码包的存放位置

默认源码包存放于GOPATH/pkg/mod中。

清空Go Modules缓存

使用go clean -modcache命令清空本地下载的Go Modules缓存。

下载依赖

默认情况下，执行go run和go build命令时，Go会基于自动go.mod文件自动拉取依赖。Go Module也提供了go mod download命令下载项目所需依赖。

所有Go Module命令

3、URI中的斜杠

访问以下两个链接：

ocalhost:3000/about
localhost:3000/about/

可以看到有/的链接会报404错误。我们需要在URL进入Gorilla Mux路由解析之前，将后面的/去掉。使用中间件会因为执行顺序的问题，Gorilla Mux会先匹配路由，在执行中间件，故使用中间件依然会返回404。

解决方法很简单，就是写一个函数把Gorilla Mux包起来，在这个函数中我们先对请求做处理，再传给Gorilla Mux解析。但需要注意把首页URL的/排除在外。

表单提交

1、读取表单请求数据

r.ParseForm()由http包提供，从请求中解析请求参数，必须是执行完这段代码，后面使用r.PostForm和r.Form才能读取到数据，否则为空数组。

Form:存储了post、put和get参数，在使用之前需要调用ParseForm方法。
PostForm:存储了post、put参数，在使用之前需要调用ParseForm方法。

如果不想获取所有请求内容，而是逐个获取的话，无需使用r.ParseForm()可直接使用r.FormValue()和r.PostFormValue()方法。

2、模板文件语法

双层大括号{{}}是默认的模板界定符。用于在HTML模板文件中界定模板语法。模板语法都包含在{{和}}中。

{{.}}语句

{{.}}中的点表示当前对象。当我们传入一个结构体对象时，我们可以使用.来访问结构体的对应字段。同理，当我们传入的变量是map时，也可以在末班文件中通过.根据key来取值。

with关键字

语法如下：

注释

注释，执行时会忽略。可以多行，不能嵌套并且必须紧贴分界符。

变量

还可以在模板中声明变量，用来保存传入模板的数据或其他语句生成的结果。具体语法如下:

其中$variable是变量的名字，在后续的代码中可以使用该变量。

移除空格

有时会不可避免的引入空格或换行符，导致模板最终渲染结果不如预期，这种情况下可以使用移除空格语法。

注意：-要紧挨{{和}}，同时与模板值之间需要使用空格分隔。

条件判断

range遍历

range遍历有两种写法，其中pipeline的值必须是数组、切片、字典或者通道。

修改默认的分界符

Go标准库的模板引擎使用两对花括号作为标识，而许多前端框架（如Vue和AngularJS）也是用两队花括号作为标识符，同时使用会产生冲突，需要修改标识符，演示修改Go语言模板引擎的默认标识符。

操作数据库

1、MySQL驱动

操作MySQL数据库

使用Go操作MySQL等数据库，一般有两种方式：

一是利用database/sql接口，直接在代码里硬编写sql语句
二是利用ORM,具体一点就是GORM,以对象关系映射的方式在抽象地操作数据库。

MySQL驱动使用

选用github.com/go-sql-diver/mysql项目作为数据库驱动。使用go get -u github.com/go-sql-driver/mysql下载驱动。

下载后，在项目中引入：

注意导入MySQL驱动时，在包路径前添加了_,这里我们使用了匿名导入的方式来加载驱动。

为什么需要匿名导入？

因为引入的是驱动，操作数据库时我们使用的是sql库里的方法，而不会具体使用到github.com/go-sql-driver/mysql包里的方法，当有未使用的包被引入时，Go编译器会停止编译。为了能让编译器正常运行，需要使用匿名导入来加载。

当导入一个数据库驱动后，此驱动会自行初始化(利用init()函数)并注册自己到Golang的database/sql上下文中，随后我们就可以通过database/sql包提供的方法来操作数据库了。

驱动里的init()代码如下：

注意: Go 语言中，为了使用导入的程序包，必须首先对其进行初始化。初始化始终在单个线程中执行，并且以程序包依赖关系的顺序执行。初始化每个包后，会优先自动执行 init() 函数，并且执行优先级高于主函数的执行优先级。

2、连接数据库

sql.DB连接池

sql.DB结构体是database/sql包封装的一个数据库操作对象，包含了操作数据库的基本方法，通常情况下理解为连接池对象。

一般而言，使用sql.Open()函数便可以初始化并返回一个*sql.DB结构体实例，只需要传入驱动名称及对应的DSN便可。

注意，调用sql.Open()时，并未开始连接数据库，只是为连接数据库做好准备而已。所以一般都会跟一个db.Ping()来检测连接状态。

连接池配置信息设置

推荐以下设置：

SetMaxOpenConns最大连接数

设置连接池最大打开数据库连接数，<=0表示无限制，默认为0。实验表明，在高并发的情况下，将值设为大于 10，可以获得比设置为 1 接近六倍的性能提升。而设置为 10 跟设置为 0（也就是无限制），在高并发的情况下，性能差距不明显。

但需要注意不能超过数据库系统设置的最大连接数。否则会出现MySQL错误：

SetMaxIdleConns空闲连接数

设置连接池最大空闲数据库连接数，<=0表示不设置空闲连接数，默认为2。实验表明，在高并发的情况下，将值设为大于 0，可以获得比设置为 0 超过 20 倍的性能提升。这是因为设置为 0 的情况下，每一个 SQL 连接执行任务以后就销毁掉了，执行新任务时又需要重新建立连接。很明显，重新建立连接是很消耗资源的一个动作。设置空闲连接数，当有新任务进来时，直接使用这些随时待命的连接传输数据，以此达到节约资源，提高执行效率的目的。

SetConnMaxLifetime过期时间

设置连接池里每一个连接的过期时间，过期会自动关闭。理论上来讲，在并发的情况下，此值越小，连接就会越快被关闭，也意味着更多的连接会被创建。设置的值不应该超过 MySQL 的 wait_timeout 设置项（默认情况下是 8 个小时）。

DSN

DSN全称是Data Source Name，表示数据库连接源，用于定义数据库的连接信息，不同数据库的DSN格式不同。可以使用mysql.Config创建MySQL的连接信息：

3、数据库表结构

新建数据库

有两种方式，一种是使用命令行创建数据库，一种是使用可视化工具（NaviCat）。

命令行创建数据库

连接数据库通用格式：

端口默认是3306,主机默认是localhost，如果默认可以不传输，使用命令mysql -u root -p即可认证成功进入命令行模式。

使用命令：CREATE DATABASE goblog CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;创建数据库。编码使用utf8mb4_unicode_ci可以支持存储Emoji,另外支持大小写不敏感(ci是Case Insensitive的缩写)。