入門から熟練度まで: Go-Zero フレームワークをマスターする-Golang-php.cn

Go-zero は、RPC、キャッシュ、スケジュールされたタスク、その他の機能を含む、完全なソリューションセットを提供する優れた Go 言語フレームワークです。実際、go-zero を使用して高パフォーマンスのサービスを構築するのは非常に簡単で、数時間で初心者から熟練者になることもできます。

この記事は、go-zero フレームワークを使用して高パフォーマンスのサービスを構築するプロセスを紹介し、読者がフレームワークの核となる概念をすぐに理解できるようにすることを目的としています。

1. インストールと構成

go-zero の使用を開始する前に、go-zero をインストールし、必要な環境をいくつか構成する必要があります。

1. インストール

go-zero のインストールは非常に簡単で、次のコマンドを実行するだけです:

$ go get -u github.com/tal-tech/go-zero

ログイン後にコピー

これにより、GitHub から go-zero の最新バージョンが自動的にダウンロードされます。ただし、Go 1.13 以降の使用が推奨されることに注意してください。

2. 構成

go-zero を使用する前に、それに必要な環境をいくつか構成する必要があります。具体的には、go-zero を使用してサービスを作成するには、goctl コマンドラインツールをインストールする必要があります。

$ GO111MODULE=on go get -u github.com/tal-tech/go-zero/tools/goctl

ログイン後にコピー

3. プロジェクトの作成

次に、goctl を使用して新しいプロジェクトを作成する必要があります。プロジェクトの名前は blog であると想定し、次のコマンドで作成できるとします。

$ mkdir blog
$ cd blog
$ go mod init blog
$ goctl api new blog

ログイン後にコピー

上記のコマンドは、新しい API プロジェクトを作成し、必要なファイルとディレクトリをいくつか生成します。

2. サービスの作成

次に、go-zero を使用して新しいサービスを作成します。サービス名は user-service であると仮定し、次の手順で作成できます:

1. サービスの生成

goctl を使用して user-service のサービスコードを生成します:

$ goctl api go -api user.api -dir .

ログイン後にコピー

上記のコマンド現在のディレクトリにユーザーディレクトリが生成され、user.go という名前のファイルが含まれます。このファイルには user-service のサービスコードが含まれています。

2. ハンドラーの実装

特定のビジネスロジック (ハンドラー) を実装する必要もあります。

まず、ユーザーディレクトリに handler という名前の新しいディレクトリを作成し、その中に userhandler.go という名前のファイルを作成する必要があります。このファイルにはハンドラーコードが含まれます。

userhandler.go コードは次のとおりです:

package handler

import (
    "net/http"

    "github.com/tal-tech/go-zero/rest/httpx"
    "blog/service/user/api/internal/logic"
    "blog/service/user/api/internal/svc"
)

func userHandler(ctx *svc.ServiceContext) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        req, err := httpx.NewRequest(r)
        if err != nil {
            httpx.WriteError(w, err)
            return
        }

        l := logic.NewUserLogic(r.Context(), ctx)
        resp, err := l.GetUser(req)
        if err != nil {
            httpx.WriteError(w, err)
            return
        }

        httpx.WriteJson(w, resp)
    }
}

ログイン後にコピー

上記のコードは、go-zero によって提供されるrest/httpx パッケージを使用します。このパッケージは、NewRequest、WriteError、WriteJSON などの便利な関数を提供します。など HTTP サービスの作成プロセスが簡素化されました。

3. ハンドラーの登録

次に、上記のハンドラープログラムをサービスに登録する必要があります。

user.go ファイルの init メソッドに、次のコードを追加します:

func (s *Service) InitHandlers() {
    s.UserHandler = http.HandlerFunc(handler.UserHandler(s.Context))
}

ログイン後にコピー

上記のコードは、userHandler 関数を HTTP サービスとして登録します。これにアクセスするには、 API ファイルを提供します。

3. テンプレートの作成

goctl create api を使用して新しい go-zero API を生成でき、これによりいくつかの初期化設定を含むフォルダーが自動的に作成されます。 goctl の要件に従って、独自のコントローラーとサービスを追加できます。

ここでは、go-zero のソースコードの読み方をよりよく学ぶためのテンプレートアプリケーションを作成します。アプリケーションには、go-zero の共通機能の使用方法を示す CRUD サンプルが含まれます。

1. テンプレートの生成

goctl を使用してテンプレートアプリケーションを生成し、go-zero のソースコードをよりよく学習できます。

$ goctl api template -o app.go

ログイン後にコピー

上記のコマンドは、テンプレートアプリケーションのすべてのソースコードを含む app.go という名前のファイルを作成します。

2. データアクセスの実装

データストレージには MySQL が使用されることを前提としています。開始する前に、MySQL をインストールして構成する必要があります。これに基づいて、go-zero が提供する go-sql を使用してデータベースアクセス層を構築できます。

具体的には、goctl を使用してデータアクセスレイヤーコードを生成できます。

$ goctl model mysql datasource "root:123456@tcp(127.0.0.1:3306)/test" -table user -dir .

ログイン後にコピー

上記のコマンドは、データアクセス用のユーザーデータモデルを含む userModel.go ファイルを生成します。

3. ビジネスロジックの実装

次に、ビジネスロジックを実装し、データアクセス層と組み合わせて使用する必要があります。具体的には、ユーザー管理用のビジネスロジックを含む userLogic.go というファイルを作成できます。

userLogic.go コードは次のとおりです:

package logic

import (
    "context"
    "github.com/tal-tech/go-zero/core/logx"
    "github.com/tal-tech/go-zero/core/stores/sqlx"
    "blog/service/user/model"
    "blog/service/user/api/internal/svc"
    "blog/service/user/api/internal/types"
)

type UserLogic struct {
    ctx context.Context
    svcCtx *svc.ServiceContext
    logx.Logger
}

func NewUserLogic(ctx context.Context, svcCtx *svc.ServiceContext) UserLogic {
    return UserLogic{
        ctx: ctx,
        svcCtx: svcCtx,
        Logger: logx.WithContext(ctx),
    }
}

func (l *UserLogic) GetUser(req types.GetUserRequest) (*types.GetUserResponse, error) {
    //Todo
}

ログイン後にコピー

上記のコードでは、sqlx、stores、logx パッケージを導入しました。sqlx は go-zero フレームワークの一部であり、特に使用されます。データベース操作用。ストアは、go-zero フレームワークのデータストレージ層です。 logx パッケージは、go-zero フレームワークによって提供されるログライブラリであり、重要なイベントの記録に役立ちます。

4. ETCD などの統合

go-zero フレームワークを使用すると、ETCD、Redis、ZooKeeper などの一般的に使用されるツールやサービスを簡単に統合できます。具体的には、go-zero が提供する関連ライブラリをコード内にインポートし、関連情報を設定ファイルに設定できます。

一般的に使用される統合方法の一部を次に示します:

1. ETCD の統合

まず、次の情報を構成ファイルに追加します:

[etcd]
host = "localhost:2379"

ログイン後にコピー

次にの etcd コードを使用するには、clientv3.New 関数を使用して新しい etcd クライアントを作成します。

import (
    "go.etcd.io/etcd/clientv3"
)

client, err := clientv3.New(clientv3.Config{
    Endpoints:   []string{"localhost:2379"},
    DialTimeout: 5 * time.Second,
})
if err != nil {
    panic(err)
}

ログイン後にコピー

上記のコードは、ETCD サーバーのアドレスとして localhost:2379 を使用する client という名前の ETCD クライアントを作成します。

2. Redis の統合

Redis を使用するには、次の情報を構成ファイルに追加する必要があります:

[redis]
host = "localhost:6379"
password = ""
db = 0

ログイン後にコピー

次に、Redis を使用するコード内のNewClient 関数は、新しい Redis クライアントを作成します。

import (
    "github.com/go-redis/redis"
)

client := redis.NewClient(&redis.Options{
    Addr:     "localhost:6379",
    Password: "", // no password set
    DB:       0,  // use default DB
})

ログイン後にコピー

上記のコードは、新しい Redis クライアントを作成します。このクライアントは、Redis サーバーアドレスとして localhost:6379 を使用し、パスワードは使用せず、デフォルトの DB を使用します。

3.ZooKeeper の統合

要使用ZooKeeper，我们需要在配置文件中添加以下信息：

[zookeeper]
host = "localhost:2181"

ログイン後にコピー

然后，在要使用ZooKeeper的代码中，使用zk.Connect函数创建一个新的ZooKeeper客户端。

import (
    "github.com/samuel/go-zookeeper/zk"
    "time"
)

conn, _, err := zk.Connect([]string{"localhost:2181"}, time.Second*5)
if err != nil {
    panic(err)
}

ログイン後にコピー

上述代码将创建一个名为conn的ZooKeeper客户端，它将使用localhost:2181作为ZooKeeper服务器的地址。

五、总结

到目前为止，我们已经深入了解了go-zero框架，并学到了如何使用它来构建高性能服务。

总结一下，要使用go-zero，请先安装和配置相关环境，然后创建一个新的项目，通过goctl命令行工具自动生成模板代码和配置文件。

接着，可以使用go-zero提供的各种功能和服务来逐步完善和扩展我们的应用程序，如集成数据库、ETCD、Redis等。

将go-zero框架用于您的下一个项目吧，它将使您能够构建出更加灵活、高效和可靠的服务！

以上が入門から熟練度まで: Go-Zero フレームワークをマスターするの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。