Reference Manual on Apache Dubbo

Ecosystem Components

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

Dubbo-go

github.com/apache/dubbo-go

The main repository for Apache Dubbo Go language implementation

Dubbo-go-samples

github.com/apache/dubbo-go-samples

Usage examples of dubbo-go:

config-api: Configuration initialization using APIs
configcenter: Using different configuration centers, currently supporting three: zookeeper, apollo, and nacos
context: How to use context to pass attachment
direct: Direct connection mode
game: Game service example
generic: Generic invocation
rpc: RPC invocation examples, including Triple, Dubbo, and cross-language/gRPC communication examples
helloworld: Introduction to RPC invocation example
logger: Logging example
registry: Demonstrates integration with different registration centers, including zk, nacos, etcd
metrics: Data reporting
filter: Examples using provided filters and custom filters
registry/servicediscovery: Application-level service discovery example
router: Routing example
tracing: Link tracing example

Dubbo-go-pixiu

github.com/apache/dubbo-go-pixiu

Generic Invocation

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

Deprecation Warning

dubbo-go generic invocation is only applicable to the dubbo2 protocol, not the triple protocol

Generic invocation is a special way of calling in Dubbo-Go that allows intermediary nodes to pass call information without interface information, commonly used in testing and gateway scenarios. Generic invocation supports both Dubbo and Triple protocols, but currently, the serialization scheme only supports Hessian.

Background

For better understanding, this document introduces generic invocation with a gateway usage scenario. Let’s first consider a normal invocation (non-generic invocation). The diagram below includes two key roles: consumer and provider (hereinafter referred to as endpoint, representing either a consumer or a provider), each having a definition of the org.apache.dubbo.sample.User interface. Suppose the org.apache.dubbo.sample.User interface needs to be used in the calling behavior.

Using the dubbogo-cli Tool

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

Deprecation Warning

Starting from version 3.1.0 of dubbo-go, this tool is no longer applicable. This tool has been discontinued and will be replaced by dubboctl in the future. Please stay updated with community news to learn about the latest developments of dubboctl.

1. Installation

dubbogo-cli is a subproject of the Apache/dubbo-go ecosystem, providing convenient application template creation, tool installation, interface debugging, and other functions to improve developer efficiency.

To install dubbogo-cli to $GOPATH/bin, run the following command:

Using Nacos as a Registry

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

1. Preparation

The dubbo-go CLI tool and dependencies are installed
Create a new demo application

2. Using grpc_cli Tool for Dubbo Service Debugging

2.1 Start the Server

Example: user.go:

func (u *UserProvider) GetUser(ctx context.Context, userStruct *CallUserStruct) (*User, error) {
	fmt.Printf("=======================\nreq:%#v\n", userStruct)
	rsp := User{"A002", "Alex Stocks", 18, userStruct.SubInfo}
	fmt.Printf("=======================\nrsp:%#v\n", rsp)
	return &rsp, nil
}

The server exposes a service named GetUser, taking a CallUserStruct parameter and returning a User parameter.
Definition of CallUserStruct parameter:

type CallUserStruct struct {
	ID string
	Male bool
	SubInfo SubInfo // Nested substructure
}
func (cs CallUserStruct) JavaClassName() string {
	return "com.ikurento.user.CallUserStruct"
}

type SubInfo struct {
	SubID string
	SubMale bool
	SubAge int
}

func (s SubInfo) JavaClassName() string {
	return "com.ikurento.user.SubInfo"
}

Definition of User structure: