Dubbo-go 协议快速开始

Mon, 01 Jan 0001 00:00:00 +0000

此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档，请参阅最新版本。

Dubbo-go 协议快速开始

1. 环境安装

1.1 安装 Go 语言环境

建议使用最新版 go 1.17

go version >= go 1.15

【Go 语言官网下载地址】

构建如下文件目录，使用命令 go mod init dubbo3-demo 初始化 go module。

quickstart
├── api
│   └── api.go
├── client
│   ├── client.go
│   └── dubbogo.yml
├── go.mod
└── server
 ├── dubbogo.yml
 └── server.go

1.2 启动zookeeper

选择您喜欢的方式启动zk，如您安装docker-compose可直接从文件启动:

zookeeper.yml:

version: '3'
services:
 zookeeper:
 image: zookeeper
 ports:
 - 2181:2181
 restart: on-failure

docker-compose -f ./zookeeper.yml up -d

2. 编写客户端服务端的接口和实现

2.1 定义接口和传输结构，位于api/api.go

package api

import (
	"context"
	"dubbo.apache.org/dubbo-go/v3/config"
	hessian "github.com/apache/dubbo-go-hessian2"
	"time"
)

//1. 定义传输结构， 如需 Java 互通，字段需要与 Java 侧对应，首字母大写
type User struct {
	ID string
	Name string
	Age int32
	Time time.Time
}

func (u *User) JavaClassName() string {
	return "org.apache.dubbo.User" // 如果与 Java 互通，需要与 Java 侧 User class全名对应,
}


var (
	UserProviderClient = &UserProvider{} // 客户端指针
)

// 2。 定义客户端存根类：UserProvider
type UserProvider struct {
	// dubbo标签，用于适配go侧客户端大写方法名 -> java侧小写方法名，只有 dubbo 协议客户端才需要使用
	GetUser func(ctx context.Context, req int32) (*User, error) //`dubbo:"getUser"`
}

func init(){
	hessian.RegisterPOJO(&User{}) // 注册传输结构到 hessian 库
	// 注册客户端存根类到框架，实例化客户端接口指针 userProvider
	config.SetConsumerService(UserProviderClient)
}

2.2 编写 Go-Server 配置和代码

server/dubbogo.yml

Triple 协议快速开始

Mon, 01 Jan 0001 00:00:00 +0000

此文档已经不再维护。您当前查看的是快照版本。如果想要查看最新版本的文档，请参阅最新版本。

Triple 协议快速开始

1. 环境安装

1.1 安装Go语言环境

建议使用最新版 go 1.17

go version >= go 1.15

【Go 语言官网下载地址】

将 $GOPATH/bin 加入环境变量

1.2 安装序列化工具protoc

【protoc 下载地址】

1.3 安装 protoc-gen-go, proto-gen-go-triple 编译插件

本章 quick start 按照最新版示例和组件进行介绍。

依赖	Dubbo-go	Triple	protoc-gen-go-triple
适配版本号	v3.0.0-rc4-1	v1.1.3	v1.0.2
适配版本号	v3.0.0-rc3	v1.0.9	v1.0.0

export GO111MODULE="on"
export GOPROXY="https://goproxy.cn"
go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.26.0
go install github.com/dubbogo/tools/cmd/protoc-gen-go-triple@v1.0.2

确保上述protoc 和安装的 protoc-gen-go-triple 位于$(GOPATH)/bin, 在系统环境变量内

$ protoc --version
libprotoc 3.14.0
$ protoc-gen-go --version
protoc-gen-go v1.26.0
$ protoc-gen-go-triple --version
protoc-gen-go-triple 1.0.2

1.4 启动zookeeper

选择您喜欢的方式启动zk，如您安装docker-compose可直接从文件启动:

快速开始 on Apache Dubbo

Dubbo-go 协议快速开始

Dubbo-go 协议快速开始

1. 环境安装

1.1 安装 Go 语言环境

1.2 启动zookeeper

2. 编写客户端服务端的接口和实现

2.1 定义接口和传输结构，位于api/api.go

2.2 编写 Go-Server 配置和代码

Triple 协议快速开始

Triple 协议快速开始

1. 环境安装

1.1 安装Go语言环境

1.2 安装序列化工具protoc

1.3 安装 protoc-gen-go, proto-gen-go-triple 编译插件

1.4 启动zookeeper