go笔记--rpc和grpc使用

go笔记--rpc和grpc使用
- rpc
- grpc

rpc

RPC(Remote Procedure Call，远程过程调用)是一种通过网络从远程计算机程序上请求服务，而不需要了解底层网络细节的应用程序通信协议。RPC协议构建于TCP或UDP,或者是HTTP上。允许开发者直接调用另一台服务器上的程序，而开发者无需另外的为这个调用过程编写网络通信相关代码，使得开发网络分布式程序在内的应用程序更加容易

RPC采用客户端-服务器端的工作模式，请求程序就是一个客户端，而服务提供程序就是一个服务器端。当执行一个远程过程调用时，客户端程序首先先发送一个带有参数的调用信息到服务端，然后等待服务端响应。在服务端，服务进程保持睡眠状态直到客户端的调用信息到达。当一个调用信息到达时，服务端获得进程参数，计算出结果，并向客户端发送应答信息。然后等待下一个调用。

在Go中，标准库提供的net/rpc包提供了通过网络或其他I/O连接对一个对象的导出方法的访问。服务端注册一个对象，使它作为一个服务被暴露，服务的名字是该对象的类型名。注册之后，对象的导出方法就可以被远程访问。服务端可以注册多个不同类型的对象（服务），但注册具有相同类型的多个对象是错误的。

只有满足如下标准的方法才能用于远程访问，其余方法会被忽略：

--

方法是导出的
方法有两个参数，都是导出类型或内建类型
方法的第二个参数是指针
方法只有一个error接口类型的返回值

也就是说，方法必须看起来像这样：

func (t *T) MethodName(argType T1, replyType *T2) error

其中T、T1和T2都能被encoding/gob包序列化。这些限制即使使用不同的编解码器也适用。（未来，对定制的编解码器可能会使用较宽松一点的限制）

方法的第一个参数代表调用者提供的参数；第二个参数代表返回给调用者的参数。方法的返回值，如果非nil，将被作为字符串回传，在客户端看来就和errors.New创建的一样。如果返回了错误，回复的参数将不会被发送给客户端。

服务端可能会单个连接上调用ServeConn管理请求。更典型地，它会创建一个网络监听器然后调用Accept；或者，对于HTTP监听器，调用HandleHTTP和http.Serve。

想要使用服务的客户端会创建一个连接，然后用该连接调用NewClient。

更方便的函数Dial（DialHTTP）会在一个原始的连接（或HTTP连接）上依次执行这两个步骤。

生成的Client类型值有两个方法，Call和Go，它们的参数为要调用的服务和方法、一个包含参数的指针、一个用于接收接个的指针。

Call方法会等待远端调用完成，而Go方法异步的发送调用请求并使用返回的Call结构体类型的Done通道字段传递完成信号。

除非设置了显式的编解码器，本包默认使用encoding/gob包来传输数据。

一个简单的例子。一个服务端想要导出Arith类型的一个对象：

server.go

package main
import (
    //"fmt"
    "log"
    "net"
    "net/http"
    "net/rpc"
    //"os"
	//"time"
	"errors"
)
type Args struct {
	A, B int
}
type Quotient struct {
	Quo, Rem int
}
type Arith int
//乘
func (t *Arith) Multiply(args *Args, reply *int) error {
	*reply = args.A * args.B
	return nil
}
//除
func (t *Arith) Divide(args *Args, quo *Quotient) error {
	if args.B == 0 {
		return errors.New("divide by zero")
	}
	quo.Quo = args.A / args.B
	quo.Rem = args.A % args.B
	return nil
}
func main() {
	arith := new(Arith)
	rpc.Register(arith)
	rpc.HandleHTTP()
	l, e := net.Listen("tcp", ":1234")
	if e != nil {
		log.Fatal("listen error:", e)
	}
	http.Serve(l, nil)
}

client.go (sync)

package main
import (
    "fmt"
    "log"
    "net/rpc"
    //"time"
)
type Args struct {
    A, B int
}
func main() {
	client, err := rpc.DialHTTP("tcp", "127.0.0.1:1234")
	if err != nil {
		log.Fatal("dialing:", err)
	}
	// Synchronous call
	args := &Args{7,8}
	var reply int
	err = client.Call("Arith.Multiply", args, &reply)
	if err != nil {
		log.Fatal("arith error:", err)
	}
	fmt.Printf("Arith: %d*%d=%d", args.A, args.B, reply)
}

client.go (async)

package main
import (
    "fmt"
    "log"
    "net/rpc"
    //"time"
)
type Args struct {
    A, B int
}
type Quotient struct {
	Quo, Rem int
}
func main() {
	client, err := rpc.DialHTTP("tcp", "127.0.0.1:1234")
	if err != nil {
		log.Fatal("dialing:", err)
	}
	// Synchronous call
	/*args := &Args{7,8}
	var reply int
	err = client.Call("Arith.Multiply", args, &reply)
	if err != nil {
		log.Fatal("arith error:", err)
	}
	fmt.Printf("Arith: %d*%d=%d", args.A, args.B, reply)*/
	// Asynchronous call
	args := &Args{10,3}
	quotient := new(Quotient)
	divCall := client.Go("Arith.Divide", args, quotient, nil)
	replyCall := <-divCall.Done	// will be equal to divCall
	// check errors, print, etc.
	fmt.Println(replyCall.Reply)
}

grpc

gRPC是一个可以在任何环境中运行的现代开源高性能RPC框架。增加了很多扩展接口，例如：可插拔的负载平衡、跟踪、健康体检和身份验证等等。

gRPC默认使用protocol buffers，它是google开源的一套成熟的结构数据序列化机制（当然也可以使用其他数据格式如JSON），可以用proto files创建gRPC服务，用protocol buffers消息类型来定义方法参数和返回类型。

在gRPC客户端可以直接调用不通服务器上的远程程序，就想调用本地程序一样，很容易构建分布式应用和服务。和很多RPC系统一样，服务负责实现定义好的接口并处理客户端请求，客户端根据接口描述直接调用需要的服务。客户端和服务器可以分别使用gRPC支持的不同语言实现。

初次接触就先简单理解为 google rpc 吧。

protobuf 本文就不讲了，直接上例子。

protoc

syntax = "proto3"; //proto版本
package proto;
//请求message
message HelloReq{
    string req=1;
}
//响应message
message HelloRep{
    string rep=1;
}
//Hello服务
service Hello{
    //定义服务中的方法
    rpc SayHello(HelloReq)returns (HelloRep){}
}

生成 pb.go

目录结构

go mod 老找不到pb.go 就只好放各自文件下了，注意正常是放在公共文件下的。

go get -u google.golang.org/grpc

server.go

package main
import (
    pb "serv/protoc"
    "net"
	"log"
    "golang.org/x/net/context"
    "google.golang.org/grpc"
)
//定义一个helloServer并实现约定的接口
type helloService struct{}
func (h helloService) SayHello(ctx context.Context, in *pb.HelloReq) (*pb.HelloRep, error) {
    resp := new(pb.HelloRep)
    resp.Rep = "reply : " + in.Req
    return resp, nil
}
var HelloServer = helloService{}
func main() {
    listen, err := net.Listen("tcp", "127.0.0.1:1234")
    if err != nil {
        log.Fatal("failed to listen")
    }
    //实现gRPC Server
    serv := grpc.NewServer()
    //注册helloServer为客户端提供服务
    pb.RegisterHelloServer(serv, HelloServer) //内部调用了s.RegisterServer()
    serv.Serve(listen)
}

client.go

package main
import (
    "fmt"
    pb "cli/protoc"
    "golang.org/x/net/context"
    "google.golang.org/grpc"
)
const (
    Address = "127.0.0.1:50052"
)
func main() {
	conn, err := grpc.Dial("127.0.0.1:1234", grpc.WithInsecure())
    if err != nil {
        fmt.Println(err)
    }
    defer conn.Close()
    //初始化客户端
    c := pb.NewHelloClient(conn)
    req := new(pb.HelloReq)
    req.Req = "hello"
    r, err := c.SayHello(context.Background(), req)
    if err != nil {
		fmt.Println(err)
		return
    }
    fmt.Println(r.Rep)
}