go-micro v2 hello-micro

go-micro v2入门到精通—1

使用go-micro 创建第一个web api

实现代码如下：

package main

import (
	"github.com/micro/go-micro/v2/web"
	"net/http"
)

func main(){
	server :=  web.NewService(web.Address(":8777"))
	server.HandleFunc("/", func(writer http.ResponseWriter, request *http.Request) {
		writer.Write([]byte("hello world"))
	})
	server.Run()
}

运行之后打开浏览器：访问 http://127.0.0.1:8777/ 我们会看见页面输出 hello word

引入gin框架生成web api

在我们项目中使用 micro 提供的API 服务来做项目，而gin框架作为web服务器的热门框架相对于灵活很多。

package main

import (
	"github.com/gin-gonic/gin"
	"github.com/micro/go-micro/v2/web"
)

func main(){
//声明gin web路由
	router := gin.Default()
	router.Handle("GET","/news", func(context *gin.Context) {
		context.String(200,"news hello")
	})
	router.Handle("GET","/test", func(context *gin.Context) {
		context.String(200,"test hello")
	})
	//添加处理gin路由
	server :=  web.NewService(web.Address(":8777"),web.Handler(router))
	server.Run()
}

consul服务发现治理

首先我们来看以下这张图片

图中，客户端的一个接口，需要调用服务A-N。客户端必须要知道所有服务的网络位置的，以往的做法是配置是配置文件中，或者有些配置在数据库中。这里就带出几个问题：

• 需要配置N个服务的网络位置，加大配置的复杂性
• 服务的网络位置变化，都需要改变每个调用者的配置
• 集群的情况下，难以做负载（反向代理的方式除外）
  总结起来一句话：服务多了，配置很麻烦，问题多多。

既然有这些问题，那么服务发现就是解决这些问题的。话说，怎么解决呢？我们再看一张图

与之前一张不同的是，加了个服务发现模块。图比较简单，这边文字描述下。服务A-N把当前自己的网络位置注册到服务发现模块（这里注册的意思就是告诉），服务发现就以K-V的方式记录下，K一般是服务名，V就是IP:PORT。服务发现模块定时的轮询查看这些服务能不能访问的了（这就是健康检查）。客户端在调用服务A-N的时候，就跑去服务发现模块问下它们的网络位置，然后再调用它们的服务。这样的方式是不是就可以解决上面的问题了呢？客户端完全不需要记录这些服务网络位置，客户端和服务端完全解耦！
这个过程大体是这样，当然服务发现模块没这么简单。里面包含的东西还很多。这样表述只是方便理解。

consul 安装

consul官网: 传送门.

启动consul

consul agent -dev -client=0.0.0.0

consul 实现服务治理

具体的安装以及启动过程我就不做赘述了，可自行百度。
服务端代码实现

package  main

import (
	"fmt"
	"github.com/gin-gonic/gin"
	"github.com/micro/go-micro/v2/registry"
	"github.com/micro/go-micro/v2/web"
	"github.com/micro/go-plugins/registry/consul/v2"
)

func main()  {
	router := gin.Default()
	router.Handle("POST","/news", func(context *gin.Context) {
		context.JSON(200,gin.H{
			"data":"index",
		})
	})
	registry := consul.NewRegistry(registry.Addrs("127.0.0.1:8500"))
	server := web.NewService(
		web.Name("helloworld"),
		//web.Address(":8082"),
		web.Handler(router),
		web.Registry(registry),
		web.Metadata(map[string]string{"protocol" : "http"}),//需要声明协议，否则导致无法调用
		)
	server.Init() //使用Init 函数 可接收flags参数
	err := server.Run()
	fmt.Println(err)
}

这里为了更好的演示效果，我们分别开启3个服务，编写run.bat 写入以下代码

@echo off
start "server1" go run main.go --server_address :8001 &
start "server2" go run main.go --server_address :8002 &
start "server3" go run main.go --server_address :8003
pause

直接双击执行，我们在consul的web管理中，可以看到有3个服务实例

现在我们再来编写服务发现端,服务发现端，只是做了一个流量转发而已。

package main

import (
	"context"
	"encoding/json"
	"github.com/micro/go-micro/v2/client"
	"github.com/micro/go-micro/v2/client/selector"
	"github.com/micro/go-micro/v2/registry"
	"github.com/micro/go-micro/v2/web"
	microhttp "github.com/micro/go-plugins/client/http/v2"
	"github.com/micro/go-plugins/registry/consul/v2"
	"io"
	"io/ioutil"
	"net/http"
	"strings"
)

func main()  {
	cr := consul.NewRegistry(registry.Addrs("127.0.0.1:8500"))
	st := selector.NewSelector(
			selector.Registry(cr),
			selector.SetStrategy(selector.RoundRobin),
		)
	server := web.NewService(web.Address(":8777"))
	server.HandleFunc("/news", func(writer http.ResponseWriter, request *http.Request) {
		resps,_ := callByGoPlugin(st,"/news")
		res,_ := json.Marshal(resps)
		writer.Write(res)
	})
	server.Run()
}

func callByGoPlugin(s selector.Selector,path string) (map[string]interface{}, error) {
	// 1. 调用`go-plugins/client/http`包的函数获取它们提供的httpClient
	gopluginClient := microhttp.NewClient(
		client.Selector(s),                     // 传入上面的selector
		client.ContentType("application/json"), // 指定contentType
	)
	// 2. 新建请求对象，传入: (1)服务名 (2)endpoint (3)请求参数
	req := gopluginClient.NewRequest("helloworld", path, nil)
	
	// 3. 新建响应对象，并call请求，获取响应
	var resp map[string]interface{}
	err := gopluginClient.Call(context.Background(), req, &resp)
	if err != nil {
		return nil, err
	}
	return resp, nil
}

func RequestApi(method string, host string, path string, body io.Reader) (string, error) {
	// 1.如果没有http开头就给它加一个
	if !strings.HasPrefix(host, "http://") && !strings.HasPrefix(host, "https://") {
		host = "http://" + host
	}
	// 2. 新建一个request
	req, _ := http.NewRequest(method, host+path, body)

	// 3. 新建httpclient，并且传入request
	client := http.DefaultClient
	res, err := client.Do(req)
	if err != nil {
		return "", err
	}

	defer res.Body.Close()

	// 4. 获取请求结果
	buff, err := ioutil.ReadAll(res.Body)
	if err != nil {
		return "", err
	}

	return string(buff), nil
}