mirror of
https://gitee.com/johng/gf
synced 2026-06-07 10:22:11 +08:00
185 lines
6.7 KiB
Markdown
185 lines
6.7 KiB
Markdown
## 安装
|
||
```
|
||
go get -u gitee.com/johng/gf
|
||
```
|
||
|
||
## 使用
|
||
```go
|
||
import "gitee.com/johng/gf/g/xxx/xxx"
|
||
```
|
||
## 说明
|
||
|
||
1. [框架入门](#框架介绍)
|
||
- [框架介绍](#框架介绍)
|
||
- [源码结构](#源码结构)
|
||
1. [Web服务开发]()
|
||
- [HTTPServer]()
|
||
- [Web Server]()
|
||
- [多域名支持]()
|
||
- [MVC开发模式]()
|
||
- [Controller]()
|
||
- [Model]()
|
||
- [View]()
|
||
- [服务注册]()
|
||
- [控制器注册]()
|
||
- [REST控制器]()
|
||
- [执行对象注册]()
|
||
- [回调函数注册]()
|
||
- [Cookie]()
|
||
- [Session]()
|
||
- [路由控制]()
|
||
- [配置管理]()
|
||
- [单例管理]()
|
||
- [数据校验]()
|
||
- [模板引擎]()
|
||
- [数据库操作]()
|
||
1. [网络服务开发]()
|
||
- [TCPServer]()
|
||
- [UDPServer]()
|
||
1. [功能模块设计]()
|
||
- [缓存模块]()
|
||
- [日志模块]()
|
||
- [时间模块]()
|
||
- [命令行模块]()
|
||
- [环境变量模块]()
|
||
- [文件管理模块]()
|
||
- [并发安全容器]()
|
||
- [通用编码模块]()
|
||
- [其他模块简介]()
|
||
|
||
### 框架介绍
|
||
|
||
|
||
### 源码结构
|
||
.
|
||
├── g 【框架目录】
|
||
│ ├── container 【常用数据结构】
|
||
│ │ ├── gbtree B+树
|
||
│ │ ├── glist 并发安全的双向链表
|
||
│ │ ├── gmap 并发安全的哈希表
|
||
│ │ └── gset 并发安全的集合
|
||
│ │
|
||
│ ├── database 【数据库操作】
|
||
│ │ └── gdb 通用关系型数据库操作封装(目前仅支持MySQL、PostgreSQL)
|
||
│ │
|
||
│ ├── encoding 【数据编码】
|
||
│ │ ├── gbase64 BASE64
|
||
│ │ ├── gbinary 二进制操作
|
||
│ │ ├── gcompress 数据压缩
|
||
│ │ ├── gcrc32 CRC32
|
||
│ │ ├── ghash 常用哈希函数
|
||
│ │ ├── ghtml HTML编码
|
||
│ │ ├── gjson JSON
|
||
│ │ ├── gmd5 MD5
|
||
│ │ ├── gsha1 SHA1
|
||
│ │ └── gurl URL
|
||
│ │
|
||
│ ├── frame 【开发框架】
|
||
│ │ ├── gcfg 通用配置管理
|
||
│ │ ├── gins 单例对象管理
|
||
│ │ └── gmvc MVC模式封装基类
|
||
│ │
|
||
│ ├── net 【网络通信】
|
||
│ │ ├── ghttp 强大的HTTP客户端及服务端
|
||
│ │ ├── gipv4 IPv4操作
|
||
│ │ ├── gipv6 IPv6操作
|
||
│ │ ├── grouter 路由管理
|
||
│ │ ├── gscanner 端口扫描
|
||
│ │ ├── gsmtp SMTP邮件管理
|
||
│ │ ├── gtcp TCP服务端
|
||
│ │ └── gudp UDP服务端
|
||
│ │
|
||
│ ├── os 【系统管理】
|
||
│ │ ├── gcache 缓存管理
|
||
│ │ ├── gcmd 命令行控制
|
||
│ │ ├── genv 环境变量
|
||
│ │ ├── gfile 文件管理
|
||
│ │ ├── gfilepool 文件指针池
|
||
│ │ ├── gfilespace 文件碎片管理
|
||
│ │ ├── glog 日志管理
|
||
│ │ ├── gmmap MMAP文件内存映射
|
||
│ │ ├── gtime 时间管理
|
||
│ │ └── gview 视图管理(通用的模板管理对象，独立于MVC模块)
|
||
│ │
|
||
│ └── util 【常用工具】
|
||
│ ├── gconv 类型转换
|
||
│ ├── grand 随机数
|
||
│ ├── gregx 正则表达式
|
||
│ ├── gvalid 表单校验
|
||
│ └── gutil 其他工具
|
||
│
|
||
├── geg 【框架示例】
|
||
├── vendor 【第三方包】
|
||
└── version.go 【版本信息】
|
||
|
||
## 配置
|
||
1. 默认读取文件运行目录的config.json文件；
|
||
1. 支持多配置文件管理，默认配置文件目录为当前运行目录；
|
||
1. config.json配置文件说明：
|
||
```json
|
||
{
|
||
"viewpath" : "视图文件存放路径",
|
||
"database" : {
|
||
"数据库分组名称" : [
|
||
{
|
||
"host" : "地址",
|
||
"port" : "端口",
|
||
"user" : "账号",
|
||
"pass" : "密码",
|
||
"name" : "数据库名称",
|
||
"type" : "数据库类型(mysql|pgsql)",
|
||
"role" : "数据库角色(master|slave)",
|
||
"charset" : "字符编码",
|
||
"priority" : "数据库优先级(负载均衡处理)"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
1. config.json示例文件：
|
||
```json
|
||
{
|
||
"viewpath" : "/home/john/Workspace/Go/gitee.com/johng/gf/geg/frame/mvc/view",
|
||
"database" : {
|
||
"default" : [
|
||
{
|
||
"host" : "127.0.0.1",
|
||
"port" : "3306",
|
||
"user" : "root",
|
||
"pass" : "123456",
|
||
"name" : "test",
|
||
"type" : "mysql",
|
||
"role" : "master",
|
||
"charset" : "utf8",
|
||
"priority" : "100"
|
||
},
|
||
{
|
||
"host" : "127.0.0.1",
|
||
"port" : "3306",
|
||
"user" : "root",
|
||
"pass" : "123456",
|
||
"name" : "test",
|
||
"type" : "mysql",
|
||
"role" : "slave",
|
||
"charset" : "utf8",
|
||
"priority" : "100"
|
||
}
|
||
],
|
||
"ucenter" : [
|
||
{
|
||
"host" : "127.0.0.1",
|
||
"port" : "3306",
|
||
"user" : "root",
|
||
"pass" : "123456",
|
||
"name" : "ucenter",
|
||
"type" : "mysql",
|
||
"role" : "master",
|
||
"charset" : "utf8",
|
||
"priority" : "100"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|