golang-grpc-gin

简介

本程序是一个 简陋的 demo ,没有业务就只是为了打通rpc与gin 数据库操作,用来学习grpc,gin 框架所写。

grpc 提供服务，gin调用服务从而提供 RESTfull Api, demo还非常简陋,后面继续完善。

特性

• 1.rpc : 采用 grpc 框架 实现 rpc 服务调用

• 2.api : 采用 gin 框架 实现RESTfull api

• 3.db : 采用 xorm 操作 mysql 实现分库,主从

• 4.package : 采用 glide 实现包管理

• 5.全文检索引擎 : 采用es 实现es的配置以及相关操作

目录结构

.
├── README.md
├── api                   Api 应用
│   ├── api.go            应用入口
│   ├── caches
│   ├── client
│   ├── controllers
│   ├── logs
│   ├── models
│   └── routers
├── conf                  配置
│   ├── conf.go
│   ├── conf_dev.toml
│   └── conf_pro.toml
├── core                  module
│   └── model.go
├── glide.lock
├── glide.yaml
├── pb                    protobuf 描述文件目录
│   ├── srvcomic.pb.go
│   ├── srvcomic.proto
│   └── srvnews.proto
├── rpc.go                RPC应用入口
├── service               服务
│   ├── register.go       服务注册
│   ├── srv-comic         
│   └── srv-news
├── utils                 工具函数
│   ├── utils_log.go
│   └── utils_string.go
└── vendor                第三方包

封装的内容

grpc部分

• 1.拦截器

  服务端: 可以理解成gin中的 middleware ,其他语言中的 hook。实现 异常的捕获，恢复防止程序意外退出。以及函数栈执行时间。

  客户端: 拦截器 执行时间, 连接池(虽然http2已经足够快保持长链接,这里也手动实现下)

• 2.trace

  利用golang 标准库 trace 来实现 服务调用的跟踪，如果想更详细的trace可以结合 zipkin。

• 3.mysql

  采用了xorm 实现通过主从可以操作多个数据库。

• 4.配置加载

  采用 toml 来对配置的解码,针对 开发环境 生产环境 加载不同配置

• 5.es

  es主从配置的封装等

api部分

• 1.middleware

  jwt 验证，recover 异常的捕获与恢复，防止程序退出。

  MVC 目录划分

  路由分组规划(私有以及公开路由)

数据表

只是简单的几个字段。

DROP TABLE IF EXISTS `comic_info`;

CREATE TABLE `comic_info` (
  `comic_id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `comic_name` varchar(32) NOT NULL DEFAULT '' COMMENT '名字',
  `status` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '1:正常2:关闭',
  `create_time` int(11) unsigned NOT NULL DEFAULT '0' COMMENT '时间',
  PRIMARY KEY (`comic_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='漫画';

LOCK TABLES `comic_info` WRITE;
/*!40000 ALTER TABLE `comic_info` DISABLE KEYS */;

INSERT INTO `comic_info` (`comic_id`, `comic_name`, `status`, `create_time`)
VALUES
	(1,'啊 啊啊啊',1,12121212),
	(2,'分水电费水电费',1,111110),
	(3,'吞吞吐吐',2,9999);

使用

前提是 对golang有所熟悉, 比如环境搭,工具链的使用。

1.git clone https://github.com/pzhen/golang-grpc-gin.git ./gogrpcgin 执行 glide up 将类包更新下来(需要vpn,你懂得)

2.将数据表导入mysql

3.然后修改配置文件中的数据库信息。

4.分别运行 go run rpc.go | go run api.go

5.访问 http://localhost:8080/rpc/comic/test 可以看到数据,命令行查看调用栈时间

可以手动抛出 panic ,来验证拦截器。