Chapter 01

はじめに

このチャプターの目次

この本について

Goのcontextパッケージって、使い所がとてもわかりにくいですよね。

例えばnet/httpなら、httpサーバーや、http通信をする際に必要になるツールをまとめているんだな、とわかります。
またdatabase/sqlなら、DB接続→クエリを投げてデータを取得するためのツールが入っているんだな、と一目瞭然です。

ですがcontextと聞いても、「これは一体なんだ？」となる方がきっと大半なのではないでしょうか。

私が初めてcontextと出会ったのは、OpenAPI Generatorというもので、APIを叩くクライアントコードを自動生成させたときでした。
なぜかcontextという謎の第一引数を渡さないといけない仕様になっていて、「何だこれ知らねえ」と思ったのを覚えています。

この本では、

Goのcontextについての説明をまるっとまとめていきたいと思います。

そもそもcontextは何者なのかという定義部分を、これがあって何が嬉しいの？という動機とあわせて紹介します。

contextについてくるDoneメソッドと、context.WithCancel()関数の用途について説明します。

contextを複数作った場合において、一つをキャンセルしたらそのキャンセル信号がどう伝播していくのか、というところについて詳しく説明します。

contextについてくるDeadlineメソッドと、context.WithDeadline関数・context.WithTimeout関数の用途について説明します。

contextについてくるErrメソッドの用途について説明します。

contextについてくるValueメソッドと、context.WithValue()関数の用途について説明します。

contextに与えられるkeyとvalueについて、

ということについて論じます。

ここでは、今まで紹介したcontextの機能の中でも、

を複合的に使った、ミニhttpサーバーもどきのコードをお見せします。

この章では、
-「contextを構造体のフィールド内に埋め込むのは良くない」という話

を、既存パッケージへのcontext対応を例に出しながら説明します。

ここでは、

ということについて軽く触れておきます。