Golang は WebService サービスを実装します

マイクロサービス アーキテクチャの人気と Web サービスの需要の高まりに伴い、Web サービスの実装に Golang を使用する開発者が増えています。 Golang は、コンパイル速度が速く、パフォーマンスが優れている軽量言語であるため、Web サービスの実装に最適です。

この記事では、HTTP リクエストの処理、JSON データの処理、Golang の組み込み "net/http" パッケージを使用した Web サーバーの実装など、Golang を使用して Web サービスを実装する方法について説明します。

1. 環境をセットアップする

開始する前に、Golang が正しくインストールされ、対応する環境変数が設定されていることを確認する必要があります。初めての方は、まず公式 Web サイトから Golang (https://golang.org/dl/) をダウンロードしてインストールし、そのディレクトリが PATH 環境変数に追加されていることを確認してください。

HTTP リクエストを処理するには、サードパーティのライブラリ「gorilla/mux」を使用する必要があります。このライブラリは、いくつかの複雑なルーティング問題を解決するのに役立ちます。

次のコマンドを使用してインストールできます:

go get -u github.com/gorilla/mux

2. Web サービスの実装

以下では、Golang と Gorilla/Mux を使用して単純な Web サービスを実装します。次の機能を提供します:

• GET リクエストを処理し、HTML ページを返します。
• GET リクエストを処理し、JSON データを返します。
• POST リクエストを処理し、JSON データを受け取ります。 。

まず、HTTP サーバーを初期化する必要があります。 Golang では、「net/http」パッケージを使用して HTTP サーバーを実装できます。このパッケージは、Handler と Addr という 2 つの重要なメンバーを持つ「Server」と呼ばれる構造を提供します。

ハンドラーは HTTP リクエストの処理に使用されます。ハンドラーをカスタマイズしてサーバーにバインドできます。ここでは、gorilla/mux を使用してルート ハンドラーを定義し、HTTP サーバーにバインドします。

package main

import (
    "encoding/json"
    "fmt"
    "log"
    "net/http"
    "github.com/gorilla/mux"
)

func main() {
    // 定义路由处理程序
    r := mux.NewRouter()

    // 定义处理GET请求的路由
    r.HandleFunc("/", homePage).Methods("GET")
    r.HandleFunc("/users", getAllUsers).Methods("GET")
    r.HandleFunc("/user/{id}", getUserByID).Methods("GET")

    // 定义处理POST请求的路由
    r.HandleFunc("/user", createUser).Methods("POST")

    // 绑定路由处理程序到HTTP服务器
    log.Fatal(http.ListenAndServe(":8080", r))
}

上記のコードを通じて、データ取得とデータ追加にそれぞれ対応する 3 つの GET メソッドと 1 つの POST メソッドを含む 4 つのルーティング ハンドラーを定義しました。

次に、これらのメソッドを実装する必要があります。

1. GET リクエストを処理して HTML ページを返す

func homePage(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Welcome to the HomePage!")
    fmt.Println("Endpoint Hit: homePage")
}

これは非常に単純なメソッドで、ブラウザに文字列を表示するだけです。

2. GET リクエストを処理し、JSON データを返す

この例では、ユーザーの詳細を含むハードコードされた JSON 文字列を作成し、HTTP レスポンスで送信します。この JSON 文字列を返します。 。

type User struct {
    ID        string `json:"id"`
    FirstName string `json:"firstname"`
    LastName  string `json:"lastname"`
    Email     string `json:"email"`
    Phone     string `json:"phone"`
}

var users []User

func getAllUsers(w http.ResponseWriter, r *http.Request) {
    users := []User{
        User{ID: "1", FirstName: "Mike", LastName: "Smith", Email: "mike@example.com", Phone: "1234567890"},
        User{ID: "2", FirstName: "John", LastName: "Doe", Email: "john@example.com", Phone: "0987654321"},
    }
    json.NewEncoder(w).Encode(users)
}

このメソッドは、HTTP 応答の本文に JSON データを書き込み、Content-Type を application/json に自動的に設定します。

3. GET リクエストを処理し、ID に基づいてユーザー情報を取得する

ユーザーが GET リクエストを送信するとき、ID を使用してデータベース内のユーザー情報を検索する必要があります。そして情報を返します。

func getUserByID(w http.ResponseWriter, r *http.Request) {
    vars := mux.Vars(r)
    id := vars["id"]
    for _, user := range users {
        if user.ID == id {
            json.NewEncoder(w).Encode(user)
            return
        }
    }
    json.NewEncoder(w).Encode(&User{})
}

このメソッドでは、最初に mux.Vars 関数を使用してリクエストから ID を取得します。次に、ユーザー リストを繰り返し処理し、ID に一致するユーザーを見つけて、それを HTTP 応答の本文に書き込みます。一致するユーザーが見つからない場合は、空のユーザーが返されます。

4. POST リクエストの処理と JSON データの受信

最後に、POST リクエストを受け取り、リクエストの本文から JSON データを解析するメソッドを実装する必要があります。ユーザーがユーザーリストに追加されます。

func createUser(w http.ResponseWriter, r *http.Request) {
    var user User
    _ = json.NewDecoder(r.Body).Decode(&user)
    user.ID = strconv.Itoa(rand.Intn(1000000)) // 随机生成一个ID
    users = append(users, user)
    json.NewEncoder(w).Encode(user)
}

このメソッドでは、まず json.NewDecoder 関数を使用してリクエスト本文で渡された JSON データを解析し、それを user という名前の変数に保存します。次に、ランダムな ID を生成し、そのユーザーをユーザー リストに追加します。

3. Web サービスのテスト

これで、GET リクエストと POST リクエストを処理し、JSON データと HTML データを返すことができる単純な Web サービスが実装されました。次に、この Web サービスをテストして、HTTP リクエストに正しく応答できることを確認する必要があります。

Postman を使用してこの Web サービスをテストすることも、ブラウザにアドレスを直接入力してテストすることもできます。

1. GET リクエスト

GET /users リクエストを送信し、応答に追加した 2 人のユーザーを確認します:

2. GET リクエスト

GET /user/1 リクエストを送信し、応答で Mike の詳細を確認します。

3. POST リクエスト

追加する POST /user リクエストを送信します。

4. 概要

この記事では、Golang と Gorilla /mux を使用して、次のことを行う方法について説明しました。 GET および POST リクエストの処理、JSON および HTML データの返しなど、単純な Web サービスを実装します。この例は少し単純化されているかもしれませんが、Golang の力をさらに探究し、実際にさらに深く理解するための良い出発点となります。

最後に、Golang と Web サービスの基本概念を理解した後、さらに深く学習することをお勧めします。ゴルーチン、チャネル、高度なルーティング技術、認証とセキュリティなどのより高度な機能を探索し、データベースを使用してデータを保存および取得することは、すべてマスターする必要がある重要な概念です。この記事があなたの学習の有益な出発点になれば幸いです。

以上がGolang は WebService サービスを実装しますの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。