目录

统一Web服务框架讲解:

web-client&server

1. 一键生成神器

(1) 安装webcli120工具

(2) 一键生成WEB工程

2. 配置文件

(1) 切换环境：

(2) 配置文件 ichub-dev.yml

(3) 连接其它服务配置客户端

3. 前端服务路由配置：继承原来

4. godi依赖注入

(1) 编写代码：单例 basedto.BaseEntitySingle

(2) 编写代码：多实例 basedto.BaseEntity

(3) 执行生成goid注入代码：

5. 根据struct自动生成测试套

6. 编写WEB REST代码

创建一个接口文件,一个接口一个struct

7. 生成swagger

8. 运行服务

9. 执行Swagger

10. 测试代码 ：

(1) Webclient： WEB客户端

(2) ESWebClient: ES客户端

(3) RuleWebClient ： 规则引擎客户端

11. git路径

(1) ES客户端：简化版本

(2) WEB框架全集：

(3) ESSERVER统一搜索服务

(4) RULESERVER统一规则引擎服务

(5) 网站管理独立微服务

统一Web服务框架讲解: 

web-client&server

1. 
   

2. 概要

编辑

编辑

编辑

1. 
   

2. 一键生成神器

1. 
   

2. 安装webcli120工具

3. 
   

go install git.ichub.com/general/webcli120/cmd/webcli120

go get git.ichub.com/general/webcli120/cmd/webcli120

1. 
   

2. 
   

1. 
   

2. 一键生成WEB工程

3. 
   

3. 
   

4. 创建一个工程，有go.mod

go.mod添加replace google.golang.org/grpc => google.golang.org/grpc v1.26.0

编辑

1. 
   

2. 创建config文件

go get git.ichub.com/general/webcli120/cmd/webcli120

Webcli120 install config

编辑

1. 
   

2. 创建整个工程文件

Webcli120 install all

（func installAll(cmd *cobra.Command, args []string) {
    installConfig(cmd, args)
    installWebServer(cmd, args)
    installCmd(cmd, args)
    installDocker(cmd, args)
    installDocx(cmd, args)
    installTest(cmd, args)
}

编辑

1. 
   

2. 执行：

Go mod tidy

Goinstall.bat

编辑

1. 
   

2. 验证

awesomeProject stat:查询性能统计

编辑

1. 
   

2. 配置文件 

1. 
   

2. 切换环境：

3. 
   

Env: ${ICHUB_ENV:dev} 代表使用ichub-dev.yml配置

支持多个配置文件切换，

支持环境变量:

hosturl: ${ETCD_HOSTURL:192.168.27.27:2379}

Docker 容器配置ETCD_HOSTURL 则可修改配置

支持加密

password: ${ES_PASSWORD:enc(8CfGuLQ79iK6e6+UU/yXiA==)}

webcli120 enc 123456

8CfGuLQ79iK6e6+UU/yXiA==  -》enc(8CfGuLQ79iK6e6+UU/yXiA==)

支持指定服务地址：

  client:
    name: www.general.website.com
    testUrl: ${ICHUB_TESTURL:http://localhost:100}

指向配置的 url

    testUrl: #${ICHUB_TESTURL:http://localhost:100}

testUrl通过etcd注册中心查询www.general.website.com服务地址。

1. 
   

2. 
   

1. 
   

2. 配置文件 ichub-dev.yml

3. 
   

etcd:    环境切换只要改etcd,
  server:
    hosturl: ${ETCD_HOSTURL:192.168.27.27:2379}
 web: --配置
  server:  本服务server 配置
    name: ${WEB_SERVER_HOST:www.general.website.com}
    port: 100

  client: --本服务CLIENT配置
    name: ${WEB_CLIENT_HOST:www.general.website.com}
    testUrl: ${ICHUB_TESTURL:http://localhost:100}
    webTimeout: 30

  swagger: 本服务swagger配置
    enable: ${SWAGGER_ENABLE:true}
    host: ${SWAGGER_HOST:localhost:100}
    basePath: /
    version: v1.0
    title: ${SWAGGER_TITLE:网站管理服务-WebsiteServer}

1. 
   

2. 
   

1. 
   

2. 连接其它服务配置客户端

3. 
   

esclient: 连接esserver
  name: web.esserver.com
  testUrl: ${WEB_ESCLIENT_TESTURL:http://localhost:88}
  webTimeout: 30
ruleclient: 连接规则引擎
  name: web.ruleserver.com
  testUrl: ${WEB_RULECLIENT_TESTURL:http://localhost:89}
  webTimeout: 30

1. 
   

2. 前端服务路由配置：继承原来

general_website:

  name: www.general.website.com

  address: 0.0.0.0

  port: 100

  # 运行模式(debug:调试,test:测试,release:正式)

  runMode: debug

1. 
   

2. godi依赖注入

1. 
   

2. 编写代码：单例 basedto.BaseEntitySingle

3. 
   

type SingleEntity struct {
    basedto.BaseEntitySingle
    MultiBindNew *multi.MultiEntity `godi:"bind"`

    Id   int
    Name string
}
 

func NewSingleEntity() *SingleEntity {
    var s = &SingleEntity{
       Name: "single",
    }
    s.InitProxy(s)
    return s
}

1. 
   

2. 
   

1. 
   

2. 编写代码：多实例 basedto.BaseEntity

3. 
   

type MultiEntity struct {
    basedto.BaseEntity

    Id   int
    Name string

    myeentity *MyEntity `godi:"auto"`
}

func NewMultiEntity() *MultiEntity {
    var s = &MultiEntity{
       Name: "multi",
    }
    s.InitProxy(s)
    return s
}

1. 
   

2. 
   

1. 
   

2. 执行生成goid注入代码：

3. 
   

Webcli120 godi all

编辑

使用测试：多实例

func Test001_FindMulti(t *testing.T) { //var bean1 = FindBeanMultiEntity()

    var bean2 = FindBeanMultiEntity()
    var bean3 = FindBeanMultiEntity()
    bean2.Name = "123"
    logrus.Info(bean2, bean3)
    assert.Equal(t, bean3.Name != bean2.Name, true)

}

单实例

func Test002_FindSingle(t *testing.T) {

    var singleEntity = FindBeanSingleEntity()

    singleEntity.Name = "aaa"
    logrus.Info(singleEntity.ToPrettyString())
    var sa = FindBeanSingleEntity()
    var sb = FindBeanSingleEntity()
    sb.Name = "bbb"
    logrus.Info(singleEntity, sa, sb)
    assert.Equal(t, sa.Name == singleEntity.Name, true)
    assert.Equal(t, sb.Name == singleEntity.Name, true)

}

1. 
   

2. 根据struct自动生成测试套

 webcli120 suite ConfigAllFuncService

编辑

1. 
   

2. 编写WEB REST代码

Server/service目录创建一个目录如website

创建一个接口文件,一个接口一个struct

编辑

配置路由func (this *WebSiteFuncService) init() *WebSiteFuncService {
    this.WebGroupPath = "/raymond"
    this.InitRoute(this, http.MethodGet, "/website")
    return this
}

编写swagger 注释

// @Summary website
// @Tags       网站管理
// @Produce json
// @Success 200    {object}   basedto.IchubResult    "成功"
// @Failure 400    {object}   string          "请求错误"
// @Failure 500    {object}   string          "内部错误"
// @Router     /website [get]
func (this *WebSiteFuncService) Execute(c *gin.Context) {
    c.IndentedJSON(http.StatusOK, (&basedto.IchubResult{}).SuccessData("ok"))

}

注册

func Register() {
    NewWebSiteFuncService().Register()

}

router目录下总注册

func Register() *webserver.WebHandlers {

    file.Register()
    config.Register()
    gocenter.Register()
    website.Register()

    return funchandler.Build()
}

1. 
   

2. 生成swagger

进入server目录执行swagini.bat生成

编辑

1. 
   

2. 运行服务

Go mod tidy

Goinstall.bat

编辑

1. 
   

2. 执行Swagger

编辑

1. 
   

2. 测试代码 ：

编辑

1. 
   

2. 
   

1. 
   

2. Webclient： WEB客户端

3. 
   

func TestWebSuites(t *testing.T) {
    suite.Run(t, new(TestWebSuite))
}

// 每个测试运行前，会执行
func (suite *TestWebSuite) SetupTest() {
    ichublog.InitLogrus()
    fileutils.FindRootDir()
    logrus.Info("SetupTest")

    var config = ichubconfig.Default()
    clientDto := config.ReadIchubWebClient()
    suite.webclient = webclient.New(clientDto)
    suite.statwebcli = webclient.DefaultStat()

}

func (suite *TestWebSuite) Test0001_WebClient() {
    logrus.Info(suite.webclient)

    var result = suite.webclient.Get("")
    logrus.Info(result)

}

1. 
   

2. 
   

1. 
   

2. ESWebClient: ES客户端

3. 
   

go get -u gitlab.ichub.com/general/esserver

Goinstall.bat

编辑

通用查询

func (this *TestWebQuerySuite) Test003_ShouldQueryDept() {
    var queryRequest = pagereq.NewQueryRequest()
    queryRequest.PageSize = 2
    queryRequest.IndexName = "ichub_sys_dept"
    queryRequest.EsTerms("dept_name", "若依科技", "kl")
    queryRequest.EsTerms("dept_name", "若依科技", "kl")
    queryRequest.Source = "dept_id,dept_name,order_nm,create_time"
    queryRequest.OrderByDesc("create_time")

    var result = this.EsWebClient.Should(queryRequest).As(&[]*model.SysDept{})

    queryRequest.Save2File(queryRequest, result)
    logrus.Info(result)
    //check
    this.Equal(200, result.Code)

}

执行结果

编辑

1. 
   

2. 
   

1. 
   

2. RuleWebClient ： 规则引擎客户端

3. 
   

go get -u gitlab.ichub.com/general/ruleserver

Goinstall.bat

编辑

动态执行规则脚本

编辑

1. 
   

2. git路径

1. 
   

2. ES客户端：简化版本

3. 
   

http://git.ichub.com/general/webcli.git

1. 
   

2. 
   

1. 
   

2. WEB框架全集：

3. 
   

http://git.ichub.com/general/webcli120.git

1. 
   

2. 
   

1. 
   

2. ESSERVER统一搜索服务

3. 
   

http://raymond@192.168.27.35/ichub2/esserver.git

1. 
   

2. 
   

1. 
   

2. RULESERVER统一规则引擎服务

3. 
   

http://raymond@192.168.27.35/ichub2/ruleserver.git

1. 
   

2. 
   

1. 
   

2. 网站管理独立微服务

3. 
   

http://raymond@192.168.27.35/general/website-management.git

vv