goweb3系列解析4 :gomini 模块解析

gomini 模块解析gomini是 goweb3 项目的核心工具模块提供项目根目录查找、包路径解析、元数据管理等基础设施能力是整个框架的基础支撑层。一、模块架构plainTextgomini/ ├── minifactroy/ # 工厂模式核心 │ ├── minifactroy.go # 对外统一接口 │ ├── metafile/ # 元数据文件管理 │ │ └── meta_file.go # 元数据写入 │ ├── internal/ # 内部实现 │ │ ├── minifile/ # 文件系统操作 │ │ │ └── mini_file.go # 目录查找、文件遍历 │ │ ├── minigomod/ # go.mod 操作 │ │ │ └── mini_file_gomod.go # 模块根目录查找 │ │ └── minipkg/ # Go 包操作 │ │ └── mini_filepkg.go # 包路径解析 │ └── meta/ # 元数据处理代码生成相关 │ ├── db/ # 数据库元数据 │ ├── goast/ # Go AST 处理 │ └── metafacade/ # 元数据门面 ├── gopool/ # 对象池 ├── goroutines/ # 协程管理 ├── goevent/ # 事件机制 ├── makego/ # 代码生成 └── cyclocomplex/ # 圈复杂度分析二、核心组件详解1. minifactroy - 统一工厂接口gopackage minifactroy // 核心方法汇总 func FindProjectRootPkg() string // 获取项目根包名从 go.mod 读取 func FindProjectRootPkgSimple() string // 获取简化的包名最后一段 func FindFiles(rootdir, suffix) // 遍历目录查找指定后缀文件 func FindRootDir() string // 查找项目根目录 func FindPkgRootDir() string // 查找 goweb3 包的根目录 func FindPkgRootDirOf(pkgname) string // 查找指定包的根目录 func FindGomodRootDir() string // 查找 go.mod 所在目录 func FindAll() map[string]string // 获取所有路径信息2. MiniFile - 文件系统操作gotype MiniFile struct { basedto.BaseEntitySingle // 单例模式基类 RootDir string // 项目根目录 configPath string // 配置文件路径 configFile string // 默认配置文件名 cfgEnvFile string // 环境配置文件名 } // 核心功能 func (this *MiniFile) FindRootDir() string // 向上遍历查找项目根目录 func (this *MiniFile) FindBasePkg() string // 从 go.mod 读取 module 名称 func (this *MiniFile) FindFiles() // 递归查找指定后缀文件 func (this *MiniFile) GetCurPath() string // 获取当前工作目录根目录查找算法gofunc (this *MiniFile) findWorkRoot(curPath, f string) string { // 1. 获取目录层级 dirs strings.Split(curPath, /) // 2. 从当前目录向上遍历 for i : len(dirs); i 0; i-- { workRoot strings.Join(dirs[0:i], /) // 3. 检查配置文件是否存在 if this.CheckConfigFileExist(workRoot, f) { os.Setenv(baseconsts.IchubBasePath, workRoot) return workRoot } } return workRoot }3. MiniFileGomod - go.mod 操作gotype MiniFileGomod struct { basedto.BaseEntitySingle *minifile.MiniFile // 组合 MiniFile } // 以 go.mod 为标识查找项目根目录 func (this *MiniFileGomod) FindRootDir() string { return this.FindRoot(this.GetCurPath(), go.mod) }4. MiniFilepkg - Go 包路径解析gotype MiniFilepkg struct { basedto.BaseEntitySingle *minifile.MiniFile BasePkgName string // 目标包名 } // 使用 Go 标准库解析包路径 func (this *MiniFilepkg) GetPkg(pkgPath string) (*build.Package, error) { pkg, err : build.Default.Import(pkgPath, , build.FindOnly) return pkg, err } // 获取包的根目录 func (this *MiniFilepkg) FindRootDir() string { pkg, err : this.GetPkg(this.BasePkgName) this.RootDir pkg.Root return this.RootDir }5. MetaFile - 元数据文件管理goconst ( meta_out /data/output/meta meta_table_out meta_out /dbdict // 数据库字典输出 meta_goast_out meta_out /goast // Go AST 输出 meta_file_out meta_out /file // 文件元数据输出 ) func (this *MetaFile) WriteMetaFile(meta) // 写入数据库表元数据 func (this *MetaFile) WriteGoastFile(si) // 写入 Go 结构体元数据 func (this *MetaFile) WriteFileFile(minf) // 写入文件路径元数据三、路径查找机制1. 查找策略对比查找类型标识文件用途FindRootDir()config/env.yml查找项目运行根目录FindGomodRootDir()go.mod查找 Go 模块根目录FindPkgRootDir()Go Module 系统查找 goweb3 包安装路径FindProjectRootPkg()go.mod内容读取项目包名2. 环境变量优先级plainText环境变量 ICHUB_BASE_PATH ↓ 如果为空 向上遍历查找配置文件 ↓ 如果找到 设置环境变量并返回路径四、依赖注入与单例模式所有核心组件都实现了单例模式通过basedto.BaseEntitySingle基类和依赖注入容器管理go// 获取单例实例的方式 minifile.FindBeanMiniFile() // 文件操作单例 minigomod.FindBeanMiniFileGomod() // go.mod 操作单例 minipkg.FindBeanMiniFilepkg() // 包操作单例五、使用示例gopackage main import ( gitee.com/leijmdas/goweb3.git/gomini/minifactroy ) func main() { // 1. 获取项目根目录 rootDir : minifactroy.FindRootDir() fmt.Println(项目根目录:, rootDir) // 2. 获取项目包名 pkgName : minifactroy.FindProjectRootPkg() fmt.Println(项目包名:, pkgName) // 3. 获取简化包名 simplePkg : minifactroy.FindProjectRootPkgSimple() fmt.Println(简化包名:, simplePkg) // 4. 查找所有 .go 文件 files, _ : minifactroy.FindFiles(rootDir, .go) fmt.Println(Go 文件数量:, len(files)) // 5. 获取 goweb3 包安装路径 pkgRoot : minifactroy.FindPkgRootDir() fmt.Println(goweb3 包路径:, pkgRoot) // 6. 获取所有路径信息 allPaths : minifactroy.FindAll() fmt.Println(allPaths) }六、设计亮点特性实现方式优势多层查找策略环境变量 → 文件遍历 → Go Module灵活适应不同运行环境单例模式依赖注入容器 懒加载避免重复初始化保证一致性跨平台兼容自动识别 Windows/Linux 路径分隔符一次编写多平台运行元数据持久化结构化元数据文件输出支持代码生成和分析工具包路径解析Go 标准库go/build准确获取第三方包位置七、在项目中的应用代码生成通过FindPkgRootDir()获取模板文件位置配置管理通过FindRootDir()定位配置文件目录包名替换通过FindProjectRootPkg()实现包路径动态替换文件遍历通过FindFiles()批量处理项目文件元数据输出通过MetaFile输出数据库表结构、Go 结构体等元信息八、典型使用场景场景1代码生成时的模板查找go// 获取 goweb3 包中的模板目录 templateDir : minifactroy.FindPkgRootDirOf(gitee.com/leijmdas/goweb3.git/cmd/goweb3) /templates // 复制模板到项目 gfile.CopyDir(templateDir, projectDir /generated)场景2动态替换包名go// 获取当前项目包名 projectPkg : minifactroy.FindProjectRootPkg() // 在生成的代码中替换包路径 content strings.ReplaceAll(content, gitee.com/leijmdas/goweb3.git, projectPkg)场景3查找项目所有 Go 文件go// 查找项目根目录下所有 .go 文件 files, err : minifactroy.FindFiles(minifactroy.FindRootDir(), .go) if err ! nil { logrus.Error(err) }