演習a3

httpパッケージについて，極々単純なWebアプリケーションで演習します．

演習（補足：httpパッケージ）

(1)

• Webブラウザからアクセスすると，"こんにちは，世界！"という文字列と，URLのパスを表示するhttpサーバ（Webサーバ）を作成せよ．このサービスのポートは123456とする．
• 例えば，http://localhost:123456/abc にアクセスすると，"こんにちは，世界！ abc" と表示する．

(2)

• Webブラウザからアクセスすると，サーバのファイルシステムの内容を表示するhttpサーバ（Webサーバ）を作成せよ．
• 例えば，http://localhost:123456/index.html にアクセスすると，サーバの実行ディレクトリにあるindex.htmlを表示する．
• 例えば，http://localhost:123456/fixed/ にアクセスすると，サーバの実行ディレクトリのサブディレクトリfixedの情報を表示する．

(3)

• 次のようなhttpサーバ（Webサーバ）を作成せよ．
• http://localhost:123456/J にアクセスすると，"こんにちは，世界！" と表示する．
• http://localhost:123456/E にアクセスすると，"Hello, World!" と表示する．
• http://localhost:123456/R/* にアクセスすると（R/の後にどのような文字列があっても），http://localhost:123456/J にリダイレクトする．すなわち，"こんにちは，世界！" と表示する．
• http://localhost:123456/fixed/* にアクセスすると，サーバの実行ディレクトリのサブディレクトリfixedの情報を表示する．
• それ以外のURLでアクセスすると，エラーを表示する．

解答例(1)

1. package main
2. import (
3. "fmt"
4. "net/http"
5. "log"
6. )
8. func helloHandler(w http.ResponseWriter, r *http.Request) {
9. fmt.Fprintf(w, "こんにちは，世界！ %s", r.URL.Path[1:])
10. }
12. func main() {
13. http.HandleFunc("/", helloHandler)
14. log.Fatal(http.ListenAndServe(":12345",nil))
15. }

解説(1)

net/httpパッケージは，拡張可能なHTTPサーバと基本的なHTTPクライアントを提供します．

概要

• 13行目のhttp.HandleFuncで，Webのルート"/"における全てのリクエストをhelloHandlerで処理することを登録しています．
• 14行目のhttp.ListenAndServeで，ポート123456でのリクエストの受付を開始しています．
• 8行目のHelloHandler関数はhttp.HandlerFunc型で，http.ResponseWriteとhttp.Requestを引数として取ります．http.ResponseWriterに書き込むことによってHTTPサーバのレスポンスが生成され，HTTPクライアントにデータが送信されます．
• http.RequestはHTTPリクエストを格納したデータ構造です．文字列r.URL.Pathは，リクエストのパス部分です．[1:]によって，最初の一文字「/」を除去した部分文字列（スライス）を作成し，それを表示するようにしています．
• URL http://localhost:10080/golang にアクセスすると「こんにちは世界！ golang」と表示されます．

関数，メソッド，型の説明

• func HandleFunc(pattern string, handler func(ResponseWriter, *Request))
  • DefaultServeMuxのパターン（第1引数patternで指定）に対しハンドラ関数（第2引数handlerで指定）を登録します．DefaultServeMuxは，デフォルトのHTTPリクエストのマルチプレクサです．登録されているパターンのリストと各リクエストのURLを比較し，URLと最も一致するパターンに登録されているハンドラを呼び出す．
  • 第1引数のpatternは/で始まる必要があります．
  • "/favicon.ico"のようにスラッシュで終わらないパターンは固定パスを表し，"/images/"のようにスラッシュで終わるパターンはサブツリーを表します．
  • 長いパターンは短いパターンより優先されます．例えば，"/images/"として登録されたハンドラと，"/images/thumbnails/"として登録されたハンドラがあるとき，"/images/thumbnails/"で始まるパス("/images/thumbnails/thum001.gif"など)は後者のハンドラが呼び出され，それ以外の"/images/"サブツリーへのパス("images/001.gif"など)では前者が呼び出されます．
• func ListenAndServe(addr string, handler Handler) os.Error
  • TCPネットワークアドレスaddrでリッスンし，HTTP接続を受け付けると，それぞれに新しいサービススレッドを作成します．
  • このサービススレッドはリクエストを読み込み，それに応答するためにhandlerを呼び出します．handlerは通常nilであり，このときはDefaultServeMuxが使われます．

Request型，URL型

type Request struct {

Method string // GET, POST, PUTなど。

RawURL string // リクエストで使われた生のURL。

URL *URL // 解析済みURL。

Proto string // "HTTP/1.0"

ProtoMajor int // 1

ProtoMinor int // 0

Header map[string]string // リクエストの行を値にマップ

Body io.ReadCloser // メッセージのボディ

ContentLength int64 // コンテンツの長さ

TransferEncoding []string // 転送に使われたエンコーディングのリスト

Close bool // 応答後に接続を閉じるかどうか

Host string // URLによって要求されたホスト

Referer string // 参照元URL

UserAgent string // 「User-Agent:」ヘッダの文字列

Form map[string][]string // 解析済みフォーム

Trailer map[string]string // トレーラーのキーを値にマップ

}

type URL struct {

Raw string // 元の文字列

Scheme string // スキーマ

RawAuthority string // [userinfo@]host

RawUserinfo string // ユーザ情報

Host string // ホスト

RawPath string // /path[?query][#fragment]

Path string // /path

OpaquePath bool // パスが不明確 (スキーマが指定されたのにルートからのパスでない)

RawQuery string // クエリ

Fragment string // フラグメント

}

func Fatal(v ...interface{})

• log.Fatalは，Print()のあとにos.Exit(1)を呼び出すことと同じです．
• os.Exitは，ステータスコードとともにカレントのプログラムを終了させます．ステータスコードは0のとき成功，それ以外の時エラーを表します．

解答例(2)

1. package main
2. import (
3. "net/http"
4. "log"
5. )
7. func main() {
8. http.Handle("/", http.FileServer(http.Dir(".")))
9. log.Fatal(http.ListenAndServe(":12345",nil))
10. }

解説(2)

概要

• 8行目のhttp.Handleで，Webのルート"/"における全てのリクエストをhttp.FileServerで処理することを登録しています．
• 9行目のhttp.ListenAndServeで，ポート123456でのリクエストの受付を開始しています．
• 8行目のhttp.FileServer関数はHandler型で，カレントディレクトリ"."をルート"/"とするファイルシステムの内容を返すハンドラを返します．
• これによって，このサーバを実行したディレクトリをWebのルートとするWebサーバとなります．
• URL http://localhost:123456/ にアクセスすると，カレントディレクトリの内容が表示されます．

関数の説明

func Handle(pattern string, handler Handler)

• Handleは、DefaultServeMuxのpatternに対しhandlerを登録します。
• (1)のHandleFuncと同じ機能です．違いは第2引数です．HandleFunc関数はfunc(ResponseWriter, *Request)型を引数にとりますが，Handle関数はHandler型を引数にとります．
• パッケージには，FileServer，NotFoundHandler，RedirectHandlerというハンドラーを返す関数が定義されています．

func FileServer(root, prefix string) Handler

• HTTPリクエストに対し，rootを起点とするファイルシステムの内容を返すハンドラを返します．

func NotFoundHandler() Handler

• 各リクエストに対して“404 page not found”を返すだけの単純なリクエストハンドラを返します．

func RedirectHandler(url string, code int) Handler

• 各リクエストに対して与えられたurlとステータスコードでリダイレクトを行うリクエストハンドラを返します．

解答例(3)

1. package main
2. import (
3. "fmt"
4. "net/http"
5. "log"
6. )
8. func helloJHandler(w http.ResponseWriter, r *http.Request) {
9. fmt.Fprintf(w, "こんにちは，世界！")
10. }
12. func helloEHandler(w http.ResponseWriter, r *http.Request) {
13. fmt.Fprintf(w, "Hello, World!")
14. }
16. func main() {
17. http.HandleFunc("/J", helloJHandler)
18. http.HandleFunc("/E", helloEHandler)
19. http.Handle("/fixed/", http.FileServer(http.Dir(".")))
20. http.Handle("/R/", http.RedirectHandler("/J", 301))
21. log.Fatal(http.ListenAndServe(":10080",nil))
22. }

解説(3)

• 8行目：helloJHandler："こんにちは，世界！" と表示するハンドラー．
• 12行目：helloEHandler："Hello, World!" と表示する．
• 17行目："/J"にアクセスするとhelloJHandlerを呼ぶ．
• 18行目："/E"にアクセスするとhelloEHandlerを呼ぶ．
• 19行目："/fixed/"にアクセスすると，そのディレクトリのファイルを表示する．.FileServerについては，解説(2)を参照．
• 20行目："/R/"にアクセスすると，"/J"にリダイレクト．RedirectHandlerについては，解説(2)を参照．301は，指定したリソースが新しいURIに移動したことを表すステータスコード．