脚本之家，脚本语言编程技术及教程分享平台！
分类导航

Python|VBS|Ruby|Lua|perl|VBA|Golang|PowerShell|Erlang|autoit|Dos|bat|

服务器之家 - 脚本之家 - Golang - Go单体服务开发最佳实践总结

Go单体服务开发最佳实践总结

2022-09-29 15:21万俊峰Kevin Golang

这篇文章主要介绍了Go单体服务开发最佳实践,通过本文详细跟大家分享一下如何使用 go-zero 快速开发一个有多个模块的单体服务，需要的朋友可以参考下

单体最佳实践的由来

  • 对于很多初创公司来说，业务的早期我们更应该关注于业务价值的交付，并且此时用户体量也很小，QPS也非常低，我们应该使用更简单的技术架构来加速业务价值的交付，此时单体的优势就体现出来了。
  • 正如我直播分享时经常提到，我们在使用单体快速交付业务价值的同时，也需要为业务的发展预留可能性，我们可以在单体里面清晰的拆分业务模块。
  • go-zero社区里也有很多小伙伴在问，咱们单体开发的最佳实践应该是怎样的。

而go-zero作为一个被广泛使用的渐进式微服务框架来说，也是我在多个大型项目完整发展过程中沉淀出来的，自然我们也充分考虑了单体服务开发的场景。

如图所示的使用go-zero的单体架构，也可以支撑很大体量的业务规模，其中Service是单体服务的多个Pod。

Go单体服务开发最佳实践总结

我就通过本文详细跟大家分享一下如何使用go-zero快速开发一个有多个模块的单体服务。

单体示例

我们用一个上传下载的单体服务来讲解go-zero单体服务开发的最佳实践，为啥用这么个示例呢？

  • go-zero社区里经常有同学会问上传文件怎么定义API文件，然后用goctl自动生成。初见此类问题会觉得比较奇怪，为啥不用OSS之类的服务呢？发现很多场景是用户需要上传一个excel，然后服务端解析完也就丢弃此文件了。一是文件较小，二是用户量也不大，就不用那么复杂的通过OSS来绕一圈了，我觉得也挺合理的。

  • go-zero社区也有同学问下载文件怎么通过定义一个API文件然后goctl自动生成。此类问题之所以通过 Go 来做，问下来一般两个原因，一是业务刚开始，能简单点布一个服务搞定就一个吧；二是希望能吃上go-zero的内置JWT自动鉴权。

仅以此为示例，无需深入探讨上传下载是否应该通过Go来实现。那么接下来我们就看看我们怎么通过go-zero来解决这么一个单体服务，我们称之为文件（file）服务。架构如下图：

Go单体服务开发最佳实践总结

单体实现

API定义

使用过go-zero的同学都知道，我们提供了一个API格式的文件来描述RESTful API，然后可以通过goctl一键生成对应的代码，我们只需要在logic文件里填写对应的业务逻辑即可。我们就来看看download和upload服务怎么定义API.

Download服务定义

示例需求如下：

  • 通过/static/<filename>路径下载名为<filename>的文件
  • 直接返回文件内容即可

我们在api目录下创建一个名为download.api的文件，内容如下：

?
1
2
3
4
5
6
7
syntax = "v1"
type DownloadRequest {
  File string `path:"file"`
}
service file-api {
  @handler DownloadHandler
  get /static/:file(DownloadRequest)

zero-api的语法还是比较能自解释的，含义如下：

  • syntax = “v1”表示这是zero-api的v1语法
  • type DownloadRequest定义了Download的请求格式
  • service file-api定义了Download的请求路由

Upload服务定义

示例需求如下：

  • 通过/upload路径上传文件
  • 通过json返回上传状态，其中的code可用于表达比HTTP code更丰富的场景

我们在api目录下创建一个名为upload.api的文件，内容如下：

?
1
2
3
4
5
6
7
8
syntax = "v1"
type UploadResponse {
  Code int `json:"code"`
}
service file-api {
  @handler UploadHandler
  post /upload returns (UploadResponse)
}

解释如下：

  • syntax = “v1”表示这是zero-api的v1语法
  • type UploadResponse定义了Upload的返回格式
  • service file-api定义了Upload的请求路由

问题来了

Download和Upload服务我们都定义好了，那怎么才能放到一个服务里给用户提供服务呢？

不知道细心的你有没注意到一些细节：

  • 不管是Download还是Upload我们在request和response数据定义的时候都加了前缀，并没有直接使用诸如Request或Response这样的
  • 我们在download.api和upload.api里面定义service的时候都是用的file-api这个service name，并没有分别用download-api和upload-api

这么做的目的其实就是为了我们接下来把这两个服务放到同一个单体里自动生成对应的Go代码。让我们来看看怎么把Download和Upload合并起来~

定义单体服务接口

出于简单考虑，goctl只支持接受单一API文件作为参数，同时接受多个API文件的问题不在此讨论，如有简单高效的方案，后续可能支持。

我们在api目录下创建一个新的file.api的文件，内容如下：

?
1
2
3
syntax = "v1"
import "download.api"
import "upload.api"

这样我们就像C/C++的#include一样把Download和Upload服务都导入进来了。但其中有几点需要注意的：

  • 定义的结构体不能重名
  • 所有文件里包含的service name必须是同一个

最外层的API文件也可以包含同一个service的部分定义，但我们推荐保持对称，除非这些API确实属于父层级，比如跟Download和Upload属于同一个逻辑层次，那么就不应该放到file.api里面定义。

至此，我们的文件结构如下：

?
1
2
3
4
5
.
└── api
    ├── download.api
    ├── file.api
    └── upload.api

生成单体服务

既然已经有了API接口定义，那么对于go-zero来说，接下来的事情就很简单直接了（当然，定义API也挺简单的，不是吗？），让我们来使用goctl生成单体服务代码。

?
1
$ goctl api go -api api/file.api -dir .

我们来看看生成后的文件结构：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
.
├── api
│   ├── download.api
│   ├── file.api
│   └── upload.api
├── etc
│   └── file-api.yaml
├── file.go
├── go.mod
├── go.sum
└── internal
    ├── config
    │   └── config.go
    ├── handler
    │   ├── downloadhandler.go
    │   ├── routes.go
    │   └── uploadhandler.go
    ├── logic
    │   ├── downloadlogic.go
    │   └── uploadlogic.go
    ├── svc
    │   └── servicecontext.go
    └── types
        └── types.go

我们来按目录解释一下项目代码的构成：

  • api目录：我们前面定义的API接口描述文件，无需多言
  • etc目录：这个是用来放置yaml配置文件的，所有的配置项都可以写在file-api.yaml文件里
  • file.go：main函数所在文件，文件名跟service同名，去掉了后缀-api
  • internal/config目录：服务的配置定义
  • internal/handler目录：API文件里定义的路由对应的handler实现
  • internal/logic目录：用来放每个路由对应的业务处理逻辑，之所以区分handler和logic是为了让业务处理部分尽可能减少依赖，把HTTP requests和逻辑处理代码隔离开，便于后续按需拆分成RPC service
  • internal/svc目录：用来定义业务逻辑处理的依赖，我们可以在main里面创建依赖的资源，然后通过ServiceContext传递给handler和logic
  • internal/types目录：定义了API请求和返回数据结构

咱们什么也不改，先来跑一下看看效果。

?
1
2
$ go run file.go -f etc/file-api.yaml
Starting server at 0.0.0.0:8888...

实现业务逻辑

接下来我们需要实现相关的业务逻辑，但是这里的逻辑其实只是一个演示用途，无需过于关注实现细节，只需要理解我们应该把业务逻辑写在logic层即可。

这里一共做了以下几件事：

增加配置项里的Path设置，用来放置上传文件，默认值我写了当前目录，因为是示例，如下：

?
1
2
3
4
5
type Config struct {
  rest.RestConf
  // 新增
  Path string `json:",default=."`
}

调整了请求体的大小限制，如下：

?
1
2
3
4
5
Name: file-api
Host: localhost
Port: 8888
# 新增
MaxBytes: 1073741824

由于Download需要写文件给客户端，所以我们把ResponseWriter当成io.Writer传递给了logic层，修改后的代码如下：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
func (l *DownloadLogic) Download(req *types.DownloadRequest) error {
  logx.Infof("download %s", req.File)
  body, err := ioutil.ReadFile(req.File)
  if err != nil {
    return err
  }
  n, err := l.writer.Write(body)
  if err != nil {
    return err
  }
  if n < len(body) {
    return io.ErrClosedPipe
  }
  return nil
}

由于Upload需要读取用户上传的文件，所以我们把http.Request传递给了logic层，修改后的代码如下：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
func (l *UploadLogic) Upload() (resp *types.UploadResponse, err error) {
  l.r.ParseMultipartForm(maxFileSize)
  file, handler, err := l.r.FormFile("myFile")
  if err != nil {
    return nil, err
  }
  defer file.Close()
  logx.Infof("upload file: %+v, file size: %d, MIME header: %+v",
    handler.Filename, handler.Size, handler.Header)
 
  tempFile, err := os.Create(path.Join(l.svcCtx.Config.Path, handler.Filename))
  if err != nil {
    return nil, err
  }
  defer tempFile.Close()
  io.Copy(tempFile, file)
  return &types.UploadResponse{
    Code: 0,
  }, nil
}

完整代码：https://github.com/zeromicro/zero-examples/tree/main/monolithic

我们可以通过启动file单体服务：

?
1
$ go run file.go -f etc/file-api.yaml

可以通过curl来验证Download服务：

?
1
2
3
4
5
6
7
$ curl -i "http://localhost:8888/static/file.go"
HTTP/1.1 200 OK
Traceparent: 00-831431c47d162b4decfb6b30fb232556-dd3b383feb1f13a9-00
Date: Mon, 25 Apr 2022 01:50:58 GMT
Content-Length: 584
Content-Type: text/plain; charset=utf-8
...

示例仓库里包含了upload.html，浏览器打开这个文件就可以尝试Upload服务了。

单体开发的总结

我把用go-zero开发单体服务的完整流程归纳如下：

  • 定义各个子模块的API文件，比如：download.api和upload.api
  • 定义总的API文件，比如：file.api。用来import步骤一定义的各个子模块的API文件
  • 通过goctl api go命令生成单体服务框架代码
  • 增加和调整配置，实现对应的子模块的业务逻辑

另外，goctl可以根据SQL一键生成CRUD以及cache代码，可以帮助大家更快速的开发单体服务。

项目地址

https://github.com/zeromicro/go-zero

到此这篇关于Go单体服务开发最佳实践的文章就介绍到这了,更多相关go单体服务内容请搜索服务器之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持服务器之家！

原文链接：https://www.cnblogs.com/kevinwan/p/16193504.html

  • Go
  • 单体服务

    • 延伸 · 阅读

    精彩推荐
    • Golanggolang中的struct操作

      golang中的struct操作

      结构体是一种聚合的数据类型，是由零个或多个任意类型的值聚合成的实体，每个值称为结构体的成员。下面介绍下golang中的struct，感兴趣的朋友一起看看...

      老朱.9942021-12-02
    • GolangGo语言压缩和解压缩tar.gz文件的方法

      Go语言压缩和解压缩tar.gz文件的方法

      这篇文章主要介绍了Go语言压缩和解压缩tar.gz文件的方法,实例分析了使用Go语言压缩文件与解压文件的技巧,具有一定参考借鉴价值,需要的朋友可以参考下...

      不吃皮蛋15142020-04-15
    • GolangGo语言操作数据库及其常规操作的示例代码

      Go语言操作数据库及其常规操作的示例代码

      这篇文章主要介绍了Go语言操作数据库及其常规操作的示例代码，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需...

      听风走了八千里7212021-05-26
    • GolangGo语言实现一个简单的并发聊天室的项目实战

      Go语言实现一个简单的并发聊天室的项目实战

      本文主要介绍了Go语言实现一个简单的并发聊天室的项目实战，文中根据实例编码详细介绍的十分详尽，具有一定的参考价值，感兴趣的小伙伴们可以参考...

      Sirius_74362022-09-07
    • Golanggolang time包做时间转换操作

      golang time包做时间转换操作

      这篇文章主要介绍了golang time包做时间转换操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧...

      weixin_415714496342021-03-12
    • Golang解决vscode中golang插件依赖安装失败问题

      解决vscode中golang插件依赖安装失败问题

      这篇文章主要介绍了解决vscode中golang插件依赖安装失败问题,本文给大家介绍的非常详细，具有一定的参考借鉴价值，需要的朋友可以参考下 ...

      feiquan13452020-05-27
    • Golang使用go的interface案例实现多态范式操作

      使用go的interface案例实现多态范式操作

      这篇文章主要介绍了使用go的interface案例实现多态范式操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧...

      涛歌依旧5022021-03-19
    • GolangGo Excelize API源码阅读Close及NewSheet方法示例解析

      Go Excelize API源码阅读Close及NewSheet方法示例解析

      这篇文章主要为大家介绍了Go Excelize API源码阅读Close及NewSheet方法示例解析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职...

      丘山子8652022-08-08
    最近更新
    编辑推荐
    阅读排行
    热门标签
    时间包 　 指针类型 　 new() 　 make() 　 并发模型 　 切片 　 静态WEB服务器 　 端口扫描器 　 Go语言入门教程 　 基础语 　 Slices 　 Maps 　 Golang编程 　 panic 　 接受者类型 　 嵌入类型 　 Slice 　 Golang教程 　 Golang项目 　 内存模型 　 开发环境搭建 　 大小端判断 　 代码组织结构 　 复合类型 　 GOPATH 　 工作目录 　 实例 　 struct类型 　 并发技术 　 buffered 　
    © 2019-2022 脚本之家 | 服务器之家(www.tuohang.net)旗下站点 版权所有关于我们联系我们版权申明网站地图