gobase - Golang快速构建应用程序基础框架插件库

gobase 是一个用于快速构建 Golang 应用程序的基础框架插件库，它提供了一系列常用功能和组件，帮助开发者快速搭建项目基础架构。

主要特性

1. 配置管理
2. 日志系统
3. 数据库集成
4. HTTP服务
5. 中间件支持
6. 工具函数集合

安装

go get github.com/yourusername/gobase

基本使用示例

1. 初始化应用

package main

import (
	"github.com/yourusername/gobase"
	"github.com/yourusername/gobase/config"
	"github.com/yourusername/gobase/logger"
)

func main() {
	// 初始化配置
	cfg, err := config.Load("./config.yaml")
	if err != nil {
		panic(err)
	}

	// 初始化日志
	logger.Init(cfg.Log)

	// 创建应用
	app := gobase.NewApplication(cfg)

	// 运行应用
	if err := app.Run(); err != nil {
		logger.Fatal("application run failed", "error", err)
	}
}

2. 配置管理

// config.yaml 示例
app:
  name: "myapp"
  env: "dev"
  port: 8080

log:
  level: "info"
  path: "./logs"

database:
  driver: "mysql"
  dsn: "user:password@tcp(localhost:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"

3. HTTP服务

package main

import (
	"github.com/yourusername/gobase"
	"github.com/yourusername/gobase/server"
	"net/http"
)

func main() {
	app := gobase.NewDefaultApplication()
	
	// 创建HTTP服务器
	srv := server.NewHTTPServer(app.Config.Server)
	
	// 注册路由
	srv.Router().GET("/", func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("Hello, gobase!"))
	})
	
	// 添加服务器到应用
	app.AddServer("http", srv)
	
	// 运行应用
	app.Run()
}

4. 数据库集成

package main

import (
	"github.com/yourusername/gobase"
	"github.com/yourusername/gobase/database"
)

type User struct {
	ID   uint   `gorm:"primaryKey"`
	Name string `gorm:"size:255"`
	Age  int
}

func main() {
	app := gobase.NewDefaultApplication()
	
	// 初始化数据库
	db, err := database.New(app.Config.Database)
	if err != nil {
		panic(err)
	}
	
	// 自动迁移
	db.AutoMigrate(&User{})
	
	// 使用示例
	user := User{Name: "John", Age: 30}
	db.Create(&user)
	
	app.Run()
}

5. 中间件支持

package main

import (
	"github.com/yourusername/gobase"
	"github.com/yourusername/gobase/server"
	"github.com/yourusername/gobase/server/middleware"
	"net/http"
)

func main() {
	app := gobase.NewDefaultApplication()
	srv := server.NewHTTPServer(app.Config.Server)
	
	// 使用日志中间件
	srv.Use(middleware.Logger())
	
	// 使用恢复中间件
	srv.Use(middleware.Recovery())
	
	srv.Router().GET("/", func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("Hello with middleware!"))
	})
	
	app.AddServer("http", srv)
	app.Run()
}

高级功能

自定义插件

package myplugin

import (
	"github.com/yourusername/gobase"
	"github.com/yourusername/gobase/plugin"
)

type MyPlugin struct {
	plugin.BasePlugin
}

func (p *MyPlugin) Init() error {
	// 初始化逻辑
	return nil
}

func (p *MyPlugin) Start() error {
	// 启动逻辑
	return nil
}

func (p *MyPlugin) Stop() error {
	// 停止逻辑
	return nil
}

// 注册插件
func init() {
	gobase.RegisterPlugin("myplugin", func() gobase.Plugin {
		return &MyPlugin{}
	})
}

使用自定义插件

package main

import (
	_ "path/to/myplugin" // 导入插件包以注册插件
	"github.com/yourusername/gobase"
)

func main() {
	app := gobase.NewDefaultApplication()
	
	// 加载插件
	app.LoadPlugin("myplugin")
	
	app.Run()
}

最佳实践

1. 将业务逻辑与基础设施分离
2. 使用依赖注入管理组件
3. 合理使用中间件处理横切关注点
4. 通过插件机制扩展功能

gobase 提供了构建 Golang 应用程序所需的基础设施，开发者可以专注于业务逻辑的实现，快速构建高质量的应用程序。