golang获取结构体中的tag_Golang模块代理goproxy.io源码研读

最新推荐文章于 2024-08-30 07:40:26 发布

weixin_39605997

最新推荐文章于 2024-08-30 07:40:26 发布

阅读量172

点赞数

文章标签： golang获取结构体中的tag html源码加密ensure-china

本文研读goproxy.io开源代码，介绍建立Golang Proxy服务需实现的功能，如提供多个接口返回模块版本号、元数据等信息。还分析了goproxy工程主要目录结构，包括generate.sh脚本、main.go和proxy.go的作用，其总体思路清晰，可解决国内Go Module下载问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

goproxy.io是一款很好用的Golang Module Proxy，解决了国内用户无法直接下载Golang模块依赖的问题。

本文准备研读一下其开源代码github.com/goproxyio/goproxy，了解下其实现原理。

goproxy工程的主要目录结构如下：

goproxy ├ build │ └ generate.sh ├ pkg │ └ proxy │ └ proxy.go └ main.go

main.go头部有一行代码：

//go:generate ./build/generate.sh

下面会解释其作用。

1 建立一个Golang Proxy服务需要实现哪些功能

$ go help goproxy...A Go module proxy is any web server that can respond to GET requests forURLs of a specified form. The requests have no query parameters, so evena site serving from a fixed file system (including a file:/// URL)can be a module proxy.The GET requests sent to a Go module proxy are:GET $GOPROXY//@v/list returns a list of all known versions of thegiven module, one per line.GET $GOPROXY//@v/.info returns JSON-formatted metadataabout that version of the given module.GET $GOPROXY//@v/.mod returns the go.mod filefor that version of the given module.GET $GOPROXY//@v/.zip returns the zip archivefor that version of the given module....

从如上说明可知，使用诸如go get等go命令会从vcs下载所需模块，设置GOPROXY环境变量即可指定Go Module Proxy服务，其为不带参数URL的GET请求提供服务，为模块下载作了一层包装。

其主要提供如下几个接口：

a)GET $GOPROXY//@v/list

该接口返回给定模块的已知版本号列表，每行一个。

b)GET $GOPROXY//@v/.info

该接口返回给定模块在给定版本的JSON格式的元数据信息。

c)GET $GOPROXY//@v/.mod

该接口返回给定模块在给定版本的go.mod的内容。

d)GET $GOPROXY//@v/.zip

该接口返回给定模块在给定版本的.zip压缩包。

为避免大小写敏感型文件系统服务问题，及会对大写字母加密，即将大写字母转换为!加小写字母的方式。

如github.com/Azure编码为github.com/!azure。

JSON格式的元数据信息对应的Go内置结构体为：

type Info struct { Version string // version string Time time.Time // commit time}

给定模块在给定版本的.zip压缩包内的文件树结构与模块源码树结构一致，且模块及版本未使用大写字母加密。

不论go命令直接访问vcs还是从Proxy下载，其均会将模块的info、mod及zip文件组合到一起，置于$GOPATH/pkg/mod/cache/download本地缓存。

因缓存路径与请求路径对应，所以对$GOPATH/pkg/mod/cache/download文件夹以https://example.com/proxy提供服务即可访问到缓存的模块。

2 goproxy/build/generate.sh

当执行go generate命令时，Go会扫描当前包相关的源码文件，找出所有包含//go:generate的特殊注释，并执行注释指定的脚本。

因goproxy.io工程需要使用内置的模块获取包，而由上一篇文章“Golang 模块获取包modfetch研读”可知，modfetch、modload等模块获取包是位于cmd/go/internal路径下的，所以无法直接引用，main.go所指向的goproxy/build/generate.sh这个脚本即是用来将modfetch、modload等内部包及其依赖包拷贝至当前工作目录下，以便直接引用。