Moleculer Go 项目教程

Moleculer Go 项目教程

moleculer 🚀 Progressive microservices framework for Go - based and compatible with https://github.com/moleculerjs/moleculer 项目地址: https://gitcode.com/gh_mirrors/mol/moleculer

1. 项目的目录结构及介绍

Moleculer Go 项目的目录结构如下：

moleculer-go/
├── broker/
├── cache/
├── cli/
├── context/
├── examples/
├── metrics/
├── middleware/
├── payload/
├── registry/
├── serializer/
├── service/
├── strategy/
├── test/
├── transit/
├── util/
├── version/
├── drone.yml
├── .gitignore
├── travis.yml
├── Dockerfile
├── LICENSE
├── README.md
├── go.mod
├── go.sum
└── moleculer.go

目录介绍：

• broker/: 包含与服务代理相关的代码。
• cache/: 包含缓存相关的代码。
• cli/: 包含命令行接口相关的代码。
• context/: 包含上下文相关的代码。
• examples/: 包含项目的示例代码。
• metrics/: 包含度量相关的代码。
• middleware/: 包含中间件相关的代码。
• payload/: 包含负载相关的代码。
• registry/: 包含服务注册相关的代码。
• serializer/: 包含序列化相关的代码。
• service/: 包含服务相关的代码。
• strategy/: 包含策略相关的代码。
• test/: 包含测试相关的代码。
• transit/: 包含传输相关的代码。
• util/: 包含工具类相关的代码。
• version/: 包含版本相关的代码。
• drone.yml: Drone CI 配置文件。
• .gitignore: Git 忽略文件配置。
• travis.yml: Travis CI 配置文件。
• Dockerfile: Docker 构建文件。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• go.mod: Go 模块依赖文件。
• go.sum: Go 模块依赖校验文件。
• moleculer.go: 项目的启动文件。

2. 项目的启动文件介绍

项目的启动文件是 moleculer.go。该文件是 Moleculer Go 框架的入口文件，负责初始化服务代理并启动服务。

主要功能：

• 初始化服务代理（Broker）。
• 注册服务。
• 启动服务代理。
• 调用服务方法并处理返回结果。

示例代码：

package main

import (
    "fmt"
    "github.com/moleculer-go/moleculer"
    "github.com/moleculer-go/moleculer/broker"
)

type MathService struct {}

func (s *MathService) Name() string {
    return "math"
}

func (s *MathService) Add(params moleculer.Payload) int {
    return params.Get("a").Int() + params.Get("b").Int()
}

func main() {
    var bkr = broker.New(&moleculer.Config{LogLevel: "error"})
    bkr.Publish(&MathService{})
    bkr.Start()

    result := <-bkr.Call("math.add", map[string]int{"a": 10, "b": 130})
    fmt.Println("result:", result.Int())
    // result: 140

    bkr.Stop()
}

3. 项目的配置文件介绍

Moleculer Go 项目的配置文件主要是 moleculer.go 文件中的 Config 结构体。该结构体定义了服务代理的配置选项。

主要配置项：

• LogLevel: 日志级别，例如 "error", "info", "debug" 等。
• Transporter: 传输协议配置，例如 "TCP", "NATS" 等。
• Serializer: 序列化配置，例如 "JSON", "MsgPack" 等。
• Registry: 服务注册配置，例如心跳间隔、超时时间等。

示例配置：

var config = &moleculer.Config{
    LogLevel: "error",
    Transporter: "TCP",
    Serializer: "JSON",
    Registry: moleculer.RegistryConfig{
        HeartbeatInterval: 5 * time.Second,
        HeartbeatTimeout:  15 * time.Second,
    },
}

通过以上配置，可以灵活地调整 Moleculer Go 服务的运行参数，以适应不同的应用场景。

moleculer 🚀 Progressive microservices framework for Go - based and compatible with https://github.com/moleculerjs/moleculer 项目地址: https://gitcode.com/gh_mirrors/mol/moleculer