当前位置:主页 > 脚本语言 > Golang >

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

时间:2022-10-15 10:19:07 | 栏目:Golang | 点击:

单体最佳实践的由来

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

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

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

单体示例

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

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

单体实现

API定义

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

Download服务定义

示例需求如下:

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

syntax = "v1"
type DownloadRequest {
  File string `path:"file"`
}
service file-api {
  @handler DownloadHandler
  get /static/:file(DownloadRequest)

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

Upload服务定义

示例需求如下:

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

syntax = "v1"
type UploadResponse {
  Code int `json:"code"`
}
service file-api {
  @handler UploadHandler
  post /upload returns (UploadResponse)
}

解释如下:

问题来了

DownloadUpload服务我们都定义好了,那怎么才能放到一个服务里给用户提供服务呢?

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

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

定义单体服务接口

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

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

syntax = "v1"
import "download.api"
import "upload.api"

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

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

至此,我们的文件结构如下:

.
└── api
    ├── download.api
    ├── file.api
    └── upload.api

生成单体服务

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

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

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

.
├── 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

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

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

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

实现业务逻辑

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

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

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

type Config struct {
  rest.RestConf
  // 新增
  Path string `json:",default=."`
}

调整了请求体的大小限制,如下:

Name: file-api
Host: localhost
Port: 8888
# 新增
MaxBytes: 1073741824

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

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层,修改后的代码如下:

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单体服务:

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

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

$ 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开发单体服务的完整流程归纳如下:

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

项目地址

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

您可能感兴趣的文章:

相关文章