Gearman-Go 使用指南

梅琛卿

于 2024-09-15 07:34:18 发布

阅读量667

点赞数 20

本文链接：https://blog.csdn.net/gitblog_00539/article/details/142271668

版权

Gearman-Go 使用指南

gearman-go This package is a Gearman API for Golang. It was implemented a native protocol for both worker and client API. 项目地址: https://gitcode.com/gh_mirrors/ge/gearman-go

项目介绍

Gearman-Go 是一个专为 Go 语言设计的 Gearman API 实现。它通过原生协议支持工作进程（worker）与客户端（client）两端的完整交互。该库分为两部分：客户端用于向 Gearman 作业服务器发送任务并接收响应；而工作者包则简化了 Gearman 工作者服务的开发过程。该项目遵循 MIT 许可证，保证了其在开放源代码社区中的自由度。

项目快速启动

安装

首先，确保您的 Go 环境已设置好。然后，可以通过以下命令安装 Gearman-Go 的客户端和工作者包：

$ go get github.com/mikespook/gearman-go/client
$ go get github.com/mikespook/gearman-go/worker

示例

工作者(Worker)端

创建一个简单的工作者来处理 ToUpper 任务，将输入字符串转换为大写：

package main

import (
    "log"
    "github.com/mikespook/gearman-go/worker"
)

func ToUpper(data []byte, _ worker.Job) ([]byte, error) {
    return []byte(string(data)), nil
}

func main() {
    w := worker.New(worker.OneByOne)
    w.ErrHandler = func(e error) { log.Println(e) }
    w.AddServer("127.0.0.1:4730")
    w.AddFunc("ToUpper", ToUpper, worker.Unlimited)
    
    if err := w.Ready(); err != nil {
        log.Fatal(err)
        return
    }

    // 开始监听并处理任务
    go w.Work()
}

客户端(Client)端

使用客户端发送一个任务到 Gearman 作业服务器，并等待结果：

package main

import (
    "fmt"
    "log"
    "github.com/mikespook/gearman-go/client"
)

func main() {
    c, err := client.New("tcp4", "127.0.0.1:4730")
    if err != nil {
        log.Fatal(err)
    }
    defer c.Close()

    c.ErrorHandler = func(e error) { log.Println(e) }

    data := []byte("hello world")
    var result []byte
    err = c.Do("ToUpper", data, client.JobNormal, func(resp *client.Response) {
        result = resp.Data
    })
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(string(result))
}

确保你的 Gearman 服务正在运行中，上述代码才能正常运作。