开源软件名称:gogo
开源软件地址:https://gitee.com/konyshe/gogo
开源软件介绍:
Go 语言轻量 web 开发框架,特点是一行代码搞定 RESTFul,不依赖第三方 ORM,也不需要生成一堆的 controllers 和 models 文件,快速使用。 背景后台数据库有 100 多张表,用 BeeGo 等框架,需要生成 controllers 和 models 等文件共 200 多个,鼠标滑都滑不过来。每次表字段一有修改,代码就要统统跟着修改,想想都恐怖,于是就做了这个轻量的 web 开发框架,支持多协程任务、websocket、日志输出,批量增删改查。 快速使用备注:由于嵌入了C代码,若遇到提示gcc无法编译的问题,可删掉UtilsBuild_linux.go文件后再尝试 package mainimport ( "net/http" "strconv" "gitee.com/konyshe/gogo")func main() { //初始化日志输出功能,DEBUG为日志输出级别,具体参考函数说明 gogo.LogInit("DEBUG", 1024) // 初始化数据库连接 if err := gogo.SQLInit("mysql", "数据库用户名:数据库密码@tcp(数据库地址:数据库端口)/表名?charset=utf8", 10, 1); err != nil { gogo.CheckErrorExit(err) return } // 增 gogo.POST("/restful/:tablename", func(ctx *gogo.HTTPContext) { affect, err := gogo.SQLInsert( ctx.GetPathParam(":tablename"), ctx.GetPostBody()) if err != nil { gogo.LogError(err) ctx.WriteString(err.Error()) } else { ctx.WriteString(strconv.FormatInt(affect, 10)) } }) // 删 gogo.DELETE("/restful/:tablename/:id", func(ctx *gogo.HTTPContext) { affect, err := gogo.SQLDelete( ctx.GetPathParam(":tablename"), "id="+ctx.GetPathParam(":id")) if err != nil { gogo.LogError(err) ctx.WriteString(err.Error()) } else { ctx.WriteString(strconv.FormatInt(affect, 10)) } }) // 改 gogo.PUT("/restful/:tablename/:id", func(ctx *gogo.HTTPContext) { affect, err := gogo.SQLUpdate( ctx.GetPathParam(":tablename"), "id="+ctx.GetPathParam(":id"), ctx.GetPostBody()) if err != nil { gogo.LogError(err) ctx.WriteString(err.Error()) } else { ctx.WriteString(strconv.FormatInt(affect, 10)) } }) // 查 gogo.GET("/restful/:tablename/:id", func(ctx *gogo.HTTPContext) { queryData, err := gogo.SQLQueryByMap( "", ctx.GetString("feilds"), ctx.GetPathParam(":tablename"), "id="+ctx.GetPathParam(":id"), "", 0, 1) if err != nil { gogo.LogError(err) ctx.WriteString(err.Error()) } else { ctx.WriteJSON(queryData) } }) // 查 gogo.GET("/restful/:tablename", func(ctx *gogo.HTTPContext) { queryData, err := gogo.SQLQueryByMap( ctx.GetString("columnname"), ctx.GetString("feilds"), ctx.GetPathParam(":tablename"), ctx.GetString("where"), ctx.GetString("order"), ctx.GetInt("offset", 0), ctx.GetInt("count", 10)) if err != nil { gogo.LogError(err) ctx.WriteString(err.Error()) } else { ctx.WriteJSON(queryData) } }) // 404页面 gogo.STATUS(http.StatusNotFound, func(ctx *gogo.HTTPContext) { ctx.WriteHeaderStatus(http.StatusNotFound) ctx.WriteString("Page Not Found !") }) // 启动HTTP服务 gogo.StartHTTP(3009)} 数据库表结构mysql> desc dede_flink;+----------+----------------------+------+-----+---------+----------------+| Field | Type | Null | Key | Default | Extra |+----------+----------------------+------+-----+---------+----------------+| id | smallint(5) unsigned | NO | PRI | NULL | auto_increment || sortrank | smallint(6) | NO | | 0 | || url | char(60) | NO | | | || webname | char(30) | NO | | | || msg | char(200) | NO | | | || email | char(50) | NO | | | || logo | char(60) | NO | | | || dtime | int(10) unsigned | NO | | 0 | || typeid | smallint(5) unsigned | NO | | 0 | || ischeck | smallint(6) | NO | | 1 | |+----------+----------------------+------+-----+---------+----------------+10 rows in set Windowsgo build -o app.exeapp.exe Linux/MacOS浏览器访问测试POST http://localhost:3009/restful/dede_flink 以下是 application/json 内容,可以批量添加多条数据 [ { "id": 20, "ischeck": 1, "webname": "hxyw", "url":"http://www.hxyw.org" }, { "id": 21, "ischeck": 1, "webname": "bejson", "url":"http://www.bejson.com" }] PUT http://localhost:3009/restful/dede_flink/21 以下是 application/json 内容,这里只将 id=21 的数据,webname 字段修改为"hello" GET http://localhost:3009/restful/dede_flink/21GET http://localhost:3009/restful/dede_flink?order=-idGET http://localhost:3009/restful/dede_flink?offset=10&&count=100&&columnname=webname DELETE http://localhost:3009/restful/dede_flink/1 GET http://localhost:3009/weqwe Start using it- Download and install it:
$ go get -u gitee.com/konyshe/gogo - Import it in your code:
import "gitee.com/konyshe/gogo" - (Optional) Import
net/http . This is required for example if using constants such as http.StatusNotFound .
示例中的方法介绍,更全的请看代码中的注释// LogInit 初始化日志输出功能// level 日志输出级别// 配置文件指定日志级别 ALL,DEBUG,INFO,WARN,ERROR,FATAL,OFF 级别由低到高// 其中 ALL表示所有调用打印日志的方法都会打出,而OFF则表示都不会打出。// 一般习惯是测试阶段为debug,生成环境为info以上// maxSize 日志文件最大体积,单位MBgogo.LogInit(level string, maxSize int64)// 系统会优先判断是否命中固定URL,当固定URL无法命中的情况下,才会去判断是否命中正则URL(开发中部分支持)gogo.GET("/restful/:tablename/:columnname", func(ctx *gogo.HTTPContext)// 注册没有命中任何URL规则时进入的函数gogo.STATUS(http.StatusNotFound, func(ctx *gogo.HTTPContext)// SQLInit 初始化数据库操作句柄,这里要提供:// driverName string: 数据库类型,例如mysql、sqlite、postgres等,参考github.com/go-sql-driver/mysql官方介绍// dataSourceName string: 数据库地址,参考github.com/go-sql-driver/mysql官方介绍// MaxOpenConns int: 最大缓存连接数,这个数值包含了MaxIdleConns// MaxIdleConns int:预备的最大空闲连接数gogo.SQLInit(driverName string, dataSourceName string, maxOpenConns int, maxIdleConns int) error// SQLInsert 增加一条数据// tableName string: 操作的表名// data []byte: 需要更新的内容,用string转换后是json格式gogo.SQLInsert(tableName string, data []byte) (int64, error)// SQLDelete 根据where条件删除数据// tableName string: 操作的表名// where string: 过滤条件,就是where后面跟着的部分gogo.SQLDelete(tableName, where string) (int64, error)// SQLUpdate 更新一条数据// tableName string: 操作的表名// where string: 过滤条件,就是where后面跟着的部分// data []byte: 需要更新的内容,用string转换后是json格式gogo.SQLUpdate(tableName, where string, data []byte) (int64, error)// SQLQueryByMap 将查询到的数据,按照指定字段的值做为索引构建map并返回// columnName string: 作为索引的字段名称// feilds string: 查询需要获取哪些字段的值,就是select后面跟着的部分,一般用"*"// tableName string: 查询的表名// where string: 过滤条件,就是where后面跟着的部分// order string: 排序条件,就是order by后面跟着的部分。默认是ASC排序,除非"-"开头则DESC排序// offset string: limit后面逗号相隔的两个数值,前者就是offset,后者就是count// count string: limit后面逗号相隔的两个数值,前者就是offset,后者就是countgogo.SQLQueryByMap(columname, feilds, tableName, where, order string, offset, count int) (interface{}, error)// StartHTTP 启动HTTP服务// port 端口号func StartHTTP(port int)// StartWebSocket 启动websocket服务// pattern 服务路径// port 端口号// handler 注册回调函数func StartWebSocket(pattern string, port int, handler func([]byte, *ImplConnection) ([]byte, error))// GetResponseWriter 获取原始的http.ResponseWriter指针(ctx *HTTPContext) GetResponseWriter() http.ResponseWriter// GetRequest 获取原始的http.Request指针(ctx *HTTPContext) GetRequest() *http.Request// GetPathParam 获取GET请求路径中的String格式参数值,例如/restful/:table_name/:id// key string: 参数名称(ctx *HTTPContext) GetPathParam(key string) string// GetPostBody 获取POST请求的内容(ctx *HTTPContext) GetPostBody() []byte// WriteExecute 将官方原始的ParseFiles和Execute接口做了合并// data interface{}: 渲染模板需要的数据// filenames ...string: 模板文件路径(ctx *HTTPContext) WriteExecute(data interface{}, filenames ...string) error// WriteByte 将[]byte格式的数据输出给HTTP客户端// content []byte: 需要输出HTTP客户端的[]byte格式数据(ctx *HTTPContext) WriteByte(content []byte)// WriteString 将String格式的数据输出给HTTP客户端// content string: 需要输出HTTP客户端的String格式数据(ctx *HTTPContext) WriteString(content string)// WriteJSON 将Struct结构体的数据转换成Json输出给HTTP客户端// v interface{}: 需要输出HTTP客户端的Struct结构体数据(ctx *HTTPContext) WriteJSON(v interface{}) error// Log GoGo使用的第三方go_logger库,输出到日志文件的同时还会在控制台输出,并根据日志级别显示不同颜色// 日志输出和官方fmt.Print、fmt.Printf使用一致func LogDebug(a ...interface{})func LogInfo(a ...interface{})func LogWarning(a ...interface{})func LogError(a ...interface{})func LogDebugF(format string, a ...interface{})func LogInfoF(format string, a ...interface{})func LogWarning(format string, a ...interface{})func LogErrorF(format string, a ...interface{})// GlobalSignalWait 全局信号等待// 需要程序等待协程运行的时候使用func GlobalSignalWait()// GlobalSignalRelease 全局信号继续// 需要程序不再等待协程运行的时候使用func GlobalSignalRelease() GoGo v2.1.8GoGo v2.0.0GoGo v1.1.2GoGo v1.0.0欢迎贡献者加入 |
请发表评论