Go gRPC 系列七：让服务同时提供 HTTP 接口

前言

你们好，我是煎鱼，不知道你有没有想过以下问题：

• 接口须要提供给其余业务组访问，可是 RPC 协议不一样没法内调，对方问可否走 HTTP 接口，怎么办？

• 微信（公众号、小程序）等第三方回调接口只支持 HTTP 接口，怎么办

我相信你在实际工做中都会遇到如上问题，在 gRPC 中都是能够找到其它解决方案的，本章节将会进行介绍。

为何能够同时提供 HTTP 接口

关键一点，gRPC 的协议是基于 HTTP/2 的，所以应用程序可以在单个 TCP 端口上提供 HTTP/1.1 和 gRPC 接口服务（两种不一样的流量）

怎么同时提供 HTTP 接口

检测协议

if r.ProtoMajor == 2 && strings.Contains(r.Header.Get("Content-Type"), "application/grpc") {
    server.ServeHTTP(w, r)
} else {
    mux.ServeHTTP(w, r)
}
复制代码

流程

1. 检测请求协议是否为 HTTP/2
2. 判断 Content-Type 是否为 application/grpc（gRPC 的默认标识位）
3. 根据协议的不一样转发到不一样的服务处理

gRPC

TLS

在前面的章节，为了便于展现所以没有简单封装

在本节需复用代码，从新封装了，可详见：go-grpc-example

目录结构

新建 simple_http_client、simple_http_server 目录，目录结构以下：

go-grpc-example
├── client
│   ├── simple_client
│   ├── simple_http_client
│   └── stream_client
├── conf
├── pkg
│   └── gtls
├── proto
├── server
│   ├── simple_http_server
│   ├── simple_server
│   └── stream_server
复制代码

Server

在 simple_http_server 目录下新建 server.go，写入文件内容：

package main

import (
	"context"
	"log"
	"net/http"
	"strings"

	"github.com/EDDYCJY/go-grpc-example/pkg/gtls"
	pb "github.com/EDDYCJY/go-grpc-example/proto"

	"google.golang.org/grpc"
)

type SearchService struct{}

func (s *SearchService) Search(ctx context.Context, r *pb.SearchRequest) (*pb.SearchResponse, error) {
	return &pb.SearchResponse{Response: r.GetRequest() + " HTTP Server"}, nil
}

const PORT = "9003"

func main() {
	certFile := "../../conf/server/server.pem"
	keyFile := "../../conf/server/server.key"
	tlsServer := gtls.Server{
		CertFile: certFile,
		KeyFile:  keyFile,
	}

	c, err := tlsServer.GetTLSCredentials()
	if err != nil {
		log.Fatalf("tlsServer.GetTLSCredentials err: %v", err)
	}

	mux := GetHTTPServeMux()

	server := grpc.NewServer(grpc.Creds(c))
	pb.RegisterSearchServiceServer(server, &SearchService{})

	http.ListenAndServeTLS(":"+PORT,
		certFile,
		keyFile,
		http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
			if r.ProtoMajor == 2 && strings.Contains(r.Header.Get("Content-Type"), "application/grpc") {
				server.ServeHTTP(w, r)
			} else {
				mux.ServeHTTP(w, r)
			}

			return
		}),
	)
}

func GetHTTPServeMux() *http.ServeMux {
	mux := http.NewServeMux()
	mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("eddycjy: go-grpc-example"))
	})

	return mux
}
复制代码

• http.NewServeMux：建立一个新的 ServeMux，ServeMux 本质上是一个路由表。它默认实现了 ServeHTTP，所以返回 Handler 后可直接经过 HandleFunc 注册 pattern 和处理逻辑的方法
• http.ListenAndServeTLS：可简单的理解为提供监听 HTTPS 服务的方法，重点的协议判断转发，也在这里面

其实，你理解后就会以为很简单，核心步骤：判断 -> 转发 -> 响应。咱们改变了前两步的默认逻辑，仅此而已

Client

在 simple_http_server 目录下新建 client.go，写入文件内容：

package main

import (
	"context"
	"log"

	"google.golang.org/grpc"

	"github.com/EDDYCJY/go-grpc-example/pkg/gtls"
	pb "github.com/EDDYCJY/go-grpc-example/proto"
)

const PORT = "9003"

func main() {
	tlsClient := gtls.Client{
		ServerName: "go-grpc-example",
		CertFile:   "../../conf/server/server.pem",
	}
	c, err := tlsClient.GetTLSCredentials()
	if err != nil {
		log.Fatalf("tlsClient.GetTLSCredentials err: %v", err)
	}

	conn, err := grpc.Dial(":"+PORT, grpc.WithTransportCredentials(c))
	if err != nil {
		log.Fatalf("grpc.Dial err: %v", err)
	}
	defer conn.Close()

	client := pb.NewSearchServiceClient(conn)
	resp, err := client.Search(context.Background(), &pb.SearchRequest{
		Request: "gRPC",
	})
	if err != nil {
		log.Fatalf("client.Search err: %v", err)
	}

	log.Printf("resp: %s", resp.GetResponse())
}
复制代码

验证

gRPC Client

$ go run client.go 
2018/10/04 14:56:56 resp: gRPC HTTP Server
复制代码

HTTP/1.1 访问

总结

经过本章节，表面上完成了同端口提供双服务的功能，但实际上，应该是加深了 HTTP/2 的理解和使用，这才是本质

问题

你觉得这个方案就万能了吗，不。Envoy Proxy 的支持就不完美，没法同时监听一个端口的两种流量。

？

若是有任何疑问或错误，欢迎在 issues 进行提问或给予修正意见，若是喜欢或对你有所帮助，欢迎 Star，对做者是一种鼓励和推动。

个人公众号

参考

本系列示例代码

• go-grpc-example