Go の HTTP パッケージの紹介

2023/01/09

Go は、Web アプリケーションを構築するための強力で柔軟な言語です。ネットパッケージは、Go のエコシステムで重要な役割を果たします。

ほとんどのサーバー側プログラミング言語と同様に、Go には HTTP プロトコルとやり取りするための HTTP パッケージが付属しています。関連する Go パッケージは、 netパッケージのサブパッケージであるhttpパッケージです。

net/http パッケージとは?

net/httpパッケージは、Go の標準ライブラリの 1 つです。HTTP クライアント、サーバー、およびその他の HTTP ベースの操作を構築するための関数と型の完全なセットを提供します。これらには以下が含まれます：

HTTP リクエストを作成するための関数。
リクエストとレスポンスの処理。
HTTP リクエストの処理。
ヘッダーや Cookie などの関連オブジェクト。

net/httpパッケージは、TLS/SSL 暗号化、HTTP/2、およびその他の高度な機能もサポートしているため、このパッケージは Go 開発者にとって不可欠なツールです。

Gorilla Web ツールキットから Echo Web フレームワークまで、多くの一般的な Go ライブラリとフレームワークは、net/httpパッケージの上に構築されています。

シンプルな HTTP サーバーの起動

サーバーの起動は、HTTP プロトコルを操作するために理解する必要がある基本操作の 1 つです。

Go で単純なサーバーを実行するプログラムは次のとおりです。

package main

import ( "fmt" "net/http" )


// handler is a typical HTTP request-response handler in Go; details later
func handler(w http.ResponseWriter, r *http.Request) {
    // Fprintf formats the string to a writer
    fmt.Fprintf(w, "Hello, World!")
}

func main() { http.HandleFunc("/", handler) http.ListenAndServe(":8080", nil) }

ハンドラー関数は、 httpパッケージの典型的な要求応答ハンドラーです。この関数は、文字列「Hello, World!」を HTTP 応答ライターに書き込みます。

コードを実行して Web ブラウザーでhttp://localhost:8080/にアクセスすると、ブラウザーに「Hello, World!」という文字列が表示されます。

リクエストとレスポンスの処理

httpパッケージのHandleFuncメソッドを使用して、着信要求を処理できます。HandleFuncメソッドは、ルート文字列とハンドラー関数を受け取ります。

http.Requestメソッドは受信リクエストのインスタンスであり、インスタンスの多数のメソッドを使用して、ルートへのリクエストと対話できます。

http.HandleFunc("/users", func(w http.ResponseWriter, r *http.Request) { switch r.Method { case "GET": // handle GET request case "POST": // handle POST request default: http.Error(w, "Invalid request method", http.StatusMethodNotAllowed) } })

上記のコードでは、httpパッケージを使用して、 /usersルートの HTTP ハンドラー関数を定義しています。ハンドラー関数は、ルートで着信 HTTP 要求をリッスンし、要求メソッド ( GET、POSTなど)に基づいてそれらを処理します。

ハンドラー関数は、ResponseWriterメソッドとRequestメソッドを引数として受け取ります。ResponseWriterは、ハンドラーがクライアントへの応答としてデータを書き込むのを支援するインターフェースであり、Requestは、HTTP メソッド、URL、ヘッダーなど、着信要求に関する情報を含む構造体です。

上記のハンドラー関数は、switchステートメントを使用してリクエストメソッドを決定し、メソッドに基づいてさまざまなコードブロックを実行します。メソッドがGETの場合、ハンドラはGETリクエストを処理します。それ以外の場合、メソッドはPOST です。POSTリクエストを処理します。

メソッドがそれ以外の場合は、「無効なリクエストメソッド」メッセージとStatusMethodNotAllowed HTTP ステータスコードを含む http.Error がクライアントに送信されます。

文字列のバイトスライスを取り込んで文字列を書き込むライターインスタンスのWriteメソッドを使用して、文字列をクライアントに書き戻すことができます。

w.Write([]byte("Hello, World!"))

ResponseWriterインスタンスのWriteHeaderメソッドを使用して、クライアントにヘッダーを書き込むことができます。

w.WriteHeader(http.StatusOK)

HTTP ミドルウェアの操作

ミドルウェアは、要求が次のハンドラー関数に進む前に、操作の受信 HTTP 要求をインターセプトする関数で構成されます。

Go でミドルウェアハンドラー関数をログに記録する例を次に示します。

func loggingMiddleware(next http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { // log the request next.ServeHTTP(w, r) // log the response }) }

loggingMiddleware関数は、HTTP ハンドラーを受け取り、新しい HTTP ハンドラーを返します。返される HTTP ハンドラーは、HTTP 応答ライターと HTTP 要求を受け取る匿名関数です。この関数は要求をログに記録し、次のHTTP ハンドラーでServeHTTPメソッドを呼び出し、応答ライターと要求を引数として渡します。

httpパッケージのHandleメソッドでミドルウェア機能を処理できます。Handleメソッドは、ルートとミドルウェア関数を受け取ります。

http.Handle("/", loggingMiddleware(http.HandlerFunc(handler)))

HTTP パッケージによるリダイレクト

リダイレクトは、ユーザーを他のリソースや Web ページに誘導する Web アプリケーションで一般的な操作です。

httpパッケージのRedirectメソッドを使用して、別の Web ページにリダイレクトできます。

http.Redirect(w, r, "http://example.com", http.StatusMovedPermanently)

Redirectメソッドは、ResponseWriterおよびRequestインスタンス、新しいページ URL、およびリダイレクトのステータスコードを受け取ります。

Go で複雑な API を構築できます

httpパッケージは、複雑な API を構築するための強力で柔軟なツールです。Go の豊富な標準ライブラリやその他の強力なサードパーティパッケージを使用して、データベース接続やさまざまな Web フレームワークのサポートなどの機能を API に追加できます。

Go を使用すると、大量のリクエストトラフィックと複雑なデータ処理タスクを簡単に処理する、スケーラブルで高性能な API を構築できます。