From c9c0aa80f5d30221a0b671a20dfdd96bddd0e892 Mon Sep 17 00:00:00 2001 From: ryoya-fujimoto Date: Thu, 8 Aug 2024 03:54:47 +0000 Subject: [PATCH] deploy: eb86960e3b40d6547bd3b926bba46c68ae9d212f --- 404.html | 6 +- about.html | 6 +- assets/js/{11.8a1b9020.js => 11.1132ddf4.js} | 2 +- assets/js/{20.df074b21.js => 20.fe633865.js} | 2 +- assets/js/{25.19720aa5.js => 25.1947468b.js} | 2 +- assets/js/26.381232ac.js | 1 - assets/js/26.d3d4e8b1.js | 1 + assets/js/{29.d895ab7b.js => 29.abc83417.js} | 2 +- assets/js/{31.d1e92e59.js => 31.bfb228fb.js} | 2 +- assets/js/{32.b5197f93.js => 32.8cd1a0f9.js} | 2 +- assets/js/{33.af6ac3d9.js => 33.7b62fcf9.js} | 2 +- assets/js/{37.2755cfa3.js => 37.e33dc2ba.js} | 2 +- assets/js/{38.854b6729.js => 38.c1e53061.js} | 2 +- assets/js/{4.fe47842b.js => 4.70d9d788.js} | 2 +- assets/js/{42.72a6a0d7.js => 42.b0391732.js} | 2 +- assets/js/{43.1b335751.js => 43.befa18f7.js} | 2 +- assets/js/{47.ac364221.js => 47.bd53d714.js} | 2 +- assets/js/{51.9faf5c7e.js => 51.185e40a9.js} | 2 +- assets/js/{52.208c9413.js => 52.11d5174a.js} | 2 +- assets/js/{53.86cf1bbe.js => 53.100b8756.js} | 2 +- assets/js/{54.285dcbcc.js => 54.07d22ebb.js} | 2 +- assets/js/{56.2bd47b99.js => 56.3af7861d.js} | 2 +- assets/js/{58.9bc04bf8.js => 58.e620bda7.js} | 2 +- assets/js/{59.8cc23887.js => 59.e6e5fc1e.js} | 2 +- assets/js/{6.3784fdd2.js => 6.cf2720fd.js} | 2 +- assets/js/{61.22707b64.js => 61.0ec08d2b.js} | 2 +- assets/js/{63.d4b90e3c.js => 63.25f3de71.js} | 2 +- assets/js/{64.cc95695a.js => 64.8015b001.js} | 2 +- assets/js/{9.eecef422.js => 9.e53c4ddc.js} | 2 +- .../js/{app.c9f8a3a4.js => app.8b93c778.js} | 4 +- cicd_infra/ansible/ANSIBLE_CODE_STYLE.html | 6 +- cicd_infra/ansible/CREATE_INVENTORY.html | 6 +- cicd_infra/ansible/CREATE_PLAYBOOK.html | 6 +- cicd_infra/ansible/CREATE_SERVER.html | 6 +- cicd_infra/ansible/INTRODUCTION.html | 6 +- cicd_infra/ansible/MANAGE_SETTINGS.html | 6 +- cicd_infra/ansible/REVERSE_PROXY.html | 6 +- cicd_infra/ansible/SAMPLE_RUN.html | 6 +- cicd_infra/ansible/USE_VARIABLE.html | 6 +- cicd_infra/ansible/index.html | 6 +- cicd_infra/drone/index.html | 6 +- cicd_infra/github_actions/index.html | 6 +- cicd_infra/jenkins/index.html | 6 +- cicd_infra/prometheus/index.html | 6 +- database/mongodb/index.html | 6 +- database/mysql/index.html | 6 +- database/overview/index.html | 6 +- database/postgresql/index.html | 6 +- database/redis/index.html | 6 +- development/docker/docker-compose/index.html | 6 +- development/docker/docker/BUILD.html | 6 +- development/docker/docker/GETSTART.html | 6 +- development/docker/docker/OPERATION.html | 6 +- development/docker/docker/RUN_AS_IMAGE.html | 6 +- development/docker/docker/index.html | 6 +- development/git/index.html | 6 +- development/github/index.html | 6 +- development/kubernetes/index.html | 6 +- frontend/angular/index.html | 6 +- frontend/dom/index.html | 6 +- frontend/jquery/index.html | 6 +- frontend/overview/index.html | 6 +- frontend/react/index.html | 6 +- frontend/svelte/index.html | 6 +- frontend/vue/index.html | 6 +- index.html | 4 +- init/hello-bootcamp/index.html | 6 +- security/overview/index.html | 6 +- server-app/concurrent/index.html | 6 +- server-app/fastapi/index.html | 6 +- server-app/go/index.html | 6 +- server-app/go/src/go-tutor/index.html | 6 +- server-app/go/var/md/init.html | 6 +- server-app/java/DI.html | 6 +- server-app/java/index.html | 133 +++++++++--------- server-app/node/index.html | 6 +- server-app/overview/index.html | 6 +- server-app/rails/index.html | 6 +- server-app/test-hands-on/index.html | 6 +- web-server/apache/index.html | 6 +- web-server/apache_nginx/index.html | 6 +- web-server/hosting/index.html | 6 +- web-server/nginx/index.html | 6 +- web-server/overview/index.html | 6 +- web-server/tls/index.html | 6 +- 85 files changed, 265 insertions(+), 258 deletions(-) rename assets/js/{11.8a1b9020.js => 11.1132ddf4.js} (99%) rename assets/js/{20.df074b21.js => 20.fe633865.js} (99%) rename assets/js/{25.19720aa5.js => 25.1947468b.js} (99%) delete mode 100644 assets/js/26.381232ac.js create mode 100644 assets/js/26.d3d4e8b1.js rename assets/js/{29.d895ab7b.js => 29.abc83417.js} (99%) rename assets/js/{31.d1e92e59.js => 31.bfb228fb.js} (99%) rename assets/js/{32.b5197f93.js => 32.8cd1a0f9.js} (99%) rename assets/js/{33.af6ac3d9.js => 33.7b62fcf9.js} (99%) rename assets/js/{37.2755cfa3.js => 37.e33dc2ba.js} (98%) rename assets/js/{38.854b6729.js => 38.c1e53061.js} (96%) rename assets/js/{4.fe47842b.js => 4.70d9d788.js} (99%) rename assets/js/{42.72a6a0d7.js => 42.b0391732.js} (99%) rename assets/js/{43.1b335751.js => 43.befa18f7.js} (99%) rename assets/js/{47.ac364221.js => 47.bd53d714.js} (90%) rename assets/js/{51.9faf5c7e.js => 51.185e40a9.js} (99%) rename assets/js/{52.208c9413.js => 52.11d5174a.js} (99%) rename assets/js/{53.86cf1bbe.js => 53.100b8756.js} (99%) rename assets/js/{54.285dcbcc.js => 54.07d22ebb.js} (99%) rename assets/js/{56.2bd47b99.js => 56.3af7861d.js} (90%) rename assets/js/{58.9bc04bf8.js => 58.e620bda7.js} (99%) rename assets/js/{59.8cc23887.js => 59.e6e5fc1e.js} (98%) rename assets/js/{6.3784fdd2.js => 6.cf2720fd.js} (98%) rename assets/js/{61.22707b64.js => 61.0ec08d2b.js} (99%) rename assets/js/{63.d4b90e3c.js => 63.25f3de71.js} (89%) rename assets/js/{64.cc95695a.js => 64.8015b001.js} (89%) rename assets/js/{9.eecef422.js => 9.e53c4ddc.js} (99%) rename assets/js/{app.c9f8a3a4.js => app.8b93c778.js} (63%) diff --git a/404.html b/404.html index bfd94559..02fad390 100644 --- a/404.html +++ b/404.html @@ -8,13 +8,13 @@ - + -

404

How did we get here?
+ - + diff --git a/about.html b/about.html index f374b658..6b074779 100644 --- a/about.html +++ b/about.html @@ -8,7 +8,7 @@ - + @@ -18,7 +18,7 @@ GitHub (opens new window)

# IIJ Bootcampとは

# 目的

IIJ Bootcampは IIJ (opens new window) で開催しているハンズオン勉強会です。 各技術が誕生した経緯・歴史、ほかの技術と比較といった知識を得るためのきっかけとして、さまざまな言語・フレームワーク・ツールに触れて実際に動かすハンズオンを行っています。 -カリキュラムにはハンズオンだけでなく、「overview」として技術ジャンルの全体像や歴史などを紹介する回も設けています。

このサイトではIIJ Bootcamp用に社内で作成したハンズオン資料をCC BY-SA (opens new window)ライセンスで公開しています(GitHubリポジトリはこちら (opens new window))。

カリキュラムの全体像や資料へのリンクはトップページをご覧ください。

# 資料の構成

ハンズオン資料は以下のカテゴリに分かれています。

カテゴリ 概要
開発系 開発に必須となるGitやdockerのハンズオン
CI/CD + 構成管理 CIサーバのハンズオンとansibleやk8sによるアプリケーションデプロイ
データベース MySQL, MongoDB, Redis ハンズオン
Webサーバ構築 Apacheやnginxを使ったWebサーバの構築
サーバサイドアプリケーション DjangoやJava、golangを使ったサーバサイドアプリケーションの構築
フロントエンド 流行りのWebフレームワークを一通り触ってみる
セキュリティ Webにおけるセキュリティについてと、脆弱なサーバを作らないためのハンズオン

# 資料の利用と修正

資料は CC BY-SAライセンス (opens new window) で公開されており、勉強会などでの2次利用が可能です。その際資料の間違いや最新情報への更新などが必要な場合は、issue (opens new window)で気軽にお知らせください。

またPullRequestについても歓迎しています。その際は CONTRIBUTING.md (opens new window) をご一読ください。

- +カリキュラムにはハンズオンだけでなく、「overview」として技術ジャンルの全体像や歴史などを紹介する回も設けています。

このサイトではIIJ Bootcamp用に社内で作成したハンズオン資料をCC BY-SA (opens new window)ライセンスで公開しています(GitHubリポジトリはこちら (opens new window))。

カリキュラムの全体像や資料へのリンクはトップページをご覧ください。

# 資料の構成

ハンズオン資料は以下のカテゴリに分かれています。

カテゴリ 概要
開発系 開発に必須となるGitやdockerのハンズオン
CI/CD + 構成管理 CIサーバのハンズオンとansibleやk8sによるアプリケーションデプロイ
データベース MySQL, MongoDB, Redis ハンズオン
Webサーバ構築 Apacheやnginxを使ったWebサーバの構築
サーバサイドアプリケーション DjangoやJava、golangを使ったサーバサイドアプリケーションの構築
フロントエンド 流行りのWebフレームワークを一通り触ってみる
セキュリティ Webにおけるセキュリティについてと、脆弱なサーバを作らないためのハンズオン

# 資料の利用と修正

資料は CC BY-SAライセンス (opens new window) で公開されており、勉強会などでの2次利用が可能です。その際資料の間違いや最新情報への更新などが必要な場合は、issue (opens new window)で気軽にお知らせください。

またPullRequestについても歓迎しています。その際は CONTRIBUTING.md (opens new window) をご一読ください。

+ diff --git a/assets/js/11.8a1b9020.js b/assets/js/11.1132ddf4.js similarity index 99% rename from assets/js/11.8a1b9020.js rename to assets/js/11.1132ddf4.js index b5329c42..b686707f 100644 --- a/assets/js/11.8a1b9020.js +++ b/assets/js/11.1132ddf4.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[11],{353:function(t,_,v){t.exports=v.p+"assets/img/lock_01.ab763314.svg"},354:function(t,_,v){t.exports=v.p+"assets/img/lock_02.ed79637a.svg"},355:function(t,_,v){t.exports=v.p+"assets/img/lock_03.6c959893.svg"},356:function(t,_,v){t.exports=v.p+"assets/img/lock_04.39275bcb.svg"},357:function(t,_,v){t.exports=v.p+"assets/img/lock_05.a935bdb6.svg"},358:function(t,_,v){t.exports=v.p+"assets/img/lock_06.82acc786.svg"},359:function(t,_,v){t.exports=v.p+"assets/img/lock_07.c47fc1fd.svg"},360:function(t,_,v){t.exports=v.p+"assets/img/dead_lock_01.e5bf7a58.svg"},361:function(t,_,v){t.exports=v.p+"assets/img/dead_lock_02.a899e10d.svg"},362:function(t,_,v){t.exports=v.p+"assets/img/dead_lock_03.b3206b7e.svg"},363:function(t,_,v){t.exports=v.p+"assets/img/dead_lock_04.ac35d38f.svg"},524:function(t,_,v){"use strict";v.r(_);var a=v(10),e=Object(a.a)({},(function(){var t=this,_=t._self._c;return _("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[_("h1",{attrs:{id:"データベース-overview"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データベース-overview"}},[t._v("#")]),t._v(" データベース Overview")]),t._v(" "),_("p",[t._v("Webアプリケーション開発において、取得したデータを適切に保存し、必要なデータを適切に取り出して利用しなければならない場面はよくあります。データベースは、そうした場面で非常に有用な技術ですが、データを適切に取り扱うためにはデータベースがどのようなことに配慮して作られているか理解する必要があります。このOverviewでは、データベースに関する基本的な仕組みについて取り扱います。")]),t._v(" "),_("h2",{attrs:{id:"データベースとは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データベースとは"}},[t._v("#")]),t._v(" データベースとは")]),t._v(" "),_("ol",[_("li",[t._v("データの集合体\n"),_("ul",[_("li",[t._v("事前に決めたルールに従って保存されたデータの集合体のこと")])])]),t._v(" "),_("li",[t._v("DBMS(Database Management System)\n"),_("ul",[_("li",[t._v("DBMSはいわゆるDB製品とほぼ同義と考えても良い")])])])]),t._v(" "),_("h2",{attrs:{id:"dbmsが備える3つの主要機能"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#dbmsが備える3つの主要機能"}},[t._v("#")]),t._v(" DBMSが備える3つの主要機能")]),t._v(" "),_("p",[t._v("DBMS(Database Management System)は、基本的に以下の3つの機能を備えている")]),t._v(" "),_("ol",[_("li",[t._v("データの管理\n"),_("ul",[_("li",[t._v("データの集合体をどのような方法・形式で管理するか")])])]),t._v(" "),_("li",[t._v("アクセス手段\n"),_("ul",[_("li",[t._v("データベースに保存されているデータをどのように取り出すか")])])]),t._v(" "),_("li",[t._v("トランザクション管理\n"),_("ul",[_("li",[t._v("新たなデータを挿入したり、不要なデータを削除したりするなど、データ操作を行う場合に、どのように読み書きを制御するか")])])])]),t._v(" "),_("h2",{attrs:{id:"データベースの種類とデータ管理方法の違い"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データベースの種類とデータ管理方法の違い"}},[t._v("#")]),t._v(" データベースの種類とデータ管理方法の違い")]),t._v(" "),_("p",[t._v("データベースは製品設計の考え方の違いにより、データの管理方法が複数存在する")]),t._v(" "),_("ol",[_("li",[t._v("リレーショナルデータベース\n"),_("ul",[_("li",[t._v("ある関係をもつ複数のデータを組(タプル)として扱う、表形式で表現できる")]),t._v(" "),_("li",[t._v("主な製品: PostgreSQL, MySQL, MariaDB, Oracle Database, Microsoft SQL Server")])])]),t._v(" "),_("li",[t._v("ドキュメント指向データベース\n"),_("ul",[_("li",[t._v("JSONやXMLなど階層構造をもつデータをドキュメントとして扱う")]),t._v(" "),_("li",[t._v("リレーショナルデータベースは、保存できるデータ定義(スキーマ)が必要になるが、ドキュメント指向データベースはJSONデータなどをそのまま保存できるため、事前にデータ定義(スキーマ)を行う必要性がない点で、スキーマレスと言われる")]),t._v(" "),_("li",[t._v("主な製品: MongoDB, Apache CouchDB")])])]),t._v(" "),_("li",[t._v("Key-Valueデータベース\n"),_("ul",[_("li",[t._v("1つのキーに1つの値(バリュー)をデータとして扱う")]),t._v(" "),_("li",[t._v("主な製品: Redis, Apache Cassandra")])])]),t._v(" "),_("li",[t._v("グラフ指向データベース\n"),_("ul",[_("li",[t._v("データの関係性を扱うデータベース。ノード、エッジ、プロパティの3要素から構成されるデータを扱う")]),t._v(" "),_("li",[t._v("主な製品: neo4j")])])])]),t._v(" "),_("p",[t._v("上記1以外は、リレーショナルデータベースではないことから、"),_("a",{attrs:{href:"https://ja.wikipedia.org/wiki/NoSQL",target:"_blank",rel:"noopener noreferrer"}},[t._v("NoSQL"),_("OutboundLink")],1),t._v("と呼ばれることもある")]),t._v(" "),_("h2",{attrs:{id:"データへのアクセス手段"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データへのアクセス手段"}},[t._v("#")]),t._v(" データへのアクセス手段")]),t._v(" "),_("ol",[_("li",[t._v("リレーショナルデータベース\n"),_("ul",[_("li",[t._v("SQL\n"),_("ul",[_("li",[t._v("SQLには、ANSI/ISOで決められた標準SQLと呼ばれるものがある。標準SQLは、決められた年をつけて表記され、現在の最新は「SQL:2016」")]),t._v(" "),_("li",[t._v("各リレーショナルDB製品には、標準SQLに沿いながらも、製品独自のSQLが実装されている。そのため、アプリケーションで利用しているリレーショナルDBを別のリレーショナルDBに変更する場合、アプリケーションが発行している全てのSQLが移行先のリレーショナルDBでも動作するか確認する必要がある。")])])])])]),t._v(" "),_("li",[t._v("非リレーショナルデータベース(NoSQL)\n"),_("ul",[_("li",[t._v("独自クエリ\n"),_("ul",[_("li",[t._v("データの管理方法により、データへのアクセス方法が異なるため、SQLのような共通言語ではなく、製品ごとに規定された独自クエリを使用する")])])])])])]),t._v(" "),_("p",[t._v("SQLを使うリレーショナルデータベースであっても差異があることが多く、非リレーショナルデータベース(NoSQL)は独自クエリになるため、アプリケーションのバックエンドに利用するデータベースをアプリケーション構築後に別のデータベースに移行するのは容易ではない。そのため、バックエンドに利用するデータベース選定は慎重に検討する必要がある。")]),t._v(" "),_("h2",{attrs:{id:"トランザクションとは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#トランザクションとは"}},[t._v("#")]),t._v(" トランザクションとは")]),t._v(" "),_("p",[t._v("アプリケーションが意味のある処理を実行する際に必要な複数のデータベースへの処理単位")]),t._v(" "),_("ul",[_("li",[t._v("例えば、AさんからBさんに10万円を送金する処理は、Aさんの口座から10万円減額し、Bさんの口座を10万円増額する、という全ての処理が完了しないと「送金」という意図した操作が成立しない。")]),t._v(" "),_("li",[t._v("トランザクションは、意図した操作を成立させるために必要な複数の処理を束ねたような概念。")])]),t._v(" "),_("h2",{attrs:{id:"トランザクションとacid特性"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#トランザクションとacid特性"}},[t._v("#")]),t._v(" トランザクションとACID特性")]),t._v(" "),_("p",[t._v("トランザクションの中でも、特にお金の処理などビジネスデータを扱う場合、データ不整合やデータ消失を起こすと重大な事故になってしまう。そうしたことが起きないように、トランザクションでは以下の4つの性質が保証されるべきとされている。")]),t._v(" "),_("ul",[_("li",[_("strong",[t._v("A")]),t._v("tomicity(原子性)\n"),_("ul",[_("li",[t._v("処理を確定する(コミット) or 確定しない(ロールバック)の二者択一になるようにする")])])]),t._v(" "),_("li",[_("strong",[t._v("C")]),t._v("onsistency(一貫性・整合性)\n"),_("ul",[_("li",[t._v("事前に定義されたルールに違反するデータの入力を拒否する")])])]),t._v(" "),_("li",[_("strong",[t._v("I")]),t._v("solation(独立性・分離性)\n"),_("ul",[_("li",[t._v("他のトランザクションの影響を受けないようにする")])])]),t._v(" "),_("li",[_("strong",[t._v("D")]),t._v("urability(永続性)\n"),_("ul",[_("li",[t._v("実行された処理結果は失われない、永続的に保存される")])])])]),t._v(" "),_("p",[t._v("ACID特性は、上記の4つの特性の英単語の頭文字から作られた単語(参考: "),_("a",{attrs:{href:"https://ja.wikipedia.org/wiki/ACID_(%E3%82%B3%E3%83%B3%E3%83%94%E3%83%A5%E3%83%BC%E3%82%BF%E7%A7%91%E5%AD%A6)",target:"_blank",rel:"noopener noreferrer"}},[t._v("Wikipedia"),_("OutboundLink")],1),t._v(")")]),t._v(" "),_("p",[t._v("一般的に、リレーショナルデータベースは、ACID特性が保証されているが、非リレーショナルデータベース(NoSQL)ではACID特性が緩められていることがある。")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("リレーショナルデータベースは、一般的にACID特性が保証されているため、データを安全に扱うことができるが、ACID特性を保証するためには様々な処理を実行する必要があるため、NoSQLに比べると相対的に速度が遅いと言われる。")])]),t._v(" "),_("li",[_("p",[t._v("非リレーショナルデータベース(NoSQL)は、リレーショナルデータベースに比べて、大規模データを高速に処理することができると言われるが、NoSQLがACID特性の一部を緩めることで、大規模データの処理性能を効率的に実施している部分がある。アプリケーション開発者は、アプリケーションで扱うデータを守る上で、ACID特性の一部が緩められていても問題がないか検討し、必要であれば保証されていない特性をアプリケーション側で補う必要があるが、考慮する必要性が無ければ、ACID特性を緩めることで、高速性等の恩恵を受けることができる。")])])]),t._v(" "),_("h2",{attrs:{id:"原子性-atomicity-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#原子性-atomicity-とは"}},[t._v("#")]),t._v(" 原子性(Atomicity)とは")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("例: AさんからBさんに10万円送金する場合")]),t._v(" "),_("ol",[_("li",[t._v("Aさんの口座を10万円減額する")]),t._v(" "),_("li",[t._v("Bさんの口座を10万円増額する")])])])]),t._v(" "),_("p",[t._v("仮に、1の処理を実行した後、2の処理が実行できなかった場合、Aさんの口座だけが減額されるトラブルが発生することになる")]),t._v(" "),_("p",[t._v("原子性は、こうしたトラブルが発生しないよう、例えば2の処理が失敗した場合、1の処理も無かったことになることによって、意図した処理が実行されるか(コミット)、処理が全く実行されないか(ロールバック)、どちらかになるように保証する特性")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("コミット(commit)")]),t._v(" "),_("p",[t._v("トランザクション内で実行してきた処理を確定すること")])]),t._v(" "),_("li",[_("p",[t._v("ロールバック(rollback)")]),t._v(" "),_("p",[t._v("トランザクション内で実行してきた処理を全て破棄し、トランザクション開始時点の状態に戻すこと")])])]),t._v(" "),_("h2",{attrs:{id:"一貫性・整合性-consistency-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#一貫性・整合性-consistency-とは"}},[t._v("#")]),t._v(" 一貫性･整合性(Consistency)とは")]),t._v(" "),_("ul",[_("li",[t._v("例: 口座の金額は0円以上である")])]),t._v(" "),_("p",[t._v("仮に、残高が5千円の口座から、1万円の引落を実行した場合、口座残高はマイナス5千円となり、「口座の金額は0円以上である」というルールに違反することになるため、このケースでは1万円の引落の処理は、データベース側でブロックされ実行されない")]),t._v(" "),_("p",[t._v("一貫性･整合性は、データベースに保存される情報が、設計者の想定していない状態にならないよう、あらかじめ設定されたルール(≒業務仕様)に適合するように保証することができる特性")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("制約の例")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("NOT NULL制約")]),t._v(" "),_("p",[t._v("NULLデータを許容しない(データが必ずあることを保証する)")])]),t._v(" "),_("li",[_("p",[t._v("UNIQUE制約")]),t._v(" "),_("p",[t._v("UNIQUE制約を設定した列のデータは、必ず一意になる(その列のデータは列内で重複しないことを保証する)")])])]),t._v(" "),_("p",[t._v("テーブル内のレコードを一意に特定するために使われる主キー(Primary Key、PKと記載される)と言われるカラムは、NOT NULL制約とUNIQUE制約の2つの制約を設定することで実現されている")])])]),t._v(" "),_("h2",{attrs:{id:"独立性・分離性-isolation-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#独立性・分離性-isolation-とは"}},[t._v("#")]),t._v(" 独立性・分離性(Isolation)とは")]),t._v(" "),_("p",[t._v("データベースは、組織内などで情報共有のために使われるため、同時に複数のアクセス(トランザクション)を処理する必要がある。独立性･分離性は、複数トランザクションを同時実行しても、複数トランザクションを1つずつ逐次実行した時と同じ結果になるように保証する特性。")]),t._v(" "),_("h3",{attrs:{id:"ロック-lock-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#ロック-lock-とは"}},[t._v("#")]),t._v(" ロック(lock)とは")]),t._v(" "),_("p",[t._v("複数のトランザクションを同時実行する際に、処理対象データが他のトランザクションの影響を受けないよう、処理に必要になる期間データを占有する機能。独立性・分離性を保証する上で必要な機能の1つ。")]),t._v(" "),_("ul",[_("li",[t._v("例: AさんからBさんに10万円送金する処理(トランザクション1)と、BさんからCさんに5万円送金する処理(トランザクション2)を同時実行する場合\n"),_("ol",[_("li",[t._v("トランザクション1がAさんの口座をロックし10万円減額し20万円にする\n"),_("br"),_("img",{attrs:{src:v(353),alt:"lock_01"}})]),t._v(" "),_("li",[t._v("トランザクション2がBさんの口座をロックし5万円減額し15万円にする\n"),_("br"),_("img",{attrs:{src:v(354),alt:"lock_02"}})]),t._v(" "),_("li",[t._v("トランザクション1がBさんの口座を10万増額しようとするが、トランザクション2が口座をロック中のため待機\n"),_("br"),_("img",{attrs:{src:v(355),alt:"lock_03"}})]),t._v(" "),_("li",[t._v("トランザクション2がCさんの口座をロックし5万円増額し10万円にする\n"),_("br"),_("img",{attrs:{src:v(356),alt:"lock_04"}})]),t._v(" "),_("li",[t._v("トランザクション2が処理結果を保存し、BさんとCさんの口座ロックを解除する\n"),_("br"),_("img",{attrs:{src:v(357),alt:"lock_05"}})]),t._v(" "),_("li",[t._v("トランザクション1がBさんの口座をロックし10万増額し25万円にする\n"),_("br"),_("img",{attrs:{src:v(358),alt:"lock_06"}})]),t._v(" "),_("li",[t._v("トランザクション1が処理結果を保存し、AさんとBさんの口座ロックを解除する\n"),_("br"),_("img",{attrs:{src:v(359),alt:"lock_07"}})])])])]),t._v(" "),_("p",[t._v("上記例の場合、Bさんの口座は、5万円の減額処理と10万円の増額処理が競合したが、トランザクション2がBさんの口座を2の時点でロックするため、トランザクション2 → トランザクション1の順番で処理が実施される。この結果は、トランザクション1を先に全て実行し、その後トランザクション2を実行した場合と同じになるので、独立性･分離性が担保できている。")]),t._v(" "),_("h3",{attrs:{id:"デッドロック-deadlock-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#デッドロック-deadlock-とは"}},[t._v("#")]),t._v(" デッドロック(deadlock)とは")]),t._v(" "),_("p",[t._v("デッドロックとは、お互いのロック解除を待つことでお互いの処理が永久に進まなくなる状態のこと。例えば、トランザクション1がトランザクション2のロック解除を待ち、トランザクション2がトランザクション1のロック解除を待ってしまう様な状態になると、トランザクション1もトランザクション2も処理が完了せずロック解除に至らないため、ロックが永久に解除されず処理が永久に終了しなくなってしまう。")]),t._v(" "),_("ul",[_("li",[t._v("例: AさんがBさんに10万円送金する処理(トランザクション1)と、BさんがAさんに5万円送金する処理(トランザクション2)を同時実行する場合\n"),_("ol",[_("li",[t._v("トランザクション1がAさんの口座をロックし10万円減額し20万円にする\n"),_("br"),_("img",{attrs:{src:v(360),alt:"dead_lock_01"}})]),t._v(" "),_("li",[t._v("トランザクション2がBさんの口座をロックし5万円減額し15万円にする\n"),_("br"),_("img",{attrs:{src:v(361),alt:"dead_lock_02"}})]),t._v(" "),_("li",[t._v("トランザクション1がBさんの口座を10万増額しようとするが、トランザクション2が口座をロック中のため待機\n"),_("br"),_("img",{attrs:{src:v(362),alt:"dead_lock_03"}})]),t._v(" "),_("li",[t._v("トランザクション2がAさんの口座を5万増額しようとするが、トランザクション1が口座をロック中のため待機\n"),_("br"),_("img",{attrs:{src:v(363),alt:"dead_lock_04"}})])])])]),t._v(" "),_("p",[t._v("上記例は、トランザクション1はBさんの口座のロック解除を待つ必要があるが、それにはトランザクション2が終了する必要があり、トランザクション2はAさんの口座のロック解除を待つしか無いが、それにはトランザクション1が終了する必要があり、処理が永久に進まなくなる。そのため、データベースには、デッドロック状態を検知し、デッドロックとなったトランザクションの片方を強制中断させることで、デッドロックを解消する機能が備えられている。")]),t._v(" "),_("p",[t._v("デッドロックによって強制中断したトランザクションは、データベースによって再度トランザクションが実行されることはないので、アプリケーション側でデッドロックによる中断を検知したらトランザクションを再実行する必要がある。デッドロックは、複数トランザクションを同時実行するのであれば必ず発生するため、アプリケーション作成時にデッドロックが起きる想定で設計しておく必要がある。")]),t._v(" "),_("h3",{attrs:{id:"分離レベル-isolation-level-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#分離レベル-isolation-level-とは"}},[t._v("#")]),t._v(" 分離レベル(isolation level)とは")]),t._v(" "),_("p",[t._v("トランザクション間の分離･独立性をどのぐらい緩めるか4段階で定義したもの。")]),t._v(" "),_("table",[_("thead",[_("tr",[_("th",{staticStyle:{"text-align":"left"}},[t._v("分離レベルの名称")]),t._v(" "),_("th",{staticStyle:{"text-align":"left"}},[t._v("分離レベルの詳細")]),t._v(" "),_("th",{staticStyle:{"text-align":"center"}},[t._v("ダーティーリード")]),t._v(" "),_("th",{staticStyle:{"text-align":"center"}},[t._v("ノンリピータブルリード")]),t._v(" "),_("th",{staticStyle:{"text-align":"center"}},[t._v("ファンタムリード")])])]),t._v(" "),_("tbody",[_("tr",[_("td",{staticStyle:{"text-align":"left"}},[t._v("READ UNCOMMITTED")]),t._v(" "),_("td",{staticStyle:{"text-align":"left"}},[t._v("他のトランザクションの確定してない(コミットされていない)データを読み取れる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")])]),t._v(" "),_("tr",[_("td",{staticStyle:{"text-align":"left"}},[t._v("READ COMMITTED")]),t._v(" "),_("td",{staticStyle:{"text-align":"left"}},[t._v("他のトランザクションが確定した(コミットした)データを読み取れる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")])]),t._v(" "),_("tr",[_("td",{staticStyle:{"text-align":"left"}},[t._v("REPEATABLE READ")]),t._v(" "),_("td",{staticStyle:{"text-align":"left"}},[t._v("トランザクション内では同じデータは何度読み取っても同じデータになる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")])]),t._v(" "),_("tr",[_("td",{staticStyle:{"text-align":"left"}},[t._v("SERIALIZABLE")]),t._v(" "),_("td",{staticStyle:{"text-align":"left"}},[t._v("複数トランザクションを同時実行しても1つずつ逐次実行した時と同じ結果になる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")])])])]),t._v(" "),_("p",[t._v("SERIALIZABLE以外の分離レベルでは、分離性･独立性を緩めることになるため、分離性･独立性に違反する現象が発生することを理解する必要がある(データベースの実装によって上記表とは異なるケースもある。例えば、MySQLはREPEATABLE READでもファンタムリードは発生しない実装になっている)")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("ダーティーリード(dirty read)")]),t._v(" "),_("p",[t._v("トランザクション1がデータAを更新した後、トランザクション2がデータAを読み取った状態で、トランザクション1が実行されなければ(ロールバックされる)、トランザクション2が読み取ったデータは実在しないデータを読み取ることになってしまう現象。")]),t._v(" "),_("p",[t._v("取得データを元に何らかの処理を行う場合は、実在しないデータを元に処理を実施してしまう状況になるため、意図しない結果を出力してしまう恐れがある。")])]),t._v(" "),_("li",[_("p",[t._v("ノンリピーダブルリード(non-repeatable read)")]),t._v(" "),_("p",[t._v("トランザクション1がデータAを読み取ったあと、トランザクション2がデータAを変更して確定(コミット)し、トランザクション1が再度データAを読み取った場合、1回目の読み取りと2回目の読み取り結果が異なってしまう現象。")]),t._v(" "),_("p",[t._v("読み取るタイミングによってデータ異なってしまうため、アプリケーションの実装によっては、意図しない結果を出力してしまう恐れがある。")])]),t._v(" "),_("li",[_("p",[t._v("ファンタムリード(phantom read)")]),t._v(" "),_("p",[t._v("トランザクション1が条件Aで検索してデータを読み取ると、データα・βが取得できるとする。トランザクション2が、条件Aに該当するデータγを追加し確定(コミット)した場合、トランザクション1が再び条件Aで検索してデータを読み取ると、データα・β以外に、1回目の読み取りでは存在してなかった、トランザクション2が追加したデータγも読み取ってしまうような現象。")]),t._v(" "),_("p",[t._v("登録データ数などを根拠に処理を行うような実装などで意図しない結果を出力してしまう恐れがある。")])])]),t._v(" "),_("p",[t._v("高い分離レベルを実現するためには、ロックをかけてデータを保護するため必要があるため、同時実行速度が犠牲になる。一方で低い分離レベルは、ロックをかける必要がなくなるため、同時実行時の速度が向上する。データベース製品ごとにどのように分離レベルが実装されているかを理解しつつ、上記のような現象が発生するリスクを許容できるかアプリケーション設計者がよく検討した上で、データの安全性よりも実行速度を重視したい場合、分離レベルを低くすることも1つの選択肢になる。")]),t._v(" "),_("h2",{attrs:{id:"永続性-durability-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#永続性-durability-とは"}},[t._v("#")]),t._v(" 永続性(Durability)とは")]),t._v(" "),_("p",[t._v("永続性とは、トランザクションが確定(コミット)したら、それ以降にデータが失われないように保証する特性。")]),t._v(" "),_("p",[t._v("トランザクションにおいて、処理が全て完了し確定(コミット)する場合、確定(コミット)が成功したら、それ以降は確定されたデータは永久に消えない状態になっている必要がある。")]),t._v(" "),_("p",[t._v("しかし、一般的に永続ディスク(ハードディスク・SSDなど)への書き込みは低速で時間のかかる処理とされている。そのため、LinuxなどのOSは、書き込み処理を高速化するため、永続ディスクよりも高速に書き込みが可能なキャッシュ領域にデータを書き込むことでアプリケーションに対しては書き込み処理完了とするような実装になっている。そして、キャッシュ領域から永続ディスクへは、一定間隔でまとめて書き込みを行う(フラッシュ処理)実装になっているが、キャッシュ領域で使われるのは、揮発性のメモリー(RAM)であるため、電源断が生じるとデータが消失してしまう。")]),t._v(" "),_("p",[t._v("仮に、確定(コミット)が成功したかの根拠となるデータの書き込み成功が、OSが用意しているキャッシュ(揮発性メモリー)領域への書き込みだった場合、電源断などの障害によってデータが消失する可能性があり、永続性の原則に違反する状況が発生してしまう。データベースでは、こうした状況を防ぐため確定(コミット)する際に、OSのキャッシュ領域ではなく、永続ディスクへの書き込みになるように制御するような機能が備わっている。")]),t._v(" "),_("h2",{attrs:{id:"まとめ"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#まとめ"}},[t._v("#")]),t._v(" まとめ")]),t._v(" "),_("h3",{attrs:{id:"データを扱うことの難しさを知る"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データを扱うことの難しさを知る"}},[t._v("#")]),t._v(" データを扱うことの難しさを知る")]),t._v(" "),_("p",[t._v("データを確実に保存し、必要な場面で確実に利用するためには、様々なことに注意を払う必要があります。アプリケーション開発者は、これまで見てきたようなデータに関して起きうる全ての状況を想定しながら、アプリケーションの設計・実装していく必要がありますが、データに関して起きうる全ての事象に対応したアプリケーションを1から実装するのは非現実的です(いわゆる"),_("a",{attrs:{href:"https://ja.wikipedia.org/wiki/%E8%BB%8A%E8%BC%AA%E3%81%AE%E5%86%8D%E7%99%BA%E6%98%8E",target:"_blank",rel:"noopener noreferrer"}},[t._v("車輪の再発明"),_("OutboundLink")],1),t._v(")。")]),t._v(" "),_("h3",{attrs:{id:"データベースを学び利用する"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データベースを学び利用する"}},[t._v("#")]),t._v(" データベースを学び利用する")]),t._v(" "),_("p",[t._v("データベースを学ぶことは、データを扱う上で起きうる事象を学ぶことができ、アプリケーション開発の中でデータを扱う際に何に配慮すれば良いか見えて来ると思います。また、データベースを利用することで、データを扱う上で起きうる事象への配慮をデータベースに任せることができれば、アプリケーション開発者はアプリケーションに求められる本質的な機能の実装に集中でき、より良いアプリケーション開発を行うことができるようになると思います。")]),t._v(" "),_("h3",{attrs:{id:"必要な機能を備えたデータベース製品を選定する"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#必要な機能を備えたデータベース製品を選定する"}},[t._v("#")]),t._v(" 必要な機能を備えたデータベース製品を選定する")]),t._v(" "),_("p",[t._v("昨今、様々なデータベース製品がリリースされています。それらの製品ごとにメリット･デメリット、得意･不得意な領域が存在します。データの安全性を重視するのか、それとも速度を重視するかなど、アプリケーションごとにデータに対する要求の方向性は変わってきますが、求める方向性に合致するデータベース製品を選定できるようになるためにも、データベースの知識を持つことが重要だと思います。")])])}),[],!1,null,null,null);_.default=e.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[11],{353:function(t,_,v){t.exports=v.p+"assets/img/lock_01.ab763314.svg"},354:function(t,_,v){t.exports=v.p+"assets/img/lock_02.ed79637a.svg"},355:function(t,_,v){t.exports=v.p+"assets/img/lock_03.6c959893.svg"},356:function(t,_,v){t.exports=v.p+"assets/img/lock_04.39275bcb.svg"},357:function(t,_,v){t.exports=v.p+"assets/img/lock_05.a935bdb6.svg"},358:function(t,_,v){t.exports=v.p+"assets/img/lock_06.82acc786.svg"},359:function(t,_,v){t.exports=v.p+"assets/img/lock_07.c47fc1fd.svg"},360:function(t,_,v){t.exports=v.p+"assets/img/dead_lock_01.e5bf7a58.svg"},361:function(t,_,v){t.exports=v.p+"assets/img/dead_lock_02.a899e10d.svg"},362:function(t,_,v){t.exports=v.p+"assets/img/dead_lock_03.b3206b7e.svg"},363:function(t,_,v){t.exports=v.p+"assets/img/dead_lock_04.ac35d38f.svg"},525:function(t,_,v){"use strict";v.r(_);var a=v(10),e=Object(a.a)({},(function(){var t=this,_=t._self._c;return _("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[_("h1",{attrs:{id:"データベース-overview"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データベース-overview"}},[t._v("#")]),t._v(" データベース Overview")]),t._v(" "),_("p",[t._v("Webアプリケーション開発において、取得したデータを適切に保存し、必要なデータを適切に取り出して利用しなければならない場面はよくあります。データベースは、そうした場面で非常に有用な技術ですが、データを適切に取り扱うためにはデータベースがどのようなことに配慮して作られているか理解する必要があります。このOverviewでは、データベースに関する基本的な仕組みについて取り扱います。")]),t._v(" "),_("h2",{attrs:{id:"データベースとは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データベースとは"}},[t._v("#")]),t._v(" データベースとは")]),t._v(" "),_("ol",[_("li",[t._v("データの集合体\n"),_("ul",[_("li",[t._v("事前に決めたルールに従って保存されたデータの集合体のこと")])])]),t._v(" "),_("li",[t._v("DBMS(Database Management System)\n"),_("ul",[_("li",[t._v("DBMSはいわゆるDB製品とほぼ同義と考えても良い")])])])]),t._v(" "),_("h2",{attrs:{id:"dbmsが備える3つの主要機能"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#dbmsが備える3つの主要機能"}},[t._v("#")]),t._v(" DBMSが備える3つの主要機能")]),t._v(" "),_("p",[t._v("DBMS(Database Management System)は、基本的に以下の3つの機能を備えている")]),t._v(" "),_("ol",[_("li",[t._v("データの管理\n"),_("ul",[_("li",[t._v("データの集合体をどのような方法・形式で管理するか")])])]),t._v(" "),_("li",[t._v("アクセス手段\n"),_("ul",[_("li",[t._v("データベースに保存されているデータをどのように取り出すか")])])]),t._v(" "),_("li",[t._v("トランザクション管理\n"),_("ul",[_("li",[t._v("新たなデータを挿入したり、不要なデータを削除したりするなど、データ操作を行う場合に、どのように読み書きを制御するか")])])])]),t._v(" "),_("h2",{attrs:{id:"データベースの種類とデータ管理方法の違い"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データベースの種類とデータ管理方法の違い"}},[t._v("#")]),t._v(" データベースの種類とデータ管理方法の違い")]),t._v(" "),_("p",[t._v("データベースは製品設計の考え方の違いにより、データの管理方法が複数存在する")]),t._v(" "),_("ol",[_("li",[t._v("リレーショナルデータベース\n"),_("ul",[_("li",[t._v("ある関係をもつ複数のデータを組(タプル)として扱う、表形式で表現できる")]),t._v(" "),_("li",[t._v("主な製品: PostgreSQL, MySQL, MariaDB, Oracle Database, Microsoft SQL Server")])])]),t._v(" "),_("li",[t._v("ドキュメント指向データベース\n"),_("ul",[_("li",[t._v("JSONやXMLなど階層構造をもつデータをドキュメントとして扱う")]),t._v(" "),_("li",[t._v("リレーショナルデータベースは、保存できるデータ定義(スキーマ)が必要になるが、ドキュメント指向データベースはJSONデータなどをそのまま保存できるため、事前にデータ定義(スキーマ)を行う必要性がない点で、スキーマレスと言われる")]),t._v(" "),_("li",[t._v("主な製品: MongoDB, Apache CouchDB")])])]),t._v(" "),_("li",[t._v("Key-Valueデータベース\n"),_("ul",[_("li",[t._v("1つのキーに1つの値(バリュー)をデータとして扱う")]),t._v(" "),_("li",[t._v("主な製品: Redis, Apache Cassandra")])])]),t._v(" "),_("li",[t._v("グラフ指向データベース\n"),_("ul",[_("li",[t._v("データの関係性を扱うデータベース。ノード、エッジ、プロパティの3要素から構成されるデータを扱う")]),t._v(" "),_("li",[t._v("主な製品: neo4j")])])])]),t._v(" "),_("p",[t._v("上記1以外は、リレーショナルデータベースではないことから、"),_("a",{attrs:{href:"https://ja.wikipedia.org/wiki/NoSQL",target:"_blank",rel:"noopener noreferrer"}},[t._v("NoSQL"),_("OutboundLink")],1),t._v("と呼ばれることもある")]),t._v(" "),_("h2",{attrs:{id:"データへのアクセス手段"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データへのアクセス手段"}},[t._v("#")]),t._v(" データへのアクセス手段")]),t._v(" "),_("ol",[_("li",[t._v("リレーショナルデータベース\n"),_("ul",[_("li",[t._v("SQL\n"),_("ul",[_("li",[t._v("SQLには、ANSI/ISOで決められた標準SQLと呼ばれるものがある。標準SQLは、決められた年をつけて表記され、現在の最新は「SQL:2016」")]),t._v(" "),_("li",[t._v("各リレーショナルDB製品には、標準SQLに沿いながらも、製品独自のSQLが実装されている。そのため、アプリケーションで利用しているリレーショナルDBを別のリレーショナルDBに変更する場合、アプリケーションが発行している全てのSQLが移行先のリレーショナルDBでも動作するか確認する必要がある。")])])])])]),t._v(" "),_("li",[t._v("非リレーショナルデータベース(NoSQL)\n"),_("ul",[_("li",[t._v("独自クエリ\n"),_("ul",[_("li",[t._v("データの管理方法により、データへのアクセス方法が異なるため、SQLのような共通言語ではなく、製品ごとに規定された独自クエリを使用する")])])])])])]),t._v(" "),_("p",[t._v("SQLを使うリレーショナルデータベースであっても差異があることが多く、非リレーショナルデータベース(NoSQL)は独自クエリになるため、アプリケーションのバックエンドに利用するデータベースをアプリケーション構築後に別のデータベースに移行するのは容易ではない。そのため、バックエンドに利用するデータベース選定は慎重に検討する必要がある。")]),t._v(" "),_("h2",{attrs:{id:"トランザクションとは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#トランザクションとは"}},[t._v("#")]),t._v(" トランザクションとは")]),t._v(" "),_("p",[t._v("アプリケーションが意味のある処理を実行する際に必要な複数のデータベースへの処理単位")]),t._v(" "),_("ul",[_("li",[t._v("例えば、AさんからBさんに10万円を送金する処理は、Aさんの口座から10万円減額し、Bさんの口座を10万円増額する、という全ての処理が完了しないと「送金」という意図した操作が成立しない。")]),t._v(" "),_("li",[t._v("トランザクションは、意図した操作を成立させるために必要な複数の処理を束ねたような概念。")])]),t._v(" "),_("h2",{attrs:{id:"トランザクションとacid特性"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#トランザクションとacid特性"}},[t._v("#")]),t._v(" トランザクションとACID特性")]),t._v(" "),_("p",[t._v("トランザクションの中でも、特にお金の処理などビジネスデータを扱う場合、データ不整合やデータ消失を起こすと重大な事故になってしまう。そうしたことが起きないように、トランザクションでは以下の4つの性質が保証されるべきとされている。")]),t._v(" "),_("ul",[_("li",[_("strong",[t._v("A")]),t._v("tomicity(原子性)\n"),_("ul",[_("li",[t._v("処理を確定する(コミット) or 確定しない(ロールバック)の二者択一になるようにする")])])]),t._v(" "),_("li",[_("strong",[t._v("C")]),t._v("onsistency(一貫性・整合性)\n"),_("ul",[_("li",[t._v("事前に定義されたルールに違反するデータの入力を拒否する")])])]),t._v(" "),_("li",[_("strong",[t._v("I")]),t._v("solation(独立性・分離性)\n"),_("ul",[_("li",[t._v("他のトランザクションの影響を受けないようにする")])])]),t._v(" "),_("li",[_("strong",[t._v("D")]),t._v("urability(永続性)\n"),_("ul",[_("li",[t._v("実行された処理結果は失われない、永続的に保存される")])])])]),t._v(" "),_("p",[t._v("ACID特性は、上記の4つの特性の英単語の頭文字から作られた単語(参考: "),_("a",{attrs:{href:"https://ja.wikipedia.org/wiki/ACID_(%E3%82%B3%E3%83%B3%E3%83%94%E3%83%A5%E3%83%BC%E3%82%BF%E7%A7%91%E5%AD%A6)",target:"_blank",rel:"noopener noreferrer"}},[t._v("Wikipedia"),_("OutboundLink")],1),t._v(")")]),t._v(" "),_("p",[t._v("一般的に、リレーショナルデータベースは、ACID特性が保証されているが、非リレーショナルデータベース(NoSQL)ではACID特性が緩められていることがある。")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("リレーショナルデータベースは、一般的にACID特性が保証されているため、データを安全に扱うことができるが、ACID特性を保証するためには様々な処理を実行する必要があるため、NoSQLに比べると相対的に速度が遅いと言われる。")])]),t._v(" "),_("li",[_("p",[t._v("非リレーショナルデータベース(NoSQL)は、リレーショナルデータベースに比べて、大規模データを高速に処理することができると言われるが、NoSQLがACID特性の一部を緩めることで、大規模データの処理性能を効率的に実施している部分がある。アプリケーション開発者は、アプリケーションで扱うデータを守る上で、ACID特性の一部が緩められていても問題がないか検討し、必要であれば保証されていない特性をアプリケーション側で補う必要があるが、考慮する必要性が無ければ、ACID特性を緩めることで、高速性等の恩恵を受けることができる。")])])]),t._v(" "),_("h2",{attrs:{id:"原子性-atomicity-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#原子性-atomicity-とは"}},[t._v("#")]),t._v(" 原子性(Atomicity)とは")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("例: AさんからBさんに10万円送金する場合")]),t._v(" "),_("ol",[_("li",[t._v("Aさんの口座を10万円減額する")]),t._v(" "),_("li",[t._v("Bさんの口座を10万円増額する")])])])]),t._v(" "),_("p",[t._v("仮に、1の処理を実行した後、2の処理が実行できなかった場合、Aさんの口座だけが減額されるトラブルが発生することになる")]),t._v(" "),_("p",[t._v("原子性は、こうしたトラブルが発生しないよう、例えば2の処理が失敗した場合、1の処理も無かったことになることによって、意図した処理が実行されるか(コミット)、処理が全く実行されないか(ロールバック)、どちらかになるように保証する特性")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("コミット(commit)")]),t._v(" "),_("p",[t._v("トランザクション内で実行してきた処理を確定すること")])]),t._v(" "),_("li",[_("p",[t._v("ロールバック(rollback)")]),t._v(" "),_("p",[t._v("トランザクション内で実行してきた処理を全て破棄し、トランザクション開始時点の状態に戻すこと")])])]),t._v(" "),_("h2",{attrs:{id:"一貫性・整合性-consistency-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#一貫性・整合性-consistency-とは"}},[t._v("#")]),t._v(" 一貫性･整合性(Consistency)とは")]),t._v(" "),_("ul",[_("li",[t._v("例: 口座の金額は0円以上である")])]),t._v(" "),_("p",[t._v("仮に、残高が5千円の口座から、1万円の引落を実行した場合、口座残高はマイナス5千円となり、「口座の金額は0円以上である」というルールに違反することになるため、このケースでは1万円の引落の処理は、データベース側でブロックされ実行されない")]),t._v(" "),_("p",[t._v("一貫性･整合性は、データベースに保存される情報が、設計者の想定していない状態にならないよう、あらかじめ設定されたルール(≒業務仕様)に適合するように保証することができる特性")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("制約の例")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("NOT NULL制約")]),t._v(" "),_("p",[t._v("NULLデータを許容しない(データが必ずあることを保証する)")])]),t._v(" "),_("li",[_("p",[t._v("UNIQUE制約")]),t._v(" "),_("p",[t._v("UNIQUE制約を設定した列のデータは、必ず一意になる(その列のデータは列内で重複しないことを保証する)")])])]),t._v(" "),_("p",[t._v("テーブル内のレコードを一意に特定するために使われる主キー(Primary Key、PKと記載される)と言われるカラムは、NOT NULL制約とUNIQUE制約の2つの制約を設定することで実現されている")])])]),t._v(" "),_("h2",{attrs:{id:"独立性・分離性-isolation-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#独立性・分離性-isolation-とは"}},[t._v("#")]),t._v(" 独立性・分離性(Isolation)とは")]),t._v(" "),_("p",[t._v("データベースは、組織内などで情報共有のために使われるため、同時に複数のアクセス(トランザクション)を処理する必要がある。独立性･分離性は、複数トランザクションを同時実行しても、複数トランザクションを1つずつ逐次実行した時と同じ結果になるように保証する特性。")]),t._v(" "),_("h3",{attrs:{id:"ロック-lock-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#ロック-lock-とは"}},[t._v("#")]),t._v(" ロック(lock)とは")]),t._v(" "),_("p",[t._v("複数のトランザクションを同時実行する際に、処理対象データが他のトランザクションの影響を受けないよう、処理に必要になる期間データを占有する機能。独立性・分離性を保証する上で必要な機能の1つ。")]),t._v(" "),_("ul",[_("li",[t._v("例: AさんからBさんに10万円送金する処理(トランザクション1)と、BさんからCさんに5万円送金する処理(トランザクション2)を同時実行する場合\n"),_("ol",[_("li",[t._v("トランザクション1がAさんの口座をロックし10万円減額し20万円にする\n"),_("br"),_("img",{attrs:{src:v(353),alt:"lock_01"}})]),t._v(" "),_("li",[t._v("トランザクション2がBさんの口座をロックし5万円減額し15万円にする\n"),_("br"),_("img",{attrs:{src:v(354),alt:"lock_02"}})]),t._v(" "),_("li",[t._v("トランザクション1がBさんの口座を10万増額しようとするが、トランザクション2が口座をロック中のため待機\n"),_("br"),_("img",{attrs:{src:v(355),alt:"lock_03"}})]),t._v(" "),_("li",[t._v("トランザクション2がCさんの口座をロックし5万円増額し10万円にする\n"),_("br"),_("img",{attrs:{src:v(356),alt:"lock_04"}})]),t._v(" "),_("li",[t._v("トランザクション2が処理結果を保存し、BさんとCさんの口座ロックを解除する\n"),_("br"),_("img",{attrs:{src:v(357),alt:"lock_05"}})]),t._v(" "),_("li",[t._v("トランザクション1がBさんの口座をロックし10万増額し25万円にする\n"),_("br"),_("img",{attrs:{src:v(358),alt:"lock_06"}})]),t._v(" "),_("li",[t._v("トランザクション1が処理結果を保存し、AさんとBさんの口座ロックを解除する\n"),_("br"),_("img",{attrs:{src:v(359),alt:"lock_07"}})])])])]),t._v(" "),_("p",[t._v("上記例の場合、Bさんの口座は、5万円の減額処理と10万円の増額処理が競合したが、トランザクション2がBさんの口座を2の時点でロックするため、トランザクション2 → トランザクション1の順番で処理が実施される。この結果は、トランザクション1を先に全て実行し、その後トランザクション2を実行した場合と同じになるので、独立性･分離性が担保できている。")]),t._v(" "),_("h3",{attrs:{id:"デッドロック-deadlock-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#デッドロック-deadlock-とは"}},[t._v("#")]),t._v(" デッドロック(deadlock)とは")]),t._v(" "),_("p",[t._v("デッドロックとは、お互いのロック解除を待つことでお互いの処理が永久に進まなくなる状態のこと。例えば、トランザクション1がトランザクション2のロック解除を待ち、トランザクション2がトランザクション1のロック解除を待ってしまう様な状態になると、トランザクション1もトランザクション2も処理が完了せずロック解除に至らないため、ロックが永久に解除されず処理が永久に終了しなくなってしまう。")]),t._v(" "),_("ul",[_("li",[t._v("例: AさんがBさんに10万円送金する処理(トランザクション1)と、BさんがAさんに5万円送金する処理(トランザクション2)を同時実行する場合\n"),_("ol",[_("li",[t._v("トランザクション1がAさんの口座をロックし10万円減額し20万円にする\n"),_("br"),_("img",{attrs:{src:v(360),alt:"dead_lock_01"}})]),t._v(" "),_("li",[t._v("トランザクション2がBさんの口座をロックし5万円減額し15万円にする\n"),_("br"),_("img",{attrs:{src:v(361),alt:"dead_lock_02"}})]),t._v(" "),_("li",[t._v("トランザクション1がBさんの口座を10万増額しようとするが、トランザクション2が口座をロック中のため待機\n"),_("br"),_("img",{attrs:{src:v(362),alt:"dead_lock_03"}})]),t._v(" "),_("li",[t._v("トランザクション2がAさんの口座を5万増額しようとするが、トランザクション1が口座をロック中のため待機\n"),_("br"),_("img",{attrs:{src:v(363),alt:"dead_lock_04"}})])])])]),t._v(" "),_("p",[t._v("上記例は、トランザクション1はBさんの口座のロック解除を待つ必要があるが、それにはトランザクション2が終了する必要があり、トランザクション2はAさんの口座のロック解除を待つしか無いが、それにはトランザクション1が終了する必要があり、処理が永久に進まなくなる。そのため、データベースには、デッドロック状態を検知し、デッドロックとなったトランザクションの片方を強制中断させることで、デッドロックを解消する機能が備えられている。")]),t._v(" "),_("p",[t._v("デッドロックによって強制中断したトランザクションは、データベースによって再度トランザクションが実行されることはないので、アプリケーション側でデッドロックによる中断を検知したらトランザクションを再実行する必要がある。デッドロックは、複数トランザクションを同時実行するのであれば必ず発生するため、アプリケーション作成時にデッドロックが起きる想定で設計しておく必要がある。")]),t._v(" "),_("h3",{attrs:{id:"分離レベル-isolation-level-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#分離レベル-isolation-level-とは"}},[t._v("#")]),t._v(" 分離レベル(isolation level)とは")]),t._v(" "),_("p",[t._v("トランザクション間の分離･独立性をどのぐらい緩めるか4段階で定義したもの。")]),t._v(" "),_("table",[_("thead",[_("tr",[_("th",{staticStyle:{"text-align":"left"}},[t._v("分離レベルの名称")]),t._v(" "),_("th",{staticStyle:{"text-align":"left"}},[t._v("分離レベルの詳細")]),t._v(" "),_("th",{staticStyle:{"text-align":"center"}},[t._v("ダーティーリード")]),t._v(" "),_("th",{staticStyle:{"text-align":"center"}},[t._v("ノンリピータブルリード")]),t._v(" "),_("th",{staticStyle:{"text-align":"center"}},[t._v("ファンタムリード")])])]),t._v(" "),_("tbody",[_("tr",[_("td",{staticStyle:{"text-align":"left"}},[t._v("READ UNCOMMITTED")]),t._v(" "),_("td",{staticStyle:{"text-align":"left"}},[t._v("他のトランザクションの確定してない(コミットされていない)データを読み取れる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")])]),t._v(" "),_("tr",[_("td",{staticStyle:{"text-align":"left"}},[t._v("READ COMMITTED")]),t._v(" "),_("td",{staticStyle:{"text-align":"left"}},[t._v("他のトランザクションが確定した(コミットした)データを読み取れる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")])]),t._v(" "),_("tr",[_("td",{staticStyle:{"text-align":"left"}},[t._v("REPEATABLE READ")]),t._v(" "),_("td",{staticStyle:{"text-align":"left"}},[t._v("トランザクション内では同じデータは何度読み取っても同じデータになる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("起きる")])]),t._v(" "),_("tr",[_("td",{staticStyle:{"text-align":"left"}},[t._v("SERIALIZABLE")]),t._v(" "),_("td",{staticStyle:{"text-align":"left"}},[t._v("複数トランザクションを同時実行しても1つずつ逐次実行した時と同じ結果になる")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")]),t._v(" "),_("td",{staticStyle:{"text-align":"center"}},[t._v("-")])])])]),t._v(" "),_("p",[t._v("SERIALIZABLE以外の分離レベルでは、分離性･独立性を緩めることになるため、分離性･独立性に違反する現象が発生することを理解する必要がある(データベースの実装によって上記表とは異なるケースもある。例えば、MySQLはREPEATABLE READでもファンタムリードは発生しない実装になっている)")]),t._v(" "),_("ul",[_("li",[_("p",[t._v("ダーティーリード(dirty read)")]),t._v(" "),_("p",[t._v("トランザクション1がデータAを更新した後、トランザクション2がデータAを読み取った状態で、トランザクション1が実行されなければ(ロールバックされる)、トランザクション2が読み取ったデータは実在しないデータを読み取ることになってしまう現象。")]),t._v(" "),_("p",[t._v("取得データを元に何らかの処理を行う場合は、実在しないデータを元に処理を実施してしまう状況になるため、意図しない結果を出力してしまう恐れがある。")])]),t._v(" "),_("li",[_("p",[t._v("ノンリピーダブルリード(non-repeatable read)")]),t._v(" "),_("p",[t._v("トランザクション1がデータAを読み取ったあと、トランザクション2がデータAを変更して確定(コミット)し、トランザクション1が再度データAを読み取った場合、1回目の読み取りと2回目の読み取り結果が異なってしまう現象。")]),t._v(" "),_("p",[t._v("読み取るタイミングによってデータ異なってしまうため、アプリケーションの実装によっては、意図しない結果を出力してしまう恐れがある。")])]),t._v(" "),_("li",[_("p",[t._v("ファンタムリード(phantom read)")]),t._v(" "),_("p",[t._v("トランザクション1が条件Aで検索してデータを読み取ると、データα・βが取得できるとする。トランザクション2が、条件Aに該当するデータγを追加し確定(コミット)した場合、トランザクション1が再び条件Aで検索してデータを読み取ると、データα・β以外に、1回目の読み取りでは存在してなかった、トランザクション2が追加したデータγも読み取ってしまうような現象。")]),t._v(" "),_("p",[t._v("登録データ数などを根拠に処理を行うような実装などで意図しない結果を出力してしまう恐れがある。")])])]),t._v(" "),_("p",[t._v("高い分離レベルを実現するためには、ロックをかけてデータを保護するため必要があるため、同時実行速度が犠牲になる。一方で低い分離レベルは、ロックをかける必要がなくなるため、同時実行時の速度が向上する。データベース製品ごとにどのように分離レベルが実装されているかを理解しつつ、上記のような現象が発生するリスクを許容できるかアプリケーション設計者がよく検討した上で、データの安全性よりも実行速度を重視したい場合、分離レベルを低くすることも1つの選択肢になる。")]),t._v(" "),_("h2",{attrs:{id:"永続性-durability-とは"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#永続性-durability-とは"}},[t._v("#")]),t._v(" 永続性(Durability)とは")]),t._v(" "),_("p",[t._v("永続性とは、トランザクションが確定(コミット)したら、それ以降にデータが失われないように保証する特性。")]),t._v(" "),_("p",[t._v("トランザクションにおいて、処理が全て完了し確定(コミット)する場合、確定(コミット)が成功したら、それ以降は確定されたデータは永久に消えない状態になっている必要がある。")]),t._v(" "),_("p",[t._v("しかし、一般的に永続ディスク(ハードディスク・SSDなど)への書き込みは低速で時間のかかる処理とされている。そのため、LinuxなどのOSは、書き込み処理を高速化するため、永続ディスクよりも高速に書き込みが可能なキャッシュ領域にデータを書き込むことでアプリケーションに対しては書き込み処理完了とするような実装になっている。そして、キャッシュ領域から永続ディスクへは、一定間隔でまとめて書き込みを行う(フラッシュ処理)実装になっているが、キャッシュ領域で使われるのは、揮発性のメモリー(RAM)であるため、電源断が生じるとデータが消失してしまう。")]),t._v(" "),_("p",[t._v("仮に、確定(コミット)が成功したかの根拠となるデータの書き込み成功が、OSが用意しているキャッシュ(揮発性メモリー)領域への書き込みだった場合、電源断などの障害によってデータが消失する可能性があり、永続性の原則に違反する状況が発生してしまう。データベースでは、こうした状況を防ぐため確定(コミット)する際に、OSのキャッシュ領域ではなく、永続ディスクへの書き込みになるように制御するような機能が備わっている。")]),t._v(" "),_("h2",{attrs:{id:"まとめ"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#まとめ"}},[t._v("#")]),t._v(" まとめ")]),t._v(" "),_("h3",{attrs:{id:"データを扱うことの難しさを知る"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データを扱うことの難しさを知る"}},[t._v("#")]),t._v(" データを扱うことの難しさを知る")]),t._v(" "),_("p",[t._v("データを確実に保存し、必要な場面で確実に利用するためには、様々なことに注意を払う必要があります。アプリケーション開発者は、これまで見てきたようなデータに関して起きうる全ての状況を想定しながら、アプリケーションの設計・実装していく必要がありますが、データに関して起きうる全ての事象に対応したアプリケーションを1から実装するのは非現実的です(いわゆる"),_("a",{attrs:{href:"https://ja.wikipedia.org/wiki/%E8%BB%8A%E8%BC%AA%E3%81%AE%E5%86%8D%E7%99%BA%E6%98%8E",target:"_blank",rel:"noopener noreferrer"}},[t._v("車輪の再発明"),_("OutboundLink")],1),t._v(")。")]),t._v(" "),_("h3",{attrs:{id:"データベースを学び利用する"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#データベースを学び利用する"}},[t._v("#")]),t._v(" データベースを学び利用する")]),t._v(" "),_("p",[t._v("データベースを学ぶことは、データを扱う上で起きうる事象を学ぶことができ、アプリケーション開発の中でデータを扱う際に何に配慮すれば良いか見えて来ると思います。また、データベースを利用することで、データを扱う上で起きうる事象への配慮をデータベースに任せることができれば、アプリケーション開発者はアプリケーションに求められる本質的な機能の実装に集中でき、より良いアプリケーション開発を行うことができるようになると思います。")]),t._v(" "),_("h3",{attrs:{id:"必要な機能を備えたデータベース製品を選定する"}},[_("a",{staticClass:"header-anchor",attrs:{href:"#必要な機能を備えたデータベース製品を選定する"}},[t._v("#")]),t._v(" 必要な機能を備えたデータベース製品を選定する")]),t._v(" "),_("p",[t._v("昨今、様々なデータベース製品がリリースされています。それらの製品ごとにメリット･デメリット、得意･不得意な領域が存在します。データの安全性を重視するのか、それとも速度を重視するかなど、アプリケーションごとにデータに対する要求の方向性は変わってきますが、求める方向性に合致するデータベース製品を選定できるようになるためにも、データベースの知識を持つことが重要だと思います。")])])}),[],!1,null,null,null);_.default=e.exports}}]); \ No newline at end of file diff --git a/assets/js/20.df074b21.js b/assets/js/20.fe633865.js similarity index 99% rename from assets/js/20.df074b21.js rename to assets/js/20.fe633865.js index 1560b392..c8be5034 100644 --- a/assets/js/20.df074b21.js +++ b/assets/js/20.fe633865.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[20],{484:function(s,a,t){s.exports=t.p+"assets/img/apache-start.82b13324.png"},485:function(s,a,t){s.exports=t.p+"assets/img/site-80.7a41e96d.png"},486:function(s,a,t){s.exports=t.p+"assets/img/site-81.19ee5e97.png"},556:function(s,a,t){"use strict";t.r(a);var e=t(10),n=Object(e.a)({},(function(){var s=this,a=s._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[a("h1",{attrs:{id:"apache-を触ってみよう"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#apache-を触ってみよう"}},[s._v("#")]),s._v(" Apache を触ってみよう")]),s._v(" "),a("h2",{attrs:{id:"事前準備"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#事前準備"}},[s._v("#")]),s._v(" 事前準備")]),s._v(" "),a("p",[s._v("以下のように"),a("code",[s._v("docker pull")]),s._v("をしておいてください。")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" pull python:3.8.2-buster\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("h2",{attrs:{id:"apacheとは"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#apacheとは"}},[s._v("#")]),s._v(" Apacheとは")]),s._v(" "),a("p",[s._v("「Apache HTTP Server」はnginxと並んで2台勢力を誇っているWebサーバソフトウェアのひとつです。\nCentOSではhttpdという名前になっていたり、単にApacheと呼ばれます。")]),s._v(" "),a("p",[s._v("Webサーバソフトウェアとは、HTTPリクエストを受けて何らかのレスポンスを返すソフトウェアのことで、たとえばHTMLファイルなどをブラウザに返すなどの役割を持っています。\nWebを扱ううえでほぼ必ず必要になる、現代に欠かせないソフトウェアです。")]),s._v(" "),a("h3",{attrs:{id:"webサーバソフトウェアのユースケース"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#webサーバソフトウェアのユースケース"}},[s._v("#")]),s._v(" Webサーバソフトウェアのユースケース")]),s._v(" "),a("p",[s._v("ApacheやnginxといったWebサーバの役割を並べてみると、以下のようになります。")]),s._v(" "),a("ul",[a("li",[s._v("HTMLやテキストファイルの配信")]),s._v(" "),a("li",[s._v("動的アプリケーションのホスティング\n"),a("ul",[a("li",[s._v("jsonを返すようなWeb APIを含む")])])]),s._v(" "),a("li",[s._v("リクエストを中継するプロキシ")]),s._v(" "),a("li",[s._v("Basic認証などによる認証処理")]),s._v(" "),a("li",[s._v("ACLなどのアクセス制御・不正な通信への防御")])]),s._v(" "),a("p",[s._v("一番初めのWebサーバの役割は、HTTPのリクエストを受け取りそれに対応するHTMLファイルを返すことでした。\n今でも大半の役割がこれです。それに付随して認証処理やアクセス制御といったセキュリティ的な役割も持つようになります。")]),s._v(" "),a("p",[s._v("その後CGI(Perl)というしくみが登場し、静的なファイルだけではなく動的にページを生成しそれを返す役割を持つようになりました。\n現在はPerlが使われることはめったにありませんが、PHPやRuby・Pythonなどの言語で書かれたプログラムを使って動的なページを扱うことができます。")]),s._v(" "),a("p",[s._v("最近では動的なページ生成を行うプログラムは別で立て、Webサーバはそこに対してリクエストを中継するだけという使われ方も増えてきました。\nこの時Webサーバは不正なリクエストを弾いたり、後段のアプリケーションの負荷分散や冗長性の確保といった役割を持ちます。\n（ほかにもroutingやlogging、アクセス管理などWebサーバに求められる基本的な機能を提供してくれます。）")]),s._v(" "),a("h3",{attrs:{id:"動的アプリケーションのホスティングとモジュール"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#動的アプリケーションのホスティングとモジュール"}},[s._v("#")]),s._v(" 動的アプリケーションのホスティングとモジュール")]),s._v(" "),a("p",[s._v("Apacheやnginxにはモジュールと呼ばれる、いわゆるプラグインのしくみがあります。\nさまざまなモジュールが存在していますが、動的アプリケーションのホスティングもこのモジュールを使ってツールを読み込むことで実現します。")]),s._v(" "),a("p",[s._v("PythonやJavaといったWebアプリケーションをモジュールから動作させる大きな利点として、プロセス管理をApacheに任せられることがあります。\nPythonなどの言語は基本的にシングルプロセスで動作するため、同時に多くのリクエストをさばく必要のあるWebアプリケーションとして動作させるには、何らかの方法でマルチプロセス化する必要があります。\nApacheには多くのリクエストをさばくためpre-forkなどのマルチプロセスを管理するしくみが備わっています。ApacheのモジュールからWebアプリケーションを実行することで、Apacheによるプロセス管理の恩恵に預かることができます。")]),s._v(" "),a("p",[s._v("別の手段として、"),a("a",{attrs:{href:"https://yhbt.net/unicorn/",target:"_blank",rel:"noopener noreferrer"}},[s._v("Unicorn(ruby)"),a("OutboundLink")],1),s._v("や"),a("a",{attrs:{href:"https://gunicorn.org/",target:"_blank",rel:"noopener noreferrer"}},[s._v("Gunicorn(Python)"),a("OutboundLink")],1),s._v("といったツールでマルチプロセス対応をする。あるいはGo言語など初めから並列処理を前提にした言語の場合はApacheでプロセス管理を行う必要はありません。")]),s._v(" "),a("p",[s._v("その場合Webサーバはプロキシとしての役割に集中することとなります。")]),s._v(" "),a("h3",{attrs:{id:"apacheの立ち位置"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#apacheの立ち位置"}},[s._v("#")]),s._v(" Apacheの立ち位置")]),s._v(" "),a("p",[s._v("Apacheは「Apacheソフトウェア財団」によって管理されるOSSで、20年以上の歴史を持ちます。\n世界的にもっとも普及したWebサーバで、LAMP（Linux, Apache, MySQL, PHP）環境のひとつにも挙げられます。")]),s._v(" "),a("p",[s._v("以前は大量のリクエストを受けた際にプロセスをforkできず、リクエストを捌き切れなくなる（いわゆるC10K問題）ことが問題視されました。\nその際nginxをはじめとして新しいWebサーバーソフトウェアが登場しましたが、Apache自体もworkerやevent MPMといった新しい仕組みを導入し、動作も安定していることからいまだに高いシェアを占めています。")]),s._v(" "),a("p",[s._v("参考: "),a("a",{attrs:{href:"https://news.netcraft.com/archives/2020/02/20/february-2020-web-server-survey.html",target:"_blank",rel:"noopener noreferrer"}},[s._v("February 2020 Web Server Survey"),a("OutboundLink")],1),s._v(")")]),s._v(" "),a("h2",{attrs:{id:"apacheをインストールして立ち上げる"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#apacheをインストールして立ち上げる"}},[s._v("#")]),s._v(" Apacheをインストールして立ち上げる")]),s._v(" "),a("p",[s._v("なにはともあれ動かしてみましょう。今回はdebianをdockerで立ち上げてその中にApacheをインストールしてみます。")]),s._v(" "),a("p",[s._v("まずは以下のようにdockerコンテナの中に入ります。")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" run --rm -itd --name test-debian -p "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("8080")]),s._v(":80 -p "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("8081")]),s._v(":81 python:3.8.2-buster /bin/bash\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("exec")]),s._v(" -it test-debian /bin/bash\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("p",[s._v("入れたら"),a("code",[s._v("apt install")]),s._v("を使ってApacheをインストールしてみましょう。")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("apt")]),s._v(" update\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Get:1 http://security.ubuntu.com/ubuntu focal-security InRelease [107 kB]")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Get:2 http://security.ubuntu.com/ubuntu focal-security/restricted amd64 Packages [4673 B]")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Get:3 http://security.ubuntu.com/ubuntu focal-security/main amd64 Packages [60.9 kB]")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Get:4 http://security.ubuntu.com/ubuntu focal-security/universe amd64 Packages [8273 B]")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#~~~略~~~")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("apt")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("install")]),s._v(" -y apache2 apache2-dev "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("vim")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Reading package lists... Done")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Building dependency tree")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Reading state information... Done")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#~~~略~~~")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Updating certificates in /etc/ssl/certs...")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#0 added, 0 removed; done.")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Running hooks in /etc/ca-certificates/update.d...")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#done.")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br"),a("span",{staticClass:"line-number"},[s._v("18")]),a("br")])]),a("p",[s._v("途中でtimezoneなどを聞かれたら"),a("code",[s._v("Asia")]),s._v("や"),a("code",[s._v("Tokyo")]),s._v("を選んでください。以下のようにバージョンを表示できれば成功です。")]),s._v(" "),a("div",{staticClass:"language-shell line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-shell"}},[a("code",[s._v("apache2 -v\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Server version: Apache/2.4.38 (Debian)")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Server built: 2019-10-15T19:53:42")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v("以下のようにApacheを起動してください。")]),s._v(" "),a("div",{staticClass:"language-shell line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-shell"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("service")]),s._v(" apache2 start\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("ブラウザを開いて"),a("code",[s._v("localhost:8080")]),s._v("にアクセスしてみてください。以下のような画面が表示されれば成功です。")]),s._v(" "),a("p",[a("img",{attrs:{src:t(484),alt:"apache-start"}})]),s._v(" "),a("h2",{attrs:{id:"htmlファイルの配信-check1"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#htmlファイルの配信-check1"}},[s._v("#")]),s._v(" HTMLファイルの配信 (check1)")]),s._v(" "),a("p",[s._v("表示されたページはデフォルトのHTMLファイルです。これを自分で作成したページに置き換えてみます。\nデフォルトではDocument Rootは"),a("code",[s._v("/var/www/html/")]),s._v("に設定されています。")]),s._v(" "),a("div",{staticClass:"custom-block tip"},[a("p",{staticClass:"custom-block-title"},[s._v("TIP")]),s._v(" "),a("p",[s._v("Document RootはApacheが静的ファイルを配信するためのroot directoryです。")])]),s._v(" "),a("p",[s._v("この下にある"),a("code",[s._v("index.html")]),s._v("ファイルを自分の物に置き換えてみましょう。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("cd")]),s._v(" /var/www/html/\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mv")]),s._v(" index.html _index.html\n"),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("echo")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Hello Bootcamp!!'")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),s._v(" index.html\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v("再び"),a("code",[s._v("http://localhost:8080/")]),s._v("を開くと"),a("code",[s._v("Hello Bootcamp!!")]),s._v("が表示されるのを確認してください。")]),s._v(" "),a("div",{staticClass:"custom-block tip"},[a("p",{staticClass:"custom-block-title"},[s._v("TIP")]),s._v(" "),a("p",[a("code",[s._v("http://localhost:8080/")]),s._v(" のようにファイル名を指定せずディレクトリ（この場合はルートディレクトリ）を指定した場合、Apacheは"),a("code",[s._v("index.html")]),s._v("を返すようにデフォルトで設定されています。\nこの設定は変更できます。")])]),s._v(" "),a("p",[s._v("Document Root配下にディレクトリを作成するとブラウザからも同様にアクセスできます。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mkdir")]),s._v(" /var/www/html/hoge\n"),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("echo")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Hello HUGA!!'")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),s._v(" /var/www/html/hoge/huga.txt\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("p",[a("code",[s._v("http://localhost:8080/hoge/huga.txt")]),s._v(" にアクセスすると追加したファイルが表示されます。")]),s._v(" "),a("h2",{attrs:{id:"virtualhost-の設定"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#virtualhost-の設定"}},[s._v("#")]),s._v(" VirtualHost の設定")]),s._v(" "),a("p",[s._v("1つのApacheで複数のWebサイトを管理したいことがあります。異なるIPアドレスやアドレス、port番号からアクセスされた時にDocument Rootなどを切り替えたいときは"),a("code",[s._v("VirtualHost")]),s._v("を設定することで実現できます。")]),s._v(" "),a("p",[s._v("ここではport番号を"),a("code",[s._v("80")]),s._v("と"),a("code",[s._v("81")]),s._v("に分けて別々のWebサイトを設定してみます。\n(docker起動時にport forwardしているため、手元からは"),a("code",[s._v("8080")]),s._v("と"),a("code",[s._v("8081")]),s._v("からアクセスできます。)")]),s._v(" "),a("p",[s._v("まずは新しくDocument RootになるディレクトリとHTMLファイルを作成します。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mkdir")]),s._v(" /var/www/html/site-80\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mkdir")]),s._v(" /var/www/html/site-81\n"),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("echo")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'This is site 80!'")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),s._v(" /var/www/html/site-80/index.html\n"),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("echo")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'This is site 81!'")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),s._v(" /var/www/html/site-81/index.html\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br")])]),a("p",[s._v("次にApacheの設定をして行きます。やることは")]),s._v(" "),a("ul",[a("li",[s._v("listen portに81を追加")]),s._v(" "),a("li",[s._v("virtual host設定の追加")])]),s._v(" "),a("p",[s._v("の2つです。listen portの追加は"),a("code",[s._v("/etc/apache2/ports.conf")]),s._v("に書きましょう。\n以下のように"),a("code",[s._v("Listen 80")]),s._v(" の下に "),a("code",[s._v("Listen 81")]),s._v("の記述を追加します。")]),s._v(" "),a("div",{staticClass:"language-apache line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[s._v("# If you just change the port or add more ports here, you will likely also\n# have to change the VirtualHost statement in\n# /etc/apache2/sites-enabled/000-default.conf\n\nListen 80\nListen 81\n\n\n Listen 443\n\n\n\n Listen 443\n\n\n# vim: syntax=apache ts=4 sw=4 sts=4 sr noet\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br")])]),a("p",[s._v("VitrualHostの設定は"),a("code",[s._v("/etc/apache2/sites-available")]),s._v("の下に作成して行きます。")]),s._v(" "),a("p",[a("code",[s._v("/etc/apache2/sites-available/site-80.conf")])]),s._v(" "),a("div",{staticClass:"language-xml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-xml"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),s._v("VirtualHost")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("*:")]),s._v("80")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v("\n DocumentRoot /var/www/html/site-80\n"),a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("")])]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[a("code",[s._v("/etc/apache2/sites-available/site-81.conf")])]),s._v(" "),a("div",{staticClass:"language-xml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-xml"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),s._v("VirtualHost")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("*:")]),s._v("81")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v("\n DocumentRoot /var/www/html/site-81\n"),a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("")])]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v("設定ファイルを作成したら"),a("code",[s._v("a2dissite")]),s._v("、"),a("code",[s._v("a2ensite")]),s._v("コマンドを使って設定を有効化しましょう。")]),s._v(" "),a("div",{staticClass:"custom-block tip"},[a("p",{staticClass:"custom-block-title"},[s._v("TIP")]),s._v(" "),a("p",[a("code",[s._v("a2dissite")]),s._v("や"),a("code",[s._v("a2ensite")]),s._v("といったコマンドは実はapache本体の機能ではありません。"),a("code",[s._v("a2ensite")]),s._v("は"),a("code",[s._v("/etc/apache2/sites-available")]),s._v("以下のファイルのsimlinkを"),a("code",[s._v("/etc/apache2/sites-enable")]),s._v("以下に追加するだけのコマンドです。\n実際のApacheは"),a("code",[s._v("/etc/apache2/sites-enable")]),s._v("以下のコンフィグファイルをloadしているため、コマンドによってサイトが有効化されたように見えるのです。")]),s._v(" "),a("p",[s._v("CentOSなど他のディストリビューションでは、これらのコマンドが存在しないことが多いので注意してください。")])]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("a2dissite 000-default\na2ensite site-80\na2ensite site-81\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v("そしてApacheをリスタートします。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("service")]),s._v(" apache2 reload\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[a("code",[s._v("localhost:8080")]),s._v("と"),a("code",[s._v("localhost:8081")]),s._v("にアクセスしてみてください。意図通りの挙動になっているでしょうか。")]),s._v(" "),a("table",[a("thead",[a("tr",[a("th",[a("img",{attrs:{src:t(485),alt:"site-80"}})])])]),s._v(" "),a("tbody")]),s._v(" "),a("table",[a("thead",[a("tr",[a("th",[a("img",{attrs:{src:t(486),alt:"site-81"}})])])]),s._v(" "),a("tbody")]),s._v(" "),a("h2",{attrs:{id:"basic-認証をかけてみる-check2"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#basic-認証をかけてみる-check2"}},[s._v("#")]),s._v(" Basic 認証をかけてみる(check2)")]),s._v(" "),a("p",[s._v("特定ディレクトリにアクセスできる人を制限するために、Basic認証をかけてみましょう。\nBasic認証用のmoduleが既にインストールされているはずなので、有効化します。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("a2enmod auth_basic\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("ls")]),s._v(" -l /etc/apache2/mods-enabled/auth_basic.load "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#確認")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#lrwxrwxrwx 1 root root 33 May 10 23:22 /etc/apache2/mods-enabled/auth_basic.load -> ../mods-available/auth_basic.load")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br")])]),a("p",[s._v("まずはパスワードが記載された"),a("code",[s._v(".htpasswd")]),s._v("ファイルを作成します。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mkdir")]),s._v(" /etc/apache2/auth/\nhtpasswd -c /etc/apache2/auth/.htpasswd admin\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("p",[a("code",[s._v("admin")]),s._v("がユーザ名になります。パスワードの入力を求められるので、適当に設定してください。")]),s._v(" "),a("p",[s._v("次に"),a("code",[s._v("/etc/apache2/sites-available/site-81.conf")]),s._v("を以下のように編集します。")]),s._v(" "),a("div",{staticClass:"language-xml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-xml"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),s._v("VirtualHost")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("*:")]),s._v("81")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v('\n DocumentRoot /var/www/html/site-81\n \n AuthUserFile /etc/apache2/auth/.htpasswd\n AuthName "site-81 Authorization"\n AuthType Basic\n Require valid-user\n '),a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("")])]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("")])]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br")])]),a("p",[s._v("ファイルを編集したら"),a("code",[s._v("service apache2 restart")]),s._v("で再起動しましょう。"),a("code",[s._v("localhost:8081")]),s._v("にアクセスしてみてください。パスワードが求められ、先ほど入力した認証情報を入れないとアクセスできなくなっているはずです。")]),s._v(" "),a("h2",{attrs:{id:"pythonアプリを動かしてみよう-check3"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#pythonアプリを動かしてみよう-check3"}},[s._v("#")]),s._v(" Pythonアプリを動かしてみよう(check3)")]),s._v(" "),a("p",[s._v("ここまではVirtualHostでリソースを管理しつつ、静的なファイルを配信する設定を作ってきました。この章では別のユースケースとして、Pythonで書かれたWebアプリをApache経由で動かす設定を作ってみます。")]),s._v(" "),a("p",[s._v("このdocker imageには既にpythonがインストールされています。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("python --version\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Python 3.8.2")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("p",[s._v("Pythonで作成したWebアプリをApacheなどから実行する場合、"),a("a",{attrs:{href:"https://ja.wikipedia.org/wiki/Web_Server_Gateway_Interface",target:"_blank",rel:"noopener noreferrer"}},[s._v("WSGI"),a("OutboundLink")],1),s._v("というインタフェース定義に従ってWebアプリを作成します。\nこれはPython側のインタフェースを規定することで、他のプログラム(今回の場合Apache)から呼び出しやすくする物です。")]),s._v(" "),a("p",[s._v("あとでやるDjangoなど主要なPythonフレームワークはこのAPIに従っているため、Djangoで作成したアプリは今回と同じ手順でApacheから実行することができます。")]),s._v(" "),a("p",[s._v("以下のようなPythonコードを"),a("code",[s._v("/var/www/html/site-80")]),s._v("以下に置いておきましょう。")]),s._v(" "),a("p",[a("code",[s._v("vim /var/www/html/site-80/app.py")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("application")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("environ"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" start_response"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n status "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'200 OK'")]),s._v("\n output "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("b'Hello! This is python application!'")]),s._v("\n\n response_headers "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-type'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'text/plain'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Length'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("str")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("len")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("output"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n start_response"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("status"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" response_headers"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),s._v("output"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br")])]),a("p",[s._v("次にwsgiを動かすためのApache moduleをインストールします。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("pip "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("install")]),s._v(" mod-wsgi\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Collecting mod-wsgi")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Using cached mod_wsgi-4.7.1.tar.gz (498 kB)")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Building wheels for collected packages: mod-wsgi")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Building wheel for mod-wsgi (setup.py) ... done")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Created wheel for mod-wsgi: filename=mod_wsgi-4.7.1-cp38-cp38-linux_x86_64.whl size=809821 sha256=570b19e67813e819f04ee00006b5c556339e37a03dea4af0021837b098588c0d")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Stored in directory: /root/.cache/pip/wheels/e9/82/71/1b42d6274a24af477453cecc993213fc8abd15433d80b01e93")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Successfully built mod-wsgi")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Installing collected packages: mod-wsgi")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Successfully installed mod-wsgi-4.7.1")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br")])]),a("p",[s._v("インストールすると以下のディレクトリにsoファイルが生成されています。Apacheに読み込ませる必要があるため確認しておきましょう。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("ls")]),s._v(" /usr/local/lib/python3.8/site-packages/mod_wsgi/server/mod_wsgi-py38.cpython-38-x86_64-linux-gnu.so\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("このファイルを読み込むように、"),a("code",[s._v("vim /etc/apache2/mods-available/wsgi.load")]),s._v("を以下のように作成します。")]),s._v(" "),a("div",{staticClass:"language-xml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-xml"}},[a("code",[s._v("LoadModule wsgi_module /usr/local/lib/python3.8/site-packages/mod_wsgi/server/mod_wsgi-py38.cpython-38-x86_64-linux-gnu.so\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("moduleを有効化しておきます。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("a2enmod wsgi\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("準備が整ったのでsite-80に先ほどのPythonアプリケーションを読み込ませましょう。\n"),a("code",[s._v("vim /etc/apache2/sites-available/site-80.conf")])]),s._v(" "),a("div",{staticClass:"language-xml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-xml"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),s._v("VirtualHost")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("*:")]),s._v("80")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v("\n DocumentRoot /var/www/html/site-80\n WSGIScriptAlias /app /var/www/html/site-80/app.py\n"),a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("")])]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br")])]),a("p",[s._v("最後にApacheをリスタートします。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("service")]),s._v(" apache2 restart\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[a("code",[s._v("http://localhost:8080/app")]),s._v(" にアクセスしてみてください。"),a("code",[s._v("Hello! This is python application!")]),s._v(" が表示されるでしょうか。")]),s._v(" "),a("p",[s._v("うまくいったら"),a("code",[s._v("app.py")]),s._v("を適当に変更して、Pythonが動的に実行されているのを確認してください。")]),s._v(" "),a("h2",{attrs:{id:"パフォーマンス測定-任意課題"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#パフォーマンス測定-任意課題"}},[s._v("#")]),s._v(" パフォーマンス測定（任意課題）")]),s._v(" "),a("p",[s._v("ApacheにはApache Benchというパフォーマンス測定ツールがついています。これを使ってMPMの違いがどのようにパフォーマンスに影響するか確認してみましょう。")]),s._v(" "),a("p",[s._v("Apache Benchは"),a("code",[s._v("ab")]),s._v("コマンドで使用できます。試しに先ほどのPythonアプリケーションのパフォーマンスを測定してみましょう。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("ab -n "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("1000")]),s._v(" -c "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("100")]),s._v(" localhost:80/app\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("これは"),a("code",[s._v("localhost:80/app")]),s._v("に対して合計10000リクエストを同時に100ずつ実行するコマンドです。\n実行結果には成功したリクエスト数や処理時間など、分析に使える情報が書かれています。")]),s._v(" "),a("p",[s._v("同時に1000リクエストを投げても、この時点では捌けていると思います。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("ab -n "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("1000")]),s._v(" -c "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("1000")]),s._v(" localhost:80/app\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("これだけでは面白くないので、pythonアプリにわざとディレイを入れてみましょう。")]),s._v(" "),a("p",[a("code",[s._v("vim /var/www/html/site-80/app.py")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" time\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("application")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("environ"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" start_response"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n time"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("sleep"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n status "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'200 OK'")]),s._v("\n output "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("b'Hello! Thisa is python application!'")]),s._v("\n\n response_headers "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-type'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'text/plain'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Length'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("str")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("len")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("output"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n start_response"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("status"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" response_headers"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),s._v("output"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br")])]),a("p",[s._v("保存したらもう一度")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("ab -n "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("1000")]),s._v(" -c "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("1000")]),s._v(" localhost:80/app\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("を試してみましょう。理論上は3秒で全部のリクエストが成功するはずですがどうでしょうか。\nさらにもっと数を増やすとどうでしょうか。")]),s._v(" "),a("p",[s._v("他にも色んなことを試してみてください。")]),s._v(" "),a("ul",[a("li",[s._v("psコマンドでApacheのプロセスを確認して、リクエスト中に何が起こってるのか確認しましょう。\n"),a("ul",[a("li",[s._v("apache の再起動直後とパフォーマンス測定後の変化を見てみましょう")])])]),s._v(" "),a("li",[a("code",[s._v("/var/log/apache2/error.log")]),s._v(" を確認してみましょう")]),s._v(" "),a("li",[s._v("MPM(Multi-Processing-Module)をpreforkやworkerに変えるとどうなるでしょうか")]),s._v(" "),a("li",[s._v("MPMの設定を変えてパフォーマンスチューニングをしてみましょう")])]),s._v(" "),a("h3",{attrs:{id:"補足-mpmの変更"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#補足-mpmの変更"}},[s._v("#")]),s._v(" 補足: MPMの変更")]),s._v(" "),a("p",[s._v("現在のMPMの確認")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("apachectl -V "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("|")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("grep")]),s._v(" MPM\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Server MPM: event")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v("MPMをpreforkに変更する。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("a2dismod mpm_event\na2enmod mpm_prefork\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("service")]),s._v(" apache2 restart\napachectl -V "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("|")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("grep")]),s._v(" MPM\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Server MPM: prefork")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br")])]),a("credit-footer")],1)}),[],!1,null,null,null);a.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[20],{485:function(s,a,t){s.exports=t.p+"assets/img/apache-start.82b13324.png"},486:function(s,a,t){s.exports=t.p+"assets/img/site-80.7a41e96d.png"},487:function(s,a,t){s.exports=t.p+"assets/img/site-81.19ee5e97.png"},557:function(s,a,t){"use strict";t.r(a);var e=t(10),n=Object(e.a)({},(function(){var s=this,a=s._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[a("h1",{attrs:{id:"apache-を触ってみよう"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#apache-を触ってみよう"}},[s._v("#")]),s._v(" Apache を触ってみよう")]),s._v(" "),a("h2",{attrs:{id:"事前準備"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#事前準備"}},[s._v("#")]),s._v(" 事前準備")]),s._v(" "),a("p",[s._v("以下のように"),a("code",[s._v("docker pull")]),s._v("をしておいてください。")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" pull python:3.8.2-buster\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("h2",{attrs:{id:"apacheとは"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#apacheとは"}},[s._v("#")]),s._v(" Apacheとは")]),s._v(" "),a("p",[s._v("「Apache HTTP Server」はnginxと並んで2台勢力を誇っているWebサーバソフトウェアのひとつです。\nCentOSではhttpdという名前になっていたり、単にApacheと呼ばれます。")]),s._v(" "),a("p",[s._v("Webサーバソフトウェアとは、HTTPリクエストを受けて何らかのレスポンスを返すソフトウェアのことで、たとえばHTMLファイルなどをブラウザに返すなどの役割を持っています。\nWebを扱ううえでほぼ必ず必要になる、現代に欠かせないソフトウェアです。")]),s._v(" "),a("h3",{attrs:{id:"webサーバソフトウェアのユースケース"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#webサーバソフトウェアのユースケース"}},[s._v("#")]),s._v(" Webサーバソフトウェアのユースケース")]),s._v(" "),a("p",[s._v("ApacheやnginxといったWebサーバの役割を並べてみると、以下のようになります。")]),s._v(" "),a("ul",[a("li",[s._v("HTMLやテキストファイルの配信")]),s._v(" "),a("li",[s._v("動的アプリケーションのホスティング\n"),a("ul",[a("li",[s._v("jsonを返すようなWeb APIを含む")])])]),s._v(" "),a("li",[s._v("リクエストを中継するプロキシ")]),s._v(" "),a("li",[s._v("Basic認証などによる認証処理")]),s._v(" "),a("li",[s._v("ACLなどのアクセス制御・不正な通信への防御")])]),s._v(" "),a("p",[s._v("一番初めのWebサーバの役割は、HTTPのリクエストを受け取りそれに対応するHTMLファイルを返すことでした。\n今でも大半の役割がこれです。それに付随して認証処理やアクセス制御といったセキュリティ的な役割も持つようになります。")]),s._v(" "),a("p",[s._v("その後CGI(Perl)というしくみが登場し、静的なファイルだけではなく動的にページを生成しそれを返す役割を持つようになりました。\n現在はPerlが使われることはめったにありませんが、PHPやRuby・Pythonなどの言語で書かれたプログラムを使って動的なページを扱うことができます。")]),s._v(" "),a("p",[s._v("最近では動的なページ生成を行うプログラムは別で立て、Webサーバはそこに対してリクエストを中継するだけという使われ方も増えてきました。\nこの時Webサーバは不正なリクエストを弾いたり、後段のアプリケーションの負荷分散や冗長性の確保といった役割を持ちます。\n（ほかにもroutingやlogging、アクセス管理などWebサーバに求められる基本的な機能を提供してくれます。）")]),s._v(" "),a("h3",{attrs:{id:"動的アプリケーションのホスティングとモジュール"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#動的アプリケーションのホスティングとモジュール"}},[s._v("#")]),s._v(" 動的アプリケーションのホスティングとモジュール")]),s._v(" "),a("p",[s._v("Apacheやnginxにはモジュールと呼ばれる、いわゆるプラグインのしくみがあります。\nさまざまなモジュールが存在していますが、動的アプリケーションのホスティングもこのモジュールを使ってツールを読み込むことで実現します。")]),s._v(" "),a("p",[s._v("PythonやJavaといったWebアプリケーションをモジュールから動作させる大きな利点として、プロセス管理をApacheに任せられることがあります。\nPythonなどの言語は基本的にシングルプロセスで動作するため、同時に多くのリクエストをさばく必要のあるWebアプリケーションとして動作させるには、何らかの方法でマルチプロセス化する必要があります。\nApacheには多くのリクエストをさばくためpre-forkなどのマルチプロセスを管理するしくみが備わっています。ApacheのモジュールからWebアプリケーションを実行することで、Apacheによるプロセス管理の恩恵に預かることができます。")]),s._v(" "),a("p",[s._v("別の手段として、"),a("a",{attrs:{href:"https://yhbt.net/unicorn/",target:"_blank",rel:"noopener noreferrer"}},[s._v("Unicorn(ruby)"),a("OutboundLink")],1),s._v("や"),a("a",{attrs:{href:"https://gunicorn.org/",target:"_blank",rel:"noopener noreferrer"}},[s._v("Gunicorn(Python)"),a("OutboundLink")],1),s._v("といったツールでマルチプロセス対応をする。あるいはGo言語など初めから並列処理を前提にした言語の場合はApacheでプロセス管理を行う必要はありません。")]),s._v(" "),a("p",[s._v("その場合Webサーバはプロキシとしての役割に集中することとなります。")]),s._v(" "),a("h3",{attrs:{id:"apacheの立ち位置"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#apacheの立ち位置"}},[s._v("#")]),s._v(" Apacheの立ち位置")]),s._v(" "),a("p",[s._v("Apacheは「Apacheソフトウェア財団」によって管理されるOSSで、20年以上の歴史を持ちます。\n世界的にもっとも普及したWebサーバで、LAMP（Linux, Apache, MySQL, PHP）環境のひとつにも挙げられます。")]),s._v(" "),a("p",[s._v("以前は大量のリクエストを受けた際にプロセスをforkできず、リクエストを捌き切れなくなる（いわゆるC10K問題）ことが問題視されました。\nその際nginxをはじめとして新しいWebサーバーソフトウェアが登場しましたが、Apache自体もworkerやevent MPMといった新しい仕組みを導入し、動作も安定していることからいまだに高いシェアを占めています。")]),s._v(" "),a("p",[s._v("参考: "),a("a",{attrs:{href:"https://news.netcraft.com/archives/2020/02/20/february-2020-web-server-survey.html",target:"_blank",rel:"noopener noreferrer"}},[s._v("February 2020 Web Server Survey"),a("OutboundLink")],1),s._v(")")]),s._v(" "),a("h2",{attrs:{id:"apacheをインストールして立ち上げる"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#apacheをインストールして立ち上げる"}},[s._v("#")]),s._v(" Apacheをインストールして立ち上げる")]),s._v(" "),a("p",[s._v("なにはともあれ動かしてみましょう。今回はdebianをdockerで立ち上げてその中にApacheをインストールしてみます。")]),s._v(" "),a("p",[s._v("まずは以下のようにdockerコンテナの中に入ります。")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" run --rm -itd --name test-debian -p "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("8080")]),s._v(":80 -p "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("8081")]),s._v(":81 python:3.8.2-buster /bin/bash\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("exec")]),s._v(" -it test-debian /bin/bash\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("p",[s._v("入れたら"),a("code",[s._v("apt install")]),s._v("を使ってApacheをインストールしてみましょう。")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("apt")]),s._v(" update\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Get:1 http://security.ubuntu.com/ubuntu focal-security InRelease [107 kB]")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Get:2 http://security.ubuntu.com/ubuntu focal-security/restricted amd64 Packages [4673 B]")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Get:3 http://security.ubuntu.com/ubuntu focal-security/main amd64 Packages [60.9 kB]")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Get:4 http://security.ubuntu.com/ubuntu focal-security/universe amd64 Packages [8273 B]")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#~~~略~~~")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("apt")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("install")]),s._v(" -y apache2 apache2-dev "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("vim")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Reading package lists... Done")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Building dependency tree")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Reading state information... Done")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#~~~略~~~")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Updating certificates in /etc/ssl/certs...")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#0 added, 0 removed; done.")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Running hooks in /etc/ca-certificates/update.d...")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#done.")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br"),a("span",{staticClass:"line-number"},[s._v("18")]),a("br")])]),a("p",[s._v("途中でtimezoneなどを聞かれたら"),a("code",[s._v("Asia")]),s._v("や"),a("code",[s._v("Tokyo")]),s._v("を選んでください。以下のようにバージョンを表示できれば成功です。")]),s._v(" "),a("div",{staticClass:"language-shell line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-shell"}},[a("code",[s._v("apache2 -v\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Server version: Apache/2.4.38 (Debian)")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Server built: 2019-10-15T19:53:42")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v("以下のようにApacheを起動してください。")]),s._v(" "),a("div",{staticClass:"language-shell line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-shell"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("service")]),s._v(" apache2 start\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("ブラウザを開いて"),a("code",[s._v("localhost:8080")]),s._v("にアクセスしてみてください。以下のような画面が表示されれば成功です。")]),s._v(" "),a("p",[a("img",{attrs:{src:t(485),alt:"apache-start"}})]),s._v(" "),a("h2",{attrs:{id:"htmlファイルの配信-check1"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#htmlファイルの配信-check1"}},[s._v("#")]),s._v(" HTMLファイルの配信 (check1)")]),s._v(" "),a("p",[s._v("表示されたページはデフォルトのHTMLファイルです。これを自分で作成したページに置き換えてみます。\nデフォルトではDocument Rootは"),a("code",[s._v("/var/www/html/")]),s._v("に設定されています。")]),s._v(" "),a("div",{staticClass:"custom-block tip"},[a("p",{staticClass:"custom-block-title"},[s._v("TIP")]),s._v(" "),a("p",[s._v("Document RootはApacheが静的ファイルを配信するためのroot directoryです。")])]),s._v(" "),a("p",[s._v("この下にある"),a("code",[s._v("index.html")]),s._v("ファイルを自分の物に置き換えてみましょう。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("cd")]),s._v(" /var/www/html/\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mv")]),s._v(" index.html _index.html\n"),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("echo")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Hello Bootcamp!!'")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),s._v(" index.html\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v("再び"),a("code",[s._v("http://localhost:8080/")]),s._v("を開くと"),a("code",[s._v("Hello Bootcamp!!")]),s._v("が表示されるのを確認してください。")]),s._v(" "),a("div",{staticClass:"custom-block tip"},[a("p",{staticClass:"custom-block-title"},[s._v("TIP")]),s._v(" "),a("p",[a("code",[s._v("http://localhost:8080/")]),s._v(" のようにファイル名を指定せずディレクトリ（この場合はルートディレクトリ）を指定した場合、Apacheは"),a("code",[s._v("index.html")]),s._v("を返すようにデフォルトで設定されています。\nこの設定は変更できます。")])]),s._v(" "),a("p",[s._v("Document Root配下にディレクトリを作成するとブラウザからも同様にアクセスできます。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mkdir")]),s._v(" /var/www/html/hoge\n"),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("echo")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Hello HUGA!!'")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),s._v(" /var/www/html/hoge/huga.txt\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("p",[a("code",[s._v("http://localhost:8080/hoge/huga.txt")]),s._v(" にアクセスすると追加したファイルが表示されます。")]),s._v(" "),a("h2",{attrs:{id:"virtualhost-の設定"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#virtualhost-の設定"}},[s._v("#")]),s._v(" VirtualHost の設定")]),s._v(" "),a("p",[s._v("1つのApacheで複数のWebサイトを管理したいことがあります。異なるIPアドレスやアドレス、port番号からアクセスされた時にDocument Rootなどを切り替えたいときは"),a("code",[s._v("VirtualHost")]),s._v("を設定することで実現できます。")]),s._v(" "),a("p",[s._v("ここではport番号を"),a("code",[s._v("80")]),s._v("と"),a("code",[s._v("81")]),s._v("に分けて別々のWebサイトを設定してみます。\n(docker起動時にport forwardしているため、手元からは"),a("code",[s._v("8080")]),s._v("と"),a("code",[s._v("8081")]),s._v("からアクセスできます。)")]),s._v(" "),a("p",[s._v("まずは新しくDocument RootになるディレクトリとHTMLファイルを作成します。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mkdir")]),s._v(" /var/www/html/site-80\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mkdir")]),s._v(" /var/www/html/site-81\n"),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("echo")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'This is site 80!'")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),s._v(" /var/www/html/site-80/index.html\n"),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("echo")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'This is site 81!'")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),s._v(" /var/www/html/site-81/index.html\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br")])]),a("p",[s._v("次にApacheの設定をして行きます。やることは")]),s._v(" "),a("ul",[a("li",[s._v("listen portに81を追加")]),s._v(" "),a("li",[s._v("virtual host設定の追加")])]),s._v(" "),a("p",[s._v("の2つです。listen portの追加は"),a("code",[s._v("/etc/apache2/ports.conf")]),s._v("に書きましょう。\n以下のように"),a("code",[s._v("Listen 80")]),s._v(" の下に "),a("code",[s._v("Listen 81")]),s._v("の記述を追加します。")]),s._v(" "),a("div",{staticClass:"language-apache line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[s._v("# If you just change the port or add more ports here, you will likely also\n# have to change the VirtualHost statement in\n# /etc/apache2/sites-enabled/000-default.conf\n\nListen 80\nListen 81\n\n\n Listen 443\n\n\n\n Listen 443\n\n\n# vim: syntax=apache ts=4 sw=4 sts=4 sr noet\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br")])]),a("p",[s._v("VitrualHostの設定は"),a("code",[s._v("/etc/apache2/sites-available")]),s._v("の下に作成して行きます。")]),s._v(" "),a("p",[a("code",[s._v("/etc/apache2/sites-available/site-80.conf")])]),s._v(" "),a("div",{staticClass:"language-xml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-xml"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),s._v("VirtualHost")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("*:")]),s._v("80")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v("\n DocumentRoot /var/www/html/site-80\n"),a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("")])]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[a("code",[s._v("/etc/apache2/sites-available/site-81.conf")])]),s._v(" "),a("div",{staticClass:"language-xml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-xml"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),s._v("VirtualHost")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("*:")]),s._v("81")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v("\n DocumentRoot /var/www/html/site-81\n"),a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("")])]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v("設定ファイルを作成したら"),a("code",[s._v("a2dissite")]),s._v("、"),a("code",[s._v("a2ensite")]),s._v("コマンドを使って設定を有効化しましょう。")]),s._v(" "),a("div",{staticClass:"custom-block tip"},[a("p",{staticClass:"custom-block-title"},[s._v("TIP")]),s._v(" "),a("p",[a("code",[s._v("a2dissite")]),s._v("や"),a("code",[s._v("a2ensite")]),s._v("といったコマンドは実はapache本体の機能ではありません。"),a("code",[s._v("a2ensite")]),s._v("は"),a("code",[s._v("/etc/apache2/sites-available")]),s._v("以下のファイルのsimlinkを"),a("code",[s._v("/etc/apache2/sites-enable")]),s._v("以下に追加するだけのコマンドです。\n実際のApacheは"),a("code",[s._v("/etc/apache2/sites-enable")]),s._v("以下のコンフィグファイルをloadしているため、コマンドによってサイトが有効化されたように見えるのです。")]),s._v(" "),a("p",[s._v("CentOSなど他のディストリビューションでは、これらのコマンドが存在しないことが多いので注意してください。")])]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("a2dissite 000-default\na2ensite site-80\na2ensite site-81\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v("そしてApacheをリスタートします。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("service")]),s._v(" apache2 reload\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[a("code",[s._v("localhost:8080")]),s._v("と"),a("code",[s._v("localhost:8081")]),s._v("にアクセスしてみてください。意図通りの挙動になっているでしょうか。")]),s._v(" "),a("table",[a("thead",[a("tr",[a("th",[a("img",{attrs:{src:t(486),alt:"site-80"}})])])]),s._v(" "),a("tbody")]),s._v(" "),a("table",[a("thead",[a("tr",[a("th",[a("img",{attrs:{src:t(487),alt:"site-81"}})])])]),s._v(" "),a("tbody")]),s._v(" "),a("h2",{attrs:{id:"basic-認証をかけてみる-check2"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#basic-認証をかけてみる-check2"}},[s._v("#")]),s._v(" Basic 認証をかけてみる(check2)")]),s._v(" "),a("p",[s._v("特定ディレクトリにアクセスできる人を制限するために、Basic認証をかけてみましょう。\nBasic認証用のmoduleが既にインストールされているはずなので、有効化します。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("a2enmod auth_basic\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("ls")]),s._v(" -l /etc/apache2/mods-enabled/auth_basic.load "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#確認")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#lrwxrwxrwx 1 root root 33 May 10 23:22 /etc/apache2/mods-enabled/auth_basic.load -> ../mods-available/auth_basic.load")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br")])]),a("p",[s._v("まずはパスワードが記載された"),a("code",[s._v(".htpasswd")]),s._v("ファイルを作成します。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mkdir")]),s._v(" /etc/apache2/auth/\nhtpasswd -c /etc/apache2/auth/.htpasswd admin\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("p",[a("code",[s._v("admin")]),s._v("がユーザ名になります。パスワードの入力を求められるので、適当に設定してください。")]),s._v(" "),a("p",[s._v("次に"),a("code",[s._v("/etc/apache2/sites-available/site-81.conf")]),s._v("を以下のように編集します。")]),s._v(" "),a("div",{staticClass:"language-xml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-xml"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),s._v("VirtualHost")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("*:")]),s._v("81")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v('\n DocumentRoot /var/www/html/site-81\n \n AuthUserFile /etc/apache2/auth/.htpasswd\n AuthName "site-81 Authorization"\n AuthType Basic\n Require valid-user\n '),a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("")])]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("")])]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br")])]),a("p",[s._v("ファイルを編集したら"),a("code",[s._v("service apache2 restart")]),s._v("で再起動しましょう。"),a("code",[s._v("localhost:8081")]),s._v("にアクセスしてみてください。パスワードが求められ、先ほど入力した認証情報を入れないとアクセスできなくなっているはずです。")]),s._v(" "),a("h2",{attrs:{id:"pythonアプリを動かしてみよう-check3"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#pythonアプリを動かしてみよう-check3"}},[s._v("#")]),s._v(" Pythonアプリを動かしてみよう(check3)")]),s._v(" "),a("p",[s._v("ここまではVirtualHostでリソースを管理しつつ、静的なファイルを配信する設定を作ってきました。この章では別のユースケースとして、Pythonで書かれたWebアプリをApache経由で動かす設定を作ってみます。")]),s._v(" "),a("p",[s._v("このdocker imageには既にpythonがインストールされています。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("python --version\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Python 3.8.2")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("p",[s._v("Pythonで作成したWebアプリをApacheなどから実行する場合、"),a("a",{attrs:{href:"https://ja.wikipedia.org/wiki/Web_Server_Gateway_Interface",target:"_blank",rel:"noopener noreferrer"}},[s._v("WSGI"),a("OutboundLink")],1),s._v("というインタフェース定義に従ってWebアプリを作成します。\nこれはPython側のインタフェースを規定することで、他のプログラム(今回の場合Apache)から呼び出しやすくする物です。")]),s._v(" "),a("p",[s._v("あとでやるDjangoなど主要なPythonフレームワークはこのAPIに従っているため、Djangoで作成したアプリは今回と同じ手順でApacheから実行することができます。")]),s._v(" "),a("p",[s._v("以下のようなPythonコードを"),a("code",[s._v("/var/www/html/site-80")]),s._v("以下に置いておきましょう。")]),s._v(" "),a("p",[a("code",[s._v("vim /var/www/html/site-80/app.py")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("application")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("environ"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" start_response"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n status "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'200 OK'")]),s._v("\n output "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("b'Hello! This is python application!'")]),s._v("\n\n response_headers "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-type'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'text/plain'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Length'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("str")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("len")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("output"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n start_response"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("status"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" response_headers"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),s._v("output"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br")])]),a("p",[s._v("次にwsgiを動かすためのApache moduleをインストールします。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("pip "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("install")]),s._v(" mod-wsgi\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Collecting mod-wsgi")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Using cached mod_wsgi-4.7.1.tar.gz (498 kB)")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Building wheels for collected packages: mod-wsgi")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Building wheel for mod-wsgi (setup.py) ... done")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Created wheel for mod-wsgi: filename=mod_wsgi-4.7.1-cp38-cp38-linux_x86_64.whl size=809821 sha256=570b19e67813e819f04ee00006b5c556339e37a03dea4af0021837b098588c0d")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Stored in directory: /root/.cache/pip/wheels/e9/82/71/1b42d6274a24af477453cecc993213fc8abd15433d80b01e93")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Successfully built mod-wsgi")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Installing collected packages: mod-wsgi")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Successfully installed mod-wsgi-4.7.1")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br")])]),a("p",[s._v("インストールすると以下のディレクトリにsoファイルが生成されています。Apacheに読み込ませる必要があるため確認しておきましょう。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("ls")]),s._v(" /usr/local/lib/python3.8/site-packages/mod_wsgi/server/mod_wsgi-py38.cpython-38-x86_64-linux-gnu.so\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("このファイルを読み込むように、"),a("code",[s._v("vim /etc/apache2/mods-available/wsgi.load")]),s._v("を以下のように作成します。")]),s._v(" "),a("div",{staticClass:"language-xml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-xml"}},[a("code",[s._v("LoadModule wsgi_module /usr/local/lib/python3.8/site-packages/mod_wsgi/server/mod_wsgi-py38.cpython-38-x86_64-linux-gnu.so\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("moduleを有効化しておきます。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("a2enmod wsgi\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("準備が整ったのでsite-80に先ほどのPythonアプリケーションを読み込ませましょう。\n"),a("code",[s._v("vim /etc/apache2/sites-available/site-80.conf")])]),s._v(" "),a("div",{staticClass:"language-xml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-xml"}},[a("code",[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),s._v("VirtualHost")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token attr-name"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("*:")]),s._v("80")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v("\n DocumentRoot /var/www/html/site-80\n WSGIScriptAlias /app /var/www/html/site-80/app.py\n"),a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token tag"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("")])]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br")])]),a("p",[s._v("最後にApacheをリスタートします。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[a("span",{pre:!0,attrs:{class:"token function"}},[s._v("service")]),s._v(" apache2 restart\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[a("code",[s._v("http://localhost:8080/app")]),s._v(" にアクセスしてみてください。"),a("code",[s._v("Hello! This is python application!")]),s._v(" が表示されるでしょうか。")]),s._v(" "),a("p",[s._v("うまくいったら"),a("code",[s._v("app.py")]),s._v("を適当に変更して、Pythonが動的に実行されているのを確認してください。")]),s._v(" "),a("h2",{attrs:{id:"パフォーマンス測定-任意課題"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#パフォーマンス測定-任意課題"}},[s._v("#")]),s._v(" パフォーマンス測定（任意課題）")]),s._v(" "),a("p",[s._v("ApacheにはApache Benchというパフォーマンス測定ツールがついています。これを使ってMPMの違いがどのようにパフォーマンスに影響するか確認してみましょう。")]),s._v(" "),a("p",[s._v("Apache Benchは"),a("code",[s._v("ab")]),s._v("コマンドで使用できます。試しに先ほどのPythonアプリケーションのパフォーマンスを測定してみましょう。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("ab -n "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("1000")]),s._v(" -c "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("100")]),s._v(" localhost:80/app\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("これは"),a("code",[s._v("localhost:80/app")]),s._v("に対して合計10000リクエストを同時に100ずつ実行するコマンドです。\n実行結果には成功したリクエスト数や処理時間など、分析に使える情報が書かれています。")]),s._v(" "),a("p",[s._v("同時に1000リクエストを投げても、この時点では捌けていると思います。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("ab -n "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("1000")]),s._v(" -c "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("1000")]),s._v(" localhost:80/app\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("これだけでは面白くないので、pythonアプリにわざとディレイを入れてみましょう。")]),s._v(" "),a("p",[a("code",[s._v("vim /var/www/html/site-80/app.py")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" time\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("application")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("environ"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" start_response"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n time"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("sleep"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n status "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'200 OK'")]),s._v("\n output "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("b'Hello! Thisa is python application!'")]),s._v("\n\n response_headers "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-type'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'text/plain'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Length'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("str")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("len")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("output"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n start_response"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("status"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" response_headers"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),s._v("output"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br")])]),a("p",[s._v("保存したらもう一度")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("ab -n "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("1000")]),s._v(" -c "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("1000")]),s._v(" localhost:80/app\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("を試してみましょう。理論上は3秒で全部のリクエストが成功するはずですがどうでしょうか。\nさらにもっと数を増やすとどうでしょうか。")]),s._v(" "),a("p",[s._v("他にも色んなことを試してみてください。")]),s._v(" "),a("ul",[a("li",[s._v("psコマンドでApacheのプロセスを確認して、リクエスト中に何が起こってるのか確認しましょう。\n"),a("ul",[a("li",[s._v("apache の再起動直後とパフォーマンス測定後の変化を見てみましょう")])])]),s._v(" "),a("li",[a("code",[s._v("/var/log/apache2/error.log")]),s._v(" を確認してみましょう")]),s._v(" "),a("li",[s._v("MPM(Multi-Processing-Module)をpreforkやworkerに変えるとどうなるでしょうか")]),s._v(" "),a("li",[s._v("MPMの設定を変えてパフォーマンスチューニングをしてみましょう")])]),s._v(" "),a("h3",{attrs:{id:"補足-mpmの変更"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#補足-mpmの変更"}},[s._v("#")]),s._v(" 補足: MPMの変更")]),s._v(" "),a("p",[s._v("現在のMPMの確認")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("apachectl -V "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("|")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("grep")]),s._v(" MPM\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Server MPM: event")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v("MPMをpreforkに変更する。")]),s._v(" "),a("div",{staticClass:"language-sh line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-sh"}},[a("code",[s._v("a2dismod mpm_event\na2enmod mpm_prefork\n"),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("service")]),s._v(" apache2 restart\napachectl -V "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("|")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("grep")]),s._v(" MPM\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#Server MPM: prefork")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br")])]),a("credit-footer")],1)}),[],!1,null,null,null);a.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/25.19720aa5.js b/assets/js/25.1947468b.js similarity index 99% rename from assets/js/25.19720aa5.js rename to assets/js/25.1947468b.js index b0f1fb15..37ba1c5a 100644 --- a/assets/js/25.19720aa5.js +++ b/assets/js/25.1947468b.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[25],{467:function(t,s,a){t.exports=a.p+"assets/img/fork.drawio.fb839165.png"},468:function(t,s,a){t.exports=a.p+"assets/img/thread.drawio.25427a90.png"},545:function(t,s,a){"use strict";a.r(s);var n=a(10),e=Object(n.a)({},(function(){var t=this,s=t._self._c;return s("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[s("header-table"),t._v(" "),s("h1",{attrs:{id:"page-frontmatter-title"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#page-frontmatter-title"}},[t._v("#")]),t._v(" "+t._s(t.$page.frontmatter.title))]),t._v(" "),s("h2",{attrs:{id:"環境準備"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#環境準備"}},[t._v("#")]),t._v(" 環境準備")]),t._v(" "),s("p",[t._v("以下のdockerコマンドでコンソールを取得してください。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ docker pull iijrfujimoto/bootcamp_concurrent\n$ mkdir bootcamp_work # 作業用のディレクトリ。名前はなんでもいい\n$ cd bootcamp_work\n$ docker run --name bootcamp_concurrent -p 8000:8000 -v $PWD:/work --rm -it iijrfujimoto/bootcamp_concurrent /bin/bash\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br")])]),s("h2",{attrs:{id:"この資料の約束"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#この資料の約束"}},[t._v("#")]),t._v(" この資料の約束")]),t._v(" "),s("p",[t._v("ターミナルでの実行例を示す際、以下のように"),s("code",[t._v("$")]),t._v("で始まっている場合はdockerを起動しているホスト側で実行するコマンドを示します。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ curl localhost:8000\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br")])]),s("p",[t._v("以下のように"),s("code",[t._v("root@40e566b8e23e")]),t._v("などで示されている場合はdockerコンテナ上で実行するコマンドであることを示します。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("root@0dd4d9fad678:/work# python3 main.py\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br")])]),s("h2",{attrs:{id:"このハンズオンの目的"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#このハンズオンの目的"}},[t._v("#")]),t._v(" このハンズオンの目的")]),t._v(" "),s("p",[t._v("このハンズオンでは、Webアプリケーションの実装に欠かせない「並行処理」について取り扱います。")]),t._v(" "),s("p",[t._v("プログラミングにおいて、同時に複数の処理を行う「並行処理」は複雑で実装が難しいものです。\nそれは普段のプログラムが「決定的」なものであるのに対し、並行処理は実行時に何が起こるのか分からない「非決定的」な動作となるからです。")]),t._v(" "),s("p",[t._v("しかしユーザからの多数のリクエストに対応するため、Webアプリケーションに並行処理の実装は必須です。\n昨今ではライブラリやフレームワークが発達し並行処理を意識しなくてもWebアプリケーションを作ることが可能ですが、\n並行処理の勘所を理解せずに使うと思わぬバグや事故を起こす可能性があります。")]),t._v(" "),s("p",[t._v("このハンズオンではWebアプリケーションにおける並行処理実装の初歩的な注意点を紹介し、不具合を起こさないための知識を得てもらう目的としています。")]),t._v(" "),s("div",{staticClass:"custom-block tip"},[s("p",{staticClass:"custom-block-title"},[t._v("並行処理と並列処理")]),t._v(" "),s("p",[t._v("並行処理(concurrent processing)と並列処理(parallel processing)は似た言葉ですが異なる動作を指す言葉です。")]),t._v(" "),s("ul",[s("li",[t._v("並行処理: ある時間内に複数のタスクを処理すること")]),t._v(" "),s("li",[t._v("並列処理: 複数のタスクを「同時に」処理すること")])]),t._v(" "),s("p",[t._v("「並行処理」と言う場合はある時間内に複数タスクを実行できればいいので、実行するタスクを小まめに切り替えながら処理する動作も含みます。\n一方で「並列処理」の場合は複数のCPUコアによって全く同時に複数タスクを処理することを指します。")]),t._v(" "),s("p",[t._v("（参考: "),s("a",{attrs:{href:"https://go.dev/blog/waza-talk",target:"_blank",rel:"noopener noreferrer"}},[t._v("Concurrency is not parallelism"),s("OutboundLink")],1),t._v("）")])]),t._v(" "),s("h2",{attrs:{id:"ハンズオン"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#ハンズオン"}},[t._v("#")]),t._v(" ハンズオン")]),t._v(" "),s("h3",{attrs:{id:"簡単な並行処理サンプル"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#簡単な並行処理サンプル"}},[t._v("#")]),t._v(" 簡単な並行処理サンプル")]),t._v(" "),s("p",[t._v("まずはPythonで簡単なWebサーバを書いてみましょう。")]),t._v(" "),s("p",[t._v("vscode等を利用して作業用ディレクトリ("),s("code",[t._v("bootcamp_work")]),t._v(")でPythonコードを書いていきましょう。")]),t._v(" "),s("div",{staticClass:"language-termianl line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ vim main.py\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br")])]),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello simple server!\\n'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br")])]),s("p",[t._v("保存したら、dockerコンテナ内からサーバを起動してみます。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("root@0dd4d9fad678:/work# python3 main.py\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br")])]),s("p",[t._v("手元のホストから以下のようにcurlで叩いてみましょう。\n「Hello simple server!」と返ってくれば成功です。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ curl localhost:8000\nHello simple server!\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br")])]),s("p",[t._v("リクエストした直後、サーバー側のログに"),s("code",[t._v("start processing path = /")]),t._v("と表示されたことを覚えておいてください。")]),t._v(" "),s("h3",{attrs:{id:"メモリ空間の共有とレースコンディション"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#メモリ空間の共有とレースコンディション"}},[t._v("#")]),t._v(" メモリ空間の共有とレースコンディション")]),t._v(" "),s("h4",{attrs:{id:"サンプルコード"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#サンプルコード"}},[t._v("#")]),t._v(" サンプルコード")]),t._v(" "),s("p",[t._v("先ほどのプログラムを少し改造して、今までのアクセス数をカウントできるようにしてみましょう。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("0")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("count_and_do_something"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello! request count=%a\\n'")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("%")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br"),s("span",{staticClass:"line-number"},[t._v("22")]),s("br"),s("span",{staticClass:"line-number"},[t._v("23")]),s("br"),s("span",{staticClass:"line-number"},[t._v("24")]),s("br"),s("span",{staticClass:"line-number"},[t._v("25")]),s("br"),s("span",{staticClass:"line-number"},[t._v("26")]),s("br"),s("span",{staticClass:"line-number"},[t._v("27")]),s("br"),s("span",{staticClass:"line-number"},[t._v("28")]),s("br"),s("span",{staticClass:"line-number"},[t._v("29")]),s("br"),s("span",{staticClass:"line-number"},[t._v("30")]),s("br"),s("span",{staticClass:"line-number"},[t._v("31")]),s("br")])]),s("p",[t._v("以下のようにcurlを複数叩いてみます。"),s("code",[t._v("&")]),t._v("はコマンドをバックグラウンドで実行する書き方です。\n先ほどはサーバ側が処理をする10秒間curlコマンドはずっと待っていましたが、"),s("code",[t._v("&")]),t._v("をつけることですぐに次のコマンドを叩けます。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ curl localhost:8000 &\n$ curl localhost:8000 &\n$ curl localhost:8000 &\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br")])]),s("p",[t._v("さて結果はどうでしょうか。3回コマンドを実行しましたが、サーバのログは以下のようになったのではないでしょうか。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("serving at port 8000\nstart processing path = /, before request count = 0\nstart processing path = /, before request count = 0\nstart processing path = /, before request count = 0\nend processing path = /, after request count = 1\nend processing path = /, after request count = 1\nend processing path = /, after request count = 1\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br")])]),s("p",[t._v("きちんとリクエスト数をカウントできていない、重大な不具合があるようです。")]),t._v(" "),s("h4",{attrs:{id:"コード解説"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#コード解説"}},[t._v("#")]),t._v(" コード解説")]),t._v(" "),s("h4",{attrs:{id:"forkとthread"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#forkとthread"}},[t._v("#")]),t._v(" forkとthread")]),t._v(" "),s("p",[t._v("このプログラムではユーザからのリクエストを同時に処理するために "),s("a",{attrs:{href:"https://docs.python.org/ja/3/library/http.server.html#http.server.ThreadingHTTPServer",target:"_blank",rel:"noopener noreferrer"}},[t._v("ThreadingHTTPServer"),s("OutboundLink")],1),t._v(" を利用しています。\nThreadingHTTPServer の説明を見てみましょう。")]),t._v(" "),s("blockquote",[s("p",[t._v("This class is identical to HTTPServer but uses threads to handle requests by using the ThreadingMixIn.")])]),t._v(" "),s("p",[t._v("どうやらリクエストを処理(handle)するために「スレッド」を利用するようです。\n"),s("a",{attrs:{href:"https://docs.python.org/ja/3.7/library/socketserver.html#socketserver.ThreadingMixIn",target:"_blank",rel:"noopener noreferrer"}},[t._v("ThreadingMixIn"),s("OutboundLink")],1),t._v(" の説明も見てみましょう。")]),t._v(" "),s("blockquote",[s("p",[t._v("Forking and threading versions of each type of server can be created using these mix-in classes.")])]),t._v(" "),s("p",[s("code",[t._v("fork")]),t._v("もしくは"),s("code",[t._v("thread")]),t._v("いずれかの仕組みで渡したServerオブジェクトを並列に実行してくれるようです。"),s("code",[t._v("fork")]),t._v("と"),s("code",[t._v("thread")]),t._v("は両方とも並列処理のための方法ですが、大きな違いがあります。")]),t._v(" "),s("p",[s("img",{attrs:{src:a(467),alt:"fork",title:"fork"}})]),t._v(" "),s("p",[s("img",{attrs:{src:a(468),alt:"thread",title:"thread"}})]),t._v(" "),s("p",[t._v("図の通り"),s("code",[t._v("fork")]),t._v("の場合forkで分かれたプロセス上で"),s("code",[t._v("SimpleHelloHandler")]),t._v("のインスタンスが実行されます。そのためリクエストを処理する各インスタンス間でメモリ空間を共有していません（できないとも言う）。\n一方で"),s("code",[t._v("thread")]),t._v("の場合はメモリ空間を共有した同じプロセス内で"),s("code",[t._v("SimpleHelloHandler")]),t._v("インスタンスが実行されます。")]),t._v(" "),s("p",[t._v("今回"),s("code",[t._v("request_total")]),t._v("はクラス変数として宣言されています。そのため各"),s("code",[t._v("SimpleHelloHandler")]),t._v("インスタンスから共有するメモリ上の変数としてアクセスが可能です。\nWebサーバを実装する時に限りませんが、ライブラリやフレームワークを利用する際にはそれがどういう仕組みで動くのか把握しておく必要があります。")]),t._v(" "),s("h4",{attrs:{id:"クリティカルセッション"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#クリティカルセッション"}},[t._v("#")]),t._v(" クリティカルセッション")]),t._v(" "),s("p",[s("code",[t._v("count_and_do_something")]),t._v("の以下の部分に注目してみましょう（といっても中身全てですが）。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("div",{staticClass:"highlight-lines"},[s("br"),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("br")]),s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t\n")])]),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br")])]),s("p",[t._v("上記2-10行目は"),s("code",[t._v("SimpleHelloHandler.request_total")]),t._v("という共有資源にアクセスしており、複数のスレッドから同時にアクセスされると不具合が起きます。このような箇所を「"),s("strong",[t._v("クリティカルセクション")]),t._v("」と呼びます。\nまた実際にクリティカルセクションに複数のスレッドが同時にアクセスしてしまい、不具合が起きている状態を「"),s("strong",[t._v("レースコンディション(競合状態)")]),t._v("」と呼びます。")]),t._v(" "),s("p",[t._v("スレッドなどを利用する並行処理プログラミングではこのクリティカルセクションを如何に減らし、そして保護するかが大切になります。")]),t._v(" "),s("h3",{attrs:{id:"排他制御・アトミック処理"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#排他制御・アトミック処理"}},[t._v("#")]),t._v(" 排他制御・アトミック処理")]),t._v(" "),s("h4",{attrs:{id:"排他制御"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#排他制御"}},[t._v("#")]),t._v(" 排他制御")]),t._v(" "),s("p",[t._v("クリティカルセクションを保護する手法の一つが、ロックを取得する排他制御と呼ばれるものです。まずは素朴に実装してみましょう。\n（説明用にすごく雑な実装なので間違っても仕事で以下のようなコードを書かないでください）")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("0")]),t._v("\n request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("False")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("while")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("True")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("if")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("not")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# request_total_lock がFalseになるまで無限ループする")]),t._v("\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("True")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# ロックの取得")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("break")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("False")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 処理が完了したらロックを解放する")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("count_and_do_something"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello! request count=%a\\n'")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("%")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br"),s("span",{staticClass:"line-number"},[t._v("22")]),s("br"),s("span",{staticClass:"line-number"},[t._v("23")]),s("br"),s("span",{staticClass:"line-number"},[t._v("24")]),s("br"),s("span",{staticClass:"line-number"},[t._v("25")]),s("br"),s("span",{staticClass:"line-number"},[t._v("26")]),s("br"),s("span",{staticClass:"line-number"},[t._v("27")]),s("br"),s("span",{staticClass:"line-number"},[t._v("28")]),s("br"),s("span",{staticClass:"line-number"},[t._v("29")]),s("br"),s("span",{staticClass:"line-number"},[t._v("30")]),s("br"),s("span",{staticClass:"line-number"},[t._v("31")]),s("br"),s("span",{staticClass:"line-number"},[t._v("32")]),s("br"),s("span",{staticClass:"line-number"},[t._v("33")]),s("br"),s("span",{staticClass:"line-number"},[t._v("34")]),s("br"),s("span",{staticClass:"line-number"},[t._v("35")]),s("br"),s("span",{staticClass:"line-number"},[t._v("36")]),s("br"),s("span",{staticClass:"line-number"},[t._v("37")]),s("br"),s("span",{staticClass:"line-number"},[t._v("38")]),s("br"),s("span",{staticClass:"line-number"},[t._v("39")]),s("br")])]),s("p",[t._v("サーバを実行してみてください。先ほどと同じようにcurlを実行するとどうでしょうか。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ curl localhost:8000 &\n$ curl localhost:8000 &\n$ curl localhost:8000 &\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br")])]),s("p",[t._v("ここでは新しくクラス変数として"),s("code",[t._v("request_total_lock")]),t._v("を追加し、"),s("code",[t._v("count_and_do_something")]),t._v("の先頭でこの変数を検査しています。\n"),s("code",[t._v("True")]),t._v("の場合は次のループに遷移し、無限に検査を繰り返します。"),s("code",[t._v("False")]),t._v("だった場合は"),s("code",[t._v("True")]),t._v("を代入しクリティカルセクションに入ります。\nクリティカルセクションの終了後、"),s("code",[t._v("request_total_lock")]),t._v("に"),s("code",[t._v("False")]),t._v("を代入し、別のスレッドが実行できるようにします。")]),t._v(" "),s("p",[t._v("少しややこしいですが、複数のスレッド間の動作を順番に書くと以下のようになります。")]),t._v(" "),s("ol",[s("li",[t._v("最初のリクエスト(thread1)が来て"),s("code",[t._v("count_and_do_something")]),t._v("が実行される")]),t._v(" "),s("li",[s("code",[t._v("request_total_lock")]),t._v("は"),s("code",[t._v("False")]),t._v("なのでthread1が"),s("code",[t._v("True")]),t._v("を代入してロックを取得する")]),t._v(" "),s("li",[t._v("2個目のリクエスト(thread2)が来て"),s("code",[t._v("count_and_do_something")]),t._v("が実行される")]),t._v(" "),s("li",[s("code",[t._v("request_total_lock")]),t._v("は"),s("code",[t._v("True")]),t._v("なのでthread2は無限ループを続ける")]),t._v(" "),s("li",[t._v("thread1でクリティカルセクションが完了し、"),s("code",[t._v("request_total_lock")]),t._v("に"),s("code",[t._v("False")]),t._v("が代入される")]),t._v(" "),s("li",[t._v("thread2がロックを取得し、クリティカルセクションを開始する")])]),t._v(" "),s("p",[t._v("このロック機構によりクリティカルセクションが保護され、"),s("code",[t._v("request_total")]),t._v("が正しくカウントされるようになりました。\nこのようにロックが取得できるまで無限ループで待ち続けるような実装を「スピンロック」と言います。")]),t._v(" "),s("p",[t._v("このコードは一見うまくいっていますが、実はレースコンディションを引き起こすクリティカルセクションが隠れています。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("div",{staticClass:"highlight-lines"},[s("br"),s("br"),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("br"),s("br")]),s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("while")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("True")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("if")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("not")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# ここから")]),t._v("\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("True")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# ここまでが実はクリティカルセクション")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("break")]),t._v("\n")])]),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br")])]),s("p",[t._v("上記の3行目で"),s("code",[t._v("request_total_lock")]),t._v("を見た後"),s("code",[t._v("True")]),t._v("を代入するまでにわずかながらでもラグがあるため、運が悪いと3行目が複数のスレッドで同時に実行される可能性があります。\nすると複数のスレッドが同時にロックを取得してしまい、クリティカルセクションが同時に実行されてしまいます。")]),t._v(" "),s("p",[t._v("後でも記載しますが、これは"),s("code",[t._v("request_total_lock")]),t._v("の検査とロックの獲得が「アトミックでない」処理のためです。")]),t._v(" "),s("p",[t._v("さて、このように並行処理に関わるスピンロックなどのコードを自前で実装するのはやめて、ライブラリを使いましょう。これはスレッドプログラミングにおける大原則です。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" threading "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" Lock\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("0")]),t._v("\n request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" Lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("acquire"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# ロックの取得。他のスレッドはアクセスできなくなる")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("release"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# ロックの解放")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("count_and_do_something"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello! request count=%a\\n'")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("%")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br"),s("span",{staticClass:"line-number"},[t._v("22")]),s("br"),s("span",{staticClass:"line-number"},[t._v("23")]),s("br"),s("span",{staticClass:"line-number"},[t._v("24")]),s("br"),s("span",{staticClass:"line-number"},[t._v("25")]),s("br"),s("span",{staticClass:"line-number"},[t._v("26")]),s("br"),s("span",{staticClass:"line-number"},[t._v("27")]),s("br"),s("span",{staticClass:"line-number"},[t._v("28")]),s("br"),s("span",{staticClass:"line-number"},[t._v("29")]),s("br"),s("span",{staticClass:"line-number"},[t._v("30")]),s("br"),s("span",{staticClass:"line-number"},[t._v("31")]),s("br"),s("span",{staticClass:"line-number"},[t._v("32")]),s("br"),s("span",{staticClass:"line-number"},[t._v("33")]),s("br"),s("span",{staticClass:"line-number"},[t._v("34")]),s("br"),s("span",{staticClass:"line-number"},[t._v("35")]),s("br"),s("span",{staticClass:"line-number"},[t._v("36")]),s("br")])]),s("p",[t._v("Pythonの "),s("a",{attrs:{href:"https://docs.python.org/ja/3/library/threading.html",target:"_blank",rel:"noopener noreferrer"}},[t._v("threadingパッケージ"),s("OutboundLink")],1),t._v(" にはスレッドプログラミングに使えるツールが用意されています。今回は "),s("a",{attrs:{href:"https://docs.python.org/ja/3/library/threading.html#lock-objects",target:"_blank",rel:"noopener noreferrer"}},[t._v("Lock"),s("OutboundLink")],1),t._v(" を利用しました。\n"),s("code",[t._v("acquire()")]),t._v("を実行するとロックを取得し、もし他のスレッドで既に取得済みの場合はブロック（コード実行をそこで停止する）します。")]),t._v(" "),s("p",[t._v("この部分は以下のようにも書けます。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br")])]),s("p",[t._v("クリティカルセクションが分かりやすくロックの開放し忘れもないので、基本的には"),s("code",[t._v("with")]),t._v("を利用して書きましょう。")]),t._v(" "),s("h4",{attrs:{id:"スレッドセーフ-アトミック-な処理"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#スレッドセーフ-アトミック-な処理"}},[t._v("#")]),t._v(" スレッドセーフ（アトミック）な処理")]),t._v(" "),s("p",[t._v("ロックを取得することでクリティカルセクションを保護できることは分かりました。\nしかし皆さんも薄々お気づきの通り、そもそもこのコードのクリティカルセクションをもっと小さくできるのではないでしょうか。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("0")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("count_and_do_something"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello! request count=%a\\n'")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("%")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br"),s("span",{staticClass:"line-number"},[t._v("22")]),s("br"),s("span",{staticClass:"line-number"},[t._v("23")]),s("br"),s("span",{staticClass:"line-number"},[t._v("24")]),s("br"),s("span",{staticClass:"line-number"},[t._v("25")]),s("br"),s("span",{staticClass:"line-number"},[t._v("26")]),s("br"),s("span",{staticClass:"line-number"},[t._v("27")]),s("br"),s("span",{staticClass:"line-number"},[t._v("28")]),s("br"),s("span",{staticClass:"line-number"},[t._v("29")]),s("br"),s("span",{staticClass:"line-number"},[t._v("30")]),s("br"),s("span",{staticClass:"line-number"},[t._v("31")]),s("br"),s("span",{staticClass:"line-number"},[t._v("32")]),s("br")])]),s("p",[t._v("どうでしょう。試しに同じようにcurlで叩いてみましょう。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ curl localhost:8000 &\n$ curl localhost:8000 &\n$ curl localhost:8000 &\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br")])]),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("serving at port 8000\nstart processing path = /, before request count = 0\nstart processing path = /, before request count = 0\nstart processing path = /, before request count = 0\nend processing path = /, after request count = 1\nend processing path = /, after request count = 2\nend processing path = /, after request count = 3\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br")])]),s("p",[s("code",[t._v("before request count")]),t._v(" はうまく出力できなくなってしまいましたが、「リクエスト数をカウントする」という要件は満たせているように見えます。\nしかしここにもレースコンディションを引き起こすクリティカルセクションが隠れています。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# クリティカルセクション")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br")])]),s("p",[t._v("スレッドプログラミングにおいて、ある処理が複数スレッドから同時に実行されても問題ない実装であることを「スレッドセーフ(thread safe)である」と言います。\n例えば先ほどの"),s("code",[t._v("acquire()")]),t._v("はスレッドセーフなメソッドであり、複数スレッドから同時にアクセスされてもレースコンディションを起こさないように実装されています。")]),t._v(" "),s("p",[t._v("一方でPythonにおける"),s("code",[t._v("+= 1")]),t._v("とはスレッドセーフな処理なんでしょうか。結論から言うとそうではありません。\nなぜこの短いコードでレースコンディションが発生するのでしょうか。")]),t._v(" "),s("p",[t._v("Pythonで書かれたコードは最終的にバイトコードにコンパイルされて実行されます（CPythonの場合）。\n"),s("code",[t._v("dis")]),t._v("を利用して実際に実行されるバイトコードを見てみましょう。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v('root@40e566b8e23e:/work# python3\nPython 3.9.2 (default, Feb 28 2021, 17:03:44)\n[GCC 10.2.1 20210110] on linux\nType "help", "copyright", "credits" or "license" for more information.\n>>> import dis\n>>> a = 0\n>>> dis.dis("a += 1")\n 1 0 LOAD_NAME 0 (a)\n 2 LOAD_CONST 0 (1)\n 4 INPLACE_ADD\n 6 STORE_NAME 0 (a)\n 8 LOAD_CONST 1 (None)\n 10 RETURN_VALUE\n>>>\n')])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br")])]),s("p",[s("code",[t._v("a += 1")]),t._v("というコードは上記の通り6行のバイトコードに変換されます。内容を見てみると以下のように動作することが分かります。")]),t._v(" "),s("ol",[s("li",[t._v("「a」というメモリ領域から値を読み込む("),s("code",[t._v("LOAD_NAME")]),t._v(")")]),t._v(" "),s("li",[t._v("加算する("),s("code",[t._v("INPLACE_ADD")]),t._v(")")]),t._v(" "),s("li",[t._v("「a」というメモリ領域に値を書き込む("),s("code",[t._v("STORE_NAME")]),t._v(")")])]),t._v(" "),s("p",[t._v("つまり"),s("code",[t._v("a += 1")]),t._v("という一見1ステップのコードでも、バイトコードやその先の機械語レベルでは複数のステップに分かれた処理である可能性があります。\n（ここで「可能性」と言っているのは、あくまで言語やコンパイラの仕様や実装次第なためです。少なくともCPythonではアトミックな機械語は生成されないはずです。）")]),t._v(" "),s("p",[t._v("仮に機械語レベルで複数ステップに分かれた処理であった場合、タイミングによってはthread1が1ステップ目を実行した後、\n入れ替わりthread2が1ステップ目を実行してしまう可能性があります。\nそのため"),s("code",[t._v("a += 1")]),t._v("のような一見単純なコードでも、レースコンディションを起こす可能性があります。")]),t._v(" "),s("p",[t._v("スレッドプログラミングにおいては常に「その処理がスレッドセーフなのか」、仕様を確認しつつ進める必要があります。")]),t._v(" "),s("div",{staticClass:"custom-block tip"},[s("p",{staticClass:"custom-block-title"},[t._v("アトミックな処理")]),t._v(" "),s("p",[t._v("「アトム(atom)」とは「これ以上分割不可能な単位」という意味を持ち、「原子性」などとも呼ばれます。\n同じように「アトミックな処理」とはその処理が「外部から途中経過が観測できず、失敗した場合は処理前の状態に復元される」ことを言います。\nその意味でCPythonにおける"),s("code",[t._v("a += 1")]),t._v("はメモリからreadしてwriteする過程があるためアトミックな処理ではありません。")]),t._v(" "),s("p",[t._v("例えばMySQLなどのRDBでトランザクションを張り、最後にCOMMITする操作はアトミックな処理です。\nまた最近のCPUには加算処理などをアトミックに行う処理が命令として用意されており、言語によってはそういった命令を利用してアトミックな加算処理などを利用することが可能です。")]),t._v(" "),s("p",[t._v("例: gccなどのCコンパイラに実装されている"),s("code",[t._v("__sync_fetch_and_add")]),t._v("など")])]),t._v(" "),s("div",{staticClass:"custom-block tip"},[s("p",{staticClass:"custom-block-title"},[t._v("コンテキストスイッチ")]),t._v(" "),s("p",[t._v("CPython(c言語で書かれたPython処理系)にはGILという仕組みがあり、Pythonプログラムは1個のCPUコアしか使うことができません。\n1個のCPUコアでは同時に1個の仕事しかできないため、複数のスレッドを動かす際は1個のCPUコアの処理時間を分け合うことになります。\nつまりあるCPUコアでthread1の仕事を進めつつあるタイミングでthread1を待機状態にし、thread2の仕事を始める・・・ということを行っていきます。\nこの仕事の割り振りを決めるのがLinuxカーネルにおける「スケジューラ」と呼ばれる機能であり、thread1->thread2など仕事内容が切り替わるのを「コンテキストスイッチ」と呼びます。")])]),t._v(" "),s("p",[s("code",[t._v("a += 1")]),t._v(" がスレッドセーフでないことが分かったので、きちんとロックを利用してスレッドセーフな実装にしましょう。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" threading "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" Lock\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("0")]),t._v("\n request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" Lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("increment_request_total")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("increment_request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("count_and_do_something"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello! request count=%a\\n'")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("%")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br"),s("span",{staticClass:"line-number"},[t._v("22")]),s("br"),s("span",{staticClass:"line-number"},[t._v("23")]),s("br"),s("span",{staticClass:"line-number"},[t._v("24")]),s("br"),s("span",{staticClass:"line-number"},[t._v("25")]),s("br"),s("span",{staticClass:"line-number"},[t._v("26")]),s("br"),s("span",{staticClass:"line-number"},[t._v("27")]),s("br"),s("span",{staticClass:"line-number"},[t._v("28")]),s("br"),s("span",{staticClass:"line-number"},[t._v("29")]),s("br"),s("span",{staticClass:"line-number"},[t._v("30")]),s("br"),s("span",{staticClass:"line-number"},[t._v("31")]),s("br"),s("span",{staticClass:"line-number"},[t._v("32")]),s("br"),s("span",{staticClass:"line-number"},[t._v("33")]),s("br"),s("span",{staticClass:"line-number"},[t._v("34")]),s("br"),s("span",{staticClass:"line-number"},[t._v("35")]),s("br"),s("span",{staticClass:"line-number"},[t._v("36")]),s("br"),s("span",{staticClass:"line-number"},[t._v("37")]),s("br")])]),s("h2",{attrs:{id:"最後に"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#最後に"}},[t._v("#")]),t._v(" 最後に")]),t._v(" "),s("p",[t._v("この資料で伝えたいのは以下のことです。")]),t._v(" "),s("ul",[s("li",[t._v("ライブラリやフレームワークを利用する際はその仕組みをきちんと理解しましょう\n"),s("ul",[s("li",[t._v("webプログラミングにおいては特に並行・並列処理をどのように実装しているのか確認しましょう")])])]),t._v(" "),s("li",[t._v("スレッドプログラミングを書いているという認識を持ち、書こうとしている処理がスレッドセーフなのか常に確認しましょう\n"),s("ul",[s("li",[t._v("Webフレームワークが推奨する書き方に習うことで、トラブルを防ぐことができます")])])]),t._v(" "),s("li",[t._v("ロックなど排他制御の実装を行う際は自前で実装せず、必ずライブラリを利用しましょう")])]),t._v(" "),s("p",[t._v("並行・並列処理、スレッドプログラミングは非常に複雑になります（これは実行するまで処理がどのような順番で実行されるか分からない非決定性から来ています）。")]),t._v(" "),s("p",[t._v("Webフレームワークはこの並行・並列処理の複雑性を隠蔽するために発達しているという側面があり、推奨される書き方をすることで複雑性を意識しなくても実装が可能なようになっています。\nしかし自分が今どのような仕組みの上で実装しているのかを意識していないと、思わぬ事故を起こす可能性があります。")]),t._v(" "),s("p",[t._v("フレームワークが提供するレールに乗りながらも、自分がスレッドプログラミングをしていることを常に意識することが大切です。")]),t._v(" "),s("credit-footer")],1)}),[],!1,null,null,null);s.default=e.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[25],{467:function(t,s,a){t.exports=a.p+"assets/img/fork.drawio.fb839165.png"},468:function(t,s,a){t.exports=a.p+"assets/img/thread.drawio.25427a90.png"},546:function(t,s,a){"use strict";a.r(s);var n=a(10),e=Object(n.a)({},(function(){var t=this,s=t._self._c;return s("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[s("header-table"),t._v(" "),s("h1",{attrs:{id:"page-frontmatter-title"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#page-frontmatter-title"}},[t._v("#")]),t._v(" "+t._s(t.$page.frontmatter.title))]),t._v(" "),s("h2",{attrs:{id:"環境準備"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#環境準備"}},[t._v("#")]),t._v(" 環境準備")]),t._v(" "),s("p",[t._v("以下のdockerコマンドでコンソールを取得してください。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ docker pull iijrfujimoto/bootcamp_concurrent\n$ mkdir bootcamp_work # 作業用のディレクトリ。名前はなんでもいい\n$ cd bootcamp_work\n$ docker run --name bootcamp_concurrent -p 8000:8000 -v $PWD:/work --rm -it iijrfujimoto/bootcamp_concurrent /bin/bash\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br")])]),s("h2",{attrs:{id:"この資料の約束"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#この資料の約束"}},[t._v("#")]),t._v(" この資料の約束")]),t._v(" "),s("p",[t._v("ターミナルでの実行例を示す際、以下のように"),s("code",[t._v("$")]),t._v("で始まっている場合はdockerを起動しているホスト側で実行するコマンドを示します。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ curl localhost:8000\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br")])]),s("p",[t._v("以下のように"),s("code",[t._v("root@40e566b8e23e")]),t._v("などで示されている場合はdockerコンテナ上で実行するコマンドであることを示します。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("root@0dd4d9fad678:/work# python3 main.py\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br")])]),s("h2",{attrs:{id:"このハンズオンの目的"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#このハンズオンの目的"}},[t._v("#")]),t._v(" このハンズオンの目的")]),t._v(" "),s("p",[t._v("このハンズオンでは、Webアプリケーションの実装に欠かせない「並行処理」について取り扱います。")]),t._v(" "),s("p",[t._v("プログラミングにおいて、同時に複数の処理を行う「並行処理」は複雑で実装が難しいものです。\nそれは普段のプログラムが「決定的」なものであるのに対し、並行処理は実行時に何が起こるのか分からない「非決定的」な動作となるからです。")]),t._v(" "),s("p",[t._v("しかしユーザからの多数のリクエストに対応するため、Webアプリケーションに並行処理の実装は必須です。\n昨今ではライブラリやフレームワークが発達し並行処理を意識しなくてもWebアプリケーションを作ることが可能ですが、\n並行処理の勘所を理解せずに使うと思わぬバグや事故を起こす可能性があります。")]),t._v(" "),s("p",[t._v("このハンズオンではWebアプリケーションにおける並行処理実装の初歩的な注意点を紹介し、不具合を起こさないための知識を得てもらう目的としています。")]),t._v(" "),s("div",{staticClass:"custom-block tip"},[s("p",{staticClass:"custom-block-title"},[t._v("並行処理と並列処理")]),t._v(" "),s("p",[t._v("並行処理(concurrent processing)と並列処理(parallel processing)は似た言葉ですが異なる動作を指す言葉です。")]),t._v(" "),s("ul",[s("li",[t._v("並行処理: ある時間内に複数のタスクを処理すること")]),t._v(" "),s("li",[t._v("並列処理: 複数のタスクを「同時に」処理すること")])]),t._v(" "),s("p",[t._v("「並行処理」と言う場合はある時間内に複数タスクを実行できればいいので、実行するタスクを小まめに切り替えながら処理する動作も含みます。\n一方で「並列処理」の場合は複数のCPUコアによって全く同時に複数タスクを処理することを指します。")]),t._v(" "),s("p",[t._v("（参考: "),s("a",{attrs:{href:"https://go.dev/blog/waza-talk",target:"_blank",rel:"noopener noreferrer"}},[t._v("Concurrency is not parallelism"),s("OutboundLink")],1),t._v("）")])]),t._v(" "),s("h2",{attrs:{id:"ハンズオン"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#ハンズオン"}},[t._v("#")]),t._v(" ハンズオン")]),t._v(" "),s("h3",{attrs:{id:"簡単な並行処理サンプル"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#簡単な並行処理サンプル"}},[t._v("#")]),t._v(" 簡単な並行処理サンプル")]),t._v(" "),s("p",[t._v("まずはPythonで簡単なWebサーバを書いてみましょう。")]),t._v(" "),s("p",[t._v("vscode等を利用して作業用ディレクトリ("),s("code",[t._v("bootcamp_work")]),t._v(")でPythonコードを書いていきましょう。")]),t._v(" "),s("div",{staticClass:"language-termianl line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ vim main.py\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br")])]),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello simple server!\\n'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br")])]),s("p",[t._v("保存したら、dockerコンテナ内からサーバを起動してみます。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("root@0dd4d9fad678:/work# python3 main.py\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br")])]),s("p",[t._v("手元のホストから以下のようにcurlで叩いてみましょう。\n「Hello simple server!」と返ってくれば成功です。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ curl localhost:8000\nHello simple server!\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br")])]),s("p",[t._v("リクエストした直後、サーバー側のログに"),s("code",[t._v("start processing path = /")]),t._v("と表示されたことを覚えておいてください。")]),t._v(" "),s("h3",{attrs:{id:"メモリ空間の共有とレースコンディション"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#メモリ空間の共有とレースコンディション"}},[t._v("#")]),t._v(" メモリ空間の共有とレースコンディション")]),t._v(" "),s("h4",{attrs:{id:"サンプルコード"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#サンプルコード"}},[t._v("#")]),t._v(" サンプルコード")]),t._v(" "),s("p",[t._v("先ほどのプログラムを少し改造して、今までのアクセス数をカウントできるようにしてみましょう。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("0")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("count_and_do_something"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello! request count=%a\\n'")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("%")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br"),s("span",{staticClass:"line-number"},[t._v("22")]),s("br"),s("span",{staticClass:"line-number"},[t._v("23")]),s("br"),s("span",{staticClass:"line-number"},[t._v("24")]),s("br"),s("span",{staticClass:"line-number"},[t._v("25")]),s("br"),s("span",{staticClass:"line-number"},[t._v("26")]),s("br"),s("span",{staticClass:"line-number"},[t._v("27")]),s("br"),s("span",{staticClass:"line-number"},[t._v("28")]),s("br"),s("span",{staticClass:"line-number"},[t._v("29")]),s("br"),s("span",{staticClass:"line-number"},[t._v("30")]),s("br"),s("span",{staticClass:"line-number"},[t._v("31")]),s("br")])]),s("p",[t._v("以下のようにcurlを複数叩いてみます。"),s("code",[t._v("&")]),t._v("はコマンドをバックグラウンドで実行する書き方です。\n先ほどはサーバ側が処理をする10秒間curlコマンドはずっと待っていましたが、"),s("code",[t._v("&")]),t._v("をつけることですぐに次のコマンドを叩けます。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ curl localhost:8000 &\n$ curl localhost:8000 &\n$ curl localhost:8000 &\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br")])]),s("p",[t._v("さて結果はどうでしょうか。3回コマンドを実行しましたが、サーバのログは以下のようになったのではないでしょうか。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("serving at port 8000\nstart processing path = /, before request count = 0\nstart processing path = /, before request count = 0\nstart processing path = /, before request count = 0\nend processing path = /, after request count = 1\nend processing path = /, after request count = 1\nend processing path = /, after request count = 1\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br")])]),s("p",[t._v("きちんとリクエスト数をカウントできていない、重大な不具合があるようです。")]),t._v(" "),s("h4",{attrs:{id:"コード解説"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#コード解説"}},[t._v("#")]),t._v(" コード解説")]),t._v(" "),s("h4",{attrs:{id:"forkとthread"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#forkとthread"}},[t._v("#")]),t._v(" forkとthread")]),t._v(" "),s("p",[t._v("このプログラムではユーザからのリクエストを同時に処理するために "),s("a",{attrs:{href:"https://docs.python.org/ja/3/library/http.server.html#http.server.ThreadingHTTPServer",target:"_blank",rel:"noopener noreferrer"}},[t._v("ThreadingHTTPServer"),s("OutboundLink")],1),t._v(" を利用しています。\nThreadingHTTPServer の説明を見てみましょう。")]),t._v(" "),s("blockquote",[s("p",[t._v("This class is identical to HTTPServer but uses threads to handle requests by using the ThreadingMixIn.")])]),t._v(" "),s("p",[t._v("どうやらリクエストを処理(handle)するために「スレッド」を利用するようです。\n"),s("a",{attrs:{href:"https://docs.python.org/ja/3.7/library/socketserver.html#socketserver.ThreadingMixIn",target:"_blank",rel:"noopener noreferrer"}},[t._v("ThreadingMixIn"),s("OutboundLink")],1),t._v(" の説明も見てみましょう。")]),t._v(" "),s("blockquote",[s("p",[t._v("Forking and threading versions of each type of server can be created using these mix-in classes.")])]),t._v(" "),s("p",[s("code",[t._v("fork")]),t._v("もしくは"),s("code",[t._v("thread")]),t._v("いずれかの仕組みで渡したServerオブジェクトを並列に実行してくれるようです。"),s("code",[t._v("fork")]),t._v("と"),s("code",[t._v("thread")]),t._v("は両方とも並列処理のための方法ですが、大きな違いがあります。")]),t._v(" "),s("p",[s("img",{attrs:{src:a(467),alt:"fork",title:"fork"}})]),t._v(" "),s("p",[s("img",{attrs:{src:a(468),alt:"thread",title:"thread"}})]),t._v(" "),s("p",[t._v("図の通り"),s("code",[t._v("fork")]),t._v("の場合forkで分かれたプロセス上で"),s("code",[t._v("SimpleHelloHandler")]),t._v("のインスタンスが実行されます。そのためリクエストを処理する各インスタンス間でメモリ空間を共有していません（できないとも言う）。\n一方で"),s("code",[t._v("thread")]),t._v("の場合はメモリ空間を共有した同じプロセス内で"),s("code",[t._v("SimpleHelloHandler")]),t._v("インスタンスが実行されます。")]),t._v(" "),s("p",[t._v("今回"),s("code",[t._v("request_total")]),t._v("はクラス変数として宣言されています。そのため各"),s("code",[t._v("SimpleHelloHandler")]),t._v("インスタンスから共有するメモリ上の変数としてアクセスが可能です。\nWebサーバを実装する時に限りませんが、ライブラリやフレームワークを利用する際にはそれがどういう仕組みで動くのか把握しておく必要があります。")]),t._v(" "),s("h4",{attrs:{id:"クリティカルセッション"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#クリティカルセッション"}},[t._v("#")]),t._v(" クリティカルセッション")]),t._v(" "),s("p",[s("code",[t._v("count_and_do_something")]),t._v("の以下の部分に注目してみましょう（といっても中身全てですが）。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("div",{staticClass:"highlight-lines"},[s("br"),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("br")]),s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t\n")])]),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br")])]),s("p",[t._v("上記2-10行目は"),s("code",[t._v("SimpleHelloHandler.request_total")]),t._v("という共有資源にアクセスしており、複数のスレッドから同時にアクセスされると不具合が起きます。このような箇所を「"),s("strong",[t._v("クリティカルセクション")]),t._v("」と呼びます。\nまた実際にクリティカルセクションに複数のスレッドが同時にアクセスしてしまい、不具合が起きている状態を「"),s("strong",[t._v("レースコンディション(競合状態)")]),t._v("」と呼びます。")]),t._v(" "),s("p",[t._v("スレッドなどを利用する並行処理プログラミングではこのクリティカルセクションを如何に減らし、そして保護するかが大切になります。")]),t._v(" "),s("h3",{attrs:{id:"排他制御・アトミック処理"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#排他制御・アトミック処理"}},[t._v("#")]),t._v(" 排他制御・アトミック処理")]),t._v(" "),s("h4",{attrs:{id:"排他制御"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#排他制御"}},[t._v("#")]),t._v(" 排他制御")]),t._v(" "),s("p",[t._v("クリティカルセクションを保護する手法の一つが、ロックを取得する排他制御と呼ばれるものです。まずは素朴に実装してみましょう。\n（説明用にすごく雑な実装なので間違っても仕事で以下のようなコードを書かないでください）")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("0")]),t._v("\n request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("False")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("while")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("True")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("if")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("not")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# request_total_lock がFalseになるまで無限ループする")]),t._v("\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("True")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# ロックの取得")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("break")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("False")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 処理が完了したらロックを解放する")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("count_and_do_something"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello! request count=%a\\n'")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("%")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br"),s("span",{staticClass:"line-number"},[t._v("22")]),s("br"),s("span",{staticClass:"line-number"},[t._v("23")]),s("br"),s("span",{staticClass:"line-number"},[t._v("24")]),s("br"),s("span",{staticClass:"line-number"},[t._v("25")]),s("br"),s("span",{staticClass:"line-number"},[t._v("26")]),s("br"),s("span",{staticClass:"line-number"},[t._v("27")]),s("br"),s("span",{staticClass:"line-number"},[t._v("28")]),s("br"),s("span",{staticClass:"line-number"},[t._v("29")]),s("br"),s("span",{staticClass:"line-number"},[t._v("30")]),s("br"),s("span",{staticClass:"line-number"},[t._v("31")]),s("br"),s("span",{staticClass:"line-number"},[t._v("32")]),s("br"),s("span",{staticClass:"line-number"},[t._v("33")]),s("br"),s("span",{staticClass:"line-number"},[t._v("34")]),s("br"),s("span",{staticClass:"line-number"},[t._v("35")]),s("br"),s("span",{staticClass:"line-number"},[t._v("36")]),s("br"),s("span",{staticClass:"line-number"},[t._v("37")]),s("br"),s("span",{staticClass:"line-number"},[t._v("38")]),s("br"),s("span",{staticClass:"line-number"},[t._v("39")]),s("br")])]),s("p",[t._v("サーバを実行してみてください。先ほどと同じようにcurlを実行するとどうでしょうか。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ curl localhost:8000 &\n$ curl localhost:8000 &\n$ curl localhost:8000 &\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br")])]),s("p",[t._v("ここでは新しくクラス変数として"),s("code",[t._v("request_total_lock")]),t._v("を追加し、"),s("code",[t._v("count_and_do_something")]),t._v("の先頭でこの変数を検査しています。\n"),s("code",[t._v("True")]),t._v("の場合は次のループに遷移し、無限に検査を繰り返します。"),s("code",[t._v("False")]),t._v("だった場合は"),s("code",[t._v("True")]),t._v("を代入しクリティカルセクションに入ります。\nクリティカルセクションの終了後、"),s("code",[t._v("request_total_lock")]),t._v("に"),s("code",[t._v("False")]),t._v("を代入し、別のスレッドが実行できるようにします。")]),t._v(" "),s("p",[t._v("少しややこしいですが、複数のスレッド間の動作を順番に書くと以下のようになります。")]),t._v(" "),s("ol",[s("li",[t._v("最初のリクエスト(thread1)が来て"),s("code",[t._v("count_and_do_something")]),t._v("が実行される")]),t._v(" "),s("li",[s("code",[t._v("request_total_lock")]),t._v("は"),s("code",[t._v("False")]),t._v("なのでthread1が"),s("code",[t._v("True")]),t._v("を代入してロックを取得する")]),t._v(" "),s("li",[t._v("2個目のリクエスト(thread2)が来て"),s("code",[t._v("count_and_do_something")]),t._v("が実行される")]),t._v(" "),s("li",[s("code",[t._v("request_total_lock")]),t._v("は"),s("code",[t._v("True")]),t._v("なのでthread2は無限ループを続ける")]),t._v(" "),s("li",[t._v("thread1でクリティカルセクションが完了し、"),s("code",[t._v("request_total_lock")]),t._v("に"),s("code",[t._v("False")]),t._v("が代入される")]),t._v(" "),s("li",[t._v("thread2がロックを取得し、クリティカルセクションを開始する")])]),t._v(" "),s("p",[t._v("このロック機構によりクリティカルセクションが保護され、"),s("code",[t._v("request_total")]),t._v("が正しくカウントされるようになりました。\nこのようにロックが取得できるまで無限ループで待ち続けるような実装を「スピンロック」と言います。")]),t._v(" "),s("p",[t._v("このコードは一見うまくいっていますが、実はレースコンディションを引き起こすクリティカルセクションが隠れています。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("div",{staticClass:"highlight-lines"},[s("br"),s("br"),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("div",{staticClass:"highlighted"},[t._v(" ")]),s("br"),s("br")]),s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("while")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("True")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("if")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("not")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# ここから")]),t._v("\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token boolean"}},[t._v("True")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# ここまでが実はクリティカルセクション")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("break")]),t._v("\n")])]),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br")])]),s("p",[t._v("上記の3行目で"),s("code",[t._v("request_total_lock")]),t._v("を見た後"),s("code",[t._v("True")]),t._v("を代入するまでにわずかながらでもラグがあるため、運が悪いと3行目が複数のスレッドで同時に実行される可能性があります。\nすると複数のスレッドが同時にロックを取得してしまい、クリティカルセクションが同時に実行されてしまいます。")]),t._v(" "),s("p",[t._v("後でも記載しますが、これは"),s("code",[t._v("request_total_lock")]),t._v("の検査とロックの獲得が「アトミックでない」処理のためです。")]),t._v(" "),s("p",[t._v("さて、このように並行処理に関わるスピンロックなどのコードを自前で実装するのはやめて、ライブラリを使いましょう。これはスレッドプログラミングにおける大原則です。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" threading "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" Lock\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("0")]),t._v("\n request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" Lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("acquire"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# ロックの取得。他のスレッドはアクセスできなくなる")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("release"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# ロックの解放")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("count_and_do_something"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello! request count=%a\\n'")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("%")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br"),s("span",{staticClass:"line-number"},[t._v("22")]),s("br"),s("span",{staticClass:"line-number"},[t._v("23")]),s("br"),s("span",{staticClass:"line-number"},[t._v("24")]),s("br"),s("span",{staticClass:"line-number"},[t._v("25")]),s("br"),s("span",{staticClass:"line-number"},[t._v("26")]),s("br"),s("span",{staticClass:"line-number"},[t._v("27")]),s("br"),s("span",{staticClass:"line-number"},[t._v("28")]),s("br"),s("span",{staticClass:"line-number"},[t._v("29")]),s("br"),s("span",{staticClass:"line-number"},[t._v("30")]),s("br"),s("span",{staticClass:"line-number"},[t._v("31")]),s("br"),s("span",{staticClass:"line-number"},[t._v("32")]),s("br"),s("span",{staticClass:"line-number"},[t._v("33")]),s("br"),s("span",{staticClass:"line-number"},[t._v("34")]),s("br"),s("span",{staticClass:"line-number"},[t._v("35")]),s("br"),s("span",{staticClass:"line-number"},[t._v("36")]),s("br")])]),s("p",[t._v("Pythonの "),s("a",{attrs:{href:"https://docs.python.org/ja/3/library/threading.html",target:"_blank",rel:"noopener noreferrer"}},[t._v("threadingパッケージ"),s("OutboundLink")],1),t._v(" にはスレッドプログラミングに使えるツールが用意されています。今回は "),s("a",{attrs:{href:"https://docs.python.org/ja/3/library/threading.html#lock-objects",target:"_blank",rel:"noopener noreferrer"}},[t._v("Lock"),s("OutboundLink")],1),t._v(" を利用しました。\n"),s("code",[t._v("acquire()")]),t._v("を実行するとロックを取得し、もし他のスレッドで既に取得済みの場合はブロック（コード実行をそこで停止する）します。")]),t._v(" "),s("p",[t._v("この部分は以下のようにも書けます。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" t"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" t\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br")])]),s("p",[t._v("クリティカルセクションが分かりやすくロックの開放し忘れもないので、基本的には"),s("code",[t._v("with")]),t._v("を利用して書きましょう。")]),t._v(" "),s("h4",{attrs:{id:"スレッドセーフ-アトミック-な処理"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#スレッドセーフ-アトミック-な処理"}},[t._v("#")]),t._v(" スレッドセーフ（アトミック）な処理")]),t._v(" "),s("p",[t._v("ロックを取得することでクリティカルセクションを保護できることは分かりました。\nしかし皆さんも薄々お気づきの通り、そもそもこのコードのクリティカルセクションをもっと小さくできるのではないでしょうか。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("0")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("count_and_do_something"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello! request count=%a\\n'")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("%")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br"),s("span",{staticClass:"line-number"},[t._v("22")]),s("br"),s("span",{staticClass:"line-number"},[t._v("23")]),s("br"),s("span",{staticClass:"line-number"},[t._v("24")]),s("br"),s("span",{staticClass:"line-number"},[t._v("25")]),s("br"),s("span",{staticClass:"line-number"},[t._v("26")]),s("br"),s("span",{staticClass:"line-number"},[t._v("27")]),s("br"),s("span",{staticClass:"line-number"},[t._v("28")]),s("br"),s("span",{staticClass:"line-number"},[t._v("29")]),s("br"),s("span",{staticClass:"line-number"},[t._v("30")]),s("br"),s("span",{staticClass:"line-number"},[t._v("31")]),s("br"),s("span",{staticClass:"line-number"},[t._v("32")]),s("br")])]),s("p",[t._v("どうでしょう。試しに同じようにcurlで叩いてみましょう。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("$ curl localhost:8000 &\n$ curl localhost:8000 &\n$ curl localhost:8000 &\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br")])]),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v("serving at port 8000\nstart processing path = /, before request count = 0\nstart processing path = /, before request count = 0\nstart processing path = /, before request count = 0\nend processing path = /, after request count = 1\nend processing path = /, after request count = 2\nend processing path = /, after request count = 3\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br")])]),s("p",[s("code",[t._v("before request count")]),t._v(" はうまく出力できなくなってしまいましたが、「リクエスト数をカウントする」という要件は満たせているように見えます。\nしかしここにもレースコンディションを引き起こすクリティカルセクションが隠れています。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# クリティカルセクション")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br")])]),s("p",[t._v("スレッドプログラミングにおいて、ある処理が複数スレッドから同時に実行されても問題ない実装であることを「スレッドセーフ(thread safe)である」と言います。\n例えば先ほどの"),s("code",[t._v("acquire()")]),t._v("はスレッドセーフなメソッドであり、複数スレッドから同時にアクセスされてもレースコンディションを起こさないように実装されています。")]),t._v(" "),s("p",[t._v("一方でPythonにおける"),s("code",[t._v("+= 1")]),t._v("とはスレッドセーフな処理なんでしょうか。結論から言うとそうではありません。\nなぜこの短いコードでレースコンディションが発生するのでしょうか。")]),t._v(" "),s("p",[t._v("Pythonで書かれたコードは最終的にバイトコードにコンパイルされて実行されます（CPythonの場合）。\n"),s("code",[t._v("dis")]),t._v("を利用して実際に実行されるバイトコードを見てみましょう。")]),t._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[t._v('root@40e566b8e23e:/work# python3\nPython 3.9.2 (default, Feb 28 2021, 17:03:44)\n[GCC 10.2.1 20210110] on linux\nType "help", "copyright", "credits" or "license" for more information.\n>>> import dis\n>>> a = 0\n>>> dis.dis("a += 1")\n 1 0 LOAD_NAME 0 (a)\n 2 LOAD_CONST 0 (1)\n 4 INPLACE_ADD\n 6 STORE_NAME 0 (a)\n 8 LOAD_CONST 1 (None)\n 10 RETURN_VALUE\n>>>\n')])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br")])]),s("p",[s("code",[t._v("a += 1")]),t._v("というコードは上記の通り6行のバイトコードに変換されます。内容を見てみると以下のように動作することが分かります。")]),t._v(" "),s("ol",[s("li",[t._v("「a」というメモリ領域から値を読み込む("),s("code",[t._v("LOAD_NAME")]),t._v(")")]),t._v(" "),s("li",[t._v("加算する("),s("code",[t._v("INPLACE_ADD")]),t._v(")")]),t._v(" "),s("li",[t._v("「a」というメモリ領域に値を書き込む("),s("code",[t._v("STORE_NAME")]),t._v(")")])]),t._v(" "),s("p",[t._v("つまり"),s("code",[t._v("a += 1")]),t._v("という一見1ステップのコードでも、バイトコードやその先の機械語レベルでは複数のステップに分かれた処理である可能性があります。\n（ここで「可能性」と言っているのは、あくまで言語やコンパイラの仕様や実装次第なためです。少なくともCPythonではアトミックな機械語は生成されないはずです。）")]),t._v(" "),s("p",[t._v("仮に機械語レベルで複数ステップに分かれた処理であった場合、タイミングによってはthread1が1ステップ目を実行した後、\n入れ替わりthread2が1ステップ目を実行してしまう可能性があります。\nそのため"),s("code",[t._v("a += 1")]),t._v("のような一見単純なコードでも、レースコンディションを起こす可能性があります。")]),t._v(" "),s("p",[t._v("スレッドプログラミングにおいては常に「その処理がスレッドセーフなのか」、仕様を確認しつつ進める必要があります。")]),t._v(" "),s("div",{staticClass:"custom-block tip"},[s("p",{staticClass:"custom-block-title"},[t._v("アトミックな処理")]),t._v(" "),s("p",[t._v("「アトム(atom)」とは「これ以上分割不可能な単位」という意味を持ち、「原子性」などとも呼ばれます。\n同じように「アトミックな処理」とはその処理が「外部から途中経過が観測できず、失敗した場合は処理前の状態に復元される」ことを言います。\nその意味でCPythonにおける"),s("code",[t._v("a += 1")]),t._v("はメモリからreadしてwriteする過程があるためアトミックな処理ではありません。")]),t._v(" "),s("p",[t._v("例えばMySQLなどのRDBでトランザクションを張り、最後にCOMMITする操作はアトミックな処理です。\nまた最近のCPUには加算処理などをアトミックに行う処理が命令として用意されており、言語によってはそういった命令を利用してアトミックな加算処理などを利用することが可能です。")]),t._v(" "),s("p",[t._v("例: gccなどのCコンパイラに実装されている"),s("code",[t._v("__sync_fetch_and_add")]),t._v("など")])]),t._v(" "),s("div",{staticClass:"custom-block tip"},[s("p",{staticClass:"custom-block-title"},[t._v("コンテキストスイッチ")]),t._v(" "),s("p",[t._v("CPython(c言語で書かれたPython処理系)にはGILという仕組みがあり、Pythonプログラムは1個のCPUコアしか使うことができません。\n1個のCPUコアでは同時に1個の仕事しかできないため、複数のスレッドを動かす際は1個のCPUコアの処理時間を分け合うことになります。\nつまりあるCPUコアでthread1の仕事を進めつつあるタイミングでthread1を待機状態にし、thread2の仕事を始める・・・ということを行っていきます。\nこの仕事の割り振りを決めるのがLinuxカーネルにおける「スケジューラ」と呼ばれる機能であり、thread1->thread2など仕事内容が切り替わるのを「コンテキストスイッチ」と呼びます。")])]),t._v(" "),s("p",[s("code",[t._v("a += 1")]),t._v(" がスレッドセーフでないことが分かったので、きちんとロックを利用してスレッドセーフな実装にしましょう。")]),t._v(" "),s("div",{staticClass:"language-python line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-python"}},[s("code",[s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" http"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("server "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" ThreadingHTTPServer\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("from")]),t._v(" threading "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" Lock\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("import")]),t._v(" time\n\nPORT "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("8000")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("class")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token class-name"}},[t._v("SimpleHelloHandler")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("BaseHTTPRequestHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("0")]),t._v("\n request_total_lock "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("=")]),t._v(" Lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("increment_request_total")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total_lock"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("+=")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("1")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("count_and_do_something")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'start processing path = {}, before request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n time"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("sleep"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("5")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# 何かの処理")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("increment_request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'end processing path = {}, after request count = {}'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),s("span",{pre:!0,attrs:{class:"token builtin"}},[t._v("format")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("\n path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("def")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("do_GET")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("count_and_do_something"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),t._v("self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("path"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_response"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token number"}},[t._v("200")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("send_header"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'Content-Type'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("'text/plain; charset=utf-8'")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("end_headers"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n self"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("wfile"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("write"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v("b'Hello! request count=%a\\n'")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token operator"}},[t._v("%")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("request_total"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n\n\n"),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("with")]),t._v(" ThreadingHTTPServer"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('""')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" SimpleHelloHandler"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v(" "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("as")]),t._v(" httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(":")]),t._v("\n "),s("span",{pre:!0,attrs:{class:"token keyword"}},[t._v("print")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token string"}},[t._v('"serving at port"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(",")]),t._v(" PORT"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n httpd"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(".")]),t._v("serve_forever"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v("(")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[t._v(")")]),t._v("\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br"),s("span",{staticClass:"line-number"},[t._v("4")]),s("br"),s("span",{staticClass:"line-number"},[t._v("5")]),s("br"),s("span",{staticClass:"line-number"},[t._v("6")]),s("br"),s("span",{staticClass:"line-number"},[t._v("7")]),s("br"),s("span",{staticClass:"line-number"},[t._v("8")]),s("br"),s("span",{staticClass:"line-number"},[t._v("9")]),s("br"),s("span",{staticClass:"line-number"},[t._v("10")]),s("br"),s("span",{staticClass:"line-number"},[t._v("11")]),s("br"),s("span",{staticClass:"line-number"},[t._v("12")]),s("br"),s("span",{staticClass:"line-number"},[t._v("13")]),s("br"),s("span",{staticClass:"line-number"},[t._v("14")]),s("br"),s("span",{staticClass:"line-number"},[t._v("15")]),s("br"),s("span",{staticClass:"line-number"},[t._v("16")]),s("br"),s("span",{staticClass:"line-number"},[t._v("17")]),s("br"),s("span",{staticClass:"line-number"},[t._v("18")]),s("br"),s("span",{staticClass:"line-number"},[t._v("19")]),s("br"),s("span",{staticClass:"line-number"},[t._v("20")]),s("br"),s("span",{staticClass:"line-number"},[t._v("21")]),s("br"),s("span",{staticClass:"line-number"},[t._v("22")]),s("br"),s("span",{staticClass:"line-number"},[t._v("23")]),s("br"),s("span",{staticClass:"line-number"},[t._v("24")]),s("br"),s("span",{staticClass:"line-number"},[t._v("25")]),s("br"),s("span",{staticClass:"line-number"},[t._v("26")]),s("br"),s("span",{staticClass:"line-number"},[t._v("27")]),s("br"),s("span",{staticClass:"line-number"},[t._v("28")]),s("br"),s("span",{staticClass:"line-number"},[t._v("29")]),s("br"),s("span",{staticClass:"line-number"},[t._v("30")]),s("br"),s("span",{staticClass:"line-number"},[t._v("31")]),s("br"),s("span",{staticClass:"line-number"},[t._v("32")]),s("br"),s("span",{staticClass:"line-number"},[t._v("33")]),s("br"),s("span",{staticClass:"line-number"},[t._v("34")]),s("br"),s("span",{staticClass:"line-number"},[t._v("35")]),s("br"),s("span",{staticClass:"line-number"},[t._v("36")]),s("br"),s("span",{staticClass:"line-number"},[t._v("37")]),s("br")])]),s("h2",{attrs:{id:"最後に"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#最後に"}},[t._v("#")]),t._v(" 最後に")]),t._v(" "),s("p",[t._v("この資料で伝えたいのは以下のことです。")]),t._v(" "),s("ul",[s("li",[t._v("ライブラリやフレームワークを利用する際はその仕組みをきちんと理解しましょう\n"),s("ul",[s("li",[t._v("webプログラミングにおいては特に並行・並列処理をどのように実装しているのか確認しましょう")])])]),t._v(" "),s("li",[t._v("スレッドプログラミングを書いているという認識を持ち、書こうとしている処理がスレッドセーフなのか常に確認しましょう\n"),s("ul",[s("li",[t._v("Webフレームワークが推奨する書き方に習うことで、トラブルを防ぐことができます")])])]),t._v(" "),s("li",[t._v("ロックなど排他制御の実装を行う際は自前で実装せず、必ずライブラリを利用しましょう")])]),t._v(" "),s("p",[t._v("並行・並列処理、スレッドプログラミングは非常に複雑になります（これは実行するまで処理がどのような順番で実行されるか分からない非決定性から来ています）。")]),t._v(" "),s("p",[t._v("Webフレームワークはこの並行・並列処理の複雑性を隠蔽するために発達しているという側面があり、推奨される書き方をすることで複雑性を意識しなくても実装が可能なようになっています。\nしかし自分が今どのような仕組みの上で実装しているのかを意識していないと、思わぬ事故を起こす可能性があります。")]),t._v(" "),s("p",[t._v("フレームワークが提供するレールに乗りながらも、自分がスレッドプログラミングをしていることを常に意識することが大切です。")]),t._v(" "),s("credit-footer")],1)}),[],!1,null,null,null);s.default=e.exports}}]); \ No newline at end of file diff --git a/assets/js/26.381232ac.js b/assets/js/26.381232ac.js deleted file mode 100644 index dfc353bc..00000000 --- a/assets/js/26.381232ac.js +++ /dev/null @@ -1 +0,0 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[26],{469:function(s,t,a){s.exports=a.p+"assets/img/white-label-error.c9ee4513.png"},470:function(s,t,a){s.exports=a.p+"assets/img/http-handler.0b72f6d9.png"},551:function(s,t,a){"use strict";a.r(t);var n=a(10),e=Object(n.a)({},(function(){var s=this,t=s._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[t("header-table"),s._v(" "),t("h1",{attrs:{id:"page-frontmatter-title"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#page-frontmatter-title"}},[s._v("#")]),s._v(" "+s._s(s.$page.frontmatter.title))]),s._v(" "),t("h2",{attrs:{id:"始めに"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#始めに"}},[s._v("#")]),s._v(" 始めに")]),s._v(" "),t("ul",[t("li",[s._v("Javaの基本")]),s._v(" "),t("li",[s._v("Spring Bootの基本")]),s._v(" "),t("li",[s._v("Spring Bootハンズオン")])]),s._v(" "),t("p",[s._v("本講義では上記について紹介し、Javaというプログラミング言語とそのWebフレームワークであるSpring Bootといった技術的な選択肢を増やすことを目的としています。")]),s._v(" "),t("h3",{attrs:{id:"本講義の前提"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#本講義の前提"}},[s._v("#")]),s._v(" 本講義の前提")]),s._v(" "),t("p",[s._v("本講義ではプログラム言語共通の制御構文や概念、たとえばif文や型など、の解説は行いません。そのため、受講者は何らかのプログラミング言語で簡単な制御構文が書けることを前提とさせてください。")]),s._v(" "),t("h3",{attrs:{id:"この資料のお約束"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#この資料のお約束"}},[s._v("#")]),s._v(" この資料のお約束")]),s._v(" "),t("p",[s._v("💻 は自分で操作する箇所を示しています。 また"),t("code",[s._v("$")]),s._v("はホストマシンのプロンプトを意味し、"),t("code",[s._v("❯")]),s._v("はコンテナ内部でのプロンプトを意味します。")]),s._v(" "),t("p",[s._v("たとえば下記の通りです。")]),s._v(" "),t("div",{staticClass:"language-shell line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-shell"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# ホストマシン上で git clone git@github.com:iij/bootcamp.git を実行する")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("git")]),s._v(" clone git@github.com:iij/bootcamp.git\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# コンテナ上で curl localhost:8080 を実行する")]),s._v("\n❯ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" localhost:8080\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br")])]),t("h3",{attrs:{id:"下準備"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#下準備"}},[s._v("#")]),s._v(" 下準備")]),s._v(" "),t("p",[s._v("講義を受講する前にコンテナイメージのpullと起動をしておくことをお勧めしています。\nまた、Dockerの実行環境があることを前提として本講義を進めます。")]),s._v(" "),t("h4",{attrs:{id:"手順"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#手順"}},[s._v("#")]),s._v(" 手順")]),s._v(" "),t("ol",[t("li",[s._v("ハンズオン用のDockerイメージをpullしてくる")])]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# やや重たいので注意してください")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" pull tamago0224/bootcamp-springboot:2023\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("ol",{attrs:{start:"2"}},[t("li",[s._v("コンテナを起動する")])]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# プロキシ環境下にいる人はプロキシの設定をする")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token assign-left variable"}},[s._v("PROXY_HOST")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v("YOUR.PROXY.HOST\n$ "),t("span",{pre:!0,attrs:{class:"token assign-left variable"}},[s._v("PROXY_PORT")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v("YOUR_PROXY_PORT\n$ "),t("span",{pre:!0,attrs:{class:"token assign-left variable"}},[s._v("JAVA_OPT")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"-Dhttp.proxyHost='),t("span",{pre:!0,attrs:{class:"token variable"}},[s._v("${PROXY_HOST}")]),s._v(" -Dhttp.proxyPort="),t("span",{pre:!0,attrs:{class:"token variable"}},[s._v("${PROXY_PORT}")]),s._v(" -Dhttps.proxyHost="),t("span",{pre:!0,attrs:{class:"token variable"}},[s._v("${PROXY_HOST}")]),s._v(" -Dhttps.proxyPort="),t("span",{pre:!0,attrs:{class:"token variable"}},[s._v("${PROXY_PORT}")]),s._v('"')]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# プロキシ設定ここまで")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# コンテナを起動する")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" run --name bootcamp-springboot -it -p "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("8080")]),s._v(":8080 -e "),t("span",{pre:!0,attrs:{class:"token assign-left variable"}},[s._v("JAVA_OPT")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"'),t("span",{pre:!0,attrs:{class:"token variable"}},[s._v("${JAVA_OPT}")]),s._v('"')]),s._v(" tamago0224/bootcamp-springboot:2023\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("ol",{attrs:{start:"3"}},[t("li",[s._v("アプリケーションの起動チェック")])]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootを起動する")]),s._v("\n❯ ./gradlew bootrun\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# ...")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# いろんなログが流れる")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br")])]),t("ol",{attrs:{start:"4"}},[t("li",[s._v("動作チェック")])]),s._v(" "),t("p",[s._v("ホストマシンの適当なブラウザから"),t("a",{attrs:{href:"http://localhost:8080",target:"_blank",rel:"noopener noreferrer"}},[s._v("localhost:8080"),t("OutboundLink")],1),s._v("にアクセスし、下記のようなエラーページが表示されることを確認してください。")]),s._v(" "),t("p",[t("img",{attrs:{src:a(469),alt:"初回起動 - WhitelabelErrorPage"}})]),s._v(" "),t("h2",{attrs:{id:"javaの基本"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#javaの基本"}},[s._v("#")]),s._v(" Javaの基本")]),s._v(" "),t("p",[s._v("JavaはOpenJDKコミュニティによって開発され、各ベンダからリリースされているプログラミング言語です。\n古くから利用されているプログラミング言語/プラットフォームである一方、2022年現在でもSIや大規模開発の現場などでよく利用されています。")]),s._v(" "),t("h3",{attrs:{id:"言語としての特徴"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#言語としての特徴"}},[s._v("#")]),s._v(" 言語としての特徴")]),s._v(" "),t("p",[s._v("JavaはC言語やRustと同じ静的型付き言語です。そのため文法や記法はC言語を踏襲した書き方となっています。"),t("br"),s._v("\nJavaの言語のパラダイムとしては、クラスの継承の概念やインタフェースなどの言語仕様を持つためオブジェクト指向プログラミングであります。その一方、Javaのバージョン8以降は関数型インタフェースやパターンマッチなど、関数型プログラミングを楽しめるような仕様も導入されています。")]),s._v(" "),t("details",{staticClass:"custom-block details"},[t("summary",[s._v("Javaのサンプルコード")]),s._v(" "),t("div",{staticClass:"language-java line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-java"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// パッケージ名(世界でユニークであると良い)")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 自社ドメインを持つ企業での製造物には自社ドメインをそのまま利用することが多い")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("List")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 外部モジュールの利用(JavaではIDEに任せてしまうのが一般的)")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("/**\n * 複数行に渡るコメント文\n *\n * - 一般的にはJavaのクラス名の命名はパスカルケース - クラス名とjavaファイルの名前は一致させる方が良い(1クラス1ファイル)\n */")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SampleClass")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("extends")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Object")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// アクセス修飾子はprivate/protected/public")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" iamPrivate"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// Javaの変数・メソッドの命名は(ローワー)キャメルケース")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("protected")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" iamProtected"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" iamPublic"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// アノテーション。そのものに効果があるものではなく、横断的に処理したりする際の目印として使うことが多い")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@SuppressWarnings")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"unused"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("sampleMethod")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" a"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" b "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("null")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("equals")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("a"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n b "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"world"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" b"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("toString")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 残念ながらJavaはnull安全な言語ではない(NullPointerExceptionの危機)")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("MyInnerClass")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// クラスの中にクラスを定義することもできる(インナークラス)")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("final")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" finalizedString"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// final化(不変化)ができる")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("MyInnerClass")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" arg"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// コンストラクタはクラス名を同一にすることで表現")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("finalizedString "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" arg"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("getFinalizedString")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("finalizedString"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("makeInstance")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v('// クラスの具体的な値(オブジェクト)のことを"インスタンス"と言います')]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("var")]),s._v(" ins "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("MyInnerClass")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// Java11から型推論が使える")]),s._v("\n ins"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("getFinalizedString")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// → hello")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br"),t("span",{staticClass:"line-number"},[s._v("23")]),t("br"),t("span",{staticClass:"line-number"},[s._v("24")]),t("br"),t("span",{staticClass:"line-number"},[s._v("25")]),t("br"),t("span",{staticClass:"line-number"},[s._v("26")]),t("br"),t("span",{staticClass:"line-number"},[s._v("27")]),t("br"),t("span",{staticClass:"line-number"},[s._v("28")]),t("br"),t("span",{staticClass:"line-number"},[s._v("29")]),t("br"),t("span",{staticClass:"line-number"},[s._v("30")]),t("br"),t("span",{staticClass:"line-number"},[s._v("31")]),t("br"),t("span",{staticClass:"line-number"},[s._v("32")]),t("br"),t("span",{staticClass:"line-number"},[s._v("33")]),t("br"),t("span",{staticClass:"line-number"},[s._v("34")]),t("br"),t("span",{staticClass:"line-number"},[s._v("35")]),t("br"),t("span",{staticClass:"line-number"},[s._v("36")]),t("br"),t("span",{staticClass:"line-number"},[s._v("37")]),t("br"),t("span",{staticClass:"line-number"},[s._v("38")]),t("br"),t("span",{staticClass:"line-number"},[s._v("39")]),t("br"),t("span",{staticClass:"line-number"},[s._v("40")]),t("br"),t("span",{staticClass:"line-number"},[s._v("41")]),t("br"),t("span",{staticClass:"line-number"},[s._v("42")]),t("br"),t("span",{staticClass:"line-number"},[s._v("43")]),t("br"),t("span",{staticClass:"line-number"},[s._v("44")]),t("br"),t("span",{staticClass:"line-number"},[s._v("45")]),t("br"),t("span",{staticClass:"line-number"},[s._v("46")]),t("br"),t("span",{staticClass:"line-number"},[s._v("47")]),t("br"),t("span",{staticClass:"line-number"},[s._v("48")]),t("br")])])]),s._v(" "),t("h3",{attrs:{id:"プロジェクト構成"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#プロジェクト構成"}},[s._v("#")]),s._v(" プロジェクト構成")]),s._v(" "),t("p",[s._v('Javaのプロジェクトのディレクトリ構成は、ほかのプログラミング言語と異なり言語として定められています。名前空間として定義できる"パッケージ"がそのままディレクトリに反映されるようにディレクトリを構成する必要があります。')]),s._v(" "),t("p",[s._v("参考: "),t("a",{attrs:{href:"https://docs.oracle.com/javase/tutorial/java/package/managingfiles.html",target:"_blank",rel:"noopener noreferrer"}},[s._v("https://docs.oracle.com/javase/tutorial/java/package/managingfiles.html"),t("OutboundLink")],1)]),s._v(" "),t("p",[s._v("たとえば"),t("code",[s._v("com.github.iij.bootcamp")]),s._v("パッケージ(=名前空間)配下に"),t("code",[s._v("Hoge")]),s._v("と"),t("code",[s._v("Huga")]),s._v("というクラスを作成する場合、下記のようなディレクトリ構造/ファイル構造になります。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v(".\n├── build.gradle\n└── src\n └── main\n └── java\n └── com\n └── github\n └── iij\n └── bootcamp\n └── Hoge.java\n │ └── class Hoge { ... }\n └── Huga.java\n └── class Huga { ... }\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br")])]),t("div",{staticClass:"custom-block tip"},[t("p",{staticClass:"custom-block-title"},[s._v("パッケージ")]),s._v(" "),t("p",[s._v("Javaにおけるパッケージとは、DNS形式で定義できる名前空間のような概念です。"),t("code",[s._v(".")]),s._v("で区切ることでパッケージ間の親子関係を定義できます。たとえば"),t("code",[s._v("com.example.iij")]),s._v("パッケージと"),t("code",[s._v("com.example.iij.bootcamp")]),s._v("パッケージでは前者が親で後者が子といった関係があります。")])]),s._v(" "),t("h3",{attrs:{id:"gradle"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#gradle"}},[s._v("#")]),s._v(" Gradle")]),s._v(" "),t("p",[s._v("Pythonであればpip、Rustであればcargo、Node.jsであればnpmのようにプログラミング言語にはそれぞれ依存関係を解決しビルドを自動化する自動化システムツールが用意されています。")]),s._v(" "),t("p",[s._v("JavaではMavenとGradleという2つの種類の自動化システムツールがよく利用されています。本講義ではGradleを利用して話を進めていきます。")]),s._v(" "),t("div",{staticClass:"custom-block warning"},[t("p",{staticClass:"custom-block-title"},[s._v("WARNING")]),s._v(" "),t("p",[s._v("Mavenを使わずにGradleを利用する理由は、Gradleの方が優れている/イケているからではなく、単に筆者がXMLが嫌いであるためである。")])]),s._v(" "),t("h2",{attrs:{id:"spring-bootの基本"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#spring-bootの基本"}},[s._v("#")]),s._v(" Spring Bootの基本")]),s._v(" "),t("p",[s._v("Spring BootはJavaのWebフレームワークのひとつです。Spring Bootの規約に従ってアプリケーションロジックを実装することで簡単にWebアプリケーションを構築できます。")]),s._v(" "),t("p",[s._v("このフレームワークは大規模な主幹システムやWebアプリケーションを実装/構築する際によく利用されており、IIJがホストしているいくつかのサービスもSpring Bootを利用して実装されています。")]),s._v(" "),t("h3",{attrs:{id:"特徴"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#特徴"}},[s._v("#")]),s._v(" 特徴")]),s._v(" "),t("p",[s._v("Spring Bootは複雑な業務要件や非機能要件をクリアするためのさまざまな機能を有しています。依存関係を宣言して注入してくれるDIコンテナや横断的な関心事を解決するAOPのサポート、数多く公開されているstarterパッケージなどはその最たる例です。")]),s._v(" "),t("p",[s._v("残念ながらこのBootcampですべての要素に触れることはできないため、興味のあるほうはドキュメントを読んでみることをお勧めします。")]),s._v(" "),t("h2",{attrs:{id:"spring-bootハンズオン"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#spring-bootハンズオン"}},[s._v("#")]),s._v(" Spring Bootハンズオン")]),s._v(" "),t("p",[s._v("本ハンズオンではブラウザで閲覧できるWeb UIの機能を持たない、HTTP API(Application Programming Interface)だけを持つAPIサーバを構築していきます。")]),s._v(" "),t("p",[s._v("それでは始めましょう。")]),s._v(" "),t("h3",{attrs:{id:"簡単なクラスを作ってみる"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#簡単なクラスを作ってみる"}},[s._v("#")]),s._v(" 簡単なクラスを作ってみる")]),s._v(" "),t("p",[s._v("まず始めに、Java言語のウォーミングアップとして純粋なJavaのクラスを作ってみましょう。")]),s._v(" "),t("p",[s._v("💻 "),t("code",[s._v("User")]),s._v("クラスを作成します。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 下記の通りに修正する")]),s._v("\n❯ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("vim")]),s._v(" src/main/java/com/github/iij/bootcamp/serverapp/User.java\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("div",{staticClass:"language-java line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-java"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("id "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("getName")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("getId")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("setName")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("setId")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("id "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("toString")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name: "')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('","')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"id: "')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br"),t("span",{staticClass:"line-number"},[s._v("23")]),t("br"),t("span",{staticClass:"line-number"},[s._v("24")]),t("br"),t("span",{staticClass:"line-number"},[s._v("25")]),t("br"),t("span",{staticClass:"line-number"},[s._v("26")]),t("br"),t("span",{staticClass:"line-number"},[s._v("27")]),t("br"),t("span",{staticClass:"line-number"},[s._v("28")]),t("br"),t("span",{staticClass:"line-number"},[s._v("29")]),t("br"),t("span",{staticClass:"line-number"},[s._v("30")]),t("br"),t("span",{staticClass:"line-number"},[s._v("31")]),t("br"),t("span",{staticClass:"line-number"},[s._v("32")]),t("br")])]),t("p",[s._v("これで"),t("code",[s._v("User")]),s._v("クラスを作成できました。次にこのクラスを実際にインスタンス化してみます。"),t("br"),s._v("\nSpring Bootアプリケーションのmain関数は"),t("code",[s._v("com.github.iij.bootcamp.serverapp.ServerAppApplication")]),s._v("にあります。ためしにこのmain関数の中で"),t("code",[s._v("User")]),s._v("クラスをインスタンス化してみます。")]),s._v(" "),t("p",[s._v("💻 ServerAppApplication.javaを修正してください。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 下記の通りに修正する")]),s._v("\n❯ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("vim")]),s._v(" src/main/java/com/github/iij/bootcamp/serverapp/ServerAppApplication.java \n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootサーバーを再起動する")]),s._v("\n❯ ./gradlew bootRun\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br")])]),t("div",{staticClass:"language-java line-numbers-mode"},[t("div",{staticClass:"highlight-lines"},[t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("br"),t("br"),t("br"),t("br")]),t("pre",{pre:!0,attrs:{class:"language-java"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("boot"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringApplication")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("boot"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("autoconfigure"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringBootApplication")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@SpringBootApplication")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ServerAppApplication")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n\t"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("static")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("main")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v(" args"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\t\t"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n\t\t"),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" user "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"アリス"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"alice"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\t\t"),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("System")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("out"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("println")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("user"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("toString")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\t\t"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n\t\t"),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringApplication")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("run")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ServerAppApplication")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" args"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\t"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br")])]),t("p",[s._v('再起動時にログに"name: アリス,id: alice"と表示されていればOKです。')]),s._v(" "),t("h4",{attrs:{id:"チェックポイント"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#チェックポイント"}},[s._v("#")]),s._v(" チェックポイント")]),s._v(" "),t("ul",[t("li",[s._v("Javaのクラスを作成した")]),s._v(" "),t("li",[s._v("クラスをインスタンス化し、標準出力に文字列を表示した")])]),s._v(" "),t("h4",{attrs:{id:"解説"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#解説"}},[s._v("#")]),s._v(" 解説")]),s._v(" "),t("p",[s._v("純粋なJavaのクラスを作成し、インスタンス化とメソッドの呼び出しを行いました。"),t("code",[s._v("User")]),s._v("クラスを眺めてもらうとわかるとおり、"),t("code",[s._v("getName")]),s._v("や"),t("code",[s._v("getId")]),s._v("などJavaにはかなり冗長なコードが多いです。これらのコードはよく「ボイラープレート」と呼ばれ、開発者が嫌うコードです。")]),s._v(" "),t("p",[s._v("JavaにはLombokなどのボイラープレートを解消するツールなどありますが、本講義はあえて紹介しません。興味がある人は調べてみてください。")]),s._v(" "),t("h3",{attrs:{id:"簡単なhttpのインタフェースを作成してみる"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#簡単なhttpのインタフェースを作成してみる"}},[s._v("#")]),s._v(" 簡単なHTTPのインタフェースを作成してみる")]),s._v(" "),t("p",[s._v("それではSpring Bootを使ってみましょう。"),t("br"),s._v("\n簡単なHTTPのインタフェースを作成し、実際にSpring Bootがどのように動作しているのかを見てみます。")]),s._v(" "),t("p",[s._v("💻 ServerAppApplication.javaを修正し、サーバを再起動してみてください。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 下記の通りに修正する")]),s._v("\n❯ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("vim")]),s._v(" src/main/java/com/github/iij/bootcamp/serverapp/ServerAppApplication.java\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootサーバーを再起動する")]),s._v("\n❯ ./gradlew bootRun\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br")])]),t("div",{staticClass:"language-java line-numbers-mode"},[t("div",{staticClass:"highlight-lines"},[t("br"),t("br"),t("br"),t("br"),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("br"),t("br")]),t("pre",{pre:!0,attrs:{class:"language-java"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("boot"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringApplication")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("boot"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("autoconfigure"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringBootApplication")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("GetMapping")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RestController")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@SpringBootApplication")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ServerAppApplication")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("static")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("main")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v(" args"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" user "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"アリス"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"alice"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("System")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("out"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("println")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("user"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("toString")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringApplication")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("run")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ServerAppApplication")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" args"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RestController")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("HelloController")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@GetMapping")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("path "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("helloWorld")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello world"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br"),t("span",{staticClass:"line-number"},[s._v("23")]),t("br"),t("span",{staticClass:"line-number"},[s._v("24")]),t("br"),t("span",{staticClass:"line-number"},[s._v("25")]),t("br"),t("span",{staticClass:"line-number"},[s._v("26")]),t("br"),t("span",{staticClass:"line-number"},[s._v("27")]),t("br"),t("span",{staticClass:"line-number"},[s._v("28")]),t("br")])]),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 動作確認")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" localhost:8080 -X GET\nhello world\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("p",[s._v('"hello world"が返ってきたら成功です。')]),s._v(" "),t("h4",{attrs:{id:"チェックポイント-2"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#チェックポイント-2"}},[s._v("#")]),s._v(" チェックポイント")]),s._v(" "),t("ul",[t("li",[t("code",[s._v("@RestController")]),s._v("アノテーションをクラスに付与してHTTPのインタフェースを作成した")])]),s._v(" "),t("h4",{attrs:{id:"解説-2"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#解説-2"}},[s._v("#")]),s._v(" 解説")]),s._v(" "),t("p",[t("code",[s._v("bootRun")]),s._v("コマンドによりSpring Bootが起動します。すると、Spring Bootの機能により "),t("code",[s._v("@RestController")]),s._v("アノテーションが付いている"),t("code",[s._v("ServerAppApplication.HelloController")]),s._v("がHTTPのインタフェースとして登録されます。")]),s._v(" "),t("p",[t("img",{attrs:{src:a(470),alt:"handler"}})]),s._v(" "),t("p",[s._v("その結果、このSpring Bootが動いている8080番ポート宛のHTTPリクエストと"),t("code",[s._v("ServerAppApplication.HelloController#helloWorld")]),s._v("が紐づけられることになり、"),t("code",[s._v("GET /")]),s._v('へのリクエストのレスポンスとして"hello world"が返ってきました。')]),s._v(" "),t("details",{staticClass:"custom-block details"},[t("summary",[s._v("Spring BootとDIコンテナ")]),s._v(" "),t("p",[s._v("Spring Bootは起動時に起動クラスのパッケージ配下のJavaファイルから特殊なアノテーション("),t("code",[s._v("@Contoroller")]),s._v(" / "),t("code",[s._v("@Component")]),s._v(" / etc...)がついたクラスを探し出します。そしてSpring Bootはそのクラスを適当な方法でインスタンス化し、自身の管理下(=DI コンテナ)に置きます。")]),s._v(" "),t("p",[s._v("(「適当な方法」を指定することもできます > "),t("a",{attrs:{href:"https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/context/annotation/Bean.html",target:"_blank",rel:"noopener noreferrer"}},[s._v("Bean Annotation"),t("OutboundLink")],1),s._v(")")]),s._v(" "),t("p",[s._v("DIコンテナに格納されたインスタンスは、後述する"),t("code",[s._v("@Autowired")]),s._v("アノテーションを使って引き出すことができます。")]),s._v(" "),t("p",[s._v("特に、"),t("code",[s._v("@Controller")]),s._v(" "),t("code",[s._v("@RestController")]),s._v("アノテーションが付与されたクラスから生成されたインスタンスはHTTPのインタフェースとして働くことになります。")]),s._v(" "),t("p",[s._v("今回の例では、 "),t("code",[s._v("ServerAppApplication")]),s._v("クラスに"),t("code",[s._v("@SpringBootApplication")]),s._v("アノテーションが付与されているので"),t("code",[s._v("ServerAppApplication")]),s._v("クラスのパッケージ"),t("code",[s._v("com.github.iij.bootcamp.serverapp")]),s._v("配下のクラスから上述の特殊なアノテーションがついているクラスを探索します。")]),s._v(" "),t("p",[t("code",[s._v("HelloController")]),s._v("クラスは"),t("code",[s._v("@RestController")]),s._v("アノテーションが付与されているため、Spring Boot起動時に"),t("code",[s._v("HelloController")]),s._v("がSpring Bootによってインスタンス化されDIコンテナに登録されました。\nその結果、"),t("code",[s._v("GET /")]),s._v("のリクエストをSpring Bootが受け取ると"),t("code",[s._v("HelloController#helloWorld")]),s._v(" が実行されるようになっていたというわけです。")])]),s._v(" "),t("h3",{attrs:{id:"簡単なリクエストを受け取ってみる"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#簡単なリクエストを受け取ってみる"}},[s._v("#")]),s._v(" 簡単なリクエストを受け取ってみる")]),s._v(" "),t("p",[s._v("次にクエリパラメータから情報を取得してみましょう。")]),s._v(" "),t("p",[s._v("💻 UserController.javaを作成し、サーバを再起動してみてください。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 下記の通りに修正する")]),s._v("\n❯ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("vim")]),s._v(" src/main/java/com/github/iij/bootcamp/serverapp/UserController.java\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootサーバーを再起動する")]),s._v("\n❯ ./gradlew bootRun\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br")])]),t("div",{staticClass:"language-java line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-java"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("GetMapping")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RequestParam")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RestController")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RestController")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserController")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" secretUser "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"ボブ"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@GetMapping")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("path "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/user"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("find")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RequestParam")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("equals")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("secretUser"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("else")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("null")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br")])]),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 動作確認")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'localhost:8080/user?id=bob'")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"ボブ"')]),s._v(","),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"id"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("h4",{attrs:{id:"チェックポイント-3"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#チェックポイント-3"}},[s._v("#")]),s._v(" チェックポイント")]),s._v(" "),t("ul",[t("li",[t("code",[s._v("@GetMapping")]),s._v("アノテーションを持つメソッドを作成し、HTTPのハンドラとして登録した")]),s._v(" "),t("li",[s._v("HTTPのハンドラとして登録されたメソッドの引数に"),t("code",[s._v("@RequestParam")]),s._v("アノテーションを付与することでクエリパラメータを実装した")])]),s._v(" "),t("h4",{attrs:{id:"解説-3"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#解説-3"}},[s._v("#")]),s._v(" 解説")]),s._v(" "),t("p",[s._v("新しいクラス"),t("code",[s._v("UserController")]),s._v("を作成しました。このクラスにも"),t("code",[s._v("@RestController")]),s._v("アノテーションが付いているためHTTPのインタフェースとして振る舞います。")]),s._v(" "),t("p",[t("code",[s._v("UserController")]),s._v("クラスの持つメソッド"),t("code",[s._v("find")]),s._v("には"),t("code",[s._v("@GetMapping")]),s._v("アノテーションがついているため、"),t("code",[s._v("GET /user")]),s._v("宛のリクエストのハンドラとして登録されることになります。そのため、Spring Bootアプリケーションの"),t("code",[s._v("/user")]),s._v("へGETリクエストを送ることでこの"),t("code",[s._v("find")]),s._v("メソッドがコールされます。")]),s._v(" "),t("p",[s._v("さらに"),t("code",[s._v("find")]),s._v("メソッドの引数"),t("code",[s._v("id")]),s._v("に"),t("code",[s._v("@RequestParam")]),s._v("アノテーションが付与されています。これにより、HTTPリクエストのクエリパラメータの値がこの変数に注入されます。つまり"),t("code",[s._v("GET /user?id=bob")]),s._v("へのリクエストをSpring Bootアプリケーションへ送ることで"),t("code",[s._v("find")]),s._v("メソッドがコールされ引数"),t("code",[s._v("id=bob")]),s._v("が引き渡されます。")]),s._v(" "),t("h3",{attrs:{id:"責任を分離する"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#責任を分離する"}},[s._v("#")]),s._v(" 責任を分離する")]),s._v(" "),t("p",[s._v("さて、前章まで基本的なHTTPのインタフェースの作り方と使い方について解説してきました。もう少し実装を深めていきましょう。"),t("br"),s._v("\n現在"),t("code",[s._v("UserController")]),s._v("クラスはHTTPのインタフェースとデータソースの管理の2つの責務を持っています。これは単一責務の原理から外れているためリファクタリングする対象です。")]),s._v(" "),t("p",[s._v("今回はシンプルに"),t("code",[s._v("UserController#find")]),s._v("の処理を抽出して別のクラスに分離、処理そのものを"),t("code",[s._v("UserController")]),s._v("クラスの外から与えてあげるようにしましょう。")]),s._v(" "),t("p",[s._v("💻 UserService.javaを作成、UserController.javaを修正し、サーバを再起動してください。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 新しいクラスUserServiceを作成する")]),s._v("\n❯ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("vim")]),s._v(" src/main/java/com/github/iij/bootcamp/serverapp/UserService.java\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# UserControllerクラスを修正する")]),s._v("\n❯ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("vim")]),s._v(" src/main/java/com/github/iij/bootcamp/serverapp/UserController.java\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootサーバーを再起動する")]),s._v("\n❯ ./gradlew bootRun\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br")])]),t("div",{staticClass:"language-java line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-java"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ArrayList")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Arrays")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("List")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("stereotype"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Component")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@Component")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserService")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// データソースに該当する部分")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("List")]),t("span",{pre:!0,attrs:{class:"token generics"}},[t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v(" userPool "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ArrayList")]),t("span",{pre:!0,attrs:{class:"token generics"}},[t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Arrays")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("asList")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"ボブ"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n \n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("/**\n * ユーザープールからid値で検索し、その結果を返却します idと一致するユーザーが見つからない場合nullを返却します\n * TODO 本当にこの実装で問題ないか、考えてみましょう\n * - 同一のidをもつインスタンスがいる場合は？データ構造はこれで良いか？\n * - nullは`User`インスタンスではない、では見つからない場合は何を返すべき？\n */")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("findById")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// Java8から導入されたStreamAPI")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" user "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userPool\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("stream")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// Streamを作成")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("filter")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("u "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("->")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("equals")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("u"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("getId")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// idと一致する`User`インスタンスのみを抽出")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("findFirst")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 抽出結果の先頭1つだけを取り出す")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("orElse")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("null")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// もし抽出した結果何も残らなかった場合、nullを返却する")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" user"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br"),t("span",{staticClass:"line-number"},[s._v("23")]),t("br"),t("span",{staticClass:"line-number"},[s._v("24")]),t("br"),t("span",{staticClass:"line-number"},[s._v("25")]),t("br"),t("span",{staticClass:"line-number"},[s._v("26")]),t("br"),t("span",{staticClass:"line-number"},[s._v("27")]),t("br"),t("span",{staticClass:"line-number"},[s._v("28")]),t("br"),t("span",{staticClass:"line-number"},[s._v("29")]),t("br"),t("span",{staticClass:"line-number"},[s._v("30")]),t("br"),t("span",{staticClass:"line-number"},[s._v("31")]),t("br")])]),t("div",{staticClass:"language-java line-numbers-mode"},[t("div",{staticClass:"highlight-lines"},[t("br"),t("br"),t("br"),t("br"),t("br"),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("br"),t("br"),t("br"),t("br"),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("br"),t("br")]),t("pre",{pre:!0,attrs:{class:"language-java"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("GetMapping")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RestController")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RequestParam")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("beans"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("factory"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Autowired")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RestController")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserController")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 修正BEGIN")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@Autowired")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserService")]),s._v(" userService"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@GetMapping")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("path "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/user"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("find")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RequestParam")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userService"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("findById")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 修正END")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br")])]),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 動作確認")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'localhost:8080/user?id=bob'")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"ボブ"')]),s._v(","),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"id"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("h4",{attrs:{id:"チェックポイント-4"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#チェックポイント-4"}},[s._v("#")]),s._v(" チェックポイント")]),s._v(" "),t("ul",[t("li",[t("code",[s._v("@Component")]),s._v("アノテーションをクラスに付与し、Spring Boot起動時に自動的にインスタンス化した")]),s._v(" "),t("li",[t("code",[s._v("@Autowired")]),s._v("アノテーションをフィールドに付与し、そのフィールドにSpring Bootがインスタンス化したインスタンスの中から適切なインスタンスを注入した")])]),s._v(" "),t("h4",{attrs:{id:"解説-4"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#解説-4"}},[s._v("#")]),s._v(" 解説")]),s._v(" "),t("p",[s._v("新しいクラス"),t("code",[s._v("UserService")]),s._v("を作成しました。このクラスには"),t("code",[s._v("@Component")]),s._v("アノテーションが付与されているため、Spring Boot起動時にSpring Bootによって自動的にインスタンス化されSpring Bootの管理下に入ります。このようにSpring Bootに管理されるようになったインスタンスはほかのクラスから"),t("code",[s._v("@Autowired")]),s._v("を利用することで利用されます。")]),s._v(" "),t("p",[s._v("今回の例では"),t("code",[s._v("UserController")]),s._v("クラスが"),t("code",[s._v("userService")]),s._v("フィールドに"),t("code",[s._v("@Autowired")]),s._v("アノテーションを付与しているため自動的に作成された"),t("code",[s._v("UserService")]),s._v("クラスのインスタンスが"),t("code",[s._v("UserController.userService")]),s._v("に代入されることになりました。このように依存関係を分離、外から依存関係を持ち込む構成のことをDI(Dependency Injection)と呼びます。")]),s._v(" "),t("p",[s._v('注意点として、デフォルトの挙動ではSpring Bootが管理するインスタンスは各クラス"1つ"となっています。つまり'),t("code",[s._v("UserController")]),s._v("クラスが引っ張ってきている"),t("code",[s._v("userService")]),s._v("とほかのクラスが引っ張ってこれる"),t("code",[s._v("UserService")]),s._v('インスタンスは完全に一致しています。このようにひとつのインスタンスを使い回す構成のことを"シングルトン"と呼びます。')]),s._v(" "),t("h3",{attrs:{id:"少し複雑なリクエストを受け取ってみる"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#少し複雑なリクエストを受け取ってみる"}},[s._v("#")]),s._v(" 少し複雑なリクエストを受け取ってみる")]),s._v(" "),t("p",[s._v("最後に、POSTリクエストとリクエストボディを指定して"),t("code",[s._v("User")]),s._v("インスタンスを登録してみましょう。"),t("br"),s._v(" "),t("code",[s._v("User")]),s._v("インスタンスには"),t("code",[s._v("id")]),s._v("と"),t("code",[s._v("name")]),s._v("の値を指定する必要があるので、これらを与えられるエンドポイントを用意します。")]),s._v(" "),t("p",[s._v("💻 UserService.javaとUserController.javaを修正し、サーバを再起動してください。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 下記の通りに修正する")]),s._v("\n❯ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("vim")]),s._v(" src/main/java/com/github/iij/bootcamp/serverapp/UserService.java\n❯ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("vim")]),s._v(" src/main/java/com/github/iij/bootcamp/serverapp/UserController.java\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootサーバーを再起動する")]),s._v("\n❯ ./gradlew bootRun\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br")])]),t("div",{staticClass:"language-java line-numbers-mode"},[t("div",{staticClass:"highlight-lines"},[t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("br"),t("br")]),t("pre",{pre:!0,attrs:{class:"language-java"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ArrayList")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Arrays")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("List")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("stereotype"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Component")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@Component")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserService")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// データソースに該当する部分")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("List")]),t("span",{pre:!0,attrs:{class:"token generics"}},[t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v(" userPool "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ArrayList")]),t("span",{pre:!0,attrs:{class:"token generics"}},[t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Arrays")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("asList")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"ボブ"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n \n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("/**\n * ユーザープールからid値で検索し、その結果を返却します idと一致するユーザーが見つからない場合nullを返却します\n */")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("findById")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" user "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userPool\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("stream")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("filter")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("u "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("->")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("equals")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("u"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("getId")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("findFirst")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("orElse")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("null")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" user"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("/**\n * ユーザープールにUserを追加します\n */")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("save")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" user"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userPool"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("add")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("user"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" user"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br"),t("span",{staticClass:"line-number"},[s._v("23")]),t("br"),t("span",{staticClass:"line-number"},[s._v("24")]),t("br"),t("span",{staticClass:"line-number"},[s._v("25")]),t("br"),t("span",{staticClass:"line-number"},[s._v("26")]),t("br"),t("span",{staticClass:"line-number"},[s._v("27")]),t("br"),t("span",{staticClass:"line-number"},[s._v("28")]),t("br"),t("span",{staticClass:"line-number"},[s._v("29")]),t("br"),t("span",{staticClass:"line-number"},[s._v("30")]),t("br"),t("span",{staticClass:"line-number"},[s._v("31")]),t("br"),t("span",{staticClass:"line-number"},[s._v("32")]),t("br"),t("span",{staticClass:"line-number"},[s._v("33")]),t("br"),t("span",{staticClass:"line-number"},[s._v("34")]),t("br"),t("span",{staticClass:"line-number"},[s._v("35")]),t("br"),t("span",{staticClass:"line-number"},[s._v("36")]),t("br")])]),t("div",{staticClass:"language-java line-numbers-mode"},[t("div",{staticClass:"highlight-lines"},[t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("br"),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("div",{staticClass:"highlighted"},[s._v(" ")]),t("br"),t("br"),t("br")]),t("pre",{pre:!0,attrs:{class:"language-java"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("beans"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("factory"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Autowired")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("GetMapping")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RestController")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RequestParam")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("PostMapping")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token import"}},[t("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RequestBody")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RestController")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserController")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@Autowired")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserService")]),s._v(" userService"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@GetMapping")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("path "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/user"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("find")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RequestParam")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userService"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("findById")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// POST /user 宛のリクエストボディスキーマ")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("static")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserCreateRequest")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("getName")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("getId")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("setName")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("setId")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("id "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" id"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@PostMapping")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("path "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/user"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("create")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RequestBody")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserCreateRequest")]),s._v(" request"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" newUser "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("request"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("getName")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" request"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("getId")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userService"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("save")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("newUser"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br"),t("span",{staticClass:"line-number"},[s._v("23")]),t("br"),t("span",{staticClass:"line-number"},[s._v("24")]),t("br"),t("span",{staticClass:"line-number"},[s._v("25")]),t("br"),t("span",{staticClass:"line-number"},[s._v("26")]),t("br"),t("span",{staticClass:"line-number"},[s._v("27")]),t("br"),t("span",{staticClass:"line-number"},[s._v("28")]),t("br"),t("span",{staticClass:"line-number"},[s._v("29")]),t("br"),t("span",{staticClass:"line-number"},[s._v("30")]),t("br"),t("span",{staticClass:"line-number"},[s._v("31")]),t("br"),t("span",{staticClass:"line-number"},[s._v("32")]),t("br"),t("span",{staticClass:"line-number"},[s._v("33")]),t("br"),t("span",{staticClass:"line-number"},[s._v("34")]),t("br"),t("span",{staticClass:"line-number"},[s._v("35")]),t("br"),t("span",{staticClass:"line-number"},[s._v("36")]),t("br"),t("span",{staticClass:"line-number"},[s._v("37")]),t("br"),t("span",{staticClass:"line-number"},[s._v("38")]),t("br"),t("span",{staticClass:"line-number"},[s._v("39")]),t("br"),t("span",{staticClass:"line-number"},[s._v("40")]),t("br"),t("span",{staticClass:"line-number"},[s._v("41")]),t("br"),t("span",{staticClass:"line-number"},[s._v("42")]),t("br"),t("span",{staticClass:"line-number"},[s._v("43")]),t("br"),t("span",{staticClass:"line-number"},[s._v("44")]),t("br"),t("span",{staticClass:"line-number"},[s._v("45")]),t("br"),t("span",{staticClass:"line-number"},[s._v("46")]),t("br"),t("span",{staticClass:"line-number"},[s._v("47")]),t("br"),t("span",{staticClass:"line-number"},[s._v("48")]),t("br"),t("span",{staticClass:"line-number"},[s._v("49")]),t("br"),t("span",{staticClass:"line-number"},[s._v("50")]),t("br"),t("span",{staticClass:"line-number"},[s._v("51")]),t("br"),t("span",{staticClass:"line-number"},[s._v("52")]),t("br"),t("span",{staticClass:"line-number"},[s._v("53")]),t("br"),t("span",{staticClass:"line-number"},[s._v("54")]),t("br")])]),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 動作確認")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" localhost:8080/user -X POST -H "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Type: application/json'")]),s._v(" -d "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('\'{"name": "アリス", "id": "alice"}\'')]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"アリス"')]),s._v(", "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"id"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"alice"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'localhost:8080/user?id=alice'")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"アリス"')]),s._v(", "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"id"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"alice"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br")])]),t("h4",{attrs:{id:"チェックポイント-5"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#チェックポイント-5"}},[s._v("#")]),s._v(" チェックポイント")]),s._v(" "),t("ul",[t("li",[t("code",[s._v("@PostMapping")]),s._v("アノテーションをメソッドに付与し、POSTリクエストのHTTPハンドラとして登録した")]),s._v(" "),t("li",[s._v("JavaのPOJOを用いてPOSTリクエストのリクエストボディのスキーマを表現した")])]),s._v(" "),t("h2",{attrs:{id:"まとめ"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#まとめ"}},[s._v("#")]),s._v(" まとめ")]),s._v(" "),t("p",[s._v("以上でSpring Bootのハンズオンは終了です。")]),s._v(" "),t("p",[s._v("本講義ではJavaの基本的な知識や書き方、Spring Bootの使い方など、基本的な機能や文法に触れてもらいました。しかしSpring Bootには多様な機能がまだまだ存在しており、データベースとの接続や非同期処理などさまざまなプロダクション環境で活躍できるポテンシャルを持っているフレームワークです。")]),s._v(" "),t("p",[s._v("本講義が、受講者のみなさまの今後の技術選定の手助けになれれば幸いです。")]),s._v(" "),t("h3",{attrs:{id:"追加の資料"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#追加の資料"}},[s._v("#")]),s._v(" 追加の資料")]),s._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"https://spring.pleiades.io/spring-boot/docs/current/reference/html",target:"_blank",rel:"noopener noreferrer"}},[s._v("Spring Bootリファレンスドキュメント"),t("OutboundLink")],1),s._v(" "),t("ul",[t("li",[s._v("多くのSpring Boot開発者がお世話になる公式ドキュメントです。アプリケーションの開発からデプロイ方法まで、幅広く情報が提供されています。")])])]),s._v(" "),t("li",[t("a",{attrs:{href:"https://spring.pleiades.io/guides",target:"_blank",rel:"noopener noreferrer"}},[s._v("Spring Boot Guides"),t("OutboundLink")],1),s._v(" "),t("ul",[t("li",[s._v("Spring Bootの各種機能を試してみるチュートリアルが公開されています。Pub/SubやMongoDB、Dockerとの連携などSpring Bootの拡張が多種公開されています。興味のある項目に触ってみてください。")])])])]),s._v(" "),t("credit-footer")],1)}),[],!1,null,null,null);t.default=e.exports}}]); \ No newline at end of file diff --git a/assets/js/26.d3d4e8b1.js b/assets/js/26.d3d4e8b1.js new file mode 100644 index 00000000..e7ce13c8 --- /dev/null +++ b/assets/js/26.d3d4e8b1.js @@ -0,0 +1 @@ +(window.webpackJsonp=window.webpackJsonp||[]).push([[26],{469:function(s,a,t){s.exports=t.p+"assets/img/white-label-error.c9ee4513.png"},470:function(s,a,t){s.exports=t.p+"assets/img/http-handler.0b72f6d9.png"},552:function(s,a,t){"use strict";t.r(a);var n=t(10),e=Object(n.a)({},(function(){var s=this,a=s._self._c;return a("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[a("header-table"),s._v(" "),a("h1",{attrs:{id:"page-frontmatter-title"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#page-frontmatter-title"}},[s._v("#")]),s._v(" "+s._s(s.$page.frontmatter.title))]),s._v(" "),a("h2",{attrs:{id:"始めに"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#始めに"}},[s._v("#")]),s._v(" 始めに")]),s._v(" "),a("ul",[a("li",[s._v("Java の基本")]),s._v(" "),a("li",[s._v("Spring Boot の基本")]),s._v(" "),a("li",[s._v("Spring Boot ハンズオン")])]),s._v(" "),a("p",[s._v("本講義では上記について紹介し、Java というプログラミング言語とその Web フレームワークである Spring Boot といった技術的な選択肢を増やすことを目的としています。")]),s._v(" "),a("h3",{attrs:{id:"本講義の前提"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#本講義の前提"}},[s._v("#")]),s._v(" 本講義の前提")]),s._v(" "),a("p",[s._v("本講義ではプログラム言語共通の制御構文や概念、たとえば if 文や型など、の解説は行いません。そのため、受講者は何らかのプログラミング言語で簡単な制御構文が書けることを前提とさせてください。")]),s._v(" "),a("p",[s._v("また、ファイルの編集については VSCode を使って編集することを前提として進めていきます。もちろん、vim などのお好きなエディタを使って頂いても問題ありませんが、その場合は適宜資料を読み替えて対応をお願いします。")]),s._v(" "),a("h3",{attrs:{id:"この資料のお約束"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#この資料のお約束"}},[s._v("#")]),s._v(" この資料のお約束")]),s._v(" "),a("p",[s._v("💻 は自分で操作する箇所を示しています。 また"),a("code",[s._v("$")]),s._v("はホストマシンのプロンプトを意味し、"),a("code",[s._v("❯")]),s._v("はコンテナ内部でのプロンプトを意味します。")]),s._v(" "),a("p",[s._v("たとえば下記の通りです。")]),s._v(" "),a("div",{staticClass:"language-shell line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-shell"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# ホストマシン上で git clone git@github.com:iij/bootcamp.git を実行する")]),s._v("\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("git")]),s._v(" clone git@github.com:iij/bootcamp.git\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# コンテナ上で curl localhost:8080 を実行する")]),s._v("\n❯ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" localhost:8080\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br")])]),a("h3",{attrs:{id:"下準備"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#下準備"}},[s._v("#")]),s._v(" 下準備")]),s._v(" "),a("p",[s._v("講義を受講する前にコンテナイメージの pull と起動をしておくことをお勧めしています。\nまた、Docker の実行環境があることを前提として本講義を進めます。")]),s._v(" "),a("h4",{attrs:{id:"手順"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#手順"}},[s._v("#")]),s._v(" 手順")]),s._v(" "),a("ol",[a("li",[a("p",[s._v("ハンズオン用の Docker イメージを pull してくる")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# やや重たいので注意してください")]),s._v("\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" pull tamago0224/bootcamp-springboot:2024\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])])]),s._v(" "),a("li",[a("p",[s._v("ハンズオン用の作業ディレクトを作成する")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 適当な場所に作業用ディレクトリを作成し、その中に work ディレクトリを作成してください。")]),s._v("\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mkdir")]),s._v(" bootcamp-java-2024 "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# このディレクトリ名は何でも良い")]),s._v("\n$ "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("cd")]),s._v(" bootcamp-java-2024\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("mkdir")]),s._v(" work\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br")])])]),s._v(" "),a("li",[a("p",[s._v("ハンズオン用の docker-compose.yml を用意する")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[s._v("$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" -o docker-compose.yml https://raw.githubusercontent.com/iij/bootcamp/master/src/server-app/java/server-app/docker-compose.yml\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("div",{staticClass:"language-yaml line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-yaml"}},[a("code",[a("span",{pre:!0,attrs:{class:"token key atrule"}},[s._v("services")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token key atrule"}},[s._v("java")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token key atrule"}},[s._v("image")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v(" tamago0224/bootcamp"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("-")]),s._v("springboot"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("2024")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token key atrule"}},[s._v("volumes")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("-")]),s._v(" ./work"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("/work\n "),a("span",{pre:!0,attrs:{class:"token key atrule"}},[s._v("working_dir")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v(" /work\n "),a("span",{pre:!0,attrs:{class:"token key atrule"}},[s._v("tty")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token boolean important"}},[s._v("true")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br")])])]),s._v(" "),a("li",[a("p",[s._v("コンテナを起動する")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# コンテナを起動する")]),s._v("\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" compose up -d\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# コンテナに入る")]),s._v("\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" compose "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("exec")]),s._v(" java /bin/bash\n"),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("pwd")]),s._v("\n/work\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br")])])]),s._v(" "),a("li",[a("p",[s._v("必要なプロジェクトファイルの用意。別画面のターミナルで以下のコマンドを実行")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[s._v("$ "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("cd")]),s._v(" bootcamp-java-2024\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("exec")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("cp")]),s._v(" java:/app/. ./work\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("ls")]),s._v(" ./work "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 以下のファイル群が確認できる")]),s._v("\nbuild build.gradle gradle gradlew settings.gradle src\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br")])])]),s._v(" "),a("li",[a("p",[s._v("アプリケーションの起動チェック")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootを起動する")]),s._v("\n❯ ./gradlew bootrun\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# ...")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# いろんなログが流れる")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br")])])]),s._v(" "),a("li",[a("p",[s._v("動作チェック")])])]),s._v(" "),a("p",[s._v("ホストマシンの適当なブラウザから"),a("a",{attrs:{href:"http://localhost:8080",target:"_blank",rel:"noopener noreferrer"}},[s._v("localhost:8080"),a("OutboundLink")],1),s._v("にアクセスし、下記のようなエラーページが表示されることを確認してください。")]),s._v(" "),a("p",[a("img",{attrs:{src:t(469),alt:"初回起動 - WhitelabelErrorPage"}})]),s._v(" "),a("h2",{attrs:{id:"java-の基本"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#java-の基本"}},[s._v("#")]),s._v(" Java の基本")]),s._v(" "),a("p",[s._v("Java は OpenJDK コミュニティによって開発され、各ベンダからリリースされているプログラミング言語です。\n古くから利用されているプログラミング言語/プラットフォームである一方、2022 年現在でも SI や大規模開発の現場などでよく利用されています。")]),s._v(" "),a("h3",{attrs:{id:"言語としての特徴"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#言語としての特徴"}},[s._v("#")]),s._v(" 言語としての特徴")]),s._v(" "),a("p",[s._v("Java は C 言語や Rust と同じ静的型付き言語です。そのため文法や記法は C 言語を踏襲した書き方となっています。"),a("br"),s._v("\nJava の言語のパラダイムとしては、クラスの継承の概念やインタフェースなどの言語仕様を持つためオブジェクト指向プログラミングであります。その一方、Java のバージョン 8 以降は関数型インタフェースやパターンマッチなど、関数型プログラミングを楽しめるような仕様も導入されています。")]),s._v(" "),a("details",{staticClass:"custom-block details"},[a("summary",[s._v("Java のサンプルコード")]),s._v(" "),a("div",{staticClass:"language-java line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-java"}},[a("code",[a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// パッケージ名(世界でユニークであると良い)")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 自社ドメインを持つ企業での製造物には自社ドメインをそのまま利用することが多い")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("List")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 外部モジュールの利用(JavaではIDEに任せてしまうのが一般的)")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("/**\n * 複数行に渡るコメント文\n *\n * - 一般的にはJavaのクラス名の命名はパスカルケース - クラス名とjavaファイルの名前は一致させる方が良い(1クラス1ファイル)\n */")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SampleClass")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("extends")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Object")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// アクセス修飾子はprivate/protected/public")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" iamPrivate"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// Javaの変数・メソッドの命名は(ローワー)キャメルケース")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("protected")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" iamProtected"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" iamPublic"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// アノテーション。そのものに効果があるものではなく、横断的に処理したりする際の目印として使うことが多い")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@SuppressWarnings")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"unused"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("sampleMethod")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" a"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" b "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("null")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("equals")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("a"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n b "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"world"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" b"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("toString")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 残念ながらJavaはnull安全な言語ではない(NullPointerExceptionの危機)")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("MyInnerClass")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// クラスの中にクラスを定義することもできる(インナークラス)")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("final")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" finalizedString"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// final化(不変化)ができる")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("MyInnerClass")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" arg"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// コンストラクタはクラス名を同一にすることで表現")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("finalizedString "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" arg"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("getFinalizedString")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("finalizedString"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("makeInstance")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v('// クラスの具体的な値(オブジェクト)のことを"インスタンス"と言います')]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("var")]),s._v(" ins "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("MyInnerClass")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// Java11から型推論が使える")]),s._v("\n ins"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("getFinalizedString")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// → hello")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br"),a("span",{staticClass:"line-number"},[s._v("18")]),a("br"),a("span",{staticClass:"line-number"},[s._v("19")]),a("br"),a("span",{staticClass:"line-number"},[s._v("20")]),a("br"),a("span",{staticClass:"line-number"},[s._v("21")]),a("br"),a("span",{staticClass:"line-number"},[s._v("22")]),a("br"),a("span",{staticClass:"line-number"},[s._v("23")]),a("br"),a("span",{staticClass:"line-number"},[s._v("24")]),a("br"),a("span",{staticClass:"line-number"},[s._v("25")]),a("br"),a("span",{staticClass:"line-number"},[s._v("26")]),a("br"),a("span",{staticClass:"line-number"},[s._v("27")]),a("br"),a("span",{staticClass:"line-number"},[s._v("28")]),a("br"),a("span",{staticClass:"line-number"},[s._v("29")]),a("br"),a("span",{staticClass:"line-number"},[s._v("30")]),a("br"),a("span",{staticClass:"line-number"},[s._v("31")]),a("br"),a("span",{staticClass:"line-number"},[s._v("32")]),a("br"),a("span",{staticClass:"line-number"},[s._v("33")]),a("br"),a("span",{staticClass:"line-number"},[s._v("34")]),a("br"),a("span",{staticClass:"line-number"},[s._v("35")]),a("br"),a("span",{staticClass:"line-number"},[s._v("36")]),a("br"),a("span",{staticClass:"line-number"},[s._v("37")]),a("br"),a("span",{staticClass:"line-number"},[s._v("38")]),a("br"),a("span",{staticClass:"line-number"},[s._v("39")]),a("br"),a("span",{staticClass:"line-number"},[s._v("40")]),a("br"),a("span",{staticClass:"line-number"},[s._v("41")]),a("br"),a("span",{staticClass:"line-number"},[s._v("42")]),a("br"),a("span",{staticClass:"line-number"},[s._v("43")]),a("br"),a("span",{staticClass:"line-number"},[s._v("44")]),a("br"),a("span",{staticClass:"line-number"},[s._v("45")]),a("br"),a("span",{staticClass:"line-number"},[s._v("46")]),a("br"),a("span",{staticClass:"line-number"},[s._v("47")]),a("br"),a("span",{staticClass:"line-number"},[s._v("48")]),a("br")])])]),s._v(" "),a("h3",{attrs:{id:"プロジェクト構成"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#プロジェクト構成"}},[s._v("#")]),s._v(" プロジェクト構成")]),s._v(" "),a("p",[s._v('Java のプロジェクトのディレクトリ構成は、ほかのプログラミング言語と異なり言語として定められています。名前空間として定義できる"パッケージ"がそのままディレクトリに反映されるようにディレクトリを構成する必要があります。')]),s._v(" "),a("p",[s._v("参考: "),a("a",{attrs:{href:"https://docs.oracle.com/javase/tutorial/java/package/managingfiles.html",target:"_blank",rel:"noopener noreferrer"}},[s._v("https://docs.oracle.com/javase/tutorial/java/package/managingfiles.html"),a("OutboundLink")],1)]),s._v(" "),a("p",[s._v("たとえば"),a("code",[s._v("com.github.iij.bootcamp")]),s._v("パッケージ(=名前空間)配下に"),a("code",[s._v("Hoge")]),s._v("と"),a("code",[s._v("Huga")]),s._v("というクラスを作成する場合、下記のようなディレクトリ構造/ファイル構造になります。")]),s._v(" "),a("div",{staticClass:"language- line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[s._v(".\n├── build.gradle\n└── src\n └── main\n └── java\n └── com\n └── github\n └── iij\n └── bootcamp\n └── Hoge.java\n │ └── class Hoge { ... }\n └── Huga.java\n └── class Huga { ... }\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br")])]),a("div",{staticClass:"custom-block tip"},[a("p",{staticClass:"custom-block-title"},[s._v("パッケージ")]),s._v(" "),a("p",[s._v("Java におけるパッケージとは、DNS 形式で定義できる名前空間のような概念です。"),a("code",[s._v(".")]),s._v("で区切ることでパッケージ間の親子関係を定義できます。たとえば"),a("code",[s._v("com.example.iij")]),s._v("パッケージと"),a("code",[s._v("com.example.iij.bootcamp")]),s._v("パッケージでは前者が親で後者が子といった関係があります。")])]),s._v(" "),a("h3",{attrs:{id:"gradle"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#gradle"}},[s._v("#")]),s._v(" Gradle")]),s._v(" "),a("p",[s._v("Python であれば pip、Rust であれば cargo、Node.js であれば npm のようにプログラミング言語にはそれぞれ依存関係を解決しビルドを自動化する自動化システムツールが用意されています。")]),s._v(" "),a("p",[s._v("Java では Maven と Gradle という 2 つの種類の自動化システムツールがよく利用されています。本講義では Gradle を利用して話を進めていきます。")]),s._v(" "),a("h2",{attrs:{id:"spring-boot-の基本"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#spring-boot-の基本"}},[s._v("#")]),s._v(" Spring Boot の基本")]),s._v(" "),a("p",[s._v("Spring Boot は Java の Web フレームワークのひとつです。Spring Boot の規約に従ってアプリケーションロジックを実装することで簡単に Web アプリケーションを構築できます。")]),s._v(" "),a("p",[s._v("このフレームワークは大規模な主幹システムや Web アプリケーションを実装/構築する際によく利用されており、IIJ がホストしているいくつかのサービスも Spring Boot を利用して実装されています。")]),s._v(" "),a("h3",{attrs:{id:"特徴"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#特徴"}},[s._v("#")]),s._v(" 特徴")]),s._v(" "),a("p",[s._v("Spring Boot は複雑な業務要件や非機能要件をクリアするためのさまざまな機能を有しています。依存関係を宣言して注入してくれる DI コンテナや横断的な関心事を解決する AOP のサポート、数多く公開されている starter パッケージなどはその最たる例です。")]),s._v(" "),a("p",[s._v("残念ながらこの Bootcamp ですべての要素に触れることはできないため、興味のあるほうはドキュメントを読んでみることをお勧めします。")]),s._v(" "),a("h2",{attrs:{id:"spring-boot-ハンズオン"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#spring-boot-ハンズオン"}},[s._v("#")]),s._v(" Spring Boot ハンズオン")]),s._v(" "),a("p",[s._v("本ハンズオンではブラウザで閲覧できる Web UI の機能を持たない、HTTP API(Application Programming Interface)だけを持つ API サーバを構築していきます。")]),s._v(" "),a("p",[s._v("それでは始めましょう。")]),s._v(" "),a("h3",{attrs:{id:"簡単なクラスを作ってみる"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#簡単なクラスを作ってみる"}},[s._v("#")]),s._v(" 簡単なクラスを作ってみる")]),s._v(" "),a("p",[s._v("まず始めに、Java 言語のウォーミングアップとして純粋な Java のクラスを作ってみましょう。")]),s._v(" "),a("p",[s._v("💻 "),a("code",[s._v("User")]),s._v("クラスを作成します。")]),s._v(" "),a("p",[s._v("下記の通りに修正してみましょう。")]),s._v(" "),a("div",{staticClass:"language-java line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-java"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// src/main/java/com/github/iij/bootcamp/serverapp/User.java")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" name"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" name"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" name"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("id "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("getName")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("getId")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("setName")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" name"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" name"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("setId")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("id "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("toString")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name: "')]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('","')]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"id: "')]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br"),a("span",{staticClass:"line-number"},[s._v("18")]),a("br"),a("span",{staticClass:"line-number"},[s._v("19")]),a("br"),a("span",{staticClass:"line-number"},[s._v("20")]),a("br"),a("span",{staticClass:"line-number"},[s._v("21")]),a("br"),a("span",{staticClass:"line-number"},[s._v("22")]),a("br"),a("span",{staticClass:"line-number"},[s._v("23")]),a("br"),a("span",{staticClass:"line-number"},[s._v("24")]),a("br"),a("span",{staticClass:"line-number"},[s._v("25")]),a("br"),a("span",{staticClass:"line-number"},[s._v("26")]),a("br"),a("span",{staticClass:"line-number"},[s._v("27")]),a("br"),a("span",{staticClass:"line-number"},[s._v("28")]),a("br"),a("span",{staticClass:"line-number"},[s._v("29")]),a("br"),a("span",{staticClass:"line-number"},[s._v("30")]),a("br"),a("span",{staticClass:"line-number"},[s._v("31")]),a("br"),a("span",{staticClass:"line-number"},[s._v("32")]),a("br"),a("span",{staticClass:"line-number"},[s._v("33")]),a("br")])]),a("p",[s._v("これで"),a("code",[s._v("User")]),s._v("クラスを作成できました。次にこのクラスを実際にインスタンス化してみます。"),a("br"),s._v("\nSpring Boot アプリケーションの main 関数は"),a("code",[s._v("com.github.iij.bootcamp.serverapp.ServerAppApplication")]),s._v("にあります。ためしにこの main 関数の中で"),a("code",[s._v("User")]),s._v("クラスをインスタンス化してみます。")]),s._v(" "),a("p",[s._v("💻 ServerAppApplication.java を修正してください。")]),s._v(" "),a("div",{staticClass:"language-java line-numbers-mode"},[a("div",{staticClass:"highlight-lines"},[a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("br"),a("br"),a("br"),a("br"),a("br")]),a("pre",{pre:!0,attrs:{class:"language-java"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// src/main/java/com/github/iij/bootcamp/serverapp/ServerAppApplication.java")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("boot"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringApplication")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("boot"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("autoconfigure"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringBootApplication")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@SpringBootApplication")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ServerAppApplication")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n\t"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("static")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("main")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v(" args"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\t\t"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n\t\t"),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" user "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"アリス"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"alice"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\t\t"),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("System")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("out"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("println")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("user"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("toString")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\t\t"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n\t\t"),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringApplication")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("run")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ServerAppApplication")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" args"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\t"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br")])]),a("p",[s._v("編集が完了したら以下のコマンドをコンテナから実行してサーバを起動しましょう。")]),s._v(" "),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[s._v("❯ ./gradlew bootRun\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v('再起動時にログに"name: アリス,id: alice"と表示されていれば OK です。')]),s._v(" "),a("h4",{attrs:{id:"チェックポイント-その-1"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#チェックポイント-その-1"}},[s._v("#")]),s._v(" チェックポイント その 1")]),s._v(" "),a("ul",[a("li",[s._v("Java のクラスを作成した")]),s._v(" "),a("li",[s._v("クラスをインスタンス化し、標準出力に文字列を表示した")])]),s._v(" "),a("h4",{attrs:{id:"解説"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#解説"}},[s._v("#")]),s._v(" 解説")]),s._v(" "),a("p",[s._v("純粋な Java のクラスを作成し、インスタンス化とメソッドの呼び出しを行いました。"),a("code",[s._v("User")]),s._v("クラスを眺めてもらうとわかるとおり、"),a("code",[s._v("getName")]),s._v("や"),a("code",[s._v("getId")]),s._v("など Java にはかなり冗長なコードが多いです。これらのコードはよく「ボイラープレート」と呼ばれ、開発者が嫌うコードです。")]),s._v(" "),a("p",[s._v("Java には Lombok などのボイラープレートを解消するツールなどありますが、本講義はあえて紹介しません。興味がある人は調べてみてください。")]),s._v(" "),a("h3",{attrs:{id:"簡単な-http-のインタフェースを作成してみる"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#簡単な-http-のインタフェースを作成してみる"}},[s._v("#")]),s._v(" 簡単な HTTP のインタフェースを作成してみる")]),s._v(" "),a("p",[s._v("それでは Spring Boot を使ってみましょう。"),a("br"),s._v("\n簡単な HTTP のインタフェースを作成し、実際に Spring Boot がどのように動作しているのかを見てみます。")]),s._v(" "),a("p",[s._v("💻 ServerAppApplication.java を修正し、サーバを再起動してみてください。")]),s._v(" "),a("div",{staticClass:"language-java line-numbers-mode"},[a("div",{staticClass:"highlight-lines"},[a("br"),a("br"),a("br"),a("br"),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("br"),a("br"),a("br")]),a("pre",{pre:!0,attrs:{class:"language-java"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// src/main/java/com/github/iij/bootcamp/serverapp/ServerAppApplication.java")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("boot"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringApplication")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("boot"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("autoconfigure"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringBootApplication")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("GetMapping")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RestController")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@SpringBootApplication")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ServerAppApplication")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("static")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("main")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v(" args"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" user "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"アリス"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"alice"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("System")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("out"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("println")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("user"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("toString")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("SpringApplication")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("run")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ServerAppApplication")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" args"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RestController")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("HelloController")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@GetMapping")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("path "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("helloWorld")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello world"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br"),a("span",{staticClass:"line-number"},[s._v("18")]),a("br"),a("span",{staticClass:"line-number"},[s._v("19")]),a("br"),a("span",{staticClass:"line-number"},[s._v("20")]),a("br"),a("span",{staticClass:"line-number"},[s._v("21")]),a("br"),a("span",{staticClass:"line-number"},[s._v("22")]),a("br"),a("span",{staticClass:"line-number"},[s._v("23")]),a("br"),a("span",{staticClass:"line-number"},[s._v("24")]),a("br"),a("span",{staticClass:"line-number"},[s._v("25")]),a("br"),a("span",{staticClass:"line-number"},[s._v("26")]),a("br"),a("span",{staticClass:"line-number"},[s._v("27")]),a("br"),a("span",{staticClass:"line-number"},[s._v("28")]),a("br"),a("span",{staticClass:"line-number"},[s._v("29")]),a("br")])]),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootサーバーを再起動する")]),s._v("\n❯ ./gradlew bootRun\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("div",{staticClass:"language- line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-text"}},[a("code",[s._v("# 動作確認\n$ curl localhost:8080 -X GET\nhello world\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("p",[s._v('"hello world"が返ってきたら成功です。')]),s._v(" "),a("h4",{attrs:{id:"チェックポイント-その-2"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#チェックポイント-その-2"}},[s._v("#")]),s._v(" チェックポイント その 2")]),s._v(" "),a("ul",[a("li",[a("code",[s._v("@RestController")]),s._v("アノテーションをクラスに付与して HTTP のインタフェースを作成した")])]),s._v(" "),a("h4",{attrs:{id:"解説-2"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#解説-2"}},[s._v("#")]),s._v(" 解説")]),s._v(" "),a("p",[a("code",[s._v("bootRun")]),s._v("コマンドにより Spring Boot が起動します。すると、Spring Boot の機能により "),a("code",[s._v("@RestController")]),s._v("アノテーションが付いている"),a("code",[s._v("ServerAppApplication.HelloController")]),s._v("が HTTP のインタフェースとして登録されます。")]),s._v(" "),a("p",[a("img",{attrs:{src:t(470),alt:"handler"}})]),s._v(" "),a("p",[s._v("その結果、この Spring Boot が動いている 8080 番ポート宛の HTTP リクエストと"),a("code",[s._v("ServerAppApplication.HelloController#helloWorld")]),s._v("が紐づけられることになり、"),a("code",[s._v("GET /")]),s._v('へのリクエストのレスポンスとして"hello world"が返ってきました。')]),s._v(" "),a("details",{staticClass:"custom-block details"},[a("summary",[s._v("Spring Boot と DI コンテナ")]),s._v(" "),a("p",[s._v("Spring Boot は起動時に起動クラスのパッケージ配下の Java ファイルから特殊なアノテーション("),a("code",[s._v("@Contoroller")]),s._v(" / "),a("code",[s._v("@Component")]),s._v(" / etc...)がついたクラスを探し出します。そして Spring Boot はそのクラスを適当な方法でインスタンス化し、自身の管理下(=DI コンテナ)に置きます。")]),s._v(" "),a("p",[s._v("(「適当な方法」を指定することもできます > "),a("a",{attrs:{href:"https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/context/annotation/Bean.html",target:"_blank",rel:"noopener noreferrer"}},[s._v("Bean Annotation"),a("OutboundLink")],1),s._v(")")]),s._v(" "),a("p",[s._v("DI コンテナに格納されたインスタンスは、後述する"),a("code",[s._v("@Autowired")]),s._v("アノテーションを使って引き出すことができます。")]),s._v(" "),a("p",[s._v("特に、"),a("code",[s._v("@Controller")]),s._v(" "),a("code",[s._v("@RestController")]),s._v("アノテーションが付与されたクラスから生成されたインスタンスは HTTP のインタフェースとして働くことになります。")]),s._v(" "),a("p",[s._v("今回の例では、 "),a("code",[s._v("ServerAppApplication")]),s._v("クラスに"),a("code",[s._v("@SpringBootApplication")]),s._v("アノテーションが付与されているので"),a("code",[s._v("ServerAppApplication")]),s._v("クラスのパッケージ"),a("code",[s._v("com.github.iij.bootcamp.serverapp")]),s._v("配下のクラスから上述の特殊なアノテーションがついているクラスを探索します。")]),s._v(" "),a("p",[a("code",[s._v("HelloController")]),s._v("クラスは"),a("code",[s._v("@RestController")]),s._v("アノテーションが付与されているため、Spring Boot 起動時に"),a("code",[s._v("HelloController")]),s._v("が Spring Boot によってインスタンス化され DI コンテナに登録されました。\nその結果、"),a("code",[s._v("GET /")]),s._v("のリクエストを Spring Boot が受け取ると"),a("code",[s._v("HelloController#helloWorld")]),s._v(" が実行されるようになっていたというわけです。")])]),s._v(" "),a("h3",{attrs:{id:"簡単なリクエストを受け取ってみる"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#簡単なリクエストを受け取ってみる"}},[s._v("#")]),s._v(" 簡単なリクエストを受け取ってみる")]),s._v(" "),a("p",[s._v("次にクエリパラメータから情報を取得してみましょう。")]),s._v(" "),a("p",[s._v("💻 UserController.java を作成し、サーバを再起動してみてください。")]),s._v(" "),a("div",{staticClass:"language-java line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-java"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// src/main/java/com/github/iij/bootcamp/serverapp/UserController.java")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("GetMapping")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RequestParam")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RestController")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RestController")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserController")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" secretUser "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"ボブ"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@GetMapping")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("path "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/user"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("find")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RequestParam")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("equals")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("secretUser"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("else")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("null")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br"),a("span",{staticClass:"line-number"},[s._v("18")]),a("br"),a("span",{staticClass:"line-number"},[s._v("19")]),a("br"),a("span",{staticClass:"line-number"},[s._v("20")]),a("br"),a("span",{staticClass:"line-number"},[s._v("21")]),a("br")])]),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootサーバーを再起動する")]),s._v("\n❯ ./gradlew bootRun\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 動作確認")]),s._v("\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'localhost:8080/user?id=bob'")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"ボブ"')]),s._v(","),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"id"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("h4",{attrs:{id:"チェックポイント-その-3"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#チェックポイント-その-3"}},[s._v("#")]),s._v(" チェックポイント その 3")]),s._v(" "),a("ul",[a("li",[a("code",[s._v("@GetMapping")]),s._v("アノテーションを持つメソッドを作成し、HTTP のハンドラとして登録した")]),s._v(" "),a("li",[s._v("HTTP のハンドラとして登録されたメソッドの引数に"),a("code",[s._v("@RequestParam")]),s._v("アノテーションを付与することでクエリパラメータを実装した")])]),s._v(" "),a("h4",{attrs:{id:"解説-3"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#解説-3"}},[s._v("#")]),s._v(" 解説")]),s._v(" "),a("p",[s._v("新しいクラス"),a("code",[s._v("UserController")]),s._v("を作成しました。このクラスにも"),a("code",[s._v("@RestController")]),s._v("アノテーションが付いているため HTTP のインタフェースとして振る舞います。")]),s._v(" "),a("p",[a("code",[s._v("UserController")]),s._v("クラスの持つメソッド"),a("code",[s._v("find")]),s._v("には"),a("code",[s._v("@GetMapping")]),s._v("アノテーションがついているため、"),a("code",[s._v("GET /user")]),s._v("宛のリクエストのハンドラとして登録されることになります。そのため、Spring Boot アプリケーションの"),a("code",[s._v("/user")]),s._v("へ GET リクエストを送ることでこの"),a("code",[s._v("find")]),s._v("メソッドがコールされます。")]),s._v(" "),a("p",[s._v("さらに"),a("code",[s._v("find")]),s._v("メソッドの引数"),a("code",[s._v("id")]),s._v("に"),a("code",[s._v("@RequestParam")]),s._v("アノテーションが付与されています。これにより、HTTP リクエストのクエリパラメータの値がこの変数に注入されます。つまり"),a("code",[s._v("GET /user?id=bob")]),s._v("へのリクエストを Spring Boot アプリケーションへ送ることで"),a("code",[s._v("find")]),s._v("メソッドがコールされ引数"),a("code",[s._v("id=bob")]),s._v("が引き渡されます。")]),s._v(" "),a("h3",{attrs:{id:"責任を分離する"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#責任を分離する"}},[s._v("#")]),s._v(" 責任を分離する")]),s._v(" "),a("p",[s._v("さて、前章まで基本的な HTTP のインタフェースの作り方と使い方について解説してきました。もう少し実装を深めていきましょう。"),a("br"),s._v("\n現在"),a("code",[s._v("UserController")]),s._v("クラスは HTTP のインタフェースとデータソースの管理の 2 つの責務を持っています。これは単一責務の原理から外れているためリファクタリングする対象です。")]),s._v(" "),a("p",[s._v("今回はシンプルに"),a("code",[s._v("UserController#find")]),s._v("の処理を抽出して別のクラスに分離、処理そのものを"),a("code",[s._v("UserController")]),s._v("クラスの外から与えてあげるようにしましょう。")]),s._v(" "),a("p",[s._v("💻 UserService.java を作成、UserController.java を修正し、サーバを再起動してください。")]),s._v(" "),a("div",{staticClass:"language-java line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-java"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// src/main/java/com/github/iij/bootcamp/serverapp/UserService.java")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ArrayList")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Arrays")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("List")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("stereotype"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Component")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@Component")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserService")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// データソースに該当する部分")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("List")]),a("span",{pre:!0,attrs:{class:"token generics"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v(" userPool "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ArrayList")]),a("span",{pre:!0,attrs:{class:"token generics"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Arrays")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("asList")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"ボブ"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("/**\n * ユーザープールからid値で検索し、その結果を返却します idと一致するユーザーが見つからない場合nullを返却します\n * TODO 本当にこの実装で問題ないか、考えてみましょう\n * - 同一のidをもつインスタンスがいる場合は？データ構造はこれで良いか？\n * - nullは`User`インスタンスではない、では見つからない場合は何を返すべき？\n */")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("findById")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// Java8から導入されたStreamAPI")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" user "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userPool\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("stream")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// Streamを作成")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("filter")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("u "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("->")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("equals")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("u"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("getId")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// idと一致する`User`インスタンスのみを抽出")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("findFirst")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 抽出結果の先頭1つだけを取り出す")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("orElse")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("null")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// もし抽出した結果何も残らなかった場合、nullを返却する")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" user"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br"),a("span",{staticClass:"line-number"},[s._v("18")]),a("br"),a("span",{staticClass:"line-number"},[s._v("19")]),a("br"),a("span",{staticClass:"line-number"},[s._v("20")]),a("br"),a("span",{staticClass:"line-number"},[s._v("21")]),a("br"),a("span",{staticClass:"line-number"},[s._v("22")]),a("br"),a("span",{staticClass:"line-number"},[s._v("23")]),a("br"),a("span",{staticClass:"line-number"},[s._v("24")]),a("br"),a("span",{staticClass:"line-number"},[s._v("25")]),a("br"),a("span",{staticClass:"line-number"},[s._v("26")]),a("br"),a("span",{staticClass:"line-number"},[s._v("27")]),a("br"),a("span",{staticClass:"line-number"},[s._v("28")]),a("br"),a("span",{staticClass:"line-number"},[s._v("29")]),a("br"),a("span",{staticClass:"line-number"},[s._v("30")]),a("br"),a("span",{staticClass:"line-number"},[s._v("31")]),a("br"),a("span",{staticClass:"line-number"},[s._v("32")]),a("br")])]),a("div",{staticClass:"language-java line-numbers-mode"},[a("div",{staticClass:"highlight-lines"},[a("br"),a("br"),a("br"),a("br"),a("br"),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("br"),a("br"),a("br"),a("br"),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("br"),a("br"),a("br")]),a("pre",{pre:!0,attrs:{class:"language-java"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// src/main/java/com/github/iij/bootcamp/serverapp/UserController.java")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("GetMapping")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RestController")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RequestParam")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("beans"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("factory"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Autowired")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RestController")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserController")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 修正BEGIN")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@Autowired")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserService")]),s._v(" userService"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@GetMapping")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("path "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/user"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("find")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RequestParam")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userService"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("findById")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 修正END")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br"),a("span",{staticClass:"line-number"},[s._v("18")]),a("br"),a("span",{staticClass:"line-number"},[s._v("19")]),a("br"),a("span",{staticClass:"line-number"},[s._v("20")]),a("br"),a("span",{staticClass:"line-number"},[s._v("21")]),a("br"),a("span",{staticClass:"line-number"},[s._v("22")]),a("br"),a("span",{staticClass:"line-number"},[s._v("23")]),a("br")])]),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootサーバーを再起動する")]),s._v("\n❯ ./gradlew bootRun\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 動作確認")]),s._v("\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'localhost:8080/user?id=bob'")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"ボブ"')]),s._v(","),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"id"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br")])]),a("h4",{attrs:{id:"チェックポイント-その-4"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#チェックポイント-その-4"}},[s._v("#")]),s._v(" チェックポイント その 4")]),s._v(" "),a("ul",[a("li",[a("code",[s._v("@Component")]),s._v("アノテーションをクラスに付与し、Spring Boot 起動時に自動的にインスタンス化した")]),s._v(" "),a("li",[a("code",[s._v("@Autowired")]),s._v("アノテーションをフィールドに付与し、そのフィールドに Spring Boot がインスタンス化したインスタンスの中から適切なインスタンスを注入した")])]),s._v(" "),a("h4",{attrs:{id:"解説-4"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#解説-4"}},[s._v("#")]),s._v(" 解説")]),s._v(" "),a("p",[s._v("新しいクラス"),a("code",[s._v("UserService")]),s._v("を作成しました。このクラスには"),a("code",[s._v("@Component")]),s._v("アノテーションが付与されているため、Spring Boot 起動時に Spring Boot によって自動的にインスタンス化され Spring Boot の管理下に入ります。このように Spring Boot に管理されるようになったインスタンスはほかのクラスから"),a("code",[s._v("@Autowired")]),s._v("を利用することで利用されます。")]),s._v(" "),a("p",[s._v("今回の例では"),a("code",[s._v("UserController")]),s._v("クラスが"),a("code",[s._v("userService")]),s._v("フィールドに"),a("code",[s._v("@Autowired")]),s._v("アノテーションを付与しているため自動的に作成された"),a("code",[s._v("UserService")]),s._v("クラスのインスタンスが"),a("code",[s._v("UserController.userService")]),s._v("に代入されることになりました。このように依存関係を分離、外から依存関係を持ち込む構成のことを DI(Dependency Injection)と呼びます。")]),s._v(" "),a("p",[s._v('注意点として、デフォルトの挙動では Spring Boot が管理するインスタンスは各クラス"1 つ"となっています。つまり'),a("code",[s._v("UserController")]),s._v("クラスが引っ張ってきている"),a("code",[s._v("userService")]),s._v("とほかのクラスが引っ張ってこれる"),a("code",[s._v("UserService")]),s._v('インスタンスは完全に一致しています。このようにひとつのインスタンスを使い回す構成のことを"シングルトン"と呼びます。')]),s._v(" "),a("h3",{attrs:{id:"少し複雑なリクエストを受け取ってみる"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#少し複雑なリクエストを受け取ってみる"}},[s._v("#")]),s._v(" 少し複雑なリクエストを受け取ってみる")]),s._v(" "),a("p",[s._v("最後に、POST リクエストとリクエストボディを指定して"),a("code",[s._v("User")]),s._v("インスタンスを登録してみましょう。"),a("br"),s._v(" "),a("code",[s._v("User")]),s._v("インスタンスには"),a("code",[s._v("id")]),s._v("と"),a("code",[s._v("name")]),s._v("の値を指定する必要があるので、これらを与えられるエンドポイントを用意します。")]),s._v(" "),a("p",[s._v("💻 UserService.java と UserController.java を修正し、サーバを再起動してください。")]),s._v(" "),a("div",{staticClass:"language-java line-numbers-mode"},[a("div",{staticClass:"highlight-lines"},[a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("br"),a("br"),a("br")]),a("pre",{pre:!0,attrs:{class:"language-java"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// src/main/java/com/github/iij/bootcamp/serverapp/UserService.java")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ArrayList")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Arrays")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("java"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("util"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("List")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("stereotype"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Component")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@Component")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserService")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// データソースに該当する部分")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("List")]),a("span",{pre:!0,attrs:{class:"token generics"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),s._v(" userPool "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ArrayList")]),a("span",{pre:!0,attrs:{class:"token generics"}},[a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("<")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(">")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Arrays")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("asList")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"ボブ"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"bob"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("/**\n * ユーザープールからid値で検索し、その結果を返却します idと一致するユーザーが見つからない場合nullを返却します\n */")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("findById")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" user "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userPool\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("stream")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("filter")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("u "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("->")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("equals")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("u"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("getId")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("findFirst")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("orElse")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("null")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" user"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("/**\n * ユーザープールにUserを追加します\n */")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("save")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" user"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userPool"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("add")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("user"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" user"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br"),a("span",{staticClass:"line-number"},[s._v("18")]),a("br"),a("span",{staticClass:"line-number"},[s._v("19")]),a("br"),a("span",{staticClass:"line-number"},[s._v("20")]),a("br"),a("span",{staticClass:"line-number"},[s._v("21")]),a("br"),a("span",{staticClass:"line-number"},[s._v("22")]),a("br"),a("span",{staticClass:"line-number"},[s._v("23")]),a("br"),a("span",{staticClass:"line-number"},[s._v("24")]),a("br"),a("span",{staticClass:"line-number"},[s._v("25")]),a("br"),a("span",{staticClass:"line-number"},[s._v("26")]),a("br"),a("span",{staticClass:"line-number"},[s._v("27")]),a("br"),a("span",{staticClass:"line-number"},[s._v("28")]),a("br"),a("span",{staticClass:"line-number"},[s._v("29")]),a("br"),a("span",{staticClass:"line-number"},[s._v("30")]),a("br"),a("span",{staticClass:"line-number"},[s._v("31")]),a("br"),a("span",{staticClass:"line-number"},[s._v("32")]),a("br"),a("span",{staticClass:"line-number"},[s._v("33")]),a("br"),a("span",{staticClass:"line-number"},[s._v("34")]),a("br"),a("span",{staticClass:"line-number"},[s._v("35")]),a("br"),a("span",{staticClass:"line-number"},[s._v("36")]),a("br"),a("span",{staticClass:"line-number"},[s._v("37")]),a("br")])]),a("div",{staticClass:"language-java line-numbers-mode"},[a("div",{staticClass:"highlight-lines"},[a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("br"),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("div",{staticClass:"highlighted"},[s._v(" ")]),a("br"),a("br"),a("br"),a("br")]),a("pre",{pre:!0,attrs:{class:"language-java"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// src/main/java/com/github/iij/bootcamp/serverapp/UserController.java")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("package")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("com"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("github"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("iij"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bootcamp"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("serverapp")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("beans"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("factory"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Autowired")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("GetMapping")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RestController")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RequestParam")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("PostMapping")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token import"}},[a("span",{pre:!0,attrs:{class:"token namespace"}},[s._v("org"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("springframework"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("web"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("bind"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("annotation"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")])]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("RequestBody")])]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RestController")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserController")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@Autowired")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserService")]),s._v(" userService"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@GetMapping")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("path "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/user"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("find")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RequestParam")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userService"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("findById")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記BEGIN")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// POST /user 宛のリクエストボディスキーマ")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("static")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserCreateRequest")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" name"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("private")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("getName")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" name"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("getId")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("setName")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" name"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" name"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("void")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("setId")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("String")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("id "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" id"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n "),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@PostMapping")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("path "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/user"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("public")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("create")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token annotation punctuation"}},[s._v("@RequestBody")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("UserCreateRequest")]),s._v(" request"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),s._v(" newUser "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("User")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("request"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("getName")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" request"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("getId")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("this")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("userService"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("save")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("newUser"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n "),a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// 追記END")]),s._v("\n\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br"),a("span",{staticClass:"line-number"},[s._v("7")]),a("br"),a("span",{staticClass:"line-number"},[s._v("8")]),a("br"),a("span",{staticClass:"line-number"},[s._v("9")]),a("br"),a("span",{staticClass:"line-number"},[s._v("10")]),a("br"),a("span",{staticClass:"line-number"},[s._v("11")]),a("br"),a("span",{staticClass:"line-number"},[s._v("12")]),a("br"),a("span",{staticClass:"line-number"},[s._v("13")]),a("br"),a("span",{staticClass:"line-number"},[s._v("14")]),a("br"),a("span",{staticClass:"line-number"},[s._v("15")]),a("br"),a("span",{staticClass:"line-number"},[s._v("16")]),a("br"),a("span",{staticClass:"line-number"},[s._v("17")]),a("br"),a("span",{staticClass:"line-number"},[s._v("18")]),a("br"),a("span",{staticClass:"line-number"},[s._v("19")]),a("br"),a("span",{staticClass:"line-number"},[s._v("20")]),a("br"),a("span",{staticClass:"line-number"},[s._v("21")]),a("br"),a("span",{staticClass:"line-number"},[s._v("22")]),a("br"),a("span",{staticClass:"line-number"},[s._v("23")]),a("br"),a("span",{staticClass:"line-number"},[s._v("24")]),a("br"),a("span",{staticClass:"line-number"},[s._v("25")]),a("br"),a("span",{staticClass:"line-number"},[s._v("26")]),a("br"),a("span",{staticClass:"line-number"},[s._v("27")]),a("br"),a("span",{staticClass:"line-number"},[s._v("28")]),a("br"),a("span",{staticClass:"line-number"},[s._v("29")]),a("br"),a("span",{staticClass:"line-number"},[s._v("30")]),a("br"),a("span",{staticClass:"line-number"},[s._v("31")]),a("br"),a("span",{staticClass:"line-number"},[s._v("32")]),a("br"),a("span",{staticClass:"line-number"},[s._v("33")]),a("br"),a("span",{staticClass:"line-number"},[s._v("34")]),a("br"),a("span",{staticClass:"line-number"},[s._v("35")]),a("br"),a("span",{staticClass:"line-number"},[s._v("36")]),a("br"),a("span",{staticClass:"line-number"},[s._v("37")]),a("br"),a("span",{staticClass:"line-number"},[s._v("38")]),a("br"),a("span",{staticClass:"line-number"},[s._v("39")]),a("br"),a("span",{staticClass:"line-number"},[s._v("40")]),a("br"),a("span",{staticClass:"line-number"},[s._v("41")]),a("br"),a("span",{staticClass:"line-number"},[s._v("42")]),a("br"),a("span",{staticClass:"line-number"},[s._v("43")]),a("br"),a("span",{staticClass:"line-number"},[s._v("44")]),a("br"),a("span",{staticClass:"line-number"},[s._v("45")]),a("br"),a("span",{staticClass:"line-number"},[s._v("46")]),a("br"),a("span",{staticClass:"line-number"},[s._v("47")]),a("br"),a("span",{staticClass:"line-number"},[s._v("48")]),a("br"),a("span",{staticClass:"line-number"},[s._v("49")]),a("br"),a("span",{staticClass:"line-number"},[s._v("50")]),a("br"),a("span",{staticClass:"line-number"},[s._v("51")]),a("br"),a("span",{staticClass:"line-number"},[s._v("52")]),a("br"),a("span",{staticClass:"line-number"},[s._v("53")]),a("br"),a("span",{staticClass:"line-number"},[s._v("54")]),a("br"),a("span",{staticClass:"line-number"},[s._v("55")]),a("br")])]),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# Spring Bootサーバーを再起動する")]),s._v("\n❯ ./gradlew bootRun\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("div",{staticClass:"language-bash line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-bash"}},[a("code",[a("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 動作確認")]),s._v("\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" localhost:8080/user -X POST -H "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Type: application/json'")]),s._v(" -d "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('\'{"name": "アリス", "id": "alice"}\'')]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"アリス"')]),s._v(", "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"id"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"alice"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n\n$ "),a("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'localhost:8080/user?id=alice'")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"アリス"')]),s._v(", "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"id"')]),a("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v('"alice"')]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br")])]),a("h4",{attrs:{id:"チェックポイント-その-5"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#チェックポイント-その-5"}},[s._v("#")]),s._v(" チェックポイント その 5")]),s._v(" "),a("ul",[a("li",[a("code",[s._v("@PostMapping")]),s._v("アノテーションをメソッドに付与し、POST リクエストの HTTP ハンドラとして登録した")]),s._v(" "),a("li",[s._v("Java の POJO を用いて POST リクエストのリクエストボディのスキーマを表現した")])]),s._v(" "),a("h2",{attrs:{id:"まとめ"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#まとめ"}},[s._v("#")]),s._v(" まとめ")]),s._v(" "),a("p",[s._v("以上で Spring Boot のハンズオンは終了です。")]),s._v(" "),a("p",[s._v("本講義では Java の基本的な知識や書き方、Spring Boot の使い方など、基本的な機能や文法に触れてもらいました。しかし Spring Boot には多様な機能がまだまだ存在しており、データベースとの接続や非同期処理などさまざまなプロダクション環境で活躍できるポテンシャルを持っているフレームワークです。")]),s._v(" "),a("p",[s._v("本講義が、受講者のみなさまの今後の技術選定の手助けになれれば幸いです。")]),s._v(" "),a("h3",{attrs:{id:"追加の資料"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#追加の資料"}},[s._v("#")]),s._v(" 追加の資料")]),s._v(" "),a("ul",[a("li",[a("a",{attrs:{href:"https://spring.pleiades.io/spring-boot/docs/current/reference/html",target:"_blank",rel:"noopener noreferrer"}},[s._v("Spring Boot リファレンスドキュメント"),a("OutboundLink")],1),s._v(" "),a("ul",[a("li",[s._v("多くの Spring Boot 開発者がお世話になる公式ドキュメントです。アプリケーションの開発からデプロイ方法まで、幅広く情報が提供されています。")])])]),s._v(" "),a("li",[a("a",{attrs:{href:"https://spring.pleiades.io/guides",target:"_blank",rel:"noopener noreferrer"}},[s._v("Spring Boot Guides"),a("OutboundLink")],1),s._v(" "),a("ul",[a("li",[s._v("Spring Boot の各種機能を試してみるチュートリアルが公開されています。Pub/Sub や MongoDB、Docker との連携など Spring Boot の拡張が多種公開されています。興味のある項目に触ってみてください。")])])])]),s._v(" "),a("credit-footer")],1)}),[],!1,null,null,null);a.default=e.exports}}]); \ No newline at end of file diff --git a/assets/js/29.d895ab7b.js b/assets/js/29.abc83417.js similarity index 99% rename from assets/js/29.d895ab7b.js rename to assets/js/29.abc83417.js index e78da236..88d4ecb0 100644 --- a/assets/js/29.d895ab7b.js +++ b/assets/js/29.abc83417.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[29],{237:function(s,e,a){s.exports=a.p+"assets/img/getting-started.a1278e29.png"},530:function(s,e,a){"use strict";a.r(e);var t=a(10),r=Object(t.a)({},(function(){var s=this,e=s._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[e("header-table"),s._v(" "),e("h2",{attrs:{id:"おさらい"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#おさらい"}},[s._v("#")]),s._v(" おさらい")]),s._v(" "),e("p",[s._v("それでは実際にDockerを使って仮想環境プラットフォームを作ってみましょう。\n事前準備の項を済ませているならばDocker環境は構築されているはずです。\n下記コマンドを入力し、コマンドが実行できるか確認してください。")]),s._v(" "),e("div",{staticClass:"language-bash line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-bash"}},[e("code",[s._v("$ "),e("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" version\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])]),e("p",[s._v("上記コマンドが実行できない方は事前にDocker（及びコマンド）のインストールが終わっているか否か確認し、未完了の人は、Docker のインストールを行ってください。")]),s._v(" "),e("h2",{attrs:{id:"docker-コンテナを起動する"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#docker-コンテナを起動する"}},[s._v("#")]),s._v(" Docker コンテナを起動する")]),s._v(" "),e("p",[s._v("Dockerコンテナを使って仮想環境プラットフォームを構築するには、大きく分けて以下のステップを踏む必要があります。")]),s._v(" "),e("ul",[e("li",[s._v("Dockerイメージのビルド")]),s._v(" "),e("li",[s._v("Dockerコンテナの作成")]),s._v(" "),e("li",[s._v("Dockerコンテナの起動")])]),s._v(" "),e("p",[s._v("従って、Dockerコンテナを起動する為に最初にすべきことは"),e("strong",[s._v("Dockerコンテナイメージ")]),s._v("を取得する事になります。")]),s._v(" "),e("p",[s._v("Dockerコンテナイメージは、自分で作成(ビルド)して取得する方法と、作成済みのDockerコンテナイメージを取得する方法の2種類があります。\nまずは、作成済みのイメージを利用してコンテナを起動することを試してみましょう。")]),s._v(" "),e("h3",{attrs:{id:"演習1-dockerコンテナを起動する"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#演習1-dockerコンテナを起動する"}},[s._v("#")]),s._v(" 演習1 Dockerコンテナを起動する")]),s._v(" "),e("ul",[e("li",[e("strong",[s._v("docker run")]),s._v("コマンドを使用して"),e("strong",[s._v("getting-started")]),s._v("コンテナを起動する"),e("div",{staticClass:"language-bash line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-bash"}},[e("code",[e("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" run --rm -p "),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("80")]),s._v(":80 docker/getting-started\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])])])]),s._v(" "),e("details",[e("summary",[s._v("実行中のログ")]),s._v(" "),e("div",{staticClass:"language- line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-text"}},[e("code",[s._v("Unable to find image 'docker/getting-started:latest' locally\nlatest: Pulling from docker/getting-started\nc158987b0551: Pull complete\n1e35f6679fab: Pull complete\ncb9626c74200: Pull complete\nb6334b6ace34: Pull complete\nf1d1c9928c82: Pull complete\n9b6f639ec6ea: Pull complete\nee68d3549ec8: Pull complete\n33e0cbbb4673: Pull complete\n4f7e34c2de10: Pull complete\nDigest: sha256:d79336f4812b6547a53e735480dde67f8f8f7071b414fbd9297609ffb989abc1\nStatus: Downloaded newer image for docker/getting-started:latest\n89e2c9780f5caf3b5250013e002e8aaf9f8ea74c2e940eca49b890dfc019ab5e\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br"),e("span",{staticClass:"line-number"},[s._v("2")]),e("br"),e("span",{staticClass:"line-number"},[s._v("3")]),e("br"),e("span",{staticClass:"line-number"},[s._v("4")]),e("br"),e("span",{staticClass:"line-number"},[s._v("5")]),e("br"),e("span",{staticClass:"line-number"},[s._v("6")]),e("br"),e("span",{staticClass:"line-number"},[s._v("7")]),e("br"),e("span",{staticClass:"line-number"},[s._v("8")]),e("br"),e("span",{staticClass:"line-number"},[s._v("9")]),e("br"),e("span",{staticClass:"line-number"},[s._v("10")]),e("br"),e("span",{staticClass:"line-number"},[s._v("11")]),e("br"),e("span",{staticClass:"line-number"},[s._v("12")]),e("br"),e("span",{staticClass:"line-number"},[s._v("13")]),e("br"),e("span",{staticClass:"line-number"},[s._v("14")]),e("br")])])]),s._v(" "),e("ul",[e("li",[s._v("起動の確認\n"),e("ul",[e("li",[s._v("ブラウザを開き、以下のURLを入力します"),e("div",{staticClass:"language- line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-text"}},[e("code",[s._v("http://localhost:80\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])])]),s._v(" "),e("li",[s._v("以下のような画面が表示されれば成功です\n"),e("img",{attrs:{src:a(237),alt:"getting-started"}})])])]),s._v(" "),e("li",[s._v("コンテナの終了\n"),e("strong",[s._v("Ctrl + c")]),s._v(" を押す")]),s._v(" "),e("li",[s._v("ターミナルが戻ってくる")])]),s._v(" "),e("h3",{attrs:{id:"発展課題1"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#発展課題1"}},[s._v("#")]),s._v(" 発展課題1")]),s._v(" "),e("p",[s._v("先ほどの作業ではフォアグラウンドで実行している為、ターミナルが占有されてしまいます。\nまた、このような起動では例えばssh等で接続している場合はセッション切断と共にコンテナが停止してしまう為、発展課題ではこれを永続化する事をやってみましょう。")]),s._v(" "),e("p",[s._v("デーモン起動をすると、ターミナルは返ってきてしまうため起動確認は "),e("code",[s._v("docker ps")]),s._v("を使って確認します。")]),s._v(" "),e("ul",[e("li",[s._v("コンテナのデーモン起動"),e("div",{staticClass:"language-bash line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-bash"}},[e("code",[e("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" run --rm -p "),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("80")]),s._v(":80 docker/getting-started\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])])]),s._v(" "),e("li",[s._v("コンテナの起動確認"),e("div",{staticClass:"language-bash line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-bash"}},[e("code",[s._v("CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n38ebcf110f45 docker/getting-started "),e("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/docker-entrypoint.…"')]),s._v(" "),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),s._v(" seconds ago Up "),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("2")]),s._v(" seconds "),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("0.0")]),s._v(".0.0:80-"),e("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("80")]),s._v("/tcp, :::80-"),e("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("80")]),s._v("/tcp fervent_shaw\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br"),e("span",{staticClass:"line-number"},[s._v("2")]),e("br")])]),e("ul",[e("li",[s._v("ここで"),e("strong",[s._v("NAMES")]),s._v("に表示されている値を記憶、若しくは記録しておいてください")])])]),s._v(" "),e("li",[s._v("起動の確認\n"),e("ul",[e("li",[s._v("ブラウザを開き、以下のURLを入力します"),e("div",{staticClass:"language- line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-text"}},[e("code",[s._v("http://localhost:80\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])])]),s._v(" "),e("li",[s._v("以下のような画面が表示されれば成功です\n"),e("img",{attrs:{src:a(237),alt:"getting-started"}})])])]),s._v(" "),e("li",[s._v("コンテナの終了\n"),e("ul",[e("li",[e("strong",[s._v("docker stop")]),s._v("コマンドを用いてdockerコンテナを停止します")])]),s._v(" "),e("div",{staticClass:"language- line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-text"}},[e("code",[s._v("docker stop \n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])])]),s._v(" "),e("li",[s._v("コンテナが停止したことの確認\n"),e("ul",[e("li",[s._v("ブラウザにて "),e("strong",[e("a",{attrs:{href:"http://localhost",target:"_blank",rel:"noopener noreferrer"}},[s._v("http://localhost"),e("OutboundLink")],1)]),s._v("にアクセスし、アクセスできないことを確認する")]),s._v(" "),e("li",[e("strong",[s._v("docker ps")]),s._v("コマンドを用いて、何も表示されないことを確認する"),e("div",{staticClass:"language- line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-text"}},[e("code",[s._v("docker ps\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br"),e("span",{staticClass:"line-number"},[s._v("2")]),e("br")])])])])])]),s._v(" "),e("credit-footer")],1)}),[],!1,null,null,null);e.default=r.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[29],{237:function(s,e,a){s.exports=a.p+"assets/img/getting-started.a1278e29.png"},532:function(s,e,a){"use strict";a.r(e);var t=a(10),r=Object(t.a)({},(function(){var s=this,e=s._self._c;return e("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[e("header-table"),s._v(" "),e("h2",{attrs:{id:"おさらい"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#おさらい"}},[s._v("#")]),s._v(" おさらい")]),s._v(" "),e("p",[s._v("それでは実際にDockerを使って仮想環境プラットフォームを作ってみましょう。\n事前準備の項を済ませているならばDocker環境は構築されているはずです。\n下記コマンドを入力し、コマンドが実行できるか確認してください。")]),s._v(" "),e("div",{staticClass:"language-bash line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-bash"}},[e("code",[s._v("$ "),e("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" version\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])]),e("p",[s._v("上記コマンドが実行できない方は事前にDocker（及びコマンド）のインストールが終わっているか否か確認し、未完了の人は、Docker のインストールを行ってください。")]),s._v(" "),e("h2",{attrs:{id:"docker-コンテナを起動する"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#docker-コンテナを起動する"}},[s._v("#")]),s._v(" Docker コンテナを起動する")]),s._v(" "),e("p",[s._v("Dockerコンテナを使って仮想環境プラットフォームを構築するには、大きく分けて以下のステップを踏む必要があります。")]),s._v(" "),e("ul",[e("li",[s._v("Dockerイメージのビルド")]),s._v(" "),e("li",[s._v("Dockerコンテナの作成")]),s._v(" "),e("li",[s._v("Dockerコンテナの起動")])]),s._v(" "),e("p",[s._v("従って、Dockerコンテナを起動する為に最初にすべきことは"),e("strong",[s._v("Dockerコンテナイメージ")]),s._v("を取得する事になります。")]),s._v(" "),e("p",[s._v("Dockerコンテナイメージは、自分で作成(ビルド)して取得する方法と、作成済みのDockerコンテナイメージを取得する方法の2種類があります。\nまずは、作成済みのイメージを利用してコンテナを起動することを試してみましょう。")]),s._v(" "),e("h3",{attrs:{id:"演習1-dockerコンテナを起動する"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#演習1-dockerコンテナを起動する"}},[s._v("#")]),s._v(" 演習1 Dockerコンテナを起動する")]),s._v(" "),e("ul",[e("li",[e("strong",[s._v("docker run")]),s._v("コマンドを使用して"),e("strong",[s._v("getting-started")]),s._v("コンテナを起動する"),e("div",{staticClass:"language-bash line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-bash"}},[e("code",[e("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" run --rm -p "),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("80")]),s._v(":80 docker/getting-started\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])])])]),s._v(" "),e("details",[e("summary",[s._v("実行中のログ")]),s._v(" "),e("div",{staticClass:"language- line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-text"}},[e("code",[s._v("Unable to find image 'docker/getting-started:latest' locally\nlatest: Pulling from docker/getting-started\nc158987b0551: Pull complete\n1e35f6679fab: Pull complete\ncb9626c74200: Pull complete\nb6334b6ace34: Pull complete\nf1d1c9928c82: Pull complete\n9b6f639ec6ea: Pull complete\nee68d3549ec8: Pull complete\n33e0cbbb4673: Pull complete\n4f7e34c2de10: Pull complete\nDigest: sha256:d79336f4812b6547a53e735480dde67f8f8f7071b414fbd9297609ffb989abc1\nStatus: Downloaded newer image for docker/getting-started:latest\n89e2c9780f5caf3b5250013e002e8aaf9f8ea74c2e940eca49b890dfc019ab5e\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br"),e("span",{staticClass:"line-number"},[s._v("2")]),e("br"),e("span",{staticClass:"line-number"},[s._v("3")]),e("br"),e("span",{staticClass:"line-number"},[s._v("4")]),e("br"),e("span",{staticClass:"line-number"},[s._v("5")]),e("br"),e("span",{staticClass:"line-number"},[s._v("6")]),e("br"),e("span",{staticClass:"line-number"},[s._v("7")]),e("br"),e("span",{staticClass:"line-number"},[s._v("8")]),e("br"),e("span",{staticClass:"line-number"},[s._v("9")]),e("br"),e("span",{staticClass:"line-number"},[s._v("10")]),e("br"),e("span",{staticClass:"line-number"},[s._v("11")]),e("br"),e("span",{staticClass:"line-number"},[s._v("12")]),e("br"),e("span",{staticClass:"line-number"},[s._v("13")]),e("br"),e("span",{staticClass:"line-number"},[s._v("14")]),e("br")])])]),s._v(" "),e("ul",[e("li",[s._v("起動の確認\n"),e("ul",[e("li",[s._v("ブラウザを開き、以下のURLを入力します"),e("div",{staticClass:"language- line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-text"}},[e("code",[s._v("http://localhost:80\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])])]),s._v(" "),e("li",[s._v("以下のような画面が表示されれば成功です\n"),e("img",{attrs:{src:a(237),alt:"getting-started"}})])])]),s._v(" "),e("li",[s._v("コンテナの終了\n"),e("strong",[s._v("Ctrl + c")]),s._v(" を押す")]),s._v(" "),e("li",[s._v("ターミナルが戻ってくる")])]),s._v(" "),e("h3",{attrs:{id:"発展課題1"}},[e("a",{staticClass:"header-anchor",attrs:{href:"#発展課題1"}},[s._v("#")]),s._v(" 発展課題1")]),s._v(" "),e("p",[s._v("先ほどの作業ではフォアグラウンドで実行している為、ターミナルが占有されてしまいます。\nまた、このような起動では例えばssh等で接続している場合はセッション切断と共にコンテナが停止してしまう為、発展課題ではこれを永続化する事をやってみましょう。")]),s._v(" "),e("p",[s._v("デーモン起動をすると、ターミナルは返ってきてしまうため起動確認は "),e("code",[s._v("docker ps")]),s._v("を使って確認します。")]),s._v(" "),e("ul",[e("li",[s._v("コンテナのデーモン起動"),e("div",{staticClass:"language-bash line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-bash"}},[e("code",[e("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" run --rm -p "),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("80")]),s._v(":80 docker/getting-started\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])])]),s._v(" "),e("li",[s._v("コンテナの起動確認"),e("div",{staticClass:"language-bash line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-bash"}},[e("code",[s._v("CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n38ebcf110f45 docker/getting-started "),e("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/docker-entrypoint.…"')]),s._v(" "),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),s._v(" seconds ago Up "),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("2")]),s._v(" seconds "),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("0.0")]),s._v(".0.0:80-"),e("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("80")]),s._v("/tcp, :::80-"),e("span",{pre:!0,attrs:{class:"token operator"}},[s._v(">")]),e("span",{pre:!0,attrs:{class:"token number"}},[s._v("80")]),s._v("/tcp fervent_shaw\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br"),e("span",{staticClass:"line-number"},[s._v("2")]),e("br")])]),e("ul",[e("li",[s._v("ここで"),e("strong",[s._v("NAMES")]),s._v("に表示されている値を記憶、若しくは記録しておいてください")])])]),s._v(" "),e("li",[s._v("起動の確認\n"),e("ul",[e("li",[s._v("ブラウザを開き、以下のURLを入力します"),e("div",{staticClass:"language- line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-text"}},[e("code",[s._v("http://localhost:80\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])])]),s._v(" "),e("li",[s._v("以下のような画面が表示されれば成功です\n"),e("img",{attrs:{src:a(237),alt:"getting-started"}})])])]),s._v(" "),e("li",[s._v("コンテナの終了\n"),e("ul",[e("li",[e("strong",[s._v("docker stop")]),s._v("コマンドを用いてdockerコンテナを停止します")])]),s._v(" "),e("div",{staticClass:"language- line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-text"}},[e("code",[s._v("docker stop \n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br")])])]),s._v(" "),e("li",[s._v("コンテナが停止したことの確認\n"),e("ul",[e("li",[s._v("ブラウザにて "),e("strong",[e("a",{attrs:{href:"http://localhost",target:"_blank",rel:"noopener noreferrer"}},[s._v("http://localhost"),e("OutboundLink")],1)]),s._v("にアクセスし、アクセスできないことを確認する")]),s._v(" "),e("li",[e("strong",[s._v("docker ps")]),s._v("コマンドを用いて、何も表示されないことを確認する"),e("div",{staticClass:"language- line-numbers-mode"},[e("pre",{pre:!0,attrs:{class:"language-text"}},[e("code",[s._v("docker ps\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\n")])]),s._v(" "),e("div",{staticClass:"line-numbers-wrapper"},[e("span",{staticClass:"line-number"},[s._v("1")]),e("br"),e("span",{staticClass:"line-number"},[s._v("2")]),e("br")])])])])])]),s._v(" "),e("credit-footer")],1)}),[],!1,null,null,null);e.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/31.d1e92e59.js b/assets/js/31.bfb228fb.js similarity index 99% rename from assets/js/31.d1e92e59.js rename to assets/js/31.bfb228fb.js index d3f03b03..ca4c7e5c 100644 --- a/assets/js/31.d1e92e59.js +++ b/assets/js/31.bfb228fb.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[31],{466:function(e,s,a){e.exports=a.p+"assets/img/docker_mirror_config.7454cae9.png"},544:function(e,s,a){"use strict";a.r(s);var t=a(10),r=Object(t.a)({},(function(){var e=this,s=e._self._c;return s("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[s("header-table"),e._v(" "),s("h1",{attrs:{id:"page-frontmatter-title"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#page-frontmatter-title"}},[e._v("#")]),e._v(" "+e._s(e.$page.frontmatter.title))]),e._v(" "),s("p",[e._v("各ハンズオンに取り組む前に、各ハンズオン用の環境を "),s("a",{attrs:{href:"https://www.docker.com/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Docker"),s("OutboundLink")],1),e._v(" で動かせるように準備します。")]),e._v(" "),s("h2",{attrs:{id:"docker-のインストール-check-1"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#docker-のインストール-check-1"}},[e._v("#")]),e._v(" Docker のインストール (Check.1)")]),e._v(" "),s("p",[e._v("各 OS やプラットフォームごとのインストール方法はここにドキュメントがあります。\n"),s("a",{attrs:{href:"https://docs.docker.com/engine/install/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Install Docker Engine"),s("OutboundLink")],1)]),e._v(" "),s("p",[e._v("この資料では Windows と macOS について、簡単に取り上げます。")]),e._v(" "),s("h3",{attrs:{id:"読み方"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#読み方"}},[e._v("#")]),e._v(" 読み方")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("このような 黒枠 になっている部分は 実際にコマンドを打ち込む部分です。 Terminal や コマンドプロンプトなどで入力ください\n$ また、 左端の $ や > は プロンプトと言って 実際には入力しません。\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br")])]),s("p",[e._v("例えば 以下の表記であれば "),s("code",[e._v("$ docker --version")]),e._v(" ではなく "),s("code",[e._v("docker --version")]),e._v(" とだけ入力してください。\nなお、 $ や > から始まらないところ は 出力例です。 こちらも 入力する必要はありません。(以下の例では "),s("code",[e._v("Docker version 20.10.7, build f0df350")]),e._v(")\nコピペするときは気をつけてください。")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker --version\n\nDocker version 20.10.7, build f0df350\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br")])]),s("h3",{attrs:{id:"windows"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#windows"}},[e._v("#")]),e._v(" Windows")]),e._v(" "),s("p",[e._v("windows の場合 "),s("a",{attrs:{href:"https://docs.docker.com/docker-for-windows/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Docker Desktop for Windows"),s("OutboundLink")],1),e._v(" を使うのがおすすめです。WSL や仮想環境に linux を立てることもできますが、ネットワークのトラブルなどが頻発するため現状あまりお勧めしません。")]),e._v(" "),s("ol",[s("li",[s("a",{attrs:{href:"https://hub.docker.com/editions/community/docker-ce-desktop-windows/",target:"_blank",rel:"noopener noreferrer"}},[e._v("ダウンロードページ"),s("OutboundLink")],1),e._v(" にアクセスし、「Get Docker」をクリックして exe ファイルをダウンロードします。\n"),s("ul",[s("li",[e._v("stable 版で問題ありません")])])]),e._v(" "),s("li",[e._v("ダウンロードした exe ファイルをクリックしてインストールします。")]),e._v(" "),s("li",[e._v("必要に応じて "),s("a",{attrs:{href:"https://docs.microsoft.com/ja-jp/windows/wsl/install-win10#step-4---download-the-linux-kernel-update-package",target:"_blank",rel:"noopener noreferrer"}},[e._v("Linux カーネル更新プログラム パッケージ"),s("OutboundLink")],1),e._v(" のインストールをします。")]),e._v(" "),s("li",[e._v("PowerShell やコマンドプロンプトを開き、"),s("code",[e._v("docker version")]),e._v("コマンドが実行できれば成功です。")])]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v(">docker --version\n\nDocker version 20.10.7, build f0df350\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br")])]),s("h3",{attrs:{id:"mac"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#mac"}},[e._v("#")]),e._v(" Mac")]),e._v(" "),s("p",[e._v("Mac の場合は "),s("a",{attrs:{href:"https://docs.docker.com/docker-for-mac/",target:"_blank",rel:"noopener noreferrer"}},[e._v("docker-for-mac"),s("OutboundLink")],1),e._v(" を使います。")]),e._v(" "),s("ol",[s("li",[s("a",{attrs:{href:"https://hub.docker.com/editions/community/docker-ce-desktop-mac/",target:"_blank",rel:"noopener noreferrer"}},[e._v("ダウンロードページ"),s("OutboundLink")],1),e._v(" にアクセスし、「Get Docker」をクリックして dmg ファイルをダウンロードします。")]),e._v(" "),s("li",[e._v("ダウンロードした dmg ファイルをクリックしてインストールします。")]),e._v(" "),s("li",[e._v("terminal を開き、"),s("code",[e._v("docker version")]),e._v("コマンドが実行できれば成功です。")])]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker --version\n\nDocker version 20.10.6, build 370c289\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br")])]),s("h2",{attrs:{id:"hello-docker"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#hello-docker"}},[e._v("#")]),e._v(" Hello Docker")]),e._v(" "),s("h3",{attrs:{id:"ミラーサーバの設定"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#ミラーサーバの設定"}},[e._v("#")]),e._v(" ミラーサーバの設定")]),e._v(" "),s("p",[e._v("（ちょっと長い説明）")]),e._v(" "),s("p",[e._v("Dockerで何かコンテナを動かす際にはイメージファイルが必要になります（詳しくはDockerハンズオンで）。\nデフォルトではイメージファイルは"),s("a",{attrs:{href:"https://hub.docker.com/",target:"_blank",rel:"noopener noreferrer"}},[e._v("dockerhub"),s("OutboundLink")],1),e._v("というDocker社公式のサービスからダウンロードできますが、少し前から同一IPアドレスから大量にアクセスがあるとアクセス制限がかかるようになりました。")]),e._v(" "),s("p",[e._v("会社のネットワークから外部のサイトにアクセスする際は必ずプロキシサーバを経由しますが、社内から全員がdockerhubにアクセスするとプロキシサーバのIPアドレスが簡単にアクセス制限の対象になってしまいます。")]),e._v(" "),s("p",[e._v("そこでイメージファイルをキャッシュしておくための社内ミラーサーバが立っていますので、そちらを使う設定を追加します。")]),e._v(" "),s("p",[e._v("Dockerのアプリを立ち上げ、Preferences > Docker Engine を開いてください。")]),e._v(" "),s("p",[s("img",{attrs:{src:a(466),alt:"docker engine config"}})]),e._v(" "),s("p",[e._v("画像では色々と書いてありますが、必要なのは以下の設定です。下記の項目を追加してください。")]),e._v(" "),s("div",{staticClass:"language-json line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-json"}},[s("code",[s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v("\n "),s("span",{pre:!0,attrs:{class:"token property"}},[e._v('"registry-mirrors"')]),s("span",{pre:!0,attrs:{class:"token operator"}},[e._v(":")]),e._v(" "),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("[")]),s("span",{pre:!0,attrs:{class:"token string"}},[e._v('"https://.jp"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("]")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(",")]),e._v("\n "),s("span",{pre:!0,attrs:{class:"token property"}},[e._v('"insecure-registries"')]),s("span",{pre:!0,attrs:{class:"token operator"}},[e._v(":")]),e._v(" "),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("[")]),e._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[e._v('".jp"')]),e._v(" "),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("]")]),e._v("\n"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),e._v("\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br"),s("span",{staticClass:"line-number"},[e._v("4")]),s("br")])]),s("p",[e._v("ミラーサーバーのURLは社内で利用可能なものを設定してください。")]),e._v(" "),s("p",[e._v("記述を追加したら"),s("code",[e._v("Apply & Restart")]),e._v("で再起動します。その後再びterminalから"),s("code",[e._v("docker system info")]),e._v("というコマンドを実行してください。")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker system info\n\nClient:\n Context: default\n Debug Mode: false\n Plugins:\n app: Docker App (Docker Inc., v0.9.1-beta3)\n buildx: Build with BuildKit (Docker Inc., v0.5.1-docker)\n compose: Docker Compose (Docker Inc., 2.0.0-beta.1)\n scan: Docker Scan (Docker Inc., v0.8.0)\n\nServer:\n...\n Insecure Registries:\n .jp\n 127.0.0.0/8\n Registry Mirrors:\n https://.jp/\n...\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br"),s("span",{staticClass:"line-number"},[e._v("4")]),s("br"),s("span",{staticClass:"line-number"},[e._v("5")]),s("br"),s("span",{staticClass:"line-number"},[e._v("6")]),s("br"),s("span",{staticClass:"line-number"},[e._v("7")]),s("br"),s("span",{staticClass:"line-number"},[e._v("8")]),s("br"),s("span",{staticClass:"line-number"},[e._v("9")]),s("br"),s("span",{staticClass:"line-number"},[e._v("10")]),s("br"),s("span",{staticClass:"line-number"},[e._v("11")]),s("br"),s("span",{staticClass:"line-number"},[e._v("12")]),s("br"),s("span",{staticClass:"line-number"},[e._v("13")]),s("br"),s("span",{staticClass:"line-number"},[e._v("14")]),s("br"),s("span",{staticClass:"line-number"},[e._v("15")]),s("br"),s("span",{staticClass:"line-number"},[e._v("16")]),s("br"),s("span",{staticClass:"line-number"},[e._v("17")]),s("br"),s("span",{staticClass:"line-number"},[e._v("18")]),s("br"),s("span",{staticClass:"line-number"},[e._v("19")]),s("br")])]),s("p",[s("code",[e._v("Insecure Registries")]),e._v("と"),s("code",[e._v("Registry Mirrors")]),e._v("に先ほど設定した値が入っていれば成功です。")]),e._v(" "),s("h3",{attrs:{id:"hello-world-コンテナを動かす-check-2"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#hello-world-コンテナを動かす-check-2"}},[e._v("#")]),e._v(" hello-world コンテナを動かす (Check.2)")]),e._v(" "),s("p",[e._v("hello-world コンテナをダウンロードして、実際に docker で動かしてみます。")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker run hello-world\n\nUnable to find image 'hello-world:latest' locally\nlatest: Pulling from library/hello-world\nb8dfde127a29: Pull complete\nDigest: sha256:9f6ad537c5132bcce57f7a0a20e317228d382c3cd61edae14650eec68b2b345c\nStatus: Downloaded newer image for hello-world:latest\n\nHello from Docker!\nThis message shows that your installation appears to be working correctly.\n...\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br"),s("span",{staticClass:"line-number"},[e._v("4")]),s("br"),s("span",{staticClass:"line-number"},[e._v("5")]),s("br"),s("span",{staticClass:"line-number"},[e._v("6")]),s("br"),s("span",{staticClass:"line-number"},[e._v("7")]),s("br"),s("span",{staticClass:"line-number"},[e._v("8")]),s("br"),s("span",{staticClass:"line-number"},[e._v("9")]),s("br"),s("span",{staticClass:"line-number"},[e._v("10")]),s("br"),s("span",{staticClass:"line-number"},[e._v("11")]),s("br")])]),s("p",[s("code",[e._v("Hello from Docker!")]),e._v("が表示されていれば成功です。")]),e._v(" "),s("h3",{attrs:{id:"失敗した場合"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#失敗した場合"}},[e._v("#")]),e._v(" 失敗した場合")]),e._v(" "),s("p",[e._v("以下のようなエラーで失敗した場合 proxy の設定が必要な場合があります。")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker run hello-world\n\nUnable to find image 'hello-world:latest' locally\ndocker: Error response from daemon: Get https://registry-1.docker.io/v2/: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers).\nSee 'docker run --help'.\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br"),s("span",{staticClass:"line-number"},[e._v("4")]),s("br"),s("span",{staticClass:"line-number"},[e._v("5")]),s("br")])]),s("p",[e._v("「docker {OS 名} proxy」などで検索すると、以下のような記事が検索されると思うので、参考にしながら設定してみてください。")]),e._v(" "),s("ul",[s("li",[e._v("Windows: "),s("a",{attrs:{href:"https://qiita.com/wryun0suke/items/1f4bbd2977ae41ee7a36",target:"_blank",rel:"noopener noreferrer"}},[e._v("https://qiita.com/wryun0suke/items/1f4bbd2977ae41ee7a36"),s("OutboundLink")],1)]),e._v(" "),s("li",[e._v("Mac: "),s("a",{attrs:{href:"https://qiita.com/kobakou/items/214129924b9cd3e64d0f",target:"_blank",rel:"noopener noreferrer"}},[e._v("https://qiita.com/kobakou/items/214129924b9cd3e64d0f"),s("OutboundLink")],1)])]),e._v(" "),s("p",[e._v("proxy の URL は環境によって異なるため、周りの誰かに確認してください。")]),e._v(" "),s("h3",{attrs:{id:"それでもダメな場合-or-違うエラーの場合"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#それでもダメな場合-or-違うエラーの場合"}},[e._v("#")]),e._v(" それでもダメな場合 or 違うエラーの場合")]),e._v(" "),s("p",[e._v("TA や講師など、周りの先輩に遠慮なく声をかけてください。")]),e._v(" "),s("h2",{attrs:{id:"nginx-を立てて手元で-html-を書き換える"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#nginx-を立てて手元で-html-を書き換える"}},[e._v("#")]),e._v(" Nginx を立てて手元で HTML を書き換える")]),e._v(" "),s("p",[e._v("次は docker の "),s("a",{attrs:{href:"https://docs.docker.com/storage/volumes/",target:"_blank",rel:"noopener noreferrer"}},[e._v("volumes"),s("OutboundLink")],1),e._v(" という機能を使い、コンテナの中のファイルを手元で編集できるようにしてみます。\nこれができると docker 環境で動かすファイルを手元のエディタで編集できるためとても便利です。")]),e._v(" "),s("p",[e._v("ここでは Nginx という web サーバーを使い、簡単な HTML ファイルをホスティングしてみます。そしてその HTML ファイルを手元で書き換えてみましょう。")]),e._v(" "),s("h3",{attrs:{id:"html-ファイルの作成"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#html-ファイルの作成"}},[e._v("#")]),e._v(" HTML ファイルの作成")]),e._v(" "),s("p",[e._v("以下のようにディレクトリを作成し、")]),e._v(" "),s("div",{staticClass:"language- line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ mkdir content\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br")])]),s("p",[e._v("その中に "),s("code",[e._v("index.html")]),e._v(" ファイルを作成してください。")]),e._v(" "),s("p",[e._v("例えば、 vim を使うなら以下のような コマンド になります。\nvim が無い、ほかのを使いたい そんな場合は 各種 メモ帳など自分の好きなエディタを利用してください。\nvim から抜けるには ESCキーを押した後「:wq"),s("Enter",[e._v("」を入力してください。")])],1),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ vim content/index.html\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br")])]),s("p",[s("code",[e._v("index.html")]),e._v("の内容はなんでもいいですが、例えば以下のようにしてみましょう。")]),e._v(" "),s("div",{staticClass:"language-html line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-html"}},[s("code",[e._v("Hello Bootcamp!\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br")])]),s("h3",{attrs:{id:"docker-コンテナの起動-check-3"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#docker-コンテナの起動-check-3"}},[e._v("#")]),e._v(" docker コンテナの起動 (Check.3)")]),e._v(" "),s("p",[s("code",[e._v("index.html")]),e._v(" ファイルが作成できたら、nginx の docker コンテナを以下のように起動します。")]),e._v(" "),s("p",[e._v("いずれも")]),e._v(" "),s("ul",[s("li",[s("code",[e._v("--name")]),e._v(" : test-nginx という名前で")]),e._v(" "),s("li",[s("code",[e._v("-p 8080:80")]),e._v(" : localhost の 8080 port を コンテナの中で 80 port に 転送し")]),e._v(" "),s("li",[s("code",[e._v("--mount....")]),e._v(": いまのディレクトリの content ディレクトリの内容を コンテナの中で /usr/share/nginx/html の中身として扱い")]),e._v(" "),s("li",[s("code",[e._v("-d")]),e._v(": daemon (バックグラウンドで実行し続ける)モードで")]),e._v(" "),s("li",[s("code",[e._v("nginx")]),e._v(": nginx:latest タグ の イメージを使って コンテナを起動する")])]),e._v(" "),s("p",[e._v("というものになります。")]),e._v(" "),s("p",[e._v("windows")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker run --name test-nginx -p 8080:80 --mount type=bind,source=%CD%/content,target=/usr/share/nginx/html,ro -d nginx\n\n47fb496ed83cb26558874e8fd6b6fff4303031a2b24f827a938310ee9646c638\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br")])]),s("p",[e._v("mac/linux")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker run --name test-nginx -p 8080:80 --mount type=bind,source=$PWD/content,target=/usr/share/nginx/html,ro -d nginx\n\n47fb496ed83cb26558874e8fd6b6fff4303031a2b24f827a938310ee9646c638\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br")])]),s("p",[e._v("エラーなく起動できたら 起動したコンテナのID が表示されます。ここは実行ごとに変わります。")]),e._v(" "),s("p",[e._v("ブラウザを開き、"),s("a",{attrs:{href:"http://localhost:8080",target:"_blank",rel:"noopener noreferrer"}},[e._v("localhost:8080"),s("OutboundLink")],1),e._v(" （"),s("code",[e._v("localhost")]),e._v("または ssh 先の IP アドレス）にアクセスしてみましょう。「Hello Bootcamp!」が表示されていれば成功です。")]),e._v(" "),s("p",[e._v("なお、"),s("code",[e._v("-d")]),e._v(" オプションを付けているので、 バックグラウンドで起動し続けています。 再度起動し直してみたい場合は 一度 "),s("code",[e._v("docker stop")]),e._v(" する必要があります。お掃除の手順を参照してください。")]),e._v(" "),s("h3",{attrs:{id:"html-ファイルを書き換える"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#html-ファイルを書き換える"}},[e._v("#")]),e._v(" HTML ファイルを書き換える")]),e._v(" "),s("p",[e._v("先ほど作成した"),s("code",[e._v("index.html")]),e._v("を編集してみましょう。")]),e._v(" "),s("div",{staticClass:"language-html line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-html"}},[s("code",[e._v("Hello Bootcamp!!!!!!\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br")])]),s("p",[e._v("保存してブラウザをリロードしてみてください。ページが更新されていれば成功です。")]),e._v(" "),s("h2",{attrs:{id:"docker-コンテナのお掃除"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#docker-コンテナのお掃除"}},[e._v("#")]),e._v(" Docker コンテナのお掃除")]),e._v(" "),s("p",[e._v("最後に Docker コンテナを止めて掃除しておきます。")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker stop test-nginx\n$ docker rm test-nginx\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br")])]),s("p",[e._v("以上で事前準備は完了です。お疲れ様でした。")])],1)}),[],!1,null,null,null);s.default=r.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[31],{466:function(e,s,a){e.exports=a.p+"assets/img/docker_mirror_config.7454cae9.png"},545:function(e,s,a){"use strict";a.r(s);var t=a(10),r=Object(t.a)({},(function(){var e=this,s=e._self._c;return s("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[s("header-table"),e._v(" "),s("h1",{attrs:{id:"page-frontmatter-title"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#page-frontmatter-title"}},[e._v("#")]),e._v(" "+e._s(e.$page.frontmatter.title))]),e._v(" "),s("p",[e._v("各ハンズオンに取り組む前に、各ハンズオン用の環境を "),s("a",{attrs:{href:"https://www.docker.com/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Docker"),s("OutboundLink")],1),e._v(" で動かせるように準備します。")]),e._v(" "),s("h2",{attrs:{id:"docker-のインストール-check-1"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#docker-のインストール-check-1"}},[e._v("#")]),e._v(" Docker のインストール (Check.1)")]),e._v(" "),s("p",[e._v("各 OS やプラットフォームごとのインストール方法はここにドキュメントがあります。\n"),s("a",{attrs:{href:"https://docs.docker.com/engine/install/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Install Docker Engine"),s("OutboundLink")],1)]),e._v(" "),s("p",[e._v("この資料では Windows と macOS について、簡単に取り上げます。")]),e._v(" "),s("h3",{attrs:{id:"読み方"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#読み方"}},[e._v("#")]),e._v(" 読み方")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("このような 黒枠 になっている部分は 実際にコマンドを打ち込む部分です。 Terminal や コマンドプロンプトなどで入力ください\n$ また、 左端の $ や > は プロンプトと言って 実際には入力しません。\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br")])]),s("p",[e._v("例えば 以下の表記であれば "),s("code",[e._v("$ docker --version")]),e._v(" ではなく "),s("code",[e._v("docker --version")]),e._v(" とだけ入力してください。\nなお、 $ や > から始まらないところ は 出力例です。 こちらも 入力する必要はありません。(以下の例では "),s("code",[e._v("Docker version 20.10.7, build f0df350")]),e._v(")\nコピペするときは気をつけてください。")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker --version\n\nDocker version 20.10.7, build f0df350\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br")])]),s("h3",{attrs:{id:"windows"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#windows"}},[e._v("#")]),e._v(" Windows")]),e._v(" "),s("p",[e._v("windows の場合 "),s("a",{attrs:{href:"https://docs.docker.com/docker-for-windows/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Docker Desktop for Windows"),s("OutboundLink")],1),e._v(" を使うのがおすすめです。WSL や仮想環境に linux を立てることもできますが、ネットワークのトラブルなどが頻発するため現状あまりお勧めしません。")]),e._v(" "),s("ol",[s("li",[s("a",{attrs:{href:"https://hub.docker.com/editions/community/docker-ce-desktop-windows/",target:"_blank",rel:"noopener noreferrer"}},[e._v("ダウンロードページ"),s("OutboundLink")],1),e._v(" にアクセスし、「Get Docker」をクリックして exe ファイルをダウンロードします。\n"),s("ul",[s("li",[e._v("stable 版で問題ありません")])])]),e._v(" "),s("li",[e._v("ダウンロードした exe ファイルをクリックしてインストールします。")]),e._v(" "),s("li",[e._v("必要に応じて "),s("a",{attrs:{href:"https://docs.microsoft.com/ja-jp/windows/wsl/install-win10#step-4---download-the-linux-kernel-update-package",target:"_blank",rel:"noopener noreferrer"}},[e._v("Linux カーネル更新プログラム パッケージ"),s("OutboundLink")],1),e._v(" のインストールをします。")]),e._v(" "),s("li",[e._v("PowerShell やコマンドプロンプトを開き、"),s("code",[e._v("docker version")]),e._v("コマンドが実行できれば成功です。")])]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v(">docker --version\n\nDocker version 20.10.7, build f0df350\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br")])]),s("h3",{attrs:{id:"mac"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#mac"}},[e._v("#")]),e._v(" Mac")]),e._v(" "),s("p",[e._v("Mac の場合は "),s("a",{attrs:{href:"https://docs.docker.com/docker-for-mac/",target:"_blank",rel:"noopener noreferrer"}},[e._v("docker-for-mac"),s("OutboundLink")],1),e._v(" を使います。")]),e._v(" "),s("ol",[s("li",[s("a",{attrs:{href:"https://hub.docker.com/editions/community/docker-ce-desktop-mac/",target:"_blank",rel:"noopener noreferrer"}},[e._v("ダウンロードページ"),s("OutboundLink")],1),e._v(" にアクセスし、「Get Docker」をクリックして dmg ファイルをダウンロードします。")]),e._v(" "),s("li",[e._v("ダウンロードした dmg ファイルをクリックしてインストールします。")]),e._v(" "),s("li",[e._v("terminal を開き、"),s("code",[e._v("docker version")]),e._v("コマンドが実行できれば成功です。")])]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker --version\n\nDocker version 20.10.6, build 370c289\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br")])]),s("h2",{attrs:{id:"hello-docker"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#hello-docker"}},[e._v("#")]),e._v(" Hello Docker")]),e._v(" "),s("h3",{attrs:{id:"ミラーサーバの設定"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#ミラーサーバの設定"}},[e._v("#")]),e._v(" ミラーサーバの設定")]),e._v(" "),s("p",[e._v("（ちょっと長い説明）")]),e._v(" "),s("p",[e._v("Dockerで何かコンテナを動かす際にはイメージファイルが必要になります（詳しくはDockerハンズオンで）。\nデフォルトではイメージファイルは"),s("a",{attrs:{href:"https://hub.docker.com/",target:"_blank",rel:"noopener noreferrer"}},[e._v("dockerhub"),s("OutboundLink")],1),e._v("というDocker社公式のサービスからダウンロードできますが、少し前から同一IPアドレスから大量にアクセスがあるとアクセス制限がかかるようになりました。")]),e._v(" "),s("p",[e._v("会社のネットワークから外部のサイトにアクセスする際は必ずプロキシサーバを経由しますが、社内から全員がdockerhubにアクセスするとプロキシサーバのIPアドレスが簡単にアクセス制限の対象になってしまいます。")]),e._v(" "),s("p",[e._v("そこでイメージファイルをキャッシュしておくための社内ミラーサーバが立っていますので、そちらを使う設定を追加します。")]),e._v(" "),s("p",[e._v("Dockerのアプリを立ち上げ、Preferences > Docker Engine を開いてください。")]),e._v(" "),s("p",[s("img",{attrs:{src:a(466),alt:"docker engine config"}})]),e._v(" "),s("p",[e._v("画像では色々と書いてありますが、必要なのは以下の設定です。下記の項目を追加してください。")]),e._v(" "),s("div",{staticClass:"language-json line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-json"}},[s("code",[s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("{")]),e._v("\n "),s("span",{pre:!0,attrs:{class:"token property"}},[e._v('"registry-mirrors"')]),s("span",{pre:!0,attrs:{class:"token operator"}},[e._v(":")]),e._v(" "),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("[")]),s("span",{pre:!0,attrs:{class:"token string"}},[e._v('"https://.jp"')]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("]")]),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v(",")]),e._v("\n "),s("span",{pre:!0,attrs:{class:"token property"}},[e._v('"insecure-registries"')]),s("span",{pre:!0,attrs:{class:"token operator"}},[e._v(":")]),e._v(" "),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("[")]),e._v(" "),s("span",{pre:!0,attrs:{class:"token string"}},[e._v('".jp"')]),e._v(" "),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("]")]),e._v("\n"),s("span",{pre:!0,attrs:{class:"token punctuation"}},[e._v("}")]),e._v("\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br"),s("span",{staticClass:"line-number"},[e._v("4")]),s("br")])]),s("p",[e._v("ミラーサーバーのURLは社内で利用可能なものを設定してください。")]),e._v(" "),s("p",[e._v("記述を追加したら"),s("code",[e._v("Apply & Restart")]),e._v("で再起動します。その後再びterminalから"),s("code",[e._v("docker system info")]),e._v("というコマンドを実行してください。")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker system info\n\nClient:\n Context: default\n Debug Mode: false\n Plugins:\n app: Docker App (Docker Inc., v0.9.1-beta3)\n buildx: Build with BuildKit (Docker Inc., v0.5.1-docker)\n compose: Docker Compose (Docker Inc., 2.0.0-beta.1)\n scan: Docker Scan (Docker Inc., v0.8.0)\n\nServer:\n...\n Insecure Registries:\n .jp\n 127.0.0.0/8\n Registry Mirrors:\n https://.jp/\n...\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br"),s("span",{staticClass:"line-number"},[e._v("4")]),s("br"),s("span",{staticClass:"line-number"},[e._v("5")]),s("br"),s("span",{staticClass:"line-number"},[e._v("6")]),s("br"),s("span",{staticClass:"line-number"},[e._v("7")]),s("br"),s("span",{staticClass:"line-number"},[e._v("8")]),s("br"),s("span",{staticClass:"line-number"},[e._v("9")]),s("br"),s("span",{staticClass:"line-number"},[e._v("10")]),s("br"),s("span",{staticClass:"line-number"},[e._v("11")]),s("br"),s("span",{staticClass:"line-number"},[e._v("12")]),s("br"),s("span",{staticClass:"line-number"},[e._v("13")]),s("br"),s("span",{staticClass:"line-number"},[e._v("14")]),s("br"),s("span",{staticClass:"line-number"},[e._v("15")]),s("br"),s("span",{staticClass:"line-number"},[e._v("16")]),s("br"),s("span",{staticClass:"line-number"},[e._v("17")]),s("br"),s("span",{staticClass:"line-number"},[e._v("18")]),s("br"),s("span",{staticClass:"line-number"},[e._v("19")]),s("br")])]),s("p",[s("code",[e._v("Insecure Registries")]),e._v("と"),s("code",[e._v("Registry Mirrors")]),e._v("に先ほど設定した値が入っていれば成功です。")]),e._v(" "),s("h3",{attrs:{id:"hello-world-コンテナを動かす-check-2"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#hello-world-コンテナを動かす-check-2"}},[e._v("#")]),e._v(" hello-world コンテナを動かす (Check.2)")]),e._v(" "),s("p",[e._v("hello-world コンテナをダウンロードして、実際に docker で動かしてみます。")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker run hello-world\n\nUnable to find image 'hello-world:latest' locally\nlatest: Pulling from library/hello-world\nb8dfde127a29: Pull complete\nDigest: sha256:9f6ad537c5132bcce57f7a0a20e317228d382c3cd61edae14650eec68b2b345c\nStatus: Downloaded newer image for hello-world:latest\n\nHello from Docker!\nThis message shows that your installation appears to be working correctly.\n...\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br"),s("span",{staticClass:"line-number"},[e._v("4")]),s("br"),s("span",{staticClass:"line-number"},[e._v("5")]),s("br"),s("span",{staticClass:"line-number"},[e._v("6")]),s("br"),s("span",{staticClass:"line-number"},[e._v("7")]),s("br"),s("span",{staticClass:"line-number"},[e._v("8")]),s("br"),s("span",{staticClass:"line-number"},[e._v("9")]),s("br"),s("span",{staticClass:"line-number"},[e._v("10")]),s("br"),s("span",{staticClass:"line-number"},[e._v("11")]),s("br")])]),s("p",[s("code",[e._v("Hello from Docker!")]),e._v("が表示されていれば成功です。")]),e._v(" "),s("h3",{attrs:{id:"失敗した場合"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#失敗した場合"}},[e._v("#")]),e._v(" 失敗した場合")]),e._v(" "),s("p",[e._v("以下のようなエラーで失敗した場合 proxy の設定が必要な場合があります。")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker run hello-world\n\nUnable to find image 'hello-world:latest' locally\ndocker: Error response from daemon: Get https://registry-1.docker.io/v2/: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers).\nSee 'docker run --help'.\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br"),s("span",{staticClass:"line-number"},[e._v("4")]),s("br"),s("span",{staticClass:"line-number"},[e._v("5")]),s("br")])]),s("p",[e._v("「docker {OS 名} proxy」などで検索すると、以下のような記事が検索されると思うので、参考にしながら設定してみてください。")]),e._v(" "),s("ul",[s("li",[e._v("Windows: "),s("a",{attrs:{href:"https://qiita.com/wryun0suke/items/1f4bbd2977ae41ee7a36",target:"_blank",rel:"noopener noreferrer"}},[e._v("https://qiita.com/wryun0suke/items/1f4bbd2977ae41ee7a36"),s("OutboundLink")],1)]),e._v(" "),s("li",[e._v("Mac: "),s("a",{attrs:{href:"https://qiita.com/kobakou/items/214129924b9cd3e64d0f",target:"_blank",rel:"noopener noreferrer"}},[e._v("https://qiita.com/kobakou/items/214129924b9cd3e64d0f"),s("OutboundLink")],1)])]),e._v(" "),s("p",[e._v("proxy の URL は環境によって異なるため、周りの誰かに確認してください。")]),e._v(" "),s("h3",{attrs:{id:"それでもダメな場合-or-違うエラーの場合"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#それでもダメな場合-or-違うエラーの場合"}},[e._v("#")]),e._v(" それでもダメな場合 or 違うエラーの場合")]),e._v(" "),s("p",[e._v("TA や講師など、周りの先輩に遠慮なく声をかけてください。")]),e._v(" "),s("h2",{attrs:{id:"nginx-を立てて手元で-html-を書き換える"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#nginx-を立てて手元で-html-を書き換える"}},[e._v("#")]),e._v(" Nginx を立てて手元で HTML を書き換える")]),e._v(" "),s("p",[e._v("次は docker の "),s("a",{attrs:{href:"https://docs.docker.com/storage/volumes/",target:"_blank",rel:"noopener noreferrer"}},[e._v("volumes"),s("OutboundLink")],1),e._v(" という機能を使い、コンテナの中のファイルを手元で編集できるようにしてみます。\nこれができると docker 環境で動かすファイルを手元のエディタで編集できるためとても便利です。")]),e._v(" "),s("p",[e._v("ここでは Nginx という web サーバーを使い、簡単な HTML ファイルをホスティングしてみます。そしてその HTML ファイルを手元で書き換えてみましょう。")]),e._v(" "),s("h3",{attrs:{id:"html-ファイルの作成"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#html-ファイルの作成"}},[e._v("#")]),e._v(" HTML ファイルの作成")]),e._v(" "),s("p",[e._v("以下のようにディレクトリを作成し、")]),e._v(" "),s("div",{staticClass:"language- line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ mkdir content\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br")])]),s("p",[e._v("その中に "),s("code",[e._v("index.html")]),e._v(" ファイルを作成してください。")]),e._v(" "),s("p",[e._v("例えば、 vim を使うなら以下のような コマンド になります。\nvim が無い、ほかのを使いたい そんな場合は 各種 メモ帳など自分の好きなエディタを利用してください。\nvim から抜けるには ESCキーを押した後「:wq"),s("Enter",[e._v("」を入力してください。")])],1),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ vim content/index.html\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br")])]),s("p",[s("code",[e._v("index.html")]),e._v("の内容はなんでもいいですが、例えば以下のようにしてみましょう。")]),e._v(" "),s("div",{staticClass:"language-html line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-html"}},[s("code",[e._v("Hello Bootcamp!\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br")])]),s("h3",{attrs:{id:"docker-コンテナの起動-check-3"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#docker-コンテナの起動-check-3"}},[e._v("#")]),e._v(" docker コンテナの起動 (Check.3)")]),e._v(" "),s("p",[s("code",[e._v("index.html")]),e._v(" ファイルが作成できたら、nginx の docker コンテナを以下のように起動します。")]),e._v(" "),s("p",[e._v("いずれも")]),e._v(" "),s("ul",[s("li",[s("code",[e._v("--name")]),e._v(" : test-nginx という名前で")]),e._v(" "),s("li",[s("code",[e._v("-p 8080:80")]),e._v(" : localhost の 8080 port を コンテナの中で 80 port に 転送し")]),e._v(" "),s("li",[s("code",[e._v("--mount....")]),e._v(": いまのディレクトリの content ディレクトリの内容を コンテナの中で /usr/share/nginx/html の中身として扱い")]),e._v(" "),s("li",[s("code",[e._v("-d")]),e._v(": daemon (バックグラウンドで実行し続ける)モードで")]),e._v(" "),s("li",[s("code",[e._v("nginx")]),e._v(": nginx:latest タグ の イメージを使って コンテナを起動する")])]),e._v(" "),s("p",[e._v("というものになります。")]),e._v(" "),s("p",[e._v("windows")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker run --name test-nginx -p 8080:80 --mount type=bind,source=%CD%/content,target=/usr/share/nginx/html,ro -d nginx\n\n47fb496ed83cb26558874e8fd6b6fff4303031a2b24f827a938310ee9646c638\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br")])]),s("p",[e._v("mac/linux")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker run --name test-nginx -p 8080:80 --mount type=bind,source=$PWD/content,target=/usr/share/nginx/html,ro -d nginx\n\n47fb496ed83cb26558874e8fd6b6fff4303031a2b24f827a938310ee9646c638\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br"),s("span",{staticClass:"line-number"},[e._v("3")]),s("br")])]),s("p",[e._v("エラーなく起動できたら 起動したコンテナのID が表示されます。ここは実行ごとに変わります。")]),e._v(" "),s("p",[e._v("ブラウザを開き、"),s("a",{attrs:{href:"http://localhost:8080",target:"_blank",rel:"noopener noreferrer"}},[e._v("localhost:8080"),s("OutboundLink")],1),e._v(" （"),s("code",[e._v("localhost")]),e._v("または ssh 先の IP アドレス）にアクセスしてみましょう。「Hello Bootcamp!」が表示されていれば成功です。")]),e._v(" "),s("p",[e._v("なお、"),s("code",[e._v("-d")]),e._v(" オプションを付けているので、 バックグラウンドで起動し続けています。 再度起動し直してみたい場合は 一度 "),s("code",[e._v("docker stop")]),e._v(" する必要があります。お掃除の手順を参照してください。")]),e._v(" "),s("h3",{attrs:{id:"html-ファイルを書き換える"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#html-ファイルを書き換える"}},[e._v("#")]),e._v(" HTML ファイルを書き換える")]),e._v(" "),s("p",[e._v("先ほど作成した"),s("code",[e._v("index.html")]),e._v("を編集してみましょう。")]),e._v(" "),s("div",{staticClass:"language-html line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-html"}},[s("code",[e._v("Hello Bootcamp!!!!!!\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br")])]),s("p",[e._v("保存してブラウザをリロードしてみてください。ページが更新されていれば成功です。")]),e._v(" "),s("h2",{attrs:{id:"docker-コンテナのお掃除"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#docker-コンテナのお掃除"}},[e._v("#")]),e._v(" Docker コンテナのお掃除")]),e._v(" "),s("p",[e._v("最後に Docker コンテナを止めて掃除しておきます。")]),e._v(" "),s("div",{staticClass:"language-terminal line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-text"}},[s("code",[e._v("$ docker stop test-nginx\n$ docker rm test-nginx\n")])]),e._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[e._v("1")]),s("br"),s("span",{staticClass:"line-number"},[e._v("2")]),s("br")])]),s("p",[e._v("以上で事前準備は完了です。お疲れ様でした。")])],1)}),[],!1,null,null,null);s.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/32.b5197f93.js b/assets/js/32.8cd1a0f9.js similarity index 99% rename from assets/js/32.b5197f93.js rename to assets/js/32.8cd1a0f9.js index 1006d3d9..bbfcfa27 100644 --- a/assets/js/32.b5197f93.js +++ b/assets/js/32.8cd1a0f9.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[32],{471:function(s,t,a){s.exports=a.p+"assets/img/event-loop.08b77931.png"},552:function(s,t,a){"use strict";a.r(t);var n=a(10),e=Object(n.a)({},(function(){var s=this,t=s._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[t("header-table"),s._v(" "),t("h1",{attrs:{id:"page-frontmatter-title"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#page-frontmatter-title"}},[s._v("#")]),s._v(" "+s._s(s.$page.frontmatter.title))]),s._v(" "),t("h2",{attrs:{id:"下準備"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#下準備"}},[s._v("#")]),s._v(" 下準備")]),s._v(" "),t("h3",{attrs:{id:"dockerコンテナの立ち上げ方"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#dockerコンテナの立ち上げ方"}},[s._v("#")]),s._v(" dockerコンテナの立ち上げ方")]),s._v(" "),t("p",[s._v("以下のコマンドでdockerコンテナを立ち上げてログインしてください。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" run --name bootcamp-node --rm -it regunorf/bootcamp-node "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("bash")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("同じdockerコンテナに複数のターミナルを接続するには以下のようにします。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("exec")]),s._v(" -it bootcamp-node "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("bash")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("ハンズオンでは同じコンテナに複数ターミナルでログインしていることを前提に記述している部分があるので、上記のように複数ターミナルを開いておいてください。")]),s._v(" "),t("h2",{attrs:{id:"node-js-とは"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#node-js-とは"}},[s._v("#")]),s._v(" Node.js とは")]),s._v(" "),t("p",[s._v("Node.js はサーバサイドで動作するJavaScriptのエンジンです。従来ブラウザ上でWebページを動的に動かすために使われていたJavaScriptを、ブラウザ上だけでなくサーバ上でも動かすためNode.jsなどが生まれました。")]),s._v(" "),t("p",[s._v("ブラウザ以外で動作するJavaScriptの実装としてはほかにもRhinoなどがあります。\n最近ではTypeScriptがそのまま動作する "),t("a",{attrs:{href:"https://github.com/denoland/deno",target:"_blank",rel:"noopener noreferrer"}},[s._v("Deno"),t("OutboundLink")],1),s._v(" も登場しています。")]),s._v(" "),t("p",[s._v("Node.jsの特徴としては、何よりもまず実装全体がイベント駆動で動作するという点です。これを説明するにはまずC10K問題から話をする必要があります。少し長くなりますが、Node.jsの立ち位置を知るためには必要なので簡単に解説します。")]),s._v(" "),t("h3",{attrs:{id:"c10k-問題"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#c10k-問題"}},[s._v("#")]),s._v(" C10K 問題")]),s._v(" "),t("p",[s._v("Webサーバーは当然の事ながらたくさんのユーザーからのアクセスに答えて、HTMLを返したりサーバーサイドのプログラム（C言語やJavaやRubyなどで書かれた）を動かしてレスポンスを返す必要があります。その際に１つ１つ順番に処理していたのではキリがないため、たくさんのアクセスを並列に処理する必要があります。")]),s._v(" "),t("p",[s._v("プログラムを並列に動かすやり方はいくつかありますが、たとえばApacheではスレッド・プロセスベースの並列処理が主要でした。\n1つのリクエストに対してOSのプロセスを立ち上げ、それぞれのプロセスで別々のプログラムを動かすことで大量のリクエストをさばくことができます。\nしかし1つのサーバ上で起動できるプロセスの数には限度があります。そのためたとえば1万人の同時リクエストを1台のサーバで（処理能力に余裕があったとしても）さばけないのが問題となりました。\nプロセスを起動すること自体のオーバーヘッドも無視できません。")]),s._v(" "),t("p",[s._v("インターネットが普及して利用者が増えたことや、IoTなど大量の小さなデータを送信する機会が増えたことで、より効率の良い方法が求められました。")]),s._v(" "),t("h3",{attrs:{id:"イベント駆動"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#イベント駆動"}},[s._v("#")]),s._v(" イベント駆動")]),s._v(" "),t("p",[s._v("C10K 問題に対してNode.jsは「イベントループ」と「ノンブロッキングI/O」の２つの仕様で解決しています。下の図はイベントループとノンブロッキングI/Oを組み合わせたNode.jsにおける並行処理の概念図です。")]),s._v(" "),t("p",[t("img",{attrs:{src:a(471),alt:"イベントループ",title:"イベントループ"}})]),s._v(" "),t("p",[s._v("まずNode.jsは基本的にシングルスレッドで動作します。Node.jsは動作中常にイベントループと呼ばれる無限ループで「diskへの書き込みが終わった」「リクエストを受けとった」のようなイベントの発生を監視しています。そして検知したイベントに対して指定されたcallback関数を実行します。")]),s._v(" "),t("p",[s._v("このようにイベントの発生に対して処理を行うプログラムを「イベント駆動型」と呼びます。")]),s._v(" "),t("p",[s._v("またNode.jsにおいて、diskへの書き込みやネットワークアクセスなど時間のかかる処理は全て非同期に実行されます。つまりdiskへの書き込みを始めた時点でプログラムは他の処理を始め、書き込みが行われている間別の処理を実行します。\nそして「書き込みが完了した」というイベントが発生すると続きの処理を行います。")]),s._v(" "),t("p",[s._v("この非同期な処理はノンブロッキングIOと呼ばれます。")]),s._v(" "),t("p",[s._v("このようにNode.jsは「イベントループ」と「ノンブロッキングI/O」の２つによってシングルスレッドで多くのリクエストを並行して処理することで、C10K問題におけるスレッドの割り当てコストを解決しています。")]),s._v(" "),t("p",[s._v("ただし逆に気をつけないといけない点は、Node.jsはシングルスレッドで動作するため、CPUを多く使うような重たい処理を行うとアプリケーション全体が遅くなってしまうことです。\nその点スレッドプログラミングでは、あるスレッドがどれだけ重くなっても他のスレッドには影響がないためアプリケーション全体のパフォーマンスが落ちることはありません。")]),s._v(" "),t("h2",{attrs:{id:"first-step"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#first-step"}},[s._v("#")]),s._v(" first step")]),s._v(" "),t("p",[s._v("まずは簡単なWebサーバを作ってみましょう。")]),s._v(" "),t("p",[s._v("下準備で立ち上げたdockerに入り、"),t("code",[s._v("bootcamp-node")]),s._v("というディレクトリを作成してください。\nそしてそのディレクトリ内に以下のファイルを"),t("code",[s._v("app.js")]),s._v("という名前で作成してください。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v("mkdir bootcamp-node\ncd bootcamp-node/\nvi app.js\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("div",{staticClass:"language-javascript line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-javascript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" http "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'http'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" hostname "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'127.0.0.1'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" port "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3000")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" server "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" http"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("createServer")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("statusCode "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("200")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("setHeader")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Type'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'text/plain'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("end")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Hello World\\n'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\nserver"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("listen")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("port"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" hostname"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n console"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("log")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token template-string"}},[t("span",{pre:!0,attrs:{class:"token template-punctuation string"}},[s._v("`")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("Server running at http://")]),t("span",{pre:!0,attrs:{class:"token interpolation"}},[t("span",{pre:!0,attrs:{class:"token interpolation-punctuation punctuation"}},[s._v("${")]),s._v("hostname"),t("span",{pre:!0,attrs:{class:"token interpolation-punctuation punctuation"}},[s._v("}")])]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token interpolation"}},[t("span",{pre:!0,attrs:{class:"token interpolation-punctuation punctuation"}},[s._v("${")]),s._v("port"),t("span",{pre:!0,attrs:{class:"token interpolation-punctuation punctuation"}},[s._v("}")])]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("/")]),t("span",{pre:!0,attrs:{class:"token template-punctuation string"}},[s._v("`")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br")])]),t("p",[s._v("ファイルを作成したら以下のコマンドでサーバーを起動します。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("node")]),s._v(" app.js\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[t("code",[s._v("Server running at http://127.0.0.1:3000/")]),s._v("というメッセージが表示されれば無事にサーバーが立ち上がっています。curlコマンドでリクエストを投げてみましょう。"),t("code",[s._v("Hello World")]),s._v(" が表示されたはずです。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" http://127.0.0.1:3000/\nHello World\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("h3",{attrs:{id:"簡単な解説"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#簡単な解説"}},[s._v("#")]),s._v(" 簡単な解説")]),s._v(" "),t("p",[s._v("この短いコードでもNode.jsの特徴が出ています。コード中の")]),s._v(" "),t("div",{staticClass:"language-javascript line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-javascript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" server "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" http"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("createServer")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("statusCode "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("200")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("setHeader")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Type'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'text/plain'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("end")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Hello World\\n'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br")])]),t("p",[s._v("の部分は"),t("code",[s._v("createServer")]),s._v("というメソッドにcallbackとして無名関数を渡すことで、リクエストが来た際の動作を定義します。今回は"),t("code",[s._v("Hello World")]),s._v("という文字列を返すようにしました。")]),s._v(" "),t("p",[s._v("このようにNode.jsでは基本的にcallback関数を指定することでサーバーの挙動を定義して行きます。")]),s._v(" "),t("h2",{attrs:{id:"npm"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#npm"}},[s._v("#")]),s._v(" NPM")]),s._v(" "),t("p",[s._v("もう少し複雑なサーバーを作りたいところですが、素のNode.jsだと色々と機能が足りないので"),t("code",[s._v("express")]),s._v("という定番ライブラリを導入します。"),t("code",[s._v("express")]),s._v("はWebサーバーを作る際の基本的な機能を提供してくれる他、pluginとして様々な機能を組み合わせることができます。")]),s._v(" "),t("p",[s._v("Node.jsで追加ライブラリを導入するには"),t("code",[s._v("NPM (node package manager)")]),s._v("と呼ばれるパッケージマネージャを使います。npmはNode.jsをインストールすると自動的に追加されます。")]),s._v(" "),t("p",[s._v("まずは"),t("code",[s._v("bootcamp-node")]),s._v("ディレクトリ以下で"),t("code",[s._v("init")]),s._v("コマンドを実行し、npmで管理するアプリケーションの定義を作成しましょう。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("npm")]),s._v(" init\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("色々聞かれますが全てenterで構いません。最後まで行くと"),t("code",[s._v("package.json")]),s._v("というファイルが作成されます。\nnpmはパッケージマネージャですが、このようにアプリケーションのメインファイルを指定したり"),t("code",[s._v("npm script")]),s._v("と呼ばれるコマンドを登録できるなど、Node.jsアプリケーション全体の管理もしてくれます。")]),s._v(" "),t("p",[s._v("以下のコマンドでアプリケーションに"),t("code",[s._v("express")]),s._v("を追加してみましょう。")]),s._v(" "),t("p",[s._v("必要であればプロキシを設定してください。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v("npm -g config set proxy http://proxy.iiji.jp:8080\nnpm -g config set https-proxy http://proxy.iiji.jp:8080\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("npm")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("install")]),s._v(" express\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("すると"),t("code",[s._v("node_modules")]),s._v("というディレクトリ内に"),t("code",[s._v("express")]),s._v("と"),t("code",[s._v("express")]),s._v("が依存するライブラリの本体がダウンロードされ、アプリケーションから使えるようになります。")]),s._v(" "),t("p",[s._v("また"),t("code",[s._v("package.json")]),s._v("を見ると"),t("code",[s._v("dependencies")]),s._v("に"),t("code",[s._v("express")]),s._v("が追加されているのが分かります。このように依存するライブラリが"),t("code",[s._v("package.json")]),s._v("で一元管理されるため、他の場所でアプリケーションを動かそうとする場合に依存ライブラリを簡単に導入することができます。")]),s._v(" "),t("p",[s._v("npmの詳しい使い方は「npm 入門」などで検索したサイトなどを見てみてください（"),t("a",{attrs:{href:"https://docs.npmjs.com/cli-documentation/",target:"_blank",rel:"noopener noreferrer"}},[s._v("公式のドキュメント"),t("OutboundLink")],1),s._v("は非常に分かりにくいです・・・）。")]),s._v(" "),t("h2",{attrs:{id:"express-アプリケーションの作成"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#express-アプリケーションの作成"}},[s._v("#")]),s._v(" express アプリケーションの作成")]),s._v(" "),t("p",[s._v("npmでexpressを導入できたので、簡単なアプリケーションを作成してみましょう。"),t("code",[s._v("express.js")]),s._v("という名前で以下のようなファイルを作成してください。")]),s._v(" "),t("div",{staticClass:"language-javascript line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-javascript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" express "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'express'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" app "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("express")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("get")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/bootcamp1'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("send")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'BOOTCAMP 1\\n'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("get")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/bootcamp2'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("send")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'BOOTCAMP 2\\n'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("post")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/create'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("send")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Create Bootcamp\\n'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("listen")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3000")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br")])]),t("p",[s._v("修正したら先ほどと同じように"),t("code",[s._v("node express.js")]),s._v("で起動しましょう。今度はアクセスするパスやメソッドによって実行されるcallback関数が変わります。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("127.0")]),s._v(".0.1:3000/bootcamp1\nBOOTCAMP "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("127.0")]),s._v(".0.1:3000/bootcamp2\nBOOTCAMP "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("2")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" -X POST "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("127.0")]),s._v(".0.1:3000/create\nCreate Bootcamp\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br")])]),t("p",[s._v("さきほどよりも少ないコードで多くの機能が実現できました。expressは人気のフレームワークで様々なプラグインやラップしたフレームワークが作られています。\nもし興味があれば調べてみてください。")]),s._v(" "),t("h2",{attrs:{id:"データベースアクセス"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#データベースアクセス"}},[s._v("#")]),s._v(" データベースアクセス")]),s._v(" "),t("p",[s._v("最後にデータベースへのアクセスを実現してみましょう。データベースにはMongoDBを使用してみます。\n（最近はあまり言われませんが、かつてはMongoDB・Express・AngularJS・Node.jsを合わせて「MEANスタック」と呼ばれたりしていました。）")]),s._v(" "),t("p",[s._v("事前準備で作られたvagrantやdockerコンテナにはmongodbが既にinstallされています。以下のコマンドでMongoDBを起動してください。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("service")]),s._v(" mongodb start\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("node.jsからMongoDBにアクセスするために"),t("code",[s._v("mongoose")]),s._v("というライブラリを使います。\n先ほどと同じようにnpmでインストールしましょう。ついでにjsonをパースするための"),t("code",[s._v("body-parser")]),s._v("も追加します。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("npm")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("install")]),s._v(" mongoose body-parser\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("今回は"),t("code",[s._v("peoples")]),s._v("というテーブルに"),t("code",[s._v("_id")]),s._v("と"),t("code",[s._v("name")]),s._v("属性をもつドキュメントを作成し、その一覧を取得するAPIを作ってみます。")]),s._v(" "),t("p",[s._v("まずはmongooseを使うためにmodelの定義を行います。以下の内容を"),t("code",[s._v("model.js")]),s._v("として作成してください。")]),s._v(" "),t("div",{staticClass:"language-javascript line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-javascript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" mongoose "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'mongoose'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" Schema "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" mongoose"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("Schema"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// Peopleの定義")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" People "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Schema")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("name")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("type")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" String"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("true")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// MongoDBへの接続")]),s._v("\nmongoose"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("connect")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'mongodb://127.0.0.1:27017/bootcamp'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("useNewUrlParser")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("true")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// モデルをエクスポート")]),s._v("\nexports"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("People "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" mongoose"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("model")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'People'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" People"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br")])]),t("p",[s._v("次に"),t("code",[s._v("mongo.js")]),s._v("を以下のように作成してAPIを定義しましょう。")]),s._v(" "),t("div",{staticClass:"language-javascript line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-javascript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" bodyParser "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'body-parser'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" express "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'express'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" app "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("express")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" model "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'./model'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("use")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("bodyParser"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("urlencoded")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("extended")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("true")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("use")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("bodyParser"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("json")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("get")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/peoples'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n model"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("People"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("find")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("err"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" peoples")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("err"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("send")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("err"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("json")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("peoples"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("post")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/peoples'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" people "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("model"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("People")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n people"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("body"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n people"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("save")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("err")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("err"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("send")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("err"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("json")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("message")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'created!\\n'")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("listen")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3000")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br"),t("span",{staticClass:"line-number"},[s._v("23")]),t("br"),t("span",{staticClass:"line-number"},[s._v("24")]),t("br"),t("span",{staticClass:"line-number"},[s._v("25")]),t("br"),t("span",{staticClass:"line-number"},[s._v("26")]),t("br"),t("span",{staticClass:"line-number"},[s._v("27")]),t("br"),t("span",{staticClass:"line-number"},[s._v("28")]),t("br"),t("span",{staticClass:"line-number"},[s._v("29")]),t("br"),t("span",{staticClass:"line-number"},[s._v("30")]),t("br")])]),t("p",[t("code",[s._v("node mongo.js")]),s._v("でサーバーを起動してください。そして別のウィンドウから以下のようにcurlでリクエストを投げることができます。")]),s._v(" "),t("p",[t("code",[s._v("name=Alice")]),s._v("なデータを作成")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" -X POST -H "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Type:application/json'")]),s._v(" -d "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('\'{"name": "Alice"}\'')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("127.0")]),s._v(".0.1:3000/peoples\n\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"message"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"created!"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("p",[s._v("一覧で取得")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("127.0")]),s._v(".0.1:3000/peoples\n\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"_id"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"5cf3f435a47f5c0cdb9023a6"')]),s._v(","),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Alice"')]),s._v(","),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"__v"')]),s._v(":0"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("h2",{attrs:{id:"最後に"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#最後に"}},[s._v("#")]),s._v(" 最後に")]),s._v(" "),t("p",[s._v("ここまで簡単なNode.jsを使ったAPIサーバーの実装を行ってみました。なんとなくNode.jsのやり方が掴めたでしょうか。")]),s._v(" "),t("p",[s._v("ただし実際のプロダクトで使用する場合は、TypeScriptを使って開発したりAPIのcallback関数を別ファイルにする、ロギングの仕組みを整えるなど様々なことを考える必要があります。")]),s._v(" "),t("p",[s._v("今回の内容は本当に基礎的なものでしかないため、もし興味があれば様々なフレームワークや実装例を調べてみてください。")]),s._v(" "),t("credit-footer")],1)}),[],!1,null,null,null);t.default=e.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[32],{471:function(s,t,a){s.exports=a.p+"assets/img/event-loop.08b77931.png"},553:function(s,t,a){"use strict";a.r(t);var n=a(10),e=Object(n.a)({},(function(){var s=this,t=s._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[t("header-table"),s._v(" "),t("h1",{attrs:{id:"page-frontmatter-title"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#page-frontmatter-title"}},[s._v("#")]),s._v(" "+s._s(s.$page.frontmatter.title))]),s._v(" "),t("h2",{attrs:{id:"下準備"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#下準備"}},[s._v("#")]),s._v(" 下準備")]),s._v(" "),t("h3",{attrs:{id:"dockerコンテナの立ち上げ方"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#dockerコンテナの立ち上げ方"}},[s._v("#")]),s._v(" dockerコンテナの立ち上げ方")]),s._v(" "),t("p",[s._v("以下のコマンドでdockerコンテナを立ち上げてログインしてください。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" run --name bootcamp-node --rm -it regunorf/bootcamp-node "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("bash")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("同じdockerコンテナに複数のターミナルを接続するには以下のようにします。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("exec")]),s._v(" -it bootcamp-node "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("bash")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("ハンズオンでは同じコンテナに複数ターミナルでログインしていることを前提に記述している部分があるので、上記のように複数ターミナルを開いておいてください。")]),s._v(" "),t("h2",{attrs:{id:"node-js-とは"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#node-js-とは"}},[s._v("#")]),s._v(" Node.js とは")]),s._v(" "),t("p",[s._v("Node.js はサーバサイドで動作するJavaScriptのエンジンです。従来ブラウザ上でWebページを動的に動かすために使われていたJavaScriptを、ブラウザ上だけでなくサーバ上でも動かすためNode.jsなどが生まれました。")]),s._v(" "),t("p",[s._v("ブラウザ以外で動作するJavaScriptの実装としてはほかにもRhinoなどがあります。\n最近ではTypeScriptがそのまま動作する "),t("a",{attrs:{href:"https://github.com/denoland/deno",target:"_blank",rel:"noopener noreferrer"}},[s._v("Deno"),t("OutboundLink")],1),s._v(" も登場しています。")]),s._v(" "),t("p",[s._v("Node.jsの特徴としては、何よりもまず実装全体がイベント駆動で動作するという点です。これを説明するにはまずC10K問題から話をする必要があります。少し長くなりますが、Node.jsの立ち位置を知るためには必要なので簡単に解説します。")]),s._v(" "),t("h3",{attrs:{id:"c10k-問題"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#c10k-問題"}},[s._v("#")]),s._v(" C10K 問題")]),s._v(" "),t("p",[s._v("Webサーバーは当然の事ながらたくさんのユーザーからのアクセスに答えて、HTMLを返したりサーバーサイドのプログラム（C言語やJavaやRubyなどで書かれた）を動かしてレスポンスを返す必要があります。その際に１つ１つ順番に処理していたのではキリがないため、たくさんのアクセスを並列に処理する必要があります。")]),s._v(" "),t("p",[s._v("プログラムを並列に動かすやり方はいくつかありますが、たとえばApacheではスレッド・プロセスベースの並列処理が主要でした。\n1つのリクエストに対してOSのプロセスを立ち上げ、それぞれのプロセスで別々のプログラムを動かすことで大量のリクエストをさばくことができます。\nしかし1つのサーバ上で起動できるプロセスの数には限度があります。そのためたとえば1万人の同時リクエストを1台のサーバで（処理能力に余裕があったとしても）さばけないのが問題となりました。\nプロセスを起動すること自体のオーバーヘッドも無視できません。")]),s._v(" "),t("p",[s._v("インターネットが普及して利用者が増えたことや、IoTなど大量の小さなデータを送信する機会が増えたことで、より効率の良い方法が求められました。")]),s._v(" "),t("h3",{attrs:{id:"イベント駆動"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#イベント駆動"}},[s._v("#")]),s._v(" イベント駆動")]),s._v(" "),t("p",[s._v("C10K 問題に対してNode.jsは「イベントループ」と「ノンブロッキングI/O」の２つの仕様で解決しています。下の図はイベントループとノンブロッキングI/Oを組み合わせたNode.jsにおける並行処理の概念図です。")]),s._v(" "),t("p",[t("img",{attrs:{src:a(471),alt:"イベントループ",title:"イベントループ"}})]),s._v(" "),t("p",[s._v("まずNode.jsは基本的にシングルスレッドで動作します。Node.jsは動作中常にイベントループと呼ばれる無限ループで「diskへの書き込みが終わった」「リクエストを受けとった」のようなイベントの発生を監視しています。そして検知したイベントに対して指定されたcallback関数を実行します。")]),s._v(" "),t("p",[s._v("このようにイベントの発生に対して処理を行うプログラムを「イベント駆動型」と呼びます。")]),s._v(" "),t("p",[s._v("またNode.jsにおいて、diskへの書き込みやネットワークアクセスなど時間のかかる処理は全て非同期に実行されます。つまりdiskへの書き込みを始めた時点でプログラムは他の処理を始め、書き込みが行われている間別の処理を実行します。\nそして「書き込みが完了した」というイベントが発生すると続きの処理を行います。")]),s._v(" "),t("p",[s._v("この非同期な処理はノンブロッキングIOと呼ばれます。")]),s._v(" "),t("p",[s._v("このようにNode.jsは「イベントループ」と「ノンブロッキングI/O」の２つによってシングルスレッドで多くのリクエストを並行して処理することで、C10K問題におけるスレッドの割り当てコストを解決しています。")]),s._v(" "),t("p",[s._v("ただし逆に気をつけないといけない点は、Node.jsはシングルスレッドで動作するため、CPUを多く使うような重たい処理を行うとアプリケーション全体が遅くなってしまうことです。\nその点スレッドプログラミングでは、あるスレッドがどれだけ重くなっても他のスレッドには影響がないためアプリケーション全体のパフォーマンスが落ちることはありません。")]),s._v(" "),t("h2",{attrs:{id:"first-step"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#first-step"}},[s._v("#")]),s._v(" first step")]),s._v(" "),t("p",[s._v("まずは簡単なWebサーバを作ってみましょう。")]),s._v(" "),t("p",[s._v("下準備で立ち上げたdockerに入り、"),t("code",[s._v("bootcamp-node")]),s._v("というディレクトリを作成してください。\nそしてそのディレクトリ内に以下のファイルを"),t("code",[s._v("app.js")]),s._v("という名前で作成してください。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v("mkdir bootcamp-node\ncd bootcamp-node/\nvi app.js\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("div",{staticClass:"language-javascript line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-javascript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" http "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'http'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" hostname "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'127.0.0.1'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" port "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3000")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" server "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" http"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("createServer")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("statusCode "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("200")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("setHeader")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Type'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'text/plain'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("end")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Hello World\\n'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\nserver"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("listen")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("port"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" hostname"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n console"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("log")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token template-string"}},[t("span",{pre:!0,attrs:{class:"token template-punctuation string"}},[s._v("`")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("Server running at http://")]),t("span",{pre:!0,attrs:{class:"token interpolation"}},[t("span",{pre:!0,attrs:{class:"token interpolation-punctuation punctuation"}},[s._v("${")]),s._v("hostname"),t("span",{pre:!0,attrs:{class:"token interpolation-punctuation punctuation"}},[s._v("}")])]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token interpolation"}},[t("span",{pre:!0,attrs:{class:"token interpolation-punctuation punctuation"}},[s._v("${")]),s._v("port"),t("span",{pre:!0,attrs:{class:"token interpolation-punctuation punctuation"}},[s._v("}")])]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("/")]),t("span",{pre:!0,attrs:{class:"token template-punctuation string"}},[s._v("`")])]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br")])]),t("p",[s._v("ファイルを作成したら以下のコマンドでサーバーを起動します。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("node")]),s._v(" app.js\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[t("code",[s._v("Server running at http://127.0.0.1:3000/")]),s._v("というメッセージが表示されれば無事にサーバーが立ち上がっています。curlコマンドでリクエストを投げてみましょう。"),t("code",[s._v("Hello World")]),s._v(" が表示されたはずです。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" http://127.0.0.1:3000/\nHello World\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("h3",{attrs:{id:"簡単な解説"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#簡単な解説"}},[s._v("#")]),s._v(" 簡単な解説")]),s._v(" "),t("p",[s._v("この短いコードでもNode.jsの特徴が出ています。コード中の")]),s._v(" "),t("div",{staticClass:"language-javascript line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-javascript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" server "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" http"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("createServer")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("statusCode "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("200")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("setHeader")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Type'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'text/plain'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("end")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Hello World\\n'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br")])]),t("p",[s._v("の部分は"),t("code",[s._v("createServer")]),s._v("というメソッドにcallbackとして無名関数を渡すことで、リクエストが来た際の動作を定義します。今回は"),t("code",[s._v("Hello World")]),s._v("という文字列を返すようにしました。")]),s._v(" "),t("p",[s._v("このようにNode.jsでは基本的にcallback関数を指定することでサーバーの挙動を定義して行きます。")]),s._v(" "),t("h2",{attrs:{id:"npm"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#npm"}},[s._v("#")]),s._v(" NPM")]),s._v(" "),t("p",[s._v("もう少し複雑なサーバーを作りたいところですが、素のNode.jsだと色々と機能が足りないので"),t("code",[s._v("express")]),s._v("という定番ライブラリを導入します。"),t("code",[s._v("express")]),s._v("はWebサーバーを作る際の基本的な機能を提供してくれる他、pluginとして様々な機能を組み合わせることができます。")]),s._v(" "),t("p",[s._v("Node.jsで追加ライブラリを導入するには"),t("code",[s._v("NPM (node package manager)")]),s._v("と呼ばれるパッケージマネージャを使います。npmはNode.jsをインストールすると自動的に追加されます。")]),s._v(" "),t("p",[s._v("まずは"),t("code",[s._v("bootcamp-node")]),s._v("ディレクトリ以下で"),t("code",[s._v("init")]),s._v("コマンドを実行し、npmで管理するアプリケーションの定義を作成しましょう。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("npm")]),s._v(" init\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("色々聞かれますが全てenterで構いません。最後まで行くと"),t("code",[s._v("package.json")]),s._v("というファイルが作成されます。\nnpmはパッケージマネージャですが、このようにアプリケーションのメインファイルを指定したり"),t("code",[s._v("npm script")]),s._v("と呼ばれるコマンドを登録できるなど、Node.jsアプリケーション全体の管理もしてくれます。")]),s._v(" "),t("p",[s._v("以下のコマンドでアプリケーションに"),t("code",[s._v("express")]),s._v("を追加してみましょう。")]),s._v(" "),t("p",[s._v("必要であればプロキシを設定してください。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v("npm -g config set proxy http://proxy.iiji.jp:8080\nnpm -g config set https-proxy http://proxy.iiji.jp:8080\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("npm")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("install")]),s._v(" express\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("すると"),t("code",[s._v("node_modules")]),s._v("というディレクトリ内に"),t("code",[s._v("express")]),s._v("と"),t("code",[s._v("express")]),s._v("が依存するライブラリの本体がダウンロードされ、アプリケーションから使えるようになります。")]),s._v(" "),t("p",[s._v("また"),t("code",[s._v("package.json")]),s._v("を見ると"),t("code",[s._v("dependencies")]),s._v("に"),t("code",[s._v("express")]),s._v("が追加されているのが分かります。このように依存するライブラリが"),t("code",[s._v("package.json")]),s._v("で一元管理されるため、他の場所でアプリケーションを動かそうとする場合に依存ライブラリを簡単に導入することができます。")]),s._v(" "),t("p",[s._v("npmの詳しい使い方は「npm 入門」などで検索したサイトなどを見てみてください（"),t("a",{attrs:{href:"https://docs.npmjs.com/cli-documentation/",target:"_blank",rel:"noopener noreferrer"}},[s._v("公式のドキュメント"),t("OutboundLink")],1),s._v("は非常に分かりにくいです・・・）。")]),s._v(" "),t("h2",{attrs:{id:"express-アプリケーションの作成"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#express-アプリケーションの作成"}},[s._v("#")]),s._v(" express アプリケーションの作成")]),s._v(" "),t("p",[s._v("npmでexpressを導入できたので、簡単なアプリケーションを作成してみましょう。"),t("code",[s._v("express.js")]),s._v("という名前で以下のようなファイルを作成してください。")]),s._v(" "),t("div",{staticClass:"language-javascript line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-javascript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" express "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'express'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" app "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("express")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("get")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/bootcamp1'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("send")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'BOOTCAMP 1\\n'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("get")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/bootcamp2'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("send")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'BOOTCAMP 2\\n'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("post")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/create'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("send")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Create Bootcamp\\n'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("listen")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3000")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br")])]),t("p",[s._v("修正したら先ほどと同じように"),t("code",[s._v("node express.js")]),s._v("で起動しましょう。今度はアクセスするパスやメソッドによって実行されるcallback関数が変わります。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("127.0")]),s._v(".0.1:3000/bootcamp1\nBOOTCAMP "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("127.0")]),s._v(".0.1:3000/bootcamp2\nBOOTCAMP "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("2")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" -X POST "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("127.0")]),s._v(".0.1:3000/create\nCreate Bootcamp\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br")])]),t("p",[s._v("さきほどよりも少ないコードで多くの機能が実現できました。expressは人気のフレームワークで様々なプラグインやラップしたフレームワークが作られています。\nもし興味があれば調べてみてください。")]),s._v(" "),t("h2",{attrs:{id:"データベースアクセス"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#データベースアクセス"}},[s._v("#")]),s._v(" データベースアクセス")]),s._v(" "),t("p",[s._v("最後にデータベースへのアクセスを実現してみましょう。データベースにはMongoDBを使用してみます。\n（最近はあまり言われませんが、かつてはMongoDB・Express・AngularJS・Node.jsを合わせて「MEANスタック」と呼ばれたりしていました。）")]),s._v(" "),t("p",[s._v("事前準備で作られたvagrantやdockerコンテナにはmongodbが既にinstallされています。以下のコマンドでMongoDBを起動してください。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("service")]),s._v(" mongodb start\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("node.jsからMongoDBにアクセスするために"),t("code",[s._v("mongoose")]),s._v("というライブラリを使います。\n先ほどと同じようにnpmでインストールしましょう。ついでにjsonをパースするための"),t("code",[s._v("body-parser")]),s._v("も追加します。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("npm")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("install")]),s._v(" mongoose body-parser\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("p",[s._v("今回は"),t("code",[s._v("peoples")]),s._v("というテーブルに"),t("code",[s._v("_id")]),s._v("と"),t("code",[s._v("name")]),s._v("属性をもつドキュメントを作成し、その一覧を取得するAPIを作ってみます。")]),s._v(" "),t("p",[s._v("まずはmongooseを使うためにmodelの定義を行います。以下の内容を"),t("code",[s._v("model.js")]),s._v("として作成してください。")]),s._v(" "),t("div",{staticClass:"language-javascript line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-javascript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" mongoose "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'mongoose'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" Schema "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" mongoose"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("Schema"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// Peopleの定義")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" People "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("Schema")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("name")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("type")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" String"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("true")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// MongoDBへの接続")]),s._v("\nmongoose"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("connect")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'mongodb://127.0.0.1:27017/bootcamp'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("useNewUrlParser")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("true")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("// モデルをエクスポート")]),s._v("\nexports"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("People "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" mongoose"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("model")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'People'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" People"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br")])]),t("p",[s._v("次に"),t("code",[s._v("mongo.js")]),s._v("を以下のように作成してAPIを定義しましょう。")]),s._v(" "),t("div",{staticClass:"language-javascript line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-javascript"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" bodyParser "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'body-parser'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" express "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'express'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" app "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("express")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" model "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("require")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'./model'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("use")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("bodyParser"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("urlencoded")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("extended")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("true")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("use")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("bodyParser"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("json")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("get")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/peoples'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n model"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("People"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("find")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("err"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" peoples")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("err"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("send")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("err"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("json")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("peoples"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("post")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/peoples'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" res")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("const")]),s._v(" people "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("new")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("model"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("People")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n people"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" req"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("body"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("name"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\n people"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("save")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token parameter"}},[s._v("err")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=>")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("err"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("send")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("err"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("json")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token literal-property property"}},[s._v("message")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'created!\\n'")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n\napp"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("listen")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3000")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(";")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br"),t("span",{staticClass:"line-number"},[s._v("23")]),t("br"),t("span",{staticClass:"line-number"},[s._v("24")]),t("br"),t("span",{staticClass:"line-number"},[s._v("25")]),t("br"),t("span",{staticClass:"line-number"},[s._v("26")]),t("br"),t("span",{staticClass:"line-number"},[s._v("27")]),t("br"),t("span",{staticClass:"line-number"},[s._v("28")]),t("br"),t("span",{staticClass:"line-number"},[s._v("29")]),t("br"),t("span",{staticClass:"line-number"},[s._v("30")]),t("br")])]),t("p",[t("code",[s._v("node mongo.js")]),s._v("でサーバーを起動してください。そして別のウィンドウから以下のようにcurlでリクエストを投げることができます。")]),s._v(" "),t("p",[t("code",[s._v("name=Alice")]),s._v("なデータを作成")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" -X POST -H "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'Content-Type:application/json'")]),s._v(" -d "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('\'{"name": "Alice"}\'')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("127.0")]),s._v(".0.1:3000/peoples\n\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"message"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"created!"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("p",[s._v("一覧で取得")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("curl")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("127.0")]),s._v(".0.1:3000/peoples\n\n"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"_id"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"5cf3f435a47f5c0cdb9023a6"')]),s._v(","),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"name"')]),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v(":")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Alice"')]),s._v(","),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"__v"')]),s._v(":0"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("h2",{attrs:{id:"最後に"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#最後に"}},[s._v("#")]),s._v(" 最後に")]),s._v(" "),t("p",[s._v("ここまで簡単なNode.jsを使ったAPIサーバーの実装を行ってみました。なんとなくNode.jsのやり方が掴めたでしょうか。")]),s._v(" "),t("p",[s._v("ただし実際のプロダクトで使用する場合は、TypeScriptを使って開発したりAPIのcallback関数を別ファイルにする、ロギングの仕組みを整えるなど様々なことを考える必要があります。")]),s._v(" "),t("p",[s._v("今回の内容は本当に基礎的なものでしかないため、もし興味があれば様々なフレームワークや実装例を調べてみてください。")]),s._v(" "),t("credit-footer")],1)}),[],!1,null,null,null);t.default=e.exports}}]); \ No newline at end of file diff --git a/assets/js/33.af6ac3d9.js b/assets/js/33.7b62fcf9.js similarity index 99% rename from assets/js/33.af6ac3d9.js rename to assets/js/33.7b62fcf9.js index c7bc6451..bb8e74e9 100644 --- a/assets/js/33.af6ac3d9.js +++ b/assets/js/33.7b62fcf9.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[33],{487:function(s,t,a){s.exports=a.p+"assets/img/figure1.959b588c.png"},557:function(s,t,a){"use strict";a.r(t);var n=a(10),e=Object(n.a)({},(function(){var s=this,t=s._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[t("header-table"),s._v(" "),t("h1",{attrs:{id:"page-frontmatter-title"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#page-frontmatter-title"}},[s._v("#")]),s._v(" "+s._s(s.$page.frontmatter.title))]),s._v(" "),t("h1",{attrs:{id:"目次"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#目次"}},[s._v("#")]),s._v(" 目次")]),s._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB"}},[s._v("はじめに")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E6%A6%82%E8%AB%96"}},[s._v("概論")]),s._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"#%E3%81%AA%E3%81%9C%E3%83%86%E3%82%B9%E3%83%88%E3%82%92%E8%A1%8C%E3%81%86%E3%81%AE%E3%81%8B"}},[s._v("なぜテストを行うのか")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E5%8A%B9%E7%8E%87%E7%9A%84%E3%81%AA%E3%83%86%E3%82%B9%E3%83%88%E3%81%A8%E3%81%AF"}},[s._v("効率的なテストとは")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E3%81%84%E3%81%A4%E3%83%86%E3%82%B9%E3%83%88%E3%82%92%E4%BD%9C%E3%82%8B%E3%81%AE%E3%81%8B"}},[s._v("いつテストを作るのか")])])])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E6%BA%96%E5%82%99"}},[s._v("準備")]),s._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"#docker%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%81%AE%E7%AB%8B%E3%81%A1%E4%B8%8A%E3%81%92%E6%96%B9"}},[s._v("dockerコンテナの立ち上げ方")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E5%AE%9F%E8%A1%8C%E6%96%B9%E6%B3%95"}},[s._v("テストの実行")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E9%96%A2%E6%95%B0%E3%83%BB%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E4%BF%AE%E6%AD%A3%E6%96%B9%E6%B3%95"}},[s._v("関数・テストの修正方法")])])])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E3%83%86%E3%82%B9%E3%83%88%E3%82%92%E5%AE%9F%E8%A1%8C%E3%81%99%E3%82%8B"}},[s._v("テストを実行する")]),s._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"#%E5%90%8C%E5%80%A4%E3%82%AF%E3%83%A9%E3%82%B9%E3%83%BB%E5%A2%83%E7%95%8C%E5%80%A4%E3%83%86%E3%82%B9%E3%83%88"}},[s._v("同値クラス・境界値テスト")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#api%E3%81%A8%E9%96%A2%E6%95%B0%E3%81%AE%E3%83%A2%E3%83%83%E3%82%AF"}},[s._v("APIと関数のモック")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#tdd%E3%82%92%E3%82%84%E3%81%A3%E3%81%A6%E3%81%BF%E3%82%8B"}},[s._v("TDDをやってみる")])])])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB"}},[s._v("おわりに")])])]),s._v(" "),t("br"),s._v(" "),t("h1",{attrs:{id:"はじめに"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#はじめに"}},[s._v("#")]),s._v(" はじめに")]),s._v(" "),t("p",[s._v("本講義はdockerを使用します。"),t("br"),s._v("\ndockerコンテナのpullには時間を要するため、概論の聴講と並行して「準備 ⇒ "),t("a",{attrs:{href:"#docker%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%81%AE%E7%AB%8B%E3%81%A1%E4%B8%8A%E3%81%92%E6%96%B9"}},[s._v("dockerコンテナの立ち上げ方")]),s._v("」を実施することを推奨します。")]),s._v(" "),t("br"),s._v(" "),t("h1",{attrs:{id:"概論"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#概論"}},[s._v("#")]),s._v(" 概論")]),s._v(" "),t("h2",{attrs:{id:"なぜテストを行うのか"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#なぜテストを行うのか"}},[s._v("#")]),s._v(" なぜテストを行うのか")]),s._v(" "),t("p",[s._v("昨今ではIT技術が普及し、炊飯器・電子レンジ・洗濯機といった身の回りのものから、航空機や車など、普段の生活に必須になるものにまで。ソフトウェアが使用されています。"),t("br"),s._v("\nまた、世の中に流通しているソフトウェアはテストが実施されており、その挙動で問題が起こらないことを保証されています。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("例えばソフトウェアに対し、テストを行われていないと仮定して、個人的に運営しているブログなどで不具合が発生した場合はどうなるでしょうか。"),t("br"),s._v("\nその不具合によってサーバがダウンしている間は、運営者に広告費が入らないなど、ある程度小規模で済みます。"),t("br"),s._v("\n（ブログ収益で生計を立てている場合、致命的ですが。）")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("例えば自動車や医療機器などで不具合が発生してしまった場合、どうなるでしょうか。"),t("br"),s._v("\n最悪の場合、ブレーキが効かない、医療機器のレーザーの出力が多すぎたなど、ソフトウェアの欠陥によって人命が失われてしまう可能性もあります。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("上記2つの例を上げましたが、大なり小なり、ソフトウェアの不具合によって、どこかの誰かが被害を被ってしまいます。"),t("br"),s._v("\nそのため、自身が作成するプログラムでは必ず動作のテストを行い、極力不具合を発生させないソフトウェアを作ることを目指す必要があります。")]),s._v(" "),t("br"),s._v(" "),t("h2",{attrs:{id:"効率的なテストとは"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#効率的なテストとは"}},[s._v("#")]),s._v(" 効率的なテストとは")]),s._v(" "),t("p",[s._v("テストを作成する場合には、不具合をなくすことも重要ですが、テストにコストをかけないことも重要になります。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("例えば、あるプロダクトに使用される、以下のような仕様の関数"),t("code",[s._v("f(x)")]),s._v("があるとします。")]),s._v(" "),t("ul",[t("li",[s._v("関数"),t("code",[s._v("f")]),s._v("は、任意の数字"),t("code",[s._v("x")]),s._v("の値を取ります。")]),s._v(" "),t("li",[s._v("任意の数字"),t("code",[s._v("x")]),s._v("は、int型であり、 "),t("em",[s._v("-2,147,483,648")]),s._v(" から "),t("em",[s._v("2,147,483,647")]),s._v(" の範囲の値を格納できます。")]),s._v(" "),t("li",[s._v("関数"),t("code",[s._v("f")]),s._v("は、与えられた数字が "),t("em",[s._v("0")]),s._v(" から "),t("em",[s._v("100")]),s._v(" の間であれば"),t("code",[s._v("True")]),s._v("、そうでなければ"),t("code",[s._v("False")]),s._v("を返却します。")])]),s._v(" "),t("p",[s._v("上記の"),t("code",[s._v("f(x)")]),s._v("の挙動を100%確かめるためには、 "),t("em",[s._v("4,294,967,296")]),s._v(" 件のテストを行わなければなりません。"),t("br"),s._v("\nしかし、実際のプロダクトを作成する場合、1つの関数に対し40億回もテストを実施してしまうと、プロダクトの売上以上に人件費や計算機の運用コストがかかってしまい、会社は倒産の危機に瀕してしまいます。")]),s._v(" "),t("p",[s._v("そのため、後述する「同値クラス・境界値テスト」などの手法によって、最低限かつ最適な回数でテストを行うことが求められます。")]),s._v(" "),t("br"),s._v(" "),t("h2",{attrs:{id:"いつテストを作るのか"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#いつテストを作るのか"}},[s._v("#")]),s._v(" いつテストを作るのか")]),s._v(" "),t("p",[s._v("開発を行う際、ウォーターフォール型の開発では、下記の流れになるかと思います。"),t("br"),s._v("\n右下向きの矢印が設計工程、中央が開発工程、右上向きの矢印がテスト工程になります。")]),s._v(" "),t("p",[t("img",{attrs:{src:a(487),alt:"figure1.png",title:"figure1"}})]),s._v(" "),t("p",[s._v("設計における各要素は、テスト工程の各要素に対応することになります。"),t("br"),s._v("\n例えば、まずは要求定義を行い、ソフトウェアに必要な要件を決めますが、この時点で明確な要件が定義できているのであれば、システムテストで実施するテスト項目を作成しておくことができます。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("このように各設計段階でテスト項目を作成することで、要件に沿ったテストを作成することができます。"),t("br"),s._v("\n（何年も開発を行っているとわかるのですが、ものを作ってからテストを作成すると、「今動くものを通すテスト」を無意識的に書いてしまい、要件も網羅できないテストを作ってしまう傾向が出てきます。）")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("また、後述するTDD（テスト駆動開発）のように、テストを作成して開発を進める手法もあります。"),t("br"),s._v("\n今回のハンズオンではコーディング・単体テスト段階で実施するテストプログラミングをやってみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h1",{attrs:{id:"準備"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#準備"}},[s._v("#")]),s._v(" 準備")]),s._v(" "),t("h2",{attrs:{id:"dockerコンテナの立ち上げ方"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#dockerコンテナの立ち上げ方"}},[s._v("#")]),s._v(" dockerコンテナの立ち上げ方")]),s._v(" "),t("p",[s._v("下記のコマンドでdockerコンテナを立ち上げます。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# リポジトリのクローン")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("git")]),s._v(" clone git@github.com:iij/bootcamp.git\n$ "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("cd")]),s._v(" bootcamp/src/server-app/test-hands-on\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# コンテナの立ち上げ")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker-compose")]),s._v(" up --build\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br")])]),t("br"),s._v(" "),t("h2",{attrs:{id:"テストの実行方法"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テストの実行方法"}},[s._v("#")]),s._v(" テストの実行方法")]),s._v(" "),t("p",[s._v("この項では、任意の「"),t("a",{attrs:{href:"#%E3%83%86%E3%82%B9%E3%83%88%E3%82%92%E5%AE%9F%E8%A1%8C%E3%81%99%E3%82%8B"}},[s._v("テストを実行する")]),s._v("」の項のテストを実行します。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("「"),t("a",{attrs:{href:"#docker%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%81%AE%E7%AB%8B%E3%81%A1%E4%B8%8A%E3%81%92%E6%96%B9"}},[s._v("dockerコンテナの立ち上げ方")]),s._v("」で、起動中のコンソールとは別のコンソールを開き、実行中のコンテナにアクセスします。"),t("br"),s._v("\nコマンドを実行すると、コンテナ内のbashが実行されます。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("cd")]),s._v(" bootcamp/src/server-app/test-hands-on\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker-compose")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("exec")]),s._v(" bootcamp-test "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("bash")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("下記のコマンドで、テストを実行してみましょう。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v('# ソースは全て"/test-hands-on"配下にあります。')]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("cd")]),s._v(" /test-hands-on\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 任意のテストを実行します。")]),s._v("\n$ python -m unittest -v exercises.exercise0.test_challenge\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br")])]),t("br"),s._v(" "),t("h2",{attrs:{id:"関数・テストの修正方法"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#関数・テストの修正方法"}},[s._v("#")]),s._v(" 関数・テストの修正方法")]),s._v(" "),t("p",[s._v("「テストの実行方法」の項でテストを行うと、初回は下記のようにテストが失敗してしまいます。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v exercises.exercise0.test_challenge\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("exercises.exercise0.test_challenge.HelloTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". FAIL\n\n"),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v("\nFAIL: test_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("exercises.exercise0.test_challenge.HelloTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n----------------------------------------------------------------------\nTraceback "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("most recent call last"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(":\n File "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/test-hands-on/exercises/exercise0/test_challenge.py"')]),s._v(", line "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("7")]),s._v(", "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("in")]),s._v(" test_success\n self.assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("hello"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(", "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"goodbye world?"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\nAssertionError: "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello world"')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("!=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"goodbye world?"')]),s._v("\n- hello world\n+ goodbye world?\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("試しに、このテストを修正してみましょう。\nテストソースである、 "),t("code",[s._v("/test-hands-on/exercises/exercise0/test_challenge.py")]),s._v(" を開いてみます。")]),s._v(" "),t("p",[s._v("内容は下記のようになっており、ソース内でimportしている "),t("code",[s._v("hello()")]),s._v(' 関数に対し、文字列"goodbye world?"が来ることを期待してテストを行っているようです。')]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("challenge "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" hello\n\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("HelloTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_success")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("hello"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"goodbye world?"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("では、テスト対象である "),t("code",[s._v("hello()")]),s._v(" 関数を見てみましょう。"),t("br"),s._v('\nどうやら、この関数は文字列"hello world"を返すようです。')]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("hello")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello world"')]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("しかし、これではテストソースで期待されている関数の返り値と、実際の関数の返り値が異なってしまっています。"),t("br"),s._v('\nこれがテストが失敗してしまう原因となるため、テストの期待する値を"goodbye world?"から"hello world"に変えてみましょう。')]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("challenge "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" hello\n\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("HelloTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_success")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("hello"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello world"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("p",[s._v("このテストを実行してみると、先程まで失敗していたテストが成功しました。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("python -m unittest -v exercises.exercise0.test_challenge\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("exercises.exercise0.test_challenge.HelloTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n\n----------------------------------------------------------------------\nRan "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("test")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("in")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v(".000s\n\nOK\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("このように、テストソースというものは、テストを実施したい関数に対して動作を確認するように作成・実行します。")]),s._v(" "),t("p",[s._v("本講義では、テストを実施したい関数に対し、テストソースで期待する返り値を設定し、関数の動作確認を行っていきます。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("ちなみに、ローカルのソースファイルの変更は、コンテナ内にも自動で同期されます。"),t("br"),s._v("\n以降はローカルでファイルを変更し、コンテナ内でテストを実行してみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h1",{attrs:{id:"テストを実行する"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テストを実行する"}},[s._v("#")]),s._v(" テストを実行する")]),s._v(" "),t("h2",{attrs:{id:"_1-同値クラス・境界値テスト"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#_1-同値クラス・境界値テスト"}},[s._v("#")]),s._v(" 1. 同値クラス・境界値テスト")]),s._v(" "),t("p",[s._v("この項では「同値クラステスト」と「境界値テスト」という手法のテストを実施し、効率的なテストについて学びます。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"同値クラステストとは"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#同値クラステストとは"}},[s._v("#")]),s._v(" 同値クラステストとは")]),s._v(" "),t("p",[s._v("同値クラステストとは「任意の関数"),t("code",[s._v("g(x)")]),s._v("の引数"),t("code",[s._v("x")]),s._v("に対し、有効である値、無効である値のグループ（有効同値クラス、無効同値クラス）を定義してテストを実施する」ものになります。")]),s._v(" "),t("p",[s._v("例えば、本書の冒頭で出てきた、関数"),t("code",[s._v("f(x)")]),s._v("では、"),t("code",[s._v("x")]),s._v("の値が "),t("em",[s._v("0")]),s._v(" から "),t("em",[s._v("100")]),s._v(" の間であれば有効同値クラス、そうでなければ無効同値クラス、と定義できます。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v("関数fは、任意の数字xの値を取ります。\n任意の数字xは、int型であり、 -2,147,483,648 から 2,147,483,647 の範囲の値を格納できます。\n関数fは、与えられた数字が 0 から 100 の間であればTrue、そうでなければFalseを返却します。\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("p",[s._v("仮に「有効同値クラス内の値が入力された場合は正常終了、無効同値クラス内の値が入力された場合は異常終了する」と見た場合、終了の仕方は「正常終了か異常終了か」の2択と見ることができます。")]),s._v(" "),t("p",[s._v("すなわち、関数"),t("code",[s._v("f(x)")]),s._v("に対する同値クラステストとは、有効同値である "),t("em",[s._v("10")]),s._v(" , "),t("em",[s._v("50")]),s._v(" , "),t("em",[s._v("90")]),s._v(" など、いくつかの値のグループと、無効同値である "),t("em",[s._v("-500")]),s._v(" , "),t("em",[s._v("-10")]),s._v(" , "),t("em",[s._v("110")]),s._v(" , "),t("em",[s._v("500")]),s._v(" などの値のグループのテストを実施すればよいことになります。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"境界値テストとは"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#境界値テストとは"}},[s._v("#")]),s._v(" 境界値テストとは")]),s._v(" "),t("p",[s._v("同値クラステストでは「有効/無効と定義した値に対する処理が正しく動くか」を確認できました。")]),s._v(" "),t("p",[s._v("しかし、これでは「有効/無効の範囲は正しいか」が確認できていません。"),t("br"),s._v("\nこういった場合は境界値テストを実施し、有効値/無効値の境界が、正しく実行されるかのテストを行います。")]),s._v(" "),t("p",[s._v("本書冒頭の関数"),t("code",[s._v("f(x)")]),s._v("を例にすると、下限の境界値は "),t("em",[s._v("-1")]),s._v(" , "),t("em",[s._v("0")]),s._v(" 、上限の境界値は "),t("em",[s._v("100")]),s._v(" , "),t("em",[s._v("101")]),s._v(" となります。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"テスト実装例"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テスト実装例"}},[s._v("#")]),s._v(" テスト実装例")]),s._v(" "),t("p",[s._v("本書冒頭で定義した、関数"),t("code",[s._v("f(x)")]),s._v("がPythonで以下のように定義されているとします。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("f")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("x"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("<=")]),s._v(" x "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("<=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("100")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("else")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("上記の関数に対し、同値クラスのテストを定義すると、下記のように書くことができます。"),t("br"),s._v("\n下記のテストでは、関数"),t("code",[s._v("f(x)")]),s._v("に有効同値クラスの値を入力すると"),t("code",[s._v("True")]),s._v("、そうでない値を入力すると"),t("code",[s._v("False")]),s._v("が返却されることを確認しています。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_equivalence_partitioning")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 有効同値のテスト")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("10")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("50")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("90")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 無効同値のテスト")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("-")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("500")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("-")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("10")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("110")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("500")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("境界値テストを定義すると、下記のように書くことができます。"),t("br"),s._v("\n下記のテストでは、関数"),t("code",[s._v("f(x)")]),s._v("に下限の境界値 "),t("em",[s._v("-1")]),s._v(" , "),t("em",[s._v("0")]),s._v(" 、上限の境界値 "),t("em",[s._v("100")]),s._v(" , "),t("em",[s._v("101")]),s._v(" を入力し、適宜"),t("code",[s._v("True")]),s._v("か"),t("code",[s._v("False")]),s._v("が返却されることを確認しています。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_equivalence_partitioning")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 下限の境界値")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("-")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 上限の境界値")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("100")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("101")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"問題にチャレンジしよう"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#問題にチャレンジしよう"}},[s._v("#")]),s._v(" 問題にチャレンジしよう")]),s._v(" "),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise1/challenge.py")]),s._v("に、商品の申し込みを行う関数"),t("code",[s._v("apply(quantity)")]),s._v("が定義されています。")]),s._v(" "),t("p",[s._v("関数は以下の仕様になっています。")]),s._v(" "),t("ul",[t("li",[s._v("この関数は、int型の引数"),t("code",[s._v("quantity")]),s._v("を取ります。")]),s._v(" "),t("li",[s._v("関数"),t("code",[s._v("apply()")]),s._v("は、10以上、100以下の値が入力されると、申し込みが成功し、文字列"),t("code",[s._v('"accepted"')]),s._v("が返却されます。")]),s._v(" "),t("li",[s._v("申し込みに失敗した場合は、文字列"),t("code",[s._v('"not accepted"')]),s._v("が返却されます。")]),s._v(" "),t("li",[s._v("int型以外のデータが入力された場合、例外"),t("code",[s._v("TypeError()")]),s._v("が発生し、プログラムが異常終了します。")])]),s._v(" "),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise1/test_challenge.py")]),s._v("に、作成途中のテストクラス"),t("code",[s._v("ApplyTestCase")]),s._v("が定義されているため、関数"),t("code",[s._v("apply(quantity)")]),s._v("に対するテストを作成してみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h2",{attrs:{id:"_2-apiと関数のモック"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#_2-apiと関数のモック"}},[s._v("#")]),s._v(" 2. APIと関数のモック")]),s._v(" "),t("p",[s._v("この項では、Pythonで実行できるAPI（FastAPI）のフレームワークを使用し、APIに対するテストや、関数のモックに触れてみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"モックとは"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#モックとは"}},[s._v("#")]),s._v(" モックとは")]),s._v(" "),t("p",[s._v("「モックアップ」の略称であり、工業製品などの試作や、店頭展示などのためにつくられる実物大模型のことを指します。"),t("br"),s._v("\n「"),t("a",{attrs:{href:"https://dictionary.goo.ne.jp/word/%e3%83%a2%e3%83%83%e3%82%af%e3%82%a2%e3%83%83%e3%83%97/",target:"_blank",rel:"noopener noreferrer"}},[s._v("goo辞書 モックアップ（mock-up）"),t("OutboundLink")],1),s._v("」より")]),s._v(" "),t("p",[s._v("テストにおけるモックとは、主にクラスや関数の動作をシミュレートするためのオブジェクトになります。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("例えば、以下のような仕様の関数"),t("code",[s._v("rock_paper_scissors(shoot)")]),s._v("があるとします。")]),s._v(" "),t("ul",[t("li",[s._v("関数"),t("code",[s._v("rock_paper_scissors(shoot)")]),s._v("は、じゃんけんを行う関数で、引数"),t("code",[s._v("shoot")]),s._v('は文字列"rock", "paper", "scissors"の、いずれかを取ります。')]),s._v(" "),t("li",[s._v("関数"),t("code",[s._v("rock_paper_scissors()")]),s._v("は、内部で引数に対してじゃんけんの手を出す関数"),t("code",[s._v("my_shoot()")]),s._v("が実行されます。")]),s._v(" "),t("li",[s._v("関数"),t("code",[s._v("my_shoot()")]),s._v("は、それぞれ "),t("em",[s._v("1/3")]),s._v(' の確率で"rock", "paper", "scissors"のいずれかを取得します。')]),s._v(" "),t("li",[s._v("関数"),t("code",[s._v("rock_paper_scissors()")]),s._v("は、入力された引数"),t("code",[s._v("shoot")]),s._v("が、関数"),t("code",[s._v("my_shoot()")]),s._v("の返り値に勝利できる場合 "),t("em",[s._v("1")]),s._v(" 、引き分けであれば "),t("em",[s._v("0")]),s._v(" 、敗北であれば "),t("em",[s._v("-1")]),s._v(" を返します。")])]),s._v(" "),t("p",[s._v("上記の関数"),t("code",[s._v("rock_paper_scissors()")]),s._v("をテストする場合、内部の関数の返り値が乱数で決定されてしまうため、通常であればテストが実行できません。"),t("br"),s._v("\n（例えば、1回目の"),t("code",[s._v("my_shoot()")]),s._v('を実行した時に"rock"が返却されたとしても、2回目も"rock"が返却されるとは限らないですよね）')]),s._v(" "),t("p",[s._v("こういった場合、関数のモックを使用して、テスト対象の関数内で使用されているクラスや関数をモックし、返り値を固定してシミュレーションを行う必要があります。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"テスト実装例-2"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テスト実装例-2"}},[s._v("#")]),s._v(" テスト実装例")]),s._v(" "),t("p",[s._v("関数"),t("code",[s._v("rock_paper_scissors(shoot)")]),s._v("が、Pythonで以下のように定義されているとします。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("rock_paper_scissors")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("shoot"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v('# 1/3で"rock", "paper", "scissors"が格納される')]),s._v("\n my_shoot_result "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" my_shoot"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# あいこ")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" shoot "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" my_shoot_result"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n \n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 勝利")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" shoot "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("and")]),s._v(" my_shoot_result "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"scissors"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" shoot "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"paper"')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("and")]),s._v(" my_shoot_result "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" shoot "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"scissors"')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("and")]),s._v(" my_shoot_result "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"paper"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n \n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 敗北")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("-")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("上記の関数に対し、モックを使用したテストを定義すると、下記のように書くことができます。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" unittest "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" mock\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 関数rock_paper_scissors(), my_shoot()は、exampleパッケージに含まれているとする")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" example\n\nrock_paper_scissors "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" example"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("rock_paper_scissors\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_rock_paper_scissors")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# あいこのテスト")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("with")]),s._v(" mock"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("patch"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("object")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'my_shoot'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" return_value"),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("rock_paper_scissors"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n \n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 勝利のテスト")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("with")]),s._v(" mock"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("patch"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("object")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'my_shoot'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" return_value"),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"scissors"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("rock_paper_scissors"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 敗北のテスト")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("with")]),s._v(" mock"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("patch"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("object")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'my_shoot'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" return_value"),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"paper"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("rock_paper_scissors"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("-")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"fastapiについて"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#fastapiについて"}},[s._v("#")]),s._v(" FastAPIについて")]),s._v(" "),t("p",[s._v("IIJ Bootcamp「FastAPI でwebアプリを作る」にて紹介されているため、詳細の説明は省きます。")]),s._v(" "),t("p",[s._v("下記「テスト実装例」にサンプルを記載するように、簡単にAPIを実装できるフレームワークになっています。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"テスト実装例-3"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テスト実装例-3"}},[s._v("#")]),s._v(" テスト実装例")]),s._v(" "),t("p",[s._v("FastAPIは、下記のようにAPIを実装できます。"),t("br"),s._v("\n下記は、ブラウザで"),t("code",[s._v("http://localhost:8000/hello")]),s._v("にアクセスすると、データ"),t("code",[s._v('{"response": "hello"}')]),s._v("を返却します。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" fastapi "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" FastAPI\n\napp "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" FastAPI"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token decorator annotation punctuation"}},[s._v("@app"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("get")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/hello"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("async")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("get_hello")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"response"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("上記のAPIに対し、HTTPステータスやレスポンスを検証するテストは、下記のように書くことができます。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_api")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v('# パス"/hello"に接続する')]),s._v("\n res "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" client"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("get"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/hello"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# HTTPステータスと、レスポンスの取得")]),s._v("\n status "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("status_code\n data "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("json"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# HTTPステータスと、レスポンスの検証")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("status"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("200")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("data"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"response"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"問題にチャレンジしよう-2"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#問題にチャレンジしよう-2"}},[s._v("#")]),s._v(" 問題にチャレンジしよう")]),s._v(" "),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise2/challenge.py")]),s._v("に、FastAPIと、いくつかのエンドポイントが定義されています。")]),s._v(" "),t("p",[s._v("上記のAPIは、コンテナから下記のコマンドで実行することができます。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python3 -m uvicorn exercises.exercise2.challenge:app --reload --host "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"0.0.0.0"')]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("API実行後は、ブラウザに下記のURLを入力すると、APIにアクセスできます。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v("http://localhost:8000/\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("また、APIは下記のエンドポイントがあります。")]),s._v(" "),t("table",[t("thead",[t("tr",[t("th",[s._v("パス")]),s._v(" "),t("th",[s._v("詳細")])])]),s._v(" "),t("tbody",[t("tr",[t("td",[s._v("/")]),s._v(" "),t("td",[t("code",[s._v('{"message": "hello world"}')]),s._v("が返却されます。")])]),s._v(" "),t("tr",[t("td",[s._v("/echo/{data}")]),s._v(" "),t("td",[t("code",[s._v('{"message": "got the message: {data}"}')]),s._v("が返却されます。"),t("br"),s._v("※"),t("code",[s._v("{data}")]),s._v("は、任意の値が代入されます。")])]),s._v(" "),t("tr",[t("td",[s._v("/gacha")]),s._v(" "),t("td",[t("code",[s._v('{"message": "{result}"')]),s._v("が返却されます。"),t("br"),s._v("※"),t("code",[s._v("{result}")]),s._v("は、 "),t("em",[s._v("1/100")]),s._v(' で文字列"you win"、それ以外で文字列"you lose"が代入されます。')])])])]),s._v(" "),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise2/test_challenge.py")]),s._v("に、作成途中のテストクラス"),t("code",[s._v("ApiTestCase")]),s._v("が定義されているため、上記の仕様のAPIに対するテストを作成してみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h2",{attrs:{id:"_3-tddをやってみる"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#_3-tddをやってみる"}},[s._v("#")]),s._v(" 3. TDDをやってみる")]),s._v(" "),t("p",[s._v("TDDとは、「テスト駆動開発( "),t("em",[s._v("Test-Driven")]),s._v(" )」のことを指し「テストファースト（テスト優先）」を掲げて開発を行う、 "),t("strong",[s._v("開発手法")]),s._v(" のことになります。")]),s._v(" "),t("p",[s._v("テスト手法じゃないよ !!!!")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"tddのやり方"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#tddのやり方"}},[s._v("#")]),s._v(" TDDのやり方")]),s._v(" "),t("p",[s._v("TDDは、任意の開発を行う設計があるうえで、下記のサイクルで開発を行っていきます。")]),s._v(" "),t("ol",[t("li",[s._v("Red\n"),t("ul",[t("li",[s._v("動作をしないテストを書く。")])])]),s._v(" "),t("li",[s._v("Green\n"),t("ul",[t("li",[s._v("迅速に、テストを実行できるコードを書いてテストを通すようにする。"),t("br"),s._v("\n※コードが汚くても良い。")])])]),s._v(" "),t("li",[s._v("Refactoring\n"),t("ul",[t("li",[s._v("リファクタリングを行い、コード内から重複を削除する。")])])])]),s._v(" "),t("p",[s._v("上記 "),t("em",[s._v("1~3")]),s._v(" のサイクルを実行し、動きつつコードとリファクタリングによって最適化されたコードを、着実に作っていく手法になります。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"テスト実装例-4"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テスト実装例-4"}},[s._v("#")]),s._v(" テスト実装例")]),s._v(" "),t("p",[s._v("この項で実際に、TDDのサイクルを見てみましょう。")]),s._v(" "),t("p",[s._v("例えば、以下の仕様のソースを作りたいとします。")]),s._v(" "),t("ul",[t("li",[s._v("クラス内の"),t("code",[s._v("do()")]),s._v('関数の、実行回数が3の倍数なら"Fizz"、5の倍数なら"Buzz"を返す、クラス'),t("code",[s._v("FizzBuzz")]),s._v("を実装します。")]),s._v(" "),t("li",[s._v("このクラスは"),t("code",[s._v("do()")]),s._v("の実行回数を、内部でカウントします。")]),s._v(" "),t("li",[s._v("3でも5の倍数でもないカウントに対しては、そのカウントを返します。")])]),s._v(" "),t("p",[s._v("上記のコードをTDDで作成していきましょう。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル1-red"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル1-red"}},[s._v("#")]),s._v(" サイクル1 Red")]),s._v(" "),t("p",[s._v("まずは、クラス"),t("code",[s._v("FizzBuzz")]),s._v("の関数を作成します。"),t("br"),s._v("\n下記のコードは、"),t("code",[s._v("example.py")]),s._v("のようなパッケージにあると考えてください。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("pass")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("次に、動作をしないテストを書きましょう。"),t("br"),s._v(" "),t("code",[s._v("do()")]),s._v("が最初に実行する時は、下記の仕様が適用されます。")]),s._v(" "),t("blockquote",[t("p",[s._v("3でも5の倍数でもないカウントに対しては、そのカウントを返します。")])]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("とりあえず1回目の実行では「1」が返ってくるはずなので、テストでは「1」を期待してみます。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("fizzbuzz "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" FizzBuzz\n\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_success")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n fb "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" FizzBuzz"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("これを実行すると、当然のようにコケますね。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". FAIL\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル1-green"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル1-green"}},[s._v("#")]),s._v(" サイクル1 Green")]),s._v(" "),t("p",[s._v("次は「とりあえず動くコードを書く」ことをします。"),t("br"),s._v("\nテストでは1が返却されることを期待しているので、1を返しましょう。"),t("br"),s._v("\nTDDって簡単ですね。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("動いたよ！！！！やったね！！！！！！！！！")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル1-refactoring"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル1-refactoring"}},[s._v("#")]),s._v(" サイクル1 Refactoring")]),s._v(" "),t("p",[s._v("現在の"),t("code",[s._v("FizzBuzz")]),s._v("は、この世界に存在するどんなものよりも洗練されているため、リファクタリングは必要ないですね。"),t("br"),s._v("\n素晴らしい。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル2-red"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル2-red"}},[s._v("#")]),s._v(" サイクル2 Red")]),s._v(" "),t("p",[s._v("2サイクル目に来ました。"),t("br"),s._v("\nRedでは、あえてテストを失敗させなければならないため、泣く泣く完成されたテストコードに手を加えましょう。")]),s._v(" "),t("p",[s._v("サイクル1 Redでも確認した通り、どうやら"),t("code",[s._v("do()")]),s._v("を実行するごとに実行回数を返してくれるそうです。"),t("br"),s._v("\n実行回数毎に、期待する値を増加させてみましょう。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("fizzbuzz "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" FizzBuzz\n\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_success")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n fb "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" FizzBuzz"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("2")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("4")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("5")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("6")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("7")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("8")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("9")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("10")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("11")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("12")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("13")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("14")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("15")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br")])]),t("br"),s._v(" "),t("p",[t("code",[s._v("FizzBuzz")]),s._v("は既に完成されているため、テストをいくら加えようが失敗するはずがないのですが、試してみましょう。"),t("br"),s._v("\nまあ、やる意味はないと思うのですが（笑）")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". FAIL\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル2-green"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル2-green"}},[s._v("#")]),s._v(" サイクル2 Green")]),s._v(" "),t("p",[s._v("なんということでしょうか。"),t("br"),s._v("\n完成されていたと思われた"),t("code",[s._v("do()")]),s._v("は、何回実行しても「1」しか返してくれないではないですか。")]),s._v(" "),t("p",[s._v("誰ですか、こんな実装にしたのは（怒）")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("global")]),s._v(" count\n count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" count\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("だいぶ雑なコードですが、たぶん動くと思うからテストしましょう。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル2-refactoring"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル2-refactoring"}},[s._v("#")]),s._v(" サイクル2 Refactoring")]),s._v(" "),t("p",[s._v("現在の"),t("code",[s._v("FizzBuzz")]),s._v("はグローバル変数が使用されているなど、あまり美しくありません。"),t("br"),s._v("\nクラスで値を持たせて、インスタンス毎に値を共有させないようにしましょう。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("__init__")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("コードを変更しましたが、テストの結果が成功のままであることを確認します。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル3-red"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル3-red"}},[s._v("#")]),s._v(" サイクル3 Red")]),s._v(" "),t("p",[s._v("さて、ここまでで以下の仕様を実装することができました。")]),s._v(" "),t("ul",[t("li",[s._v("内部でカウントを保持する。")]),s._v(" "),t("li",[s._v("3でも5でもないカウントは、その値を返す。")])]),s._v(" "),t("br"),s._v(" "),t("p",[s._v('次は「3の倍数なら"Fizz"を返す」を実装してみましょう。')]),s._v(" "),t("p",[s._v("失敗するテストを書きます。\nテスト全体を書くと文字量が多くなりますので、以降は差分で表記します。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v('- self.assertEqual(fb.do(), 3)\n+ self.assertEqual(fb.do(), "Fizz")\n\n- self.assertEqual(fb.do(), 6)\n+ self.assertEqual(fb.do(), "Fizz")\n\n- self.assertEqual(fb.do(), 9)\n+ self.assertEqual(fb.do(), "Fizz")\n\n- self.assertEqual(fb.do(), 12)\n+ self.assertEqual(fb.do(), "Fizz")\n\n- self.assertEqual(fb.do(), 15)\n+ self.assertEqual(fb.do(), "Fizz")\n')])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("テストは失敗しますね。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". FAIL\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル3-green"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル3-green"}},[s._v("#")]),s._v(" サイクル3 Green")]),s._v(" "),t("p",[s._v('さて、"Fizz"を返せるように'),t("code",[s._v("FizzBuzz")]),s._v("を修正しましょう。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("__init__")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("%")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Fizz"')]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("テストはオールグリーンです。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル3-refactoring"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル3-refactoring"}},[s._v("#")]),s._v(" サイクル3 Refactoring")]),s._v(" "),t("p",[s._v("特にリファクタリング箇所がないので省きます。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル4-red"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル4-red"}},[s._v("#")]),s._v(" サイクル4 Red")]),s._v(" "),t("p",[s._v("最後の仕様になります。"),t("br"),s._v('\n最後は「5の倍数なら"Buzz"を返す」を実装します。')]),s._v(" "),t("p",[s._v('ただし、3かつ5の倍数であれば"FizzBuzz"が返ることに注意してください。')]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v('- self.assertEqual(fb.do(), 5)\n+ self.assertEqual(fb.do(), "Buzz")\n\n- self.assertEqual(fb.do(), 10)\n+ self.assertEqual(fb.do(), "Buzz")\n\n- self.assertEqual(fb.do(), 15)\n+ self.assertEqual(fb.do(), "FizzBuzz")\n')])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("「手がかかる子ほど可愛い」というのは、このことを言うのでしょうか。"),t("br"),s._v("\nだんだんコンソールに出力される「FAIL」が愛おしく思えてきました。")]),s._v(" "),t("p",[s._v("きっと「失敗の後は必ず成功する」ということが約束されているからでしょう。")]),s._v(" "),t("p",[s._v("みなさんも、そう思いませんか？")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". FAIL\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル4-green"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル4-green"}},[s._v("#")]),s._v(" サイクル4 Green")]),s._v(" "),t("p",[s._v('"Buzz"および"FizzBuzz"を返せるようにしましょう。')]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("__init__")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("%")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("15")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"FizzBuzz"')]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("%")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Fizz"')]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("%")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("5")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Buzz"')]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("テストも通ります。"),t("br"),s._v("\nやったか！？（まだ終わりじゃないです。）")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル4-refactoring"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル4-refactoring"}},[s._v("#")]),s._v(" サイクル4 Refactoring")]),s._v(" "),t("p",[s._v("最後のリファクタリングになります。"),t("br"),s._v("\nこれで全てを終わらせて、あなたは次のステージへ進むことになるでしょう。")]),s._v(" "),t("p",[s._v("先程書いた"),t("code",[s._v("FizzBuzz")]),s._v("では、まだ手続きを共通化し、最適にできる部分があります。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#####################################")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# このコードは一例です。")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# みんなが読みやすいコードを書こうね！")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#####################################")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("__init__")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("_divided")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" count"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" div"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("int")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("not")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("%")]),s._v(" div"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n result "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Fizz"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Buzz"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"FizzBuzz"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n index "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("_divided"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("5")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("<<")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" \\\n "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("_divided"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" result"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),s._v("index"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("多分これが一番美しいと思います。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"問題にチャレンジしよう-3"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#問題にチャレンジしよう-3"}},[s._v("#")]),s._v(" 問題にチャレンジしよう")]),s._v(" "),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise3/challenge.py")]),s._v("には、FastAPIで書かれた作りかけのAPIがあります。")]),s._v(" "),t("p",[s._v("上記のAPIは、コンテナから下記のコマンドで実行することができます。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python3 -m uvicorn exercises.exercise3.challenge:app --reload --host "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"0.0.0.0"')]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("API実行後は、ブラウザに下記のURLを入力すると、APIにアクセスできます。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v("http://localhost:8000/\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("みなさんには、TDDを使って上記のAPIを完成させてもらいます。"),t("br"),s._v("\n作ってもらいたいAPIの仕様は、下記のものになります。")]),s._v(" "),t("ul",[t("li",[s._v("このAPIは、"),t("code",[s._v("/, /add, /sub, /mul, /div")]),s._v("の5つのエンドポイントがあります。")]),s._v(" "),t("li",[s._v("このAPIはサーバ内部でint型の値を保持し、現在設定されている値を"),t("code",[s._v("/")]),s._v("にアクセスすることで、確認することができます。\nまた、値は0始まりになります。")]),s._v(" "),t("li",[t("code",[s._v("/add, /sub, /mul, /div")]),s._v("にパスパラメータを与えると、保持されている値に対し、四則演算を行います（後述）。")]),s._v(" "),t("li",[s._v("本APIでは、全てint型で計算を行います。")])]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("以下、APIのパスについて")]),s._v(" "),t("table",[t("thead",[t("tr",[t("th",[s._v("パス")]),s._v(" "),t("th",[s._v("詳細")])])]),s._v(" "),t("tbody",[t("tr",[t("td",[s._v("/")]),s._v(" "),t("td",[t("code",[s._v('{"current_number": {数値}}')]),s._v("が返却されます。"),t("br"),s._v("{数値}には、サーバで保持されている値が入ります。")])]),s._v(" "),t("tr",[t("td",[s._v("/add/{data}")]),s._v(" "),t("td",[t("code",[s._v('{"current_number": {数値}}')]),s._v("が返却されます。"),t("br"),s._v("{data}に渡された値をサーバで保持している値に加算します。")])]),s._v(" "),t("tr",[t("td",[s._v("/sub/{data}")]),s._v(" "),t("td",[t("code",[s._v('{"current_number": {数値}}')]),s._v("が返却されます。"),t("br"),s._v("{data}に渡された値をサーバで保持している値から減算します。")])]),s._v(" "),t("tr",[t("td",[s._v("/mul/{data}")]),s._v(" "),t("td",[t("code",[s._v('{"current_number": {数値}}')]),s._v("が返却されます。"),t("br"),s._v("{data}に渡された値をサーバで保持している値に乗算します。")])]),s._v(" "),t("tr",[t("td",[s._v("/div/{data}")]),s._v(" "),t("td",[t("code",[s._v('{"current_number": {数値}}')]),s._v("が返却されます。"),t("br"),s._v("{data}に渡された値をサーバで保持している値から除算します。")])])])]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("サーバでの値の保持・取得関数は、ソース内に定義されています。"),t("br"),s._v("\n以下に、使い方の例を記載します。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# サーバ内に保持されている値を記録します。")]),s._v("\nset_current_number"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# サーバ内に保持されている値を取得します")]),s._v("\ngot_data "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" get_current_number"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# got_data = 1")]),s._v("\n\nset_current_number"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("123")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("456")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\ngot_data "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" get_current_number"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# got_data = 579")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br")])]),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise3/test_challenge.py")]),s._v("には、本APIが完成すると通るようになる、テスト"),t("code",[s._v("test_success()")]),s._v("が定義されています。")]),s._v(" "),t("p",[s._v("上記のテストがOKになるよう、各種APIをTDDを使って作成してみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h1",{attrs:{id:"おわりに"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#おわりに"}},[s._v("#")]),s._v(" おわりに")]),s._v(" "),t("p",[s._v("一般的にソフトウェアテストというと、専門のテスト部隊があって「Excelにスクショをペタペタ貼るだけでしょ？」というようなイメージを持ち、敬遠される方も少なくはないと思います。")]),s._v(" "),t("p",[s._v("開発者がテストについて知識を持ち、単体テストで可能な限りの不具合をなくしておくと、後の工程で不具合が少なく済ますことができたり、メリットがあります。"),t("br"),s._v("\nまた、後の工程で発生した不具合の内容を聞いた・見ただけで、どのモジュール同士で問題が起こっているのか目星がつくなど、効率的なトラブルシュートやソフトウェアの理解にも繋がります。")]),s._v(" "),t("p",[s._v("冒頭でも述べましたが、ソフトウェアにも品質というものがあり、この品質次第で会社の売上に影響が出たり、企業のセキュリティや人命に影響を及ぼしてしまう懸念もあります。")]),s._v(" "),t("p",[s._v("そのため。開発を行う際には是非テストにも注力をしていただき、ユーザーの満足できるソフトウェアを作れるよう、目指してみてください。")]),s._v(" "),t("p",[s._v("良いエンジニアライフを！👍")]),s._v(" "),t("credit-footer")],1)}),[],!1,null,null,null);t.default=e.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[33],{484:function(s,t,a){s.exports=a.p+"assets/img/figure1.959b588c.png"},556:function(s,t,a){"use strict";a.r(t);var n=a(10),e=Object(n.a)({},(function(){var s=this,t=s._self._c;return t("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[t("header-table"),s._v(" "),t("h1",{attrs:{id:"page-frontmatter-title"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#page-frontmatter-title"}},[s._v("#")]),s._v(" "+s._s(s.$page.frontmatter.title))]),s._v(" "),t("h1",{attrs:{id:"目次"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#目次"}},[s._v("#")]),s._v(" 目次")]),s._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB"}},[s._v("はじめに")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E6%A6%82%E8%AB%96"}},[s._v("概論")]),s._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"#%E3%81%AA%E3%81%9C%E3%83%86%E3%82%B9%E3%83%88%E3%82%92%E8%A1%8C%E3%81%86%E3%81%AE%E3%81%8B"}},[s._v("なぜテストを行うのか")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E5%8A%B9%E7%8E%87%E7%9A%84%E3%81%AA%E3%83%86%E3%82%B9%E3%83%88%E3%81%A8%E3%81%AF"}},[s._v("効率的なテストとは")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E3%81%84%E3%81%A4%E3%83%86%E3%82%B9%E3%83%88%E3%82%92%E4%BD%9C%E3%82%8B%E3%81%AE%E3%81%8B"}},[s._v("いつテストを作るのか")])])])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E6%BA%96%E5%82%99"}},[s._v("準備")]),s._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"#docker%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%81%AE%E7%AB%8B%E3%81%A1%E4%B8%8A%E3%81%92%E6%96%B9"}},[s._v("dockerコンテナの立ち上げ方")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E5%AE%9F%E8%A1%8C%E6%96%B9%E6%B3%95"}},[s._v("テストの実行")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E9%96%A2%E6%95%B0%E3%83%BB%E3%83%86%E3%82%B9%E3%83%88%E3%81%AE%E4%BF%AE%E6%AD%A3%E6%96%B9%E6%B3%95"}},[s._v("関数・テストの修正方法")])])])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E3%83%86%E3%82%B9%E3%83%88%E3%82%92%E5%AE%9F%E8%A1%8C%E3%81%99%E3%82%8B"}},[s._v("テストを実行する")]),s._v(" "),t("ul",[t("li",[t("a",{attrs:{href:"#%E5%90%8C%E5%80%A4%E3%82%AF%E3%83%A9%E3%82%B9%E3%83%BB%E5%A2%83%E7%95%8C%E5%80%A4%E3%83%86%E3%82%B9%E3%83%88"}},[s._v("同値クラス・境界値テスト")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#api%E3%81%A8%E9%96%A2%E6%95%B0%E3%81%AE%E3%83%A2%E3%83%83%E3%82%AF"}},[s._v("APIと関数のモック")])]),s._v(" "),t("li",[t("a",{attrs:{href:"#tdd%E3%82%92%E3%82%84%E3%81%A3%E3%81%A6%E3%81%BF%E3%82%8B"}},[s._v("TDDをやってみる")])])])]),s._v(" "),t("li",[t("a",{attrs:{href:"#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB"}},[s._v("おわりに")])])]),s._v(" "),t("br"),s._v(" "),t("h1",{attrs:{id:"はじめに"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#はじめに"}},[s._v("#")]),s._v(" はじめに")]),s._v(" "),t("p",[s._v("本講義はdockerを使用します。"),t("br"),s._v("\ndockerコンテナのpullには時間を要するため、概論の聴講と並行して「準備 ⇒ "),t("a",{attrs:{href:"#docker%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%81%AE%E7%AB%8B%E3%81%A1%E4%B8%8A%E3%81%92%E6%96%B9"}},[s._v("dockerコンテナの立ち上げ方")]),s._v("」を実施することを推奨します。")]),s._v(" "),t("br"),s._v(" "),t("h1",{attrs:{id:"概論"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#概論"}},[s._v("#")]),s._v(" 概論")]),s._v(" "),t("h2",{attrs:{id:"なぜテストを行うのか"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#なぜテストを行うのか"}},[s._v("#")]),s._v(" なぜテストを行うのか")]),s._v(" "),t("p",[s._v("昨今ではIT技術が普及し、炊飯器・電子レンジ・洗濯機といった身の回りのものから、航空機や車など、普段の生活に必須になるものにまで。ソフトウェアが使用されています。"),t("br"),s._v("\nまた、世の中に流通しているソフトウェアはテストが実施されており、その挙動で問題が起こらないことを保証されています。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("例えばソフトウェアに対し、テストを行われていないと仮定して、個人的に運営しているブログなどで不具合が発生した場合はどうなるでしょうか。"),t("br"),s._v("\nその不具合によってサーバがダウンしている間は、運営者に広告費が入らないなど、ある程度小規模で済みます。"),t("br"),s._v("\n（ブログ収益で生計を立てている場合、致命的ですが。）")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("例えば自動車や医療機器などで不具合が発生してしまった場合、どうなるでしょうか。"),t("br"),s._v("\n最悪の場合、ブレーキが効かない、医療機器のレーザーの出力が多すぎたなど、ソフトウェアの欠陥によって人命が失われてしまう可能性もあります。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("上記2つの例を上げましたが、大なり小なり、ソフトウェアの不具合によって、どこかの誰かが被害を被ってしまいます。"),t("br"),s._v("\nそのため、自身が作成するプログラムでは必ず動作のテストを行い、極力不具合を発生させないソフトウェアを作ることを目指す必要があります。")]),s._v(" "),t("br"),s._v(" "),t("h2",{attrs:{id:"効率的なテストとは"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#効率的なテストとは"}},[s._v("#")]),s._v(" 効率的なテストとは")]),s._v(" "),t("p",[s._v("テストを作成する場合には、不具合をなくすことも重要ですが、テストにコストをかけないことも重要になります。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("例えば、あるプロダクトに使用される、以下のような仕様の関数"),t("code",[s._v("f(x)")]),s._v("があるとします。")]),s._v(" "),t("ul",[t("li",[s._v("関数"),t("code",[s._v("f")]),s._v("は、任意の数字"),t("code",[s._v("x")]),s._v("の値を取ります。")]),s._v(" "),t("li",[s._v("任意の数字"),t("code",[s._v("x")]),s._v("は、int型であり、 "),t("em",[s._v("-2,147,483,648")]),s._v(" から "),t("em",[s._v("2,147,483,647")]),s._v(" の範囲の値を格納できます。")]),s._v(" "),t("li",[s._v("関数"),t("code",[s._v("f")]),s._v("は、与えられた数字が "),t("em",[s._v("0")]),s._v(" から "),t("em",[s._v("100")]),s._v(" の間であれば"),t("code",[s._v("True")]),s._v("、そうでなければ"),t("code",[s._v("False")]),s._v("を返却します。")])]),s._v(" "),t("p",[s._v("上記の"),t("code",[s._v("f(x)")]),s._v("の挙動を100%確かめるためには、 "),t("em",[s._v("4,294,967,296")]),s._v(" 件のテストを行わなければなりません。"),t("br"),s._v("\nしかし、実際のプロダクトを作成する場合、1つの関数に対し40億回もテストを実施してしまうと、プロダクトの売上以上に人件費や計算機の運用コストがかかってしまい、会社は倒産の危機に瀕してしまいます。")]),s._v(" "),t("p",[s._v("そのため、後述する「同値クラス・境界値テスト」などの手法によって、最低限かつ最適な回数でテストを行うことが求められます。")]),s._v(" "),t("br"),s._v(" "),t("h2",{attrs:{id:"いつテストを作るのか"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#いつテストを作るのか"}},[s._v("#")]),s._v(" いつテストを作るのか")]),s._v(" "),t("p",[s._v("開発を行う際、ウォーターフォール型の開発では、下記の流れになるかと思います。"),t("br"),s._v("\n右下向きの矢印が設計工程、中央が開発工程、右上向きの矢印がテスト工程になります。")]),s._v(" "),t("p",[t("img",{attrs:{src:a(484),alt:"figure1.png",title:"figure1"}})]),s._v(" "),t("p",[s._v("設計における各要素は、テスト工程の各要素に対応することになります。"),t("br"),s._v("\n例えば、まずは要求定義を行い、ソフトウェアに必要な要件を決めますが、この時点で明確な要件が定義できているのであれば、システムテストで実施するテスト項目を作成しておくことができます。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("このように各設計段階でテスト項目を作成することで、要件に沿ったテストを作成することができます。"),t("br"),s._v("\n（何年も開発を行っているとわかるのですが、ものを作ってからテストを作成すると、「今動くものを通すテスト」を無意識的に書いてしまい、要件も網羅できないテストを作ってしまう傾向が出てきます。）")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("また、後述するTDD（テスト駆動開発）のように、テストを作成して開発を進める手法もあります。"),t("br"),s._v("\n今回のハンズオンではコーディング・単体テスト段階で実施するテストプログラミングをやってみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h1",{attrs:{id:"準備"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#準備"}},[s._v("#")]),s._v(" 準備")]),s._v(" "),t("h2",{attrs:{id:"dockerコンテナの立ち上げ方"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#dockerコンテナの立ち上げ方"}},[s._v("#")]),s._v(" dockerコンテナの立ち上げ方")]),s._v(" "),t("p",[s._v("下記のコマンドでdockerコンテナを立ち上げます。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# リポジトリのクローン")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("git")]),s._v(" clone git@github.com:iij/bootcamp.git\n$ "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("cd")]),s._v(" bootcamp/src/server-app/test-hands-on\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# コンテナの立ち上げ")]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker-compose")]),s._v(" up --build\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br")])]),t("br"),s._v(" "),t("h2",{attrs:{id:"テストの実行方法"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テストの実行方法"}},[s._v("#")]),s._v(" テストの実行方法")]),s._v(" "),t("p",[s._v("この項では、任意の「"),t("a",{attrs:{href:"#%E3%83%86%E3%82%B9%E3%83%88%E3%82%92%E5%AE%9F%E8%A1%8C%E3%81%99%E3%82%8B"}},[s._v("テストを実行する")]),s._v("」の項のテストを実行します。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("「"),t("a",{attrs:{href:"#docker%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E3%81%AE%E7%AB%8B%E3%81%A1%E4%B8%8A%E3%81%92%E6%96%B9"}},[s._v("dockerコンテナの立ち上げ方")]),s._v("」で、起動中のコンソールとは別のコンソールを開き、実行中のコンテナにアクセスします。"),t("br"),s._v("\nコマンドを実行すると、コンテナ内のbashが実行されます。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("cd")]),s._v(" bootcamp/src/server-app/test-hands-on\n$ "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("docker-compose")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("exec")]),s._v(" bootcamp-test "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("bash")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("下記のコマンドで、テストを実行してみましょう。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v('# ソースは全て"/test-hands-on"配下にあります。')]),s._v("\n$ "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("cd")]),s._v(" /test-hands-on\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 任意のテストを実行します。")]),s._v("\n$ python -m unittest -v exercises.exercise0.test_challenge\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br")])]),t("br"),s._v(" "),t("h2",{attrs:{id:"関数・テストの修正方法"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#関数・テストの修正方法"}},[s._v("#")]),s._v(" 関数・テストの修正方法")]),s._v(" "),t("p",[s._v("「テストの実行方法」の項でテストを行うと、初回は下記のようにテストが失敗してしまいます。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v exercises.exercise0.test_challenge\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("exercises.exercise0.test_challenge.HelloTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". FAIL\n\n"),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v("\nFAIL: test_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("exercises.exercise0.test_challenge.HelloTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n----------------------------------------------------------------------\nTraceback "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("most recent call last"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(":\n File "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/test-hands-on/exercises/exercise0/test_challenge.py"')]),s._v(", line "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("7")]),s._v(", "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("in")]),s._v(" test_success\n self.assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("hello"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(", "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"goodbye world?"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\nAssertionError: "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello world"')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("!=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"goodbye world?"')]),s._v("\n- hello world\n+ goodbye world?\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("試しに、このテストを修正してみましょう。\nテストソースである、 "),t("code",[s._v("/test-hands-on/exercises/exercise0/test_challenge.py")]),s._v(" を開いてみます。")]),s._v(" "),t("p",[s._v("内容は下記のようになっており、ソース内でimportしている "),t("code",[s._v("hello()")]),s._v(' 関数に対し、文字列"goodbye world?"が来ることを期待してテストを行っているようです。')]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("challenge "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" hello\n\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("HelloTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_success")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("hello"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"goodbye world?"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("では、テスト対象である "),t("code",[s._v("hello()")]),s._v(" 関数を見てみましょう。"),t("br"),s._v('\nどうやら、この関数は文字列"hello world"を返すようです。')]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("hello")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello world"')]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("しかし、これではテストソースで期待されている関数の返り値と、実際の関数の返り値が異なってしまっています。"),t("br"),s._v('\nこれがテストが失敗してしまう原因となるため、テストの期待する値を"goodbye world?"から"hello world"に変えてみましょう。')]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("challenge "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" hello\n\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("HelloTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_success")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("hello"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello world"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("p",[s._v("このテストを実行してみると、先程まで失敗していたテストが成功しました。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("python -m unittest -v exercises.exercise0.test_challenge\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("exercises.exercise0.test_challenge.HelloTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n\n----------------------------------------------------------------------\nRan "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token builtin class-name"}},[s._v("test")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("in")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v(".000s\n\nOK\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("このように、テストソースというものは、テストを実施したい関数に対して動作を確認するように作成・実行します。")]),s._v(" "),t("p",[s._v("本講義では、テストを実施したい関数に対し、テストソースで期待する返り値を設定し、関数の動作確認を行っていきます。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("ちなみに、ローカルのソースファイルの変更は、コンテナ内にも自動で同期されます。"),t("br"),s._v("\n以降はローカルでファイルを変更し、コンテナ内でテストを実行してみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h1",{attrs:{id:"テストを実行する"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テストを実行する"}},[s._v("#")]),s._v(" テストを実行する")]),s._v(" "),t("h2",{attrs:{id:"_1-同値クラス・境界値テスト"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#_1-同値クラス・境界値テスト"}},[s._v("#")]),s._v(" 1. 同値クラス・境界値テスト")]),s._v(" "),t("p",[s._v("この項では「同値クラステスト」と「境界値テスト」という手法のテストを実施し、効率的なテストについて学びます。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"同値クラステストとは"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#同値クラステストとは"}},[s._v("#")]),s._v(" 同値クラステストとは")]),s._v(" "),t("p",[s._v("同値クラステストとは「任意の関数"),t("code",[s._v("g(x)")]),s._v("の引数"),t("code",[s._v("x")]),s._v("に対し、有効である値、無効である値のグループ（有効同値クラス、無効同値クラス）を定義してテストを実施する」ものになります。")]),s._v(" "),t("p",[s._v("例えば、本書の冒頭で出てきた、関数"),t("code",[s._v("f(x)")]),s._v("では、"),t("code",[s._v("x")]),s._v("の値が "),t("em",[s._v("0")]),s._v(" から "),t("em",[s._v("100")]),s._v(" の間であれば有効同値クラス、そうでなければ無効同値クラス、と定義できます。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v("関数fは、任意の数字xの値を取ります。\n任意の数字xは、int型であり、 -2,147,483,648 から 2,147,483,647 の範囲の値を格納できます。\n関数fは、与えられた数字が 0 から 100 の間であればTrue、そうでなければFalseを返却します。\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("p",[s._v("仮に「有効同値クラス内の値が入力された場合は正常終了、無効同値クラス内の値が入力された場合は異常終了する」と見た場合、終了の仕方は「正常終了か異常終了か」の2択と見ることができます。")]),s._v(" "),t("p",[s._v("すなわち、関数"),t("code",[s._v("f(x)")]),s._v("に対する同値クラステストとは、有効同値である "),t("em",[s._v("10")]),s._v(" , "),t("em",[s._v("50")]),s._v(" , "),t("em",[s._v("90")]),s._v(" など、いくつかの値のグループと、無効同値である "),t("em",[s._v("-500")]),s._v(" , "),t("em",[s._v("-10")]),s._v(" , "),t("em",[s._v("110")]),s._v(" , "),t("em",[s._v("500")]),s._v(" などの値のグループのテストを実施すればよいことになります。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"境界値テストとは"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#境界値テストとは"}},[s._v("#")]),s._v(" 境界値テストとは")]),s._v(" "),t("p",[s._v("同値クラステストでは「有効/無効と定義した値に対する処理が正しく動くか」を確認できました。")]),s._v(" "),t("p",[s._v("しかし、これでは「有効/無効の範囲は正しいか」が確認できていません。"),t("br"),s._v("\nこういった場合は境界値テストを実施し、有効値/無効値の境界が、正しく実行されるかのテストを行います。")]),s._v(" "),t("p",[s._v("本書冒頭の関数"),t("code",[s._v("f(x)")]),s._v("を例にすると、下限の境界値は "),t("em",[s._v("-1")]),s._v(" , "),t("em",[s._v("0")]),s._v(" 、上限の境界値は "),t("em",[s._v("100")]),s._v(" , "),t("em",[s._v("101")]),s._v(" となります。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"テスト実装例"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テスト実装例"}},[s._v("#")]),s._v(" テスト実装例")]),s._v(" "),t("p",[s._v("本書冒頭で定義した、関数"),t("code",[s._v("f(x)")]),s._v("がPythonで以下のように定義されているとします。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("f")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("x"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("<=")]),s._v(" x "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("<=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("100")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("else")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("上記の関数に対し、同値クラスのテストを定義すると、下記のように書くことができます。"),t("br"),s._v("\n下記のテストでは、関数"),t("code",[s._v("f(x)")]),s._v("に有効同値クラスの値を入力すると"),t("code",[s._v("True")]),s._v("、そうでない値を入力すると"),t("code",[s._v("False")]),s._v("が返却されることを確認しています。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_equivalence_partitioning")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 有効同値のテスト")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("10")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("50")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("90")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 無効同値のテスト")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("-")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("500")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("-")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("10")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("110")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("500")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("境界値テストを定義すると、下記のように書くことができます。"),t("br"),s._v("\n下記のテストでは、関数"),t("code",[s._v("f(x)")]),s._v("に下限の境界値 "),t("em",[s._v("-1")]),s._v(" , "),t("em",[s._v("0")]),s._v(" 、上限の境界値 "),t("em",[s._v("100")]),s._v(" , "),t("em",[s._v("101")]),s._v(" を入力し、適宜"),t("code",[s._v("True")]),s._v("か"),t("code",[s._v("False")]),s._v("が返却されることを確認しています。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_equivalence_partitioning")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 下限の境界値")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("-")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 上限の境界値")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("100")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("True")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("f"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("101")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"問題にチャレンジしよう"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#問題にチャレンジしよう"}},[s._v("#")]),s._v(" 問題にチャレンジしよう")]),s._v(" "),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise1/challenge.py")]),s._v("に、商品の申し込みを行う関数"),t("code",[s._v("apply(quantity)")]),s._v("が定義されています。")]),s._v(" "),t("p",[s._v("関数は以下の仕様になっています。")]),s._v(" "),t("ul",[t("li",[s._v("この関数は、int型の引数"),t("code",[s._v("quantity")]),s._v("を取ります。")]),s._v(" "),t("li",[s._v("関数"),t("code",[s._v("apply()")]),s._v("は、10以上、100以下の値が入力されると、申し込みが成功し、文字列"),t("code",[s._v('"accepted"')]),s._v("が返却されます。")]),s._v(" "),t("li",[s._v("申し込みに失敗した場合は、文字列"),t("code",[s._v('"not accepted"')]),s._v("が返却されます。")]),s._v(" "),t("li",[s._v("int型以外のデータが入力された場合、例外"),t("code",[s._v("TypeError()")]),s._v("が発生し、プログラムが異常終了します。")])]),s._v(" "),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise1/test_challenge.py")]),s._v("に、作成途中のテストクラス"),t("code",[s._v("ApplyTestCase")]),s._v("が定義されているため、関数"),t("code",[s._v("apply(quantity)")]),s._v("に対するテストを作成してみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h2",{attrs:{id:"_2-apiと関数のモック"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#_2-apiと関数のモック"}},[s._v("#")]),s._v(" 2. APIと関数のモック")]),s._v(" "),t("p",[s._v("この項では、Pythonで実行できるAPI（FastAPI）のフレームワークを使用し、APIに対するテストや、関数のモックに触れてみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"モックとは"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#モックとは"}},[s._v("#")]),s._v(" モックとは")]),s._v(" "),t("p",[s._v("「モックアップ」の略称であり、工業製品などの試作や、店頭展示などのためにつくられる実物大模型のことを指します。"),t("br"),s._v("\n「"),t("a",{attrs:{href:"https://dictionary.goo.ne.jp/word/%e3%83%a2%e3%83%83%e3%82%af%e3%82%a2%e3%83%83%e3%83%97/",target:"_blank",rel:"noopener noreferrer"}},[s._v("goo辞書 モックアップ（mock-up）"),t("OutboundLink")],1),s._v("」より")]),s._v(" "),t("p",[s._v("テストにおけるモックとは、主にクラスや関数の動作をシミュレートするためのオブジェクトになります。")]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("例えば、以下のような仕様の関数"),t("code",[s._v("rock_paper_scissors(shoot)")]),s._v("があるとします。")]),s._v(" "),t("ul",[t("li",[s._v("関数"),t("code",[s._v("rock_paper_scissors(shoot)")]),s._v("は、じゃんけんを行う関数で、引数"),t("code",[s._v("shoot")]),s._v('は文字列"rock", "paper", "scissors"の、いずれかを取ります。')]),s._v(" "),t("li",[s._v("関数"),t("code",[s._v("rock_paper_scissors()")]),s._v("は、内部で引数に対してじゃんけんの手を出す関数"),t("code",[s._v("my_shoot()")]),s._v("が実行されます。")]),s._v(" "),t("li",[s._v("関数"),t("code",[s._v("my_shoot()")]),s._v("は、それぞれ "),t("em",[s._v("1/3")]),s._v(' の確率で"rock", "paper", "scissors"のいずれかを取得します。')]),s._v(" "),t("li",[s._v("関数"),t("code",[s._v("rock_paper_scissors()")]),s._v("は、入力された引数"),t("code",[s._v("shoot")]),s._v("が、関数"),t("code",[s._v("my_shoot()")]),s._v("の返り値に勝利できる場合 "),t("em",[s._v("1")]),s._v(" 、引き分けであれば "),t("em",[s._v("0")]),s._v(" 、敗北であれば "),t("em",[s._v("-1")]),s._v(" を返します。")])]),s._v(" "),t("p",[s._v("上記の関数"),t("code",[s._v("rock_paper_scissors()")]),s._v("をテストする場合、内部の関数の返り値が乱数で決定されてしまうため、通常であればテストが実行できません。"),t("br"),s._v("\n（例えば、1回目の"),t("code",[s._v("my_shoot()")]),s._v('を実行した時に"rock"が返却されたとしても、2回目も"rock"が返却されるとは限らないですよね）')]),s._v(" "),t("p",[s._v("こういった場合、関数のモックを使用して、テスト対象の関数内で使用されているクラスや関数をモックし、返り値を固定してシミュレーションを行う必要があります。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"テスト実装例-2"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テスト実装例-2"}},[s._v("#")]),s._v(" テスト実装例")]),s._v(" "),t("p",[s._v("関数"),t("code",[s._v("rock_paper_scissors(shoot)")]),s._v("が、Pythonで以下のように定義されているとします。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("rock_paper_scissors")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("shoot"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v('# 1/3で"rock", "paper", "scissors"が格納される')]),s._v("\n my_shoot_result "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" my_shoot"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# あいこ")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" shoot "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" my_shoot_result"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n \n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 勝利")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" shoot "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("and")]),s._v(" my_shoot_result "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"scissors"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" shoot "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"paper"')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("and")]),s._v(" my_shoot_result "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" shoot "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"scissors"')]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("and")]),s._v(" my_shoot_result "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"paper"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n \n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 敗北")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("-")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("上記の関数に対し、モックを使用したテストを定義すると、下記のように書くことができます。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" unittest "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" mock\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 関数rock_paper_scissors(), my_shoot()は、exampleパッケージに含まれているとする")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" example\n\nrock_paper_scissors "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" example"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("rock_paper_scissors\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_rock_paper_scissors")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# あいこのテスト")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("with")]),s._v(" mock"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("patch"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("object")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'my_shoot'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" return_value"),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("rock_paper_scissors"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n \n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 勝利のテスト")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("with")]),s._v(" mock"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("patch"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("object")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'my_shoot'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" return_value"),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"scissors"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("rock_paper_scissors"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# 敗北のテスト")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("with")]),s._v(" mock"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("patch"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),t("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("object")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v("'my_shoot'")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" return_value"),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"paper"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("rock_paper_scissors"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"rock"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("-")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"fastapiについて"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#fastapiについて"}},[s._v("#")]),s._v(" FastAPIについて")]),s._v(" "),t("p",[s._v("IIJ Bootcamp「FastAPI でwebアプリを作る」にて紹介されているため、詳細の説明は省きます。")]),s._v(" "),t("p",[s._v("下記「テスト実装例」にサンプルを記載するように、簡単にAPIを実装できるフレームワークになっています。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"テスト実装例-3"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テスト実装例-3"}},[s._v("#")]),s._v(" テスト実装例")]),s._v(" "),t("p",[s._v("FastAPIは、下記のようにAPIを実装できます。"),t("br"),s._v("\n下記は、ブラウザで"),t("code",[s._v("http://localhost:8000/hello")]),s._v("にアクセスすると、データ"),t("code",[s._v('{"response": "hello"}')]),s._v("を返却します。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" fastapi "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" FastAPI\n\napp "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" FastAPI"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token decorator annotation punctuation"}},[s._v("@app"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("get")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/hello"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("async")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("get_hello")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"response"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("上記のAPIに対し、HTTPステータスやレスポンスを検証するテストは、下記のように書くことができます。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_api")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v('# パス"/hello"に接続する')]),s._v("\n res "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" client"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("get"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"/hello"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# HTTPステータスと、レスポンスの取得")]),s._v("\n status "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("status_code\n data "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" res"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("json"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# HTTPステータスと、レスポンスの検証")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("status"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("200")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("data"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"response"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"hello"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"問題にチャレンジしよう-2"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#問題にチャレンジしよう-2"}},[s._v("#")]),s._v(" 問題にチャレンジしよう")]),s._v(" "),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise2/challenge.py")]),s._v("に、FastAPIと、いくつかのエンドポイントが定義されています。")]),s._v(" "),t("p",[s._v("上記のAPIは、コンテナから下記のコマンドで実行することができます。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python3 -m uvicorn exercises.exercise2.challenge:app --reload --host "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"0.0.0.0"')]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("API実行後は、ブラウザに下記のURLを入力すると、APIにアクセスできます。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v("http://localhost:8000/\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("また、APIは下記のエンドポイントがあります。")]),s._v(" "),t("table",[t("thead",[t("tr",[t("th",[s._v("パス")]),s._v(" "),t("th",[s._v("詳細")])])]),s._v(" "),t("tbody",[t("tr",[t("td",[s._v("/")]),s._v(" "),t("td",[t("code",[s._v('{"message": "hello world"}')]),s._v("が返却されます。")])]),s._v(" "),t("tr",[t("td",[s._v("/echo/{data}")]),s._v(" "),t("td",[t("code",[s._v('{"message": "got the message: {data}"}')]),s._v("が返却されます。"),t("br"),s._v("※"),t("code",[s._v("{data}")]),s._v("は、任意の値が代入されます。")])]),s._v(" "),t("tr",[t("td",[s._v("/gacha")]),s._v(" "),t("td",[t("code",[s._v('{"message": "{result}"')]),s._v("が返却されます。"),t("br"),s._v("※"),t("code",[s._v("{result}")]),s._v("は、 "),t("em",[s._v("1/100")]),s._v(' で文字列"you win"、それ以外で文字列"you lose"が代入されます。')])])])]),s._v(" "),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise2/test_challenge.py")]),s._v("に、作成途中のテストクラス"),t("code",[s._v("ApiTestCase")]),s._v("が定義されているため、上記の仕様のAPIに対するテストを作成してみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h2",{attrs:{id:"_3-tddをやってみる"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#_3-tddをやってみる"}},[s._v("#")]),s._v(" 3. TDDをやってみる")]),s._v(" "),t("p",[s._v("TDDとは、「テスト駆動開発( "),t("em",[s._v("Test-Driven")]),s._v(" )」のことを指し「テストファースト（テスト優先）」を掲げて開発を行う、 "),t("strong",[s._v("開発手法")]),s._v(" のことになります。")]),s._v(" "),t("p",[s._v("テスト手法じゃないよ !!!!")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"tddのやり方"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#tddのやり方"}},[s._v("#")]),s._v(" TDDのやり方")]),s._v(" "),t("p",[s._v("TDDは、任意の開発を行う設計があるうえで、下記のサイクルで開発を行っていきます。")]),s._v(" "),t("ol",[t("li",[s._v("Red\n"),t("ul",[t("li",[s._v("動作をしないテストを書く。")])])]),s._v(" "),t("li",[s._v("Green\n"),t("ul",[t("li",[s._v("迅速に、テストを実行できるコードを書いてテストを通すようにする。"),t("br"),s._v("\n※コードが汚くても良い。")])])]),s._v(" "),t("li",[s._v("Refactoring\n"),t("ul",[t("li",[s._v("リファクタリングを行い、コード内から重複を削除する。")])])])]),s._v(" "),t("p",[s._v("上記 "),t("em",[s._v("1~3")]),s._v(" のサイクルを実行し、動きつつコードとリファクタリングによって最適化されたコードを、着実に作っていく手法になります。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"テスト実装例-4"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#テスト実装例-4"}},[s._v("#")]),s._v(" テスト実装例")]),s._v(" "),t("p",[s._v("この項で実際に、TDDのサイクルを見てみましょう。")]),s._v(" "),t("p",[s._v("例えば、以下の仕様のソースを作りたいとします。")]),s._v(" "),t("ul",[t("li",[s._v("クラス内の"),t("code",[s._v("do()")]),s._v('関数の、実行回数が3の倍数なら"Fizz"、5の倍数なら"Buzz"を返す、クラス'),t("code",[s._v("FizzBuzz")]),s._v("を実装します。")]),s._v(" "),t("li",[s._v("このクラスは"),t("code",[s._v("do()")]),s._v("の実行回数を、内部でカウントします。")]),s._v(" "),t("li",[s._v("3でも5の倍数でもないカウントに対しては、そのカウントを返します。")])]),s._v(" "),t("p",[s._v("上記のコードをTDDで作成していきましょう。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル1-red"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル1-red"}},[s._v("#")]),s._v(" サイクル1 Red")]),s._v(" "),t("p",[s._v("まずは、クラス"),t("code",[s._v("FizzBuzz")]),s._v("の関数を作成します。"),t("br"),s._v("\n下記のコードは、"),t("code",[s._v("example.py")]),s._v("のようなパッケージにあると考えてください。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("pass")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("次に、動作をしないテストを書きましょう。"),t("br"),s._v(" "),t("code",[s._v("do()")]),s._v("が最初に実行する時は、下記の仕様が適用されます。")]),s._v(" "),t("blockquote",[t("p",[s._v("3でも5の倍数でもないカウントに対しては、そのカウントを返します。")])]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("とりあえず1回目の実行では「1」が返ってくるはずなので、テストでは「1」を期待してみます。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("fizzbuzz "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" FizzBuzz\n\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_success")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n fb "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" FizzBuzz"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("これを実行すると、当然のようにコケますね。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". FAIL\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル1-green"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル1-green"}},[s._v("#")]),s._v(" サイクル1 Green")]),s._v(" "),t("p",[s._v("次は「とりあえず動くコードを書く」ことをします。"),t("br"),s._v("\nテストでは1が返却されることを期待しているので、1を返しましょう。"),t("br"),s._v("\nTDDって簡単ですね。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("動いたよ！！！！やったね！！！！！！！！！")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル1-refactoring"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル1-refactoring"}},[s._v("#")]),s._v(" サイクル1 Refactoring")]),s._v(" "),t("p",[s._v("現在の"),t("code",[s._v("FizzBuzz")]),s._v("は、この世界に存在するどんなものよりも洗練されているため、リファクタリングは必要ないですね。"),t("br"),s._v("\n素晴らしい。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル2-red"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル2-red"}},[s._v("#")]),s._v(" サイクル2 Red")]),s._v(" "),t("p",[s._v("2サイクル目に来ました。"),t("br"),s._v("\nRedでは、あえてテストを失敗させなければならないため、泣く泣く完成されたテストコードに手を加えましょう。")]),s._v(" "),t("p",[s._v("サイクル1 Redでも確認した通り、どうやら"),t("code",[s._v("do()")]),s._v("を実行するごとに実行回数を返してくれるそうです。"),t("br"),s._v("\n実行回数毎に、期待する値を増加させてみましょう。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" unittest\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("fizzbuzz "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" FizzBuzz\n\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("ExampleTestCase")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("unittest"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("TestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("test_success")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n fb "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" FizzBuzz"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("2")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("4")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("5")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("6")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("7")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("8")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("9")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("10")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("11")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("12")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("13")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("14")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("assertEqual"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("fb"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("do"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("15")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br"),t("span",{staticClass:"line-number"},[s._v("18")]),t("br"),t("span",{staticClass:"line-number"},[s._v("19")]),t("br"),t("span",{staticClass:"line-number"},[s._v("20")]),t("br"),t("span",{staticClass:"line-number"},[s._v("21")]),t("br"),t("span",{staticClass:"line-number"},[s._v("22")]),t("br")])]),t("br"),s._v(" "),t("p",[t("code",[s._v("FizzBuzz")]),s._v("は既に完成されているため、テストをいくら加えようが失敗するはずがないのですが、試してみましょう。"),t("br"),s._v("\nまあ、やる意味はないと思うのですが（笑）")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". FAIL\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル2-green"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル2-green"}},[s._v("#")]),s._v(" サイクル2 Green")]),s._v(" "),t("p",[s._v("なんということでしょうか。"),t("br"),s._v("\n完成されていたと思われた"),t("code",[s._v("do()")]),s._v("は、何回実行しても「1」しか返してくれないではないですか。")]),s._v(" "),t("p",[s._v("誰ですか、こんな実装にしたのは（怒）")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("global")]),s._v(" count\n count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" count\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("だいぶ雑なコードですが、たぶん動くと思うからテストしましょう。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル2-refactoring"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル2-refactoring"}},[s._v("#")]),s._v(" サイクル2 Refactoring")]),s._v(" "),t("p",[s._v("現在の"),t("code",[s._v("FizzBuzz")]),s._v("はグローバル変数が使用されているなど、あまり美しくありません。"),t("br"),s._v("\nクラスで値を持たせて、インスタンス毎に値を共有させないようにしましょう。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("__init__")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("コードを変更しましたが、テストの結果が成功のままであることを確認します。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル3-red"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル3-red"}},[s._v("#")]),s._v(" サイクル3 Red")]),s._v(" "),t("p",[s._v("さて、ここまでで以下の仕様を実装することができました。")]),s._v(" "),t("ul",[t("li",[s._v("内部でカウントを保持する。")]),s._v(" "),t("li",[s._v("3でも5でもないカウントは、その値を返す。")])]),s._v(" "),t("br"),s._v(" "),t("p",[s._v('次は「3の倍数なら"Fizz"を返す」を実装してみましょう。')]),s._v(" "),t("p",[s._v("失敗するテストを書きます。\nテスト全体を書くと文字量が多くなりますので、以降は差分で表記します。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v('- self.assertEqual(fb.do(), 3)\n+ self.assertEqual(fb.do(), "Fizz")\n\n- self.assertEqual(fb.do(), 6)\n+ self.assertEqual(fb.do(), "Fizz")\n\n- self.assertEqual(fb.do(), 9)\n+ self.assertEqual(fb.do(), "Fizz")\n\n- self.assertEqual(fb.do(), 12)\n+ self.assertEqual(fb.do(), "Fizz")\n\n- self.assertEqual(fb.do(), 15)\n+ self.assertEqual(fb.do(), "Fizz")\n')])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("テストは失敗しますね。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". FAIL\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル3-green"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル3-green"}},[s._v("#")]),s._v(" サイクル3 Green")]),s._v(" "),t("p",[s._v('さて、"Fizz"を返せるように'),t("code",[s._v("FizzBuzz")]),s._v("を修正しましょう。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("__init__")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("%")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Fizz"')]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("テストはオールグリーンです。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル3-refactoring"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル3-refactoring"}},[s._v("#")]),s._v(" サイクル3 Refactoring")]),s._v(" "),t("p",[s._v("特にリファクタリング箇所がないので省きます。")]),s._v(" "),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル4-red"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル4-red"}},[s._v("#")]),s._v(" サイクル4 Red")]),s._v(" "),t("p",[s._v("最後の仕様になります。"),t("br"),s._v('\n最後は「5の倍数なら"Buzz"を返す」を実装します。')]),s._v(" "),t("p",[s._v('ただし、3かつ5の倍数であれば"FizzBuzz"が返ることに注意してください。')]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v('- self.assertEqual(fb.do(), 5)\n+ self.assertEqual(fb.do(), "Buzz")\n\n- self.assertEqual(fb.do(), 10)\n+ self.assertEqual(fb.do(), "Buzz")\n\n- self.assertEqual(fb.do(), 15)\n+ self.assertEqual(fb.do(), "FizzBuzz")\n')])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("「手がかかる子ほど可愛い」というのは、このことを言うのでしょうか。"),t("br"),s._v("\nだんだんコンソールに出力される「FAIL」が愛おしく思えてきました。")]),s._v(" "),t("p",[s._v("きっと「失敗の後は必ず成功する」ということが約束されているからでしょう。")]),s._v(" "),t("p",[s._v("みなさんも、そう思いませんか？")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". FAIL\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル4-green"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル4-green"}},[s._v("#")]),s._v(" サイクル4 Green")]),s._v(" "),t("p",[s._v('"Buzz"および"FizzBuzz"を返せるようにしましょう。')]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("__init__")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("%")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("15")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"FizzBuzz"')]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("%")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Fizz"')]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("if")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("%")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("5")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("==")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Buzz"')]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("テストも通ります。"),t("br"),s._v("\nやったか！？（まだ終わりじゃないです。）")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"サイクル4-refactoring"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#サイクル4-refactoring"}},[s._v("#")]),s._v(" サイクル4 Refactoring")]),s._v(" "),t("p",[s._v("最後のリファクタリングになります。"),t("br"),s._v("\nこれで全てを終わらせて、あなたは次のステージへ進むことになるでしょう。")]),s._v(" "),t("p",[s._v("先程書いた"),t("code",[s._v("FizzBuzz")]),s._v("では、まだ手続きを共通化し、最適にできる部分があります。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#####################################")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# このコードは一例です。")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# みんなが読みやすいコードを書こうね！")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("#####################################")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("class")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token class-name"}},[s._v("FizzBuzz")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("__init__")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("0")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("_divided")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" count"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" div"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token builtin"}},[s._v("int")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("not")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("%")]),s._v(" div"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("def")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token function"}},[s._v("do")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v("\n self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),s._v("\n result "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Fizz"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"Buzz"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"FizzBuzz"')]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n index "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("_divided"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("5")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("<<")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" \\\n "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("_divided"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("self"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("count"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("3")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n "),t("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("return")]),s._v(" result"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("[")]),s._v("index"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("]")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br"),t("span",{staticClass:"line-number"},[s._v("11")]),t("br"),t("span",{staticClass:"line-number"},[s._v("12")]),t("br"),t("span",{staticClass:"line-number"},[s._v("13")]),t("br"),t("span",{staticClass:"line-number"},[s._v("14")]),t("br"),t("span",{staticClass:"line-number"},[s._v("15")]),t("br"),t("span",{staticClass:"line-number"},[s._v("16")]),t("br"),t("span",{staticClass:"line-number"},[s._v("17")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("多分これが一番美しいと思います。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python -m unittest -v example.test_fizzbuzz\ntest_success "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("example.test_fizzbuzz.ExampleTestCase"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("..")]),s._v(". ok\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br")])]),t("br"),s._v(" "),t("h3",{attrs:{id:"問題にチャレンジしよう-3"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#問題にチャレンジしよう-3"}},[s._v("#")]),s._v(" 問題にチャレンジしよう")]),s._v(" "),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise3/challenge.py")]),s._v("には、FastAPIで書かれた作りかけのAPIがあります。")]),s._v(" "),t("p",[s._v("上記のAPIは、コンテナから下記のコマンドで実行することができます。")]),s._v(" "),t("div",{staticClass:"language-bash line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-bash"}},[t("code",[s._v("$ python3 -m uvicorn exercises.exercise3.challenge:app --reload --host "),t("span",{pre:!0,attrs:{class:"token string"}},[s._v('"0.0.0.0"')]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("API実行後は、ブラウザに下記のURLを入力すると、APIにアクセスできます。")]),s._v(" "),t("div",{staticClass:"language- line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-text"}},[t("code",[s._v("http://localhost:8000/\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br")])]),t("br"),s._v(" "),t("p",[s._v("みなさんには、TDDを使って上記のAPIを完成させてもらいます。"),t("br"),s._v("\n作ってもらいたいAPIの仕様は、下記のものになります。")]),s._v(" "),t("ul",[t("li",[s._v("このAPIは、"),t("code",[s._v("/, /add, /sub, /mul, /div")]),s._v("の5つのエンドポイントがあります。")]),s._v(" "),t("li",[s._v("このAPIはサーバ内部でint型の値を保持し、現在設定されている値を"),t("code",[s._v("/")]),s._v("にアクセスすることで、確認することができます。\nまた、値は0始まりになります。")]),s._v(" "),t("li",[t("code",[s._v("/add, /sub, /mul, /div")]),s._v("にパスパラメータを与えると、保持されている値に対し、四則演算を行います（後述）。")]),s._v(" "),t("li",[s._v("本APIでは、全てint型で計算を行います。")])]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("以下、APIのパスについて")]),s._v(" "),t("table",[t("thead",[t("tr",[t("th",[s._v("パス")]),s._v(" "),t("th",[s._v("詳細")])])]),s._v(" "),t("tbody",[t("tr",[t("td",[s._v("/")]),s._v(" "),t("td",[t("code",[s._v('{"current_number": {数値}}')]),s._v("が返却されます。"),t("br"),s._v("{数値}には、サーバで保持されている値が入ります。")])]),s._v(" "),t("tr",[t("td",[s._v("/add/{data}")]),s._v(" "),t("td",[t("code",[s._v('{"current_number": {数値}}')]),s._v("が返却されます。"),t("br"),s._v("{data}に渡された値をサーバで保持している値に加算します。")])]),s._v(" "),t("tr",[t("td",[s._v("/sub/{data}")]),s._v(" "),t("td",[t("code",[s._v('{"current_number": {数値}}')]),s._v("が返却されます。"),t("br"),s._v("{data}に渡された値をサーバで保持している値から減算します。")])]),s._v(" "),t("tr",[t("td",[s._v("/mul/{data}")]),s._v(" "),t("td",[t("code",[s._v('{"current_number": {数値}}')]),s._v("が返却されます。"),t("br"),s._v("{data}に渡された値をサーバで保持している値に乗算します。")])]),s._v(" "),t("tr",[t("td",[s._v("/div/{data}")]),s._v(" "),t("td",[t("code",[s._v('{"current_number": {数値}}')]),s._v("が返却されます。"),t("br"),s._v("{data}に渡された値をサーバで保持している値から除算します。")])])])]),s._v(" "),t("br"),s._v(" "),t("p",[s._v("サーバでの値の保持・取得関数は、ソース内に定義されています。"),t("br"),s._v("\n以下に、使い方の例を記載します。")]),s._v(" "),t("div",{staticClass:"language-python line-numbers-mode"},[t("pre",{pre:!0,attrs:{class:"language-python"}},[t("code",[t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# サーバ内に保持されている値を記録します。")]),s._v("\nset_current_number"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("1")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# サーバ内に保持されている値を取得します")]),s._v("\ngot_data "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" get_current_number"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# got_data = 1")]),s._v("\n\nset_current_number"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("123")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("+")]),s._v(" "),t("span",{pre:!0,attrs:{class:"token number"}},[s._v("456")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\ngot_data "),t("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" get_current_number"),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),t("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n"),t("span",{pre:!0,attrs:{class:"token comment"}},[s._v("# got_data = 579")]),s._v("\n")])]),s._v(" "),t("div",{staticClass:"line-numbers-wrapper"},[t("span",{staticClass:"line-number"},[s._v("1")]),t("br"),t("span",{staticClass:"line-number"},[s._v("2")]),t("br"),t("span",{staticClass:"line-number"},[s._v("3")]),t("br"),t("span",{staticClass:"line-number"},[s._v("4")]),t("br"),t("span",{staticClass:"line-number"},[s._v("5")]),t("br"),t("span",{staticClass:"line-number"},[s._v("6")]),t("br"),t("span",{staticClass:"line-number"},[s._v("7")]),t("br"),t("span",{staticClass:"line-number"},[s._v("8")]),t("br"),t("span",{staticClass:"line-number"},[s._v("9")]),t("br"),t("span",{staticClass:"line-number"},[s._v("10")]),t("br")])]),t("p",[s._v("dockerコンテナ内の"),t("code",[s._v("/test-hands-on/exercises/exercise3/test_challenge.py")]),s._v("には、本APIが完成すると通るようになる、テスト"),t("code",[s._v("test_success()")]),s._v("が定義されています。")]),s._v(" "),t("p",[s._v("上記のテストがOKになるよう、各種APIをTDDを使って作成してみましょう。")]),s._v(" "),t("br"),s._v(" "),t("h1",{attrs:{id:"おわりに"}},[t("a",{staticClass:"header-anchor",attrs:{href:"#おわりに"}},[s._v("#")]),s._v(" おわりに")]),s._v(" "),t("p",[s._v("一般的にソフトウェアテストというと、専門のテスト部隊があって「Excelにスクショをペタペタ貼るだけでしょ？」というようなイメージを持ち、敬遠される方も少なくはないと思います。")]),s._v(" "),t("p",[s._v("開発者がテストについて知識を持ち、単体テストで可能な限りの不具合をなくしておくと、後の工程で不具合が少なく済ますことができたり、メリットがあります。"),t("br"),s._v("\nまた、後の工程で発生した不具合の内容を聞いた・見ただけで、どのモジュール同士で問題が起こっているのか目星がつくなど、効率的なトラブルシュートやソフトウェアの理解にも繋がります。")]),s._v(" "),t("p",[s._v("冒頭でも述べましたが、ソフトウェアにも品質というものがあり、この品質次第で会社の売上に影響が出たり、企業のセキュリティや人命に影響を及ぼしてしまう懸念もあります。")]),s._v(" "),t("p",[s._v("そのため。開発を行う際には是非テストにも注力をしていただき、ユーザーの満足できるソフトウェアを作れるよう、目指してみてください。")]),s._v(" "),t("p",[s._v("良いエンジニアライフを！👍")]),s._v(" "),t("credit-footer")],1)}),[],!1,null,null,null);t.default=e.exports}}]); \ No newline at end of file diff --git a/assets/js/37.2755cfa3.js b/assets/js/37.e33dc2ba.js similarity index 98% rename from assets/js/37.2755cfa3.js rename to assets/js/37.e33dc2ba.js index afc5bb48..52dd44c7 100644 --- a/assets/js/37.2755cfa3.js +++ b/assets/js/37.e33dc2ba.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[37],{509:function(t,r,e){"use strict";e.r(r);var a=e(10),o=Object(a.a)({},(function(){var t=this,r=t._self._c;return r("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[r("h1",{attrs:{id:"iij-bootcampとは"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#iij-bootcampとは"}},[t._v("#")]),t._v(" IIJ Bootcampとは")]),t._v(" "),r("h2",{attrs:{id:"目的"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#目的"}},[t._v("#")]),t._v(" 目的")]),t._v(" "),r("p",[r("RouterLink",{attrs:{to:"/"}},[t._v("IIJ Bootcamp")]),t._v("は "),r("a",{attrs:{href:"https://www.iij.ad.jp/",target:"_blank",rel:"noopener noreferrer"}},[t._v("IIJ"),r("OutboundLink")],1),t._v(" で開催しているハンズオン勉強会です。\n各技術が誕生した経緯・歴史、ほかの技術と比較といった知識を得るためのきっかけとして、さまざまな言語・フレームワーク・ツールに触れて実際に動かすハンズオンを行っています。\nカリキュラムにはハンズオンだけでなく、「overview」として技術ジャンルの全体像や歴史などを紹介する回も設けています。")],1),t._v(" "),r("p",[t._v("このサイトでは"),r("RouterLink",{attrs:{to:"/"}},[t._v("IIJ Bootcamp")]),t._v("用に社内で作成したハンズオン資料を"),r("a",{attrs:{href:"https://creativecommons.org/licenses/by-sa/4.0/",target:"_blank",rel:"noopener noreferrer"}},[t._v("CC BY-SA"),r("OutboundLink")],1),t._v("ライセンスで公開しています(GitHubリポジトリは"),r("a",{attrs:{href:"https://github.com/iij/bootcamp",target:"_blank",rel:"noopener noreferrer"}},[t._v("こちら"),r("OutboundLink")],1),t._v(")。")],1),t._v(" "),r("p",[t._v("カリキュラムの全体像や資料へのリンクは"),r("RouterLink",{attrs:{to:"/"}},[t._v("トップページ")]),t._v("をご覧ください。")],1),t._v(" "),r("h2",{attrs:{id:"資料の構成"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#資料の構成"}},[t._v("#")]),t._v(" 資料の構成")]),t._v(" "),r("p",[t._v("ハンズオン資料は以下のカテゴリに分かれています。")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("カテゴリ")]),t._v(" "),r("th",[t._v("概要")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("開発系")]),t._v(" "),r("td",[t._v("開発に必須となるGitやdockerのハンズオン")])]),t._v(" "),r("tr",[r("td",[t._v("CI/CD + 構成管理")]),t._v(" "),r("td",[t._v("CIサーバのハンズオンとansibleやk8sによるアプリケーションデプロイ")])]),t._v(" "),r("tr",[r("td",[t._v("データベース")]),t._v(" "),r("td",[t._v("MySQL, MongoDB, Redis ハンズオン")])]),t._v(" "),r("tr",[r("td",[t._v("Webサーバ構築")]),t._v(" "),r("td",[t._v("Apacheやnginxを使ったWebサーバの構築")])]),t._v(" "),r("tr",[r("td",[t._v("サーバサイドアプリケーション")]),t._v(" "),r("td",[t._v("DjangoやJava、golangを使ったサーバサイドアプリケーションの構築")])]),t._v(" "),r("tr",[r("td",[t._v("フロントエンド")]),t._v(" "),r("td",[t._v("流行りのWebフレームワークを一通り触ってみる")])]),t._v(" "),r("tr",[r("td",[t._v("セキュリティ")]),t._v(" "),r("td",[t._v("Webにおけるセキュリティについてと、脆弱なサーバを作らないためのハンズオン")])])])]),t._v(" "),r("h2",{attrs:{id:"資料の利用と修正"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#資料の利用と修正"}},[t._v("#")]),t._v(" 資料の利用と修正")]),t._v(" "),r("p",[t._v("資料は "),r("a",{attrs:{href:"https://github.com/iij/bootcamp/blob/master/LICENSE.md",target:"_blank",rel:"noopener noreferrer"}},[t._v("CC BY-SAライセンス"),r("OutboundLink")],1),t._v(" で公開されており、勉強会などでの2次利用が可能です。その際資料の間違いや最新情報への更新などが必要な場合は、"),r("a",{attrs:{href:"https://github.com/iij/bootcamp/issues",target:"_blank",rel:"noopener noreferrer"}},[t._v("issue"),r("OutboundLink")],1),t._v("で気軽にお知らせください。")]),t._v(" "),r("p",[t._v("またPullRequestについても歓迎しています。その際は "),r("a",{attrs:{href:"https://github.com/iij/bootcamp/blob/master/CONTRIBUTING.md",target:"_blank",rel:"noopener noreferrer"}},[t._v("CONTRIBUTING.md"),r("OutboundLink")],1),t._v(" をご一読ください。")])])}),[],!1,null,null,null);r.default=o.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[37],{508:function(t,r,e){"use strict";e.r(r);var a=e(10),o=Object(a.a)({},(function(){var t=this,r=t._self._c;return r("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[r("h1",{attrs:{id:"iij-bootcampとは"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#iij-bootcampとは"}},[t._v("#")]),t._v(" IIJ Bootcampとは")]),t._v(" "),r("h2",{attrs:{id:"目的"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#目的"}},[t._v("#")]),t._v(" 目的")]),t._v(" "),r("p",[r("RouterLink",{attrs:{to:"/"}},[t._v("IIJ Bootcamp")]),t._v("は "),r("a",{attrs:{href:"https://www.iij.ad.jp/",target:"_blank",rel:"noopener noreferrer"}},[t._v("IIJ"),r("OutboundLink")],1),t._v(" で開催しているハンズオン勉強会です。\n各技術が誕生した経緯・歴史、ほかの技術と比較といった知識を得るためのきっかけとして、さまざまな言語・フレームワーク・ツールに触れて実際に動かすハンズオンを行っています。\nカリキュラムにはハンズオンだけでなく、「overview」として技術ジャンルの全体像や歴史などを紹介する回も設けています。")],1),t._v(" "),r("p",[t._v("このサイトでは"),r("RouterLink",{attrs:{to:"/"}},[t._v("IIJ Bootcamp")]),t._v("用に社内で作成したハンズオン資料を"),r("a",{attrs:{href:"https://creativecommons.org/licenses/by-sa/4.0/",target:"_blank",rel:"noopener noreferrer"}},[t._v("CC BY-SA"),r("OutboundLink")],1),t._v("ライセンスで公開しています(GitHubリポジトリは"),r("a",{attrs:{href:"https://github.com/iij/bootcamp",target:"_blank",rel:"noopener noreferrer"}},[t._v("こちら"),r("OutboundLink")],1),t._v(")。")],1),t._v(" "),r("p",[t._v("カリキュラムの全体像や資料へのリンクは"),r("RouterLink",{attrs:{to:"/"}},[t._v("トップページ")]),t._v("をご覧ください。")],1),t._v(" "),r("h2",{attrs:{id:"資料の構成"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#資料の構成"}},[t._v("#")]),t._v(" 資料の構成")]),t._v(" "),r("p",[t._v("ハンズオン資料は以下のカテゴリに分かれています。")]),t._v(" "),r("table",[r("thead",[r("tr",[r("th",[t._v("カテゴリ")]),t._v(" "),r("th",[t._v("概要")])])]),t._v(" "),r("tbody",[r("tr",[r("td",[t._v("開発系")]),t._v(" "),r("td",[t._v("開発に必須となるGitやdockerのハンズオン")])]),t._v(" "),r("tr",[r("td",[t._v("CI/CD + 構成管理")]),t._v(" "),r("td",[t._v("CIサーバのハンズオンとansibleやk8sによるアプリケーションデプロイ")])]),t._v(" "),r("tr",[r("td",[t._v("データベース")]),t._v(" "),r("td",[t._v("MySQL, MongoDB, Redis ハンズオン")])]),t._v(" "),r("tr",[r("td",[t._v("Webサーバ構築")]),t._v(" "),r("td",[t._v("Apacheやnginxを使ったWebサーバの構築")])]),t._v(" "),r("tr",[r("td",[t._v("サーバサイドアプリケーション")]),t._v(" "),r("td",[t._v("DjangoやJava、golangを使ったサーバサイドアプリケーションの構築")])]),t._v(" "),r("tr",[r("td",[t._v("フロントエンド")]),t._v(" "),r("td",[t._v("流行りのWebフレームワークを一通り触ってみる")])]),t._v(" "),r("tr",[r("td",[t._v("セキュリティ")]),t._v(" "),r("td",[t._v("Webにおけるセキュリティについてと、脆弱なサーバを作らないためのハンズオン")])])])]),t._v(" "),r("h2",{attrs:{id:"資料の利用と修正"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#資料の利用と修正"}},[t._v("#")]),t._v(" 資料の利用と修正")]),t._v(" "),r("p",[t._v("資料は "),r("a",{attrs:{href:"https://github.com/iij/bootcamp/blob/master/LICENSE.md",target:"_blank",rel:"noopener noreferrer"}},[t._v("CC BY-SAライセンス"),r("OutboundLink")],1),t._v(" で公開されており、勉強会などでの2次利用が可能です。その際資料の間違いや最新情報への更新などが必要な場合は、"),r("a",{attrs:{href:"https://github.com/iij/bootcamp/issues",target:"_blank",rel:"noopener noreferrer"}},[t._v("issue"),r("OutboundLink")],1),t._v("で気軽にお知らせください。")]),t._v(" "),r("p",[t._v("またPullRequestについても歓迎しています。その際は "),r("a",{attrs:{href:"https://github.com/iij/bootcamp/blob/master/CONTRIBUTING.md",target:"_blank",rel:"noopener noreferrer"}},[t._v("CONTRIBUTING.md"),r("OutboundLink")],1),t._v(" をご一読ください。")])])}),[],!1,null,null,null);r.default=o.exports}}]); \ No newline at end of file diff --git a/assets/js/38.854b6729.js b/assets/js/38.c1e53061.js similarity index 96% rename from assets/js/38.854b6729.js rename to assets/js/38.c1e53061.js index 90cd6876..ca019a28 100644 --- a/assets/js/38.854b6729.js +++ b/assets/js/38.c1e53061.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[38],{508:function(t,o,n){"use strict";n.r(o);var l=n(10),e=Object(l.a)({},(function(){var t=this,o=t._self._c;return o("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[o("h2",{attrs:{id:"_6-正しい-playbook-を書くために"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#_6-正しい-playbook-を書くために"}},[t._v("#")]),t._v(" 6. 正しい Playbook を書くために")]),t._v(" "),o("p",[t._v("Ansible とは、IT 自動化ツールです。\nAnsible を使うと言うことはより多くのシステムを簡単に扱えるようにするということになります。\nIT が常に変化するものである以上、Ansible の Playbook もまた常に変化するシステムに対応するべく、加筆修正を加えていくことが欠かせません。")]),t._v(" "),o("p",[t._v("そのために Ansible は Inventory や Roles といった形で分解することができるようなっており、\nまた、それらを git で管理したりすることができるようになっています。")]),t._v(" "),o("p",[t._v("Playbook が様々な形で分解できると言うことは Playbook を複数人でメンテナンスする事ができるということであり、そのためには統一された書式で記載することが欠かせません。")]),t._v(" "),o("ol",{attrs:{start:"5"}},[o("li",[t._v("でご案内したディレクトリ構造のベストプラクティスもその一つですが\nInventory の分け方や変数の記述についても様々な形で記載しています。")])]),t._v(" "),o("p",[t._v("これらの書式チェックに有効な"),o("code",[t._v("ansible-lint")]),t._v("を活用するなど、できる限り「動くから良い」ではなく「他の人が使う可能性がある」と言ったことを考慮し、ベストプラクティスに沿った形で Playbook を作成して頂ければと思います。")]),t._v(" "),o("credit-footer")],1)}),[],!1,null,null,null);o.default=e.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[38],{509:function(t,o,n){"use strict";n.r(o);var l=n(10),e=Object(l.a)({},(function(){var t=this,o=t._self._c;return o("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[o("h2",{attrs:{id:"_6-正しい-playbook-を書くために"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#_6-正しい-playbook-を書くために"}},[t._v("#")]),t._v(" 6. 正しい Playbook を書くために")]),t._v(" "),o("p",[t._v("Ansible とは、IT 自動化ツールです。\nAnsible を使うと言うことはより多くのシステムを簡単に扱えるようにするということになります。\nIT が常に変化するものである以上、Ansible の Playbook もまた常に変化するシステムに対応するべく、加筆修正を加えていくことが欠かせません。")]),t._v(" "),o("p",[t._v("そのために Ansible は Inventory や Roles といった形で分解することができるようなっており、\nまた、それらを git で管理したりすることができるようになっています。")]),t._v(" "),o("p",[t._v("Playbook が様々な形で分解できると言うことは Playbook を複数人でメンテナンスする事ができるということであり、そのためには統一された書式で記載することが欠かせません。")]),t._v(" "),o("ol",{attrs:{start:"5"}},[o("li",[t._v("でご案内したディレクトリ構造のベストプラクティスもその一つですが\nInventory の分け方や変数の記述についても様々な形で記載しています。")])]),t._v(" "),o("p",[t._v("これらの書式チェックに有効な"),o("code",[t._v("ansible-lint")]),t._v("を活用するなど、できる限り「動くから良い」ではなく「他の人が使う可能性がある」と言ったことを考慮し、ベストプラクティスに沿った形で Playbook を作成して頂ければと思います。")]),t._v(" "),o("credit-footer")],1)}),[],!1,null,null,null);o.default=e.exports}}]); \ No newline at end of file diff --git a/assets/js/4.fe47842b.js b/assets/js/4.70d9d788.js similarity index 99% rename from assets/js/4.fe47842b.js rename to assets/js/4.70d9d788.js index 1d9e1eda..47b2cecc 100644 --- a/assets/js/4.fe47842b.js +++ b/assets/js/4.70d9d788.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[4],{257:function(t,s,a){t.exports=a.p+"assets/img/2-tree.a737f3fb.svg"},411:function(t,s,a){t.exports=a.p+"assets/img/1.f70c70b4.png"},412:function(t,s,a){t.exports=a.p+"assets/img/1-console.d801891b.png"},413:function(t,s,a){t.exports=a.p+"assets/img/2.c84e5dd6.png"},414:function(t,s,a){t.exports=a.p+"assets/img/2-console.ef2ec19d.png"},415:function(t,s,a){t.exports=a.p+"assets/img/2-elements.23f81857.png"},416:function(t,s,a){t.exports=a.p+"assets/img/2.1-document.09510311.png"},417:function(t,s){t.exports="data:image/png;base64,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"},418:function(t,s){t.exports="data:image/png;base64,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"},419:function(t,s){t.exports="data:image/png;base64,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3KW6fvCa6rpjLQM5EREREVESUKJyYvBQdWz4JerYRder48NGKNW9RKkuLcORE6pL/TZ1yqqnGMiJiIiIiPyUlZWpiooKVVl5ppkSXGP/Iepwt3L13sDJaufQM5Qqda6n0hLKu779BgM5EREREZGXCRMmqG9+8xuqR48eZko4W07to+qbStVTjcPV7j4t60DPuO34CdXlgy287CERERERkQu94t/61l2Rw3gYoXvIu/Xoo/qPPEd98sc3zJT2+o+qUkcO7VcH92w3U4iIiIiICstdd92lJk6coO/v2bNHvfbaa/q+68wzz1SVlZVqyZIlZkobKVmpG1Abb8nK5f/yn2pc7fXqg5efVCt/+o9makqvASPUjf/1vjpyuFH9z71XqL1b68wcIiIiIqLCMX/+w2rAgAH6/h133KlDuZeZM2eoGTNmqNmzrzdT2tgndR6/5EZ1bMgw56TOreqUVYvCl6xs+8MyfTv28htU7b/+h74v0Cu+d+t7qnuPPurvf/Si7i0nIiIiIio0EsYBYRz15E8//VTr8JOf/MTM9Ycf/sF1xrvuWKO6vP6EOufoZ2rogcNq6P5DumccYVzPM8sHtrUlkEvPuFcoX3rvVIZyIiIiIupUNmzYoMtS7CGILvVbVEnTAXXKR6+ra/p+rK7p/ZEeur3+cz0N8yKd1GmXq7ih/OjhRoZyIiIiIupUmpqa1OLFS1qHdevWmTlpHP+r6rL1A1Xy8XbVv+sRVVHWrIeS/Z/qaZgX+SorDOVEREREVCyilKzYShob1PCjh9ToPzfqQYf0lmkQOZADQzkRERERFYOoJStBZBTIwQ3lE677jr4PXqEcl00kIiIiIiokkUtWAsg4kAeTurJiSYnz60RERERERAUEpSpRSlY6knEgt0tVNq18Sq17pm3n0Bt+lSlVOdp0QC39/lTda05EREREVIjyrmTFDeMv/+yb+j54hXH+UBARERERFTKUquRNyQrDOBERERFR5iIFcoZxIiIiIqJ4hA7kDONERERERPEJHchHVU/Tt24Yh94DKxjGiYiIiKjgHT582NxTasCAAeZedPY69uzZY+6llPTs2St1TcKA0As+9KxL1NY/LDNT2hty9iXq4K56dXDPdjOFiIiIiKiw3HXXXWrixAn6PgL0q6++qu+7Kisr9bB48WIzxdull17aGsrffHOdevDBB/V9CB3IiYiIiIg6u4qKCnXfffFda9x2zz3fUfX19WZMqa7dunX/oblPREREREQtGhsbdWgeP75KdevWzUzNDMpgfvrTn6mNGzeaKSnsISciIiIi8lFWVqZGjhypKivPNFOi2bBho9q2bZv+CX4XAzkRERERUQ5l9EudRERERESUGQZyIiIiIqIcYiAnIiIiIsohBnIiIiIiopxR6v8BeJnDOYHBdTEAAAAASUVORK5CYII="},420:function(t,s){t.exports="data:image/png;base64,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Pd2NwbOaO3eemjZv9vfWHMA55ny0RURERK1HRGHbiFWvq2nH1Gs7a5oRyIuKdum12EIvOkT6Hutt23aoufOLB74gmN5408NtSmhMGQ0CNZbNPRjo1ca5sezVRn026rRN4D7nnLNqlo/KV199FXaK1Xu3cZ3ly/+iXo3ox/r161X5SJ8+P4jpwMWGINgj4CPoI/B79cknn6rp0KFDeot3OMecT0RERK2L77CNUGlKIpxMTbaXEhO3dkzPr32+WXbrFTbBNVJoG4HXS9A21zK11AbOQzDG4EcDx9hvHUHduV0+gwmfG+dh2a5LN73aXt9Y4ocduFG/jQGT8X7tHK719NPLaj5r5L+UaA9cRPCOF9M+roegT0RERBSthAULHnP91RGUeKCHGYEUwdEWLpwiKCJAo9bYWfvspx07QCOQhhskaY5DYLUhyIf7NUZzb+Ze3TivabdnnosTeqdN2Qg0FuBRWoIeb+dnM73c4T5zLCBgjx9/mRooefToUXnppbUxezPJqad2V20DfrAIpSPfffe9Wo8WyjsGDOhfW9rh9guSeAvJyF8uCfmVSLytxE1V6Ve1rwVEjzaei5eykYaMHz+u9kdt8C7tcD+Bj4GQ+EEbWLs2WLZDRERErY/6uXa9TG2IM3A/99zqmJSNmF+QREnQypXPy4kTJ/SetgG/IDlt2rV6zZslS56SjRs36TUiIiJqTZICgYzZepnaEPS4oue1T58+qqQEAyHD/by8H1VV36q23nvv/bj+VHtzhWeK10GaXuvGYHAke7WJiIhaL/Zst3FpaWnSoUMHNSCSYgdhu3//fpKaGnxvdl5enpqbt5VUVlapAZH2z7YTERFR68OwTdQEZsy4U83xU+1ERETUdkT16j8iIiIiIgqPPdtETcDUcLNshIiIqG1h2CYiIiIiihOWkRARERERxQnDNhERERFRnDBsExERERHFCcM2EREREVGcJAwffgEHSBIRERERxUFChw5pDNtERERERHHAMhIiIiIiojhh2CYiIiIiihOWkRARERERRaG6U0CqA5kiKSnBDVVVklBaIgnlpQzbREREREQRSUySE1l9Vciubp8u1R26qs0JRw5IwtGyYOhm2CYiIiIi8u9EzgCpTu0ox3vmyfEBI6W6Uze1PaF8vyTtXC9JezYzbBMRERER+YWykerup8n3vS6Q7384VU707C3SPkEksWY6Wi2JxUXSbsNSDpAkIiIiIvJL1Wm3T5fjAy4IBu2UmliNoA01oftEVrbq7WbPNhERERG1SampqZKVlSW5uYP0Fu8OnZotZSd1lw9Ou0SOnJpZF7SNE9WSuPMzhm0iIiIianuGDh0qt912q5xyyil6iz+fndxJiitTZGl5LznQqaaNMGE7pIwk+ZRO0uP08/VafRk5gyUts7deIyIiIiJqedCbfdddMyMO2tD+xHEJnPSddEs8qmq06/lOJKFsX2jP9uif/1EGjpkqO9c9LQUL/l1vDULIvvaJrXL0m3J5YdZlcnBXod5DRERERNRyzJw5U4YNG6qWS0pKZP369WrZadCgQZKbmysrV67UW+p8e0pH+aZjQL5M7ie7c0bLwdQOjgGSu6TdhmWhYTvnvPHyb/csVctugXvSw29LRs6ZDNxERERE1GLNnz9PMjMz1fIdd9ypArebq66aKBMnTpQpU6bqLaHMq/9OHnCR9Lz4Wimtbi/Hjx+Xkk8KJWnnm5K0Z1NoGcmud9bUBuwBo6+RMf/x32rZWD1rXE3A/kjan9JJJsx5SZWVEBERERG1JCZoA4I26refeWZp7fTAAw/ovQ1LLP5MEior5OiOv8mkwJcyqeMXkt95ryS/+bi0++JNta/eq//sHm1n4D72TTkDNxERERG1Ktu2bVOlIvbkyYnjkrhrpyR8uVsyko5KVmqVmhLKvlLbsM/1PdsM3ERERETUVlRWVsqKFStrpy1btug93iSUl0qvY0ek77flalIBvGYbuIZtYOAmIiIiorYg0jISL8KGbXAG7qGTf6WWwS1w49WBREREREQtScRlJB40GLa9Cb7MJCHB8SJvIiIiIqIWINoykoY0GLbt8pEdBUtly/K6LnX0Yl+hy0eOVVbI6vvGqd5uIiIiIqKWCOUjTVZG4gza6/5wm1oGt6DNd24TERERUUvWZGUkDNpERERE1NagfCTuZSQM2kREREREsRESthm0iYiIiIhiJyRs5+SNV3Nn0IaOXbMYtImIiIiIfAgJ2wULbpO/PTi1XtAGhOvVsy6TZ2f8C4M2EREREbVY33zzjV4SyczM1EuRs9soKSnRS0EJHTqkBV+UTURERETUBsycOVOGDRuqlhGO33jjDbXslJubq6YVK1boLe5GjRpVG7jffXeLPPLII2oZGLaJiIiIqE3JysqSBx+M3bu0bffc8yspLi7WayJJycntZ+tlIiIiIqJWr7y8XAXiIUMGS3Jyst4aHZSmLFjwB9m+fbveEsSebSIiIiJqk1JTUyU7O1tycwfpLZHZtm27FBUVqZ99d2LYJiIiIiKKE9dfkCQiIiIiomiJ/B+fuvch3Kgi/QAAAABJRU5ErkJggg=="},421:function(t,s){t.exports="data:image/png;base64,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"},422:function(t,s){t.exports="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAuwAAABrCAYAAAAsCte1AAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAAEnQAABJ0Ad5mH3gAACL5SURBVHhe7d0LfBRVni/wX9DVBZJOCImJSAJoAiRg4yMOkWVFmoXxgQyiI/E5ivoZr7s6QR2WdVfvZ8ddh0UdUHe8O3dnUQdHAxciMgx6ZW0UWR5r5iItLyEOISAGEiAPHqsrcM85daq7qrq6093pjh34fT+f0np1VXV1R391+l+nMi65ZNhpEBERERFR2vj43Bxc0bYHGRkZ6KXnERERERFRGmJgJyIiIiJKYwzsRERERERpjIGdiIiIiCiNMbCT0rt3b5SWluipcAMHDkT//rl6ioiIiIi6CwM7KbfdditmzqzGPffcpeeEyKD+5JOz1SCDOxERERF1HwZ2Uj79dLP6d2VlZVhoP3ToMPbt24fevfuIUP9o0kO77wc78Mo9L6NUT1MnKkdi+qqbcP2dejqpinG92Pb02dl6unuVzb8J9781Evl6Oqo7K3G/OFbX9c1l5jC/WC/oRErPbWy+9/jrWLFiRXB4/fGr9JJ4TMdzlm2sWPEcqvSS5MrGmLfiOL8p+MzyZ08Q61eiTE+nVBp8P4jo7BR7YPfejOrqR1E941oU6llhCq/FDLmOOUy7VC9IgLm/6pvh1bMMl2KadR/mEO24IiqEb4Z1O859mULrTXNfISbeadZ93Qef2wEH37cxzHBdSYh1vRht3hzAwoVvqHG30D5v3ospDe1nj6m46x5xgfKDWXqaUuK3G/BvE38nhjXY3qLn9SSHPsTPJk/GZDH86IVP9MyQoqoduOmvzWEtRgzQC4IW4af69ZPf2K7npbmkfGbGBef9qyZgTKWepRjzGbSJqKeKIbDrgFxyBIF2PctFoe8+VFcNQUPNS5g/Xw+1n+ml8RIBuaJIj7tr9Fv2I4cFH6JJL4uNDOG3wdu6OrgNf2MRfI7Qrt5X9fVAw149JzEyrPtyAqjR+6oJiHlVjtAuQ7gvBwHzHKqVbgsL4yr4+wC/3pYcFvjje/du1q/fEDG0nzhxgqGd0osZ8G7fgmY962wgw/plOauw5p+G43diWLMJuPhut9CehrrpMzsqAn/Rtd/Nr0RERKnQSWCXoXa8SIYiFNbu0PNciKBZJVJuoOZVJCE3ipB8PbyevfD7uxaSownuw3JREahdjUYUocIMyPJ9Dd4tQrZ4X11ppRPb8RV3ILAydFHR5H9XXABlwTvG/BVCXBj5itAeeDd0Dps+xMpABzzeq4MXEfICwlcsjnv+2xBxPukY2onS2OVLcdmgFvxx+SNo07Pa3n8ef2zLw8XX8FeboM0H0D6hrHvKZIiIukEngb0J/gUvobaTZOgtKQIa62IL62YpR8RymUsxxpslguv6JARSs3wmvNTlgpwsccz19n14SyCrJj2Dh4tLFSHwdgIt9+EK83KA9t3YZt1Q4XAM9oh/F5cYx1bYHznoQIN9JZQPFscpLiJKjJXUdHLOTWQpD+0jl+KVv9wRHG51eXnpuLW2dSKVkKj69+B6a3FXgV4guNXGG9tdCp+cUMchxoPHI+fPwkyXbQVLWSLsK7it4OuN4R/HTTWWF7yMf1Tz5mCM/EgHzgiuI4eZI43VYnccbV/o+uGINb+O5RFKAlTdeHCdUbA21Br1wc7yAiHhWl7nMbnUHh9oR7OtntmxTqL16a4cx/PMEGTqJYZQKYVxLsx1ncftfF+Oc6aOWb7GLNkwhnjvFcjOF1+6tk3Yt1/PkAZMQKHczKDR4r8UqdD5Z3a0qc1+fpw16sn8zPR3z9zWlAl99AKrvWjYmo/BUb+f9s/C9Xve6fdD6uSzV5zriCHWezWIiIQk3HRaCJVHW0VAiqkePDrvtPEobg9gZSfpv9hn2Vfc9evmMYd+lFWlLxVH4A90iMTeDxfo+cmgLg5aD4WCv7xoqeqHOvULQg7y5MFf0A8etKIluJK82LgNOXWy1V+spVbKR44I+a0t+fY6/oTq96NzhvbJk29Q45JbaJfdQsZCBeZxBVi3ZDge/qUxLNmnF2oyaM8ceQBL9PKHf7kAu2TAtYVvI0DfOnCrZb3nxcHGe/PqCNx6xX7Mk/tAASbcMwXNS2ZjXUee+J+ueZEgQ/gclO2Zrfcjho8OYMytzlAvtvWX8vXGOvO2tKDfyCeMdQ48gr9Vr5XbFtP7FoS2pdZVG4hDH5Q9cw2yV8iaXzE8tRtHR4yyBGgZRq5B2YHNui5YDK81Y8C91pBohIgxBbux3Fxn4mZYs2DznF1iuk9YeUH+tQXIbNmNut/qGTHRxwTr/vZjsDO8ifdx/+Sjeh1Zz5wvjtMSbpJWn+5yjuR51Eut5HmbMuqA/ZiCx21sp2jzmtB2XjsmPh9ncBOvWVWKtqeMdZZ/cByZEypcwl1kntw88R+AvcHWddniftPdA7Dz/a1iogCepJfFxPaZZU64BlMKd+nl4juUNwRTrOsk6zOTwV+E5vbXzGMxzqOb7TW74ZkcIRSr0D8Kng9Cn9nyD8TF6zPWi9BYvh+xffZl853nUAxnWSkXEXVNEgK7ESI93gpgZaim2q0eXJGt1nIdt/r2wmtRIf4b31gXrVX7M9TqfRjDYgTEXqpcLxDMdZ3lI8Yxm2RNeFVOnWpNP6jnJY9xcWAyLwxqHMekWuFN6ubdCrTWOH7dUK3w4n8RvhLUO99/CkJ78s3C5JF5OLLlebxxQM9yKngZEwYCuz66BX49C5iLeR+JQJJ1OUbrgFw67gmMyWoRwd+63jK88c4jInjHZ9f/M1+Th35ty8OOrXTcFJR2rMJrHy3Tc4QtC1WoLxuuW9AVeTxjg6/ftWMTjoht5qeoGW2/CC3vmoF5wxYExCkacJURkvJnl2KAiAPrquXlniZC0zqxTuaoIiPE3FmGsrzj2P5itODQiAb5Glt5QTEqJvTB0c174wocZfNl6704JltQacS71mOUxIXA8uA6bdi1WQSyvExxJpPL9RxFslWENssxHZGfcYFHnUe1HXHM/jnBGC3O9XYRTJ0XOuJcP/UB1m0wppo/PCDCXx9kX2JMd24qPJb/TGRPWoubRu/Hmn+6BakqHoz5M5PnJzjP+M6Y5yd5xAXmZLFFsa/g9z6aDXvFeSlAqcsFUVnVEHXBaf3MmufUqYuJqH9DDrF99tnopy7a2y3nkIgoPkkI7AZb7bUQWBdAe7CUIxaF8N3ghadxdaclOHZN8K+Md1/NaFU30OarXwUqWhfbLyDajyQxuDehpdUYs14YhE6V0areFFxJt77LunnL+WwNNb2j0W8N++L914n/XXuGoDyJif3qqytx991GKczGjRuxYsVKNS7J1vSZM3+iSmFOnDiOefNeUq3unSooEqGrBdt3WIKvU/4A9MNWbHa2OG/ZKEJ1KPwW5Yj41rEJGyMF/5i1oNnyf9EjrTv1WIjaV9ZEW6mLWdrSL2eoXuu719Ikgq0OSXmFfUSw2Q9n/yDbPxFvVoff/KK+4kUHsEsHyEhkS+VRsdVgecGdA1SQCVhDSqd0aHE5pu9KpHPkRpZ8WG2vDrWQqu3IFmVruYNsmRUnOVPVqiTLMvVLpiRvPL0mdzl+9y+hWnaRCNFu/Xmky9LtM8tGtjin+z+J4QJLkRd7Mpzbfw0w31f4Bae+OOzkb8gqts++DetWiD3JX47kcpbCEFECkhbYwzQdElHULOWIgbyx0tMhgn6iPcvEsS8doj3e8cips/ewospXkuxgawdQPD7swsDWqn7wiLro8Dlb33WrelTqtVnISVIdjzOsv/76QjUuuYV1WRpzxutYhXmWEpbg8M5cvcJ3T4WHVJAtlZaWx7Kr8nH0g+1pE7zTgvxVwFruYA6xtN7Hof2w+CAGzcDQw7Pxu5rQd0/VtlMYVdI1YkBYzX1SxfLZmyVBsqQmGPBd7t8gIoogCYH9M9SL/y55chxtBjpoWluGo1E3rorQ6a2y1Gb75DxZWiOno9TEq/pv5w2b0akQjb2ot7XmX4oSkUnaG3ZYWsC7zmg9j3BDqXnjq77Ace67sHyIeG/6OJt2oKHd5cJEv//WJPwskPqw7iwRmYoB1kbI5v04ghEY5bwJc+RolFpaw/e2iuCSNSBFN9nZdee+Emf/2V21trsEFRm20XJUnEnNWWpS6RHfJSezhVBurxiDR8Tbui7Zy0jShvN4Lsl0uakwOnWuU1Cy46atWZ7EFjRtsf5KNRUDLxZ737MxyaUx6fmZeYrsv1pEv1CV5TnOm0+N9xUsDQvKRukosS1r6Uon34+4P/sNW7DIDO5iy9FviiUiCklKC3ugXvxvoni85aFCurylPYB1tkAsROglJlBr1mRbBnVTpuzCUE5H6MZQ1nvLYO/aS03kXmKa/HXiP+XiYsByHOqGV7G/uk5ueHVn7svl4UqyVxfZheMNoTpzo1tJ6y8Kn4lzJbtwvD7UN7t4bzfYesxpwrYGxzpyvxHff3xSHtYPfIDt4jqp9ArzxlB546juNcVkrjNO9+SizMLMcSOAfaH68l0fLccueZOn80bUH4SmnUFb3vA6c2T8scp9X4lahv0y6w4cbXl/bkJPqnwuhkdU5s+uMOrRa4xWPaM+2npjpHBnJcaI07h/hVHKYa7jNW9ClTfiufaCIfx2P/bL7cleZKKUCVQ9p5+s+dx0PSdEldY4b0aUN+05bmDsLkZ50BBUBEt9KnH/vfFHU+PGXHFuuqPUYdNCowvHKS+LeGnInvQELs5uwR/XJPZrT8/5zMLvp5A9HMnvdDTq5tOr7Hfjmp+9z9JLj/NvKJbvR8KfvQr+sqcnPU1E1ImMSy4ZdlqPu5I3SVaJ0OhGPrwoWG8ug7hqEdcaV7vfWGquF2m5lVoX9j7HZUCvEhcDelK2XEfu/12GaCOEu/dbbi7XxAVGja2+3LHcyrmu5bhs5yVIP6gpeODux+Q8327bcq7THljc5QcndV8ZjOxxZUYw+O76aDhW9BdBetAmzPtN6IZR2VOMtbvHI1tm42+tN30qzsBvv+kzbLnsmeWL0XhlHLDkl7fAL7tiVD3WyNcYx5Wn9gPjdW1i/WDJi/24DZb92bZlLFVdOd46ES3iPdp7gQm/UJHnwbbO957A609fi/5idPsbk/HTGmO2QfZMYe9+UUQHrJu4wRGknevZb3pUbCFEbmM7+r1l9HqxyNGKLrvtmzJBHI9zG0FX4fHX/yfGq4NeiMk/XWTMtnEek/24VQCTvdZYbnI09nssuJ4x7daqGnp/sawj2daTpQ23t6NCHB+CN/Qaxyt7E3GeDzu3z8SyL3We+9rPnb5Akj2eWG+i/N7jr+Np72f42Y+ex3/qeXZTMeKhOSKk60lsxafRbjyteg4rxJ/2G5N/CtvXSOnqZyZ7GtI9qVhKQJyfY/I+M70/fd19VH4ue8vEuYU+JrfPK/Qa243aYReo4X9DnX8/pE4++06XExG5+/jcHFzRtgcZGRmdB3Y6O/z4xw9i1KhRYWFdkkH9ySdnn1016xRGhRfZtaGtxxBKts4De5yiBnYiIkpX1sCeuptOqUf5zW/ewK9+9b/DwrokA/r8+S/i2WfnMKyfre6shGpdj9oFJBEREaUCW9iJKKJQjTB/wu8uqoVd1agYDq3+e/zohU/0VKzkPRB3W2463s4WdiKiHoYlMUREREREaYwlMUREREREPQQDOxERERFRGmNgJyIiIiJKYwzsRERERERpjIGdiIiIiCiNMbATEREREaUxBnYiIiIiojTGwE5ERERElMYY2ImIiIiI0hgDOxERERFRGmNgJyIiIiJKYwzsREQJuvrqSj1GRESUOgzsREQJGDq0FHfffZf6NxERUSoxsFOnsrKy0L9/rp4iIiIiou6Uccklw07rcaIwMqjfeOMNOP/881Fb+zYOHTqsl5zpZmHsr2eg79rZ+L+vLdPzkivn3rXwjc0Ddi5A7dy5eu53xXi/F+gpYCv+8MAt2KOnyPhbKC0tDV689u/fH5WVldiwYYP4uzik5sm/j127dqX07yT4vdGOpfA7SkRE352Pz83BFW17kJGREUdg996Mal8R0B5AzYIP0aRn2xReixlVXnj0JBpXY37tZ3oiTub+sBf++W8jYMwVLsW06vEo1lNB0Y4rokL4ZtwGb/CAnfsyhdZr9L+E2vAVYuKd9ih8wQPvQKDmVfgtB1zouw9V3iw9FeK6z+D5MbQHFmOBdWNJYA3r33zzjQjsy9DR0aGXJk5+8S68sBBffdWE06cTv14cNGsHrhwaHljUfHQ1BCcW2FWYKt8E/6xH0KrnRZKUwD5xKaZNL0D93LEI7NTzEmK8XywajrWr9KyEPIxld1yODW8+iDm4Dq9MeRKXf/ksrv7De3q5ZMyfdLQGJf5X9LzUme1bgwcy12DW8r9DrZ4XL1mrLstfYrVw4RtYv36DnkqVqfDOnYMLtzGwExGdiayBPYaSGBmQH0V1yREE2vUsFzJsVlcNQUPNS5g/Xw+JhnUZkCtCYdSNDLHB/cgh0bDeKi4q9Db8jUXwVd8Mr15DUu+r+nqgYa+ekxgV1nPERYXeV40I4N6q++Ar1CuY5IWHXsccnGFdbqvaB3FxEVon1WF9xYrfJyWsS7m5/dS2b799Os4991w9N0GHW4DyCcjRkz1J62tjUfvA8DRoXU+i3AEo0KPAxRiQCRxotYb1nkf+LcQT1iW5vtkST0RE1FWdBHYZaseLZChCYe0OPc+F92ZUiZTrbDFOVKHveng9e+H3dy0kRxPch+WiIlC7Go0oQoWZouX7GrxbBGjxvkQuTJjYjq+4A4GVoYuKJv+74gIoC94xl+o5sZEXEL7iSL8EJIdbWE/mT/znnXee+nffvn1x2223djG0b8JXLRMxcqKepO/e0QPoUmN/mhk6dKgeA06cOK5KXiINcrnJ+joiIqKu6CSwN8G/oPMSEG9JEdBYF1tYl6UcssV+WqSgeinGeLPQHlifhECqfx1wtJpLF+RkiWOut+/DW6JKbTyDh4tLFSHwdgIt9+EK83KA9t3YZt1Q4XAMlqU4xSVhxxZZIcoHJ+vcuEt1WHdKRmhv3LQVF1w+S0+5keUeOzAtOKyF1yVLyVKa0DrWeu4Q+zo7MDaBCwVZCmPdxvfvnaqX2DnXsx538DimjxBTeSixHtfcl7v/F4fcf8D6O9ag/rprkJ95DebK8TuqMFIsGjlajv8rZpvr3PEkJmWKBYVVYlxOG8OyS9SWNFk2E1pWf8cyvBJssA4ts73G3P6Uf8A0VZpjrPOA/GMOHpMxrL/yOuM1MbC2lO/b9yXmzXsx4iCXm9jCTkREyZKEXmIKofJoK+CbIcOxOYSH5Fh4p41HcXsAKztJ/8U+y75mXGsE7JiZx9ysp8UcWfpScQT+QIdI7P1cw1qi1MVB66FQ8JcXLVX9UKd+QchBnvXgPV5UBc/ho5hmO4n5yBEhv7UlX1+IJPr+3XV3WDfJ0H7ffT+CxxO8mSA+qxaiPm+KawjH0JfxfV2LrspPxOBfCxVwQ2Fb1gLvwJV5q+DX69Q+sAAH9VKDXkfWxpvrzF2FvtPjD+3BUpiwfVhMXArfWKB+rnk8cgjVqe8x5y/aKqZa7OvFUD+fdIf/Dle/eQ1mfS6+L0fXYJYYL9n4uVjwOX4tx2VNu16n5M1n8f5RsaipRozLaWOY+oXakiDDtlH7Hly+sRmTrjND+3t4eLmxjZGjxYWAeo0I8WPFxYLct6pVfwVT9Wt/Lf/wzGPSg72mnoiIKL0lIbAbIdLjrQBWhmqq3erBFdlqLddxq28vvBYVxbKxPlqr9meo1fswhsUIiL1UuV4gmOs6y0eMYzbJmvCqnDrVmh4xQCXMuDgwmRcGNS4lLU3+Vy3vSwwi0MsLkxlmiU5hf9VyWuwrQX1wPf3+kxDaJ078CxXWJVm2Mm3azXjwwfs7HQYPHqRe01XTp/8wwdC+DI3bgAvHhLdUD5o6EX0Pr8JGy015ra89j3qRK4Ot8hPvRkmuCL2/jhJ01Tpb8QdrvfnOR7BDBOjorfuJyblIVoIfQFtPrC05uj/hmzulaVdOwkgRsJ+zhuovloqAnovLh5gt4zK012ALhuEB38PiNQ9hUqa4OOjCjaVOsn/10tIS5OYm1lIuXydfLwciIqKuSEJgN7QH3rWVxATWBdCOIpTE3MxeCN8NXngaV8fZC0sT/Cvj3VczWtUNtPnqV4GK1sX2C4j2I0kM7k1o0SnQemEQOlWtaIl0dSIubvyNlhIdrdFvDfvi/dftFSsNQXkymtm/YzK0J6J13SZg7N2wXzpMRXYecGzbB44gLgN+C5BXpC6AVDg+vAmNUcKxEaBH4MpgeYoxyF5qzO0kU+try8V30NyfewlPOhqaHQq303LyE6pnV9twlLCYZTT52RfrtaRXMPW9NWgurMLcYbnYslH2TJMcsleY6uqfYObMatV1YyLk6+Tr5cAnohIRUVckLbCHaTqkQlKOrd4jCu/V8Ho6RNBPtGeZOPalQ7THOx45dfYeVlT5SpIdbO0AiseHXRio2vZYdFaic/CIuGDJQk4X63hWrfp3VQpjWr9+I1asWBl1qKlZjIaG5PXWvWjR/9FjcVKt3SNQlNKbT2Xf5JbSk5SWoMzFWrX92ag/HKpRT6RmvjvIrhOD9eK6Nl2GaDN4x1MzrjhKWIKDsxvIfgXisttQkBPnPqKQXTLOn/+iGjZu3Kjnxke+ztxG6rt4JCKiM1kSAvtnqJetwLI1zUqXb7RGbD62UzeuitDprbLUZqt+xmVpjZyOUhN/QT940IEG212d0akQjb2ot7XmX4qSYqC9YYelBbzrmlQTu/P4jBtIw258tdHlNOY6TTvQ0O5yYaLff2sXfxaQ9eqybt0M7VdccZkY/xpfffVVxCFZXT1KMqy3t0fpO7QTe8JuPl2Gthagb1i3j1NRXJ4HtOwNBe3cAcjWo8rQIvTVo1LrlwfEPwuQ3e0t3csQmGUG99SU3yTDHL8M1EZd+ZaNRrhWteO6Tj2emvGdbeKNZhag01MtbzIdPQzNnz+r6uXzhz1kuTG163bu3KUG86FI8ZKvM7dBRETUFUlpYQ/U71UtyKEbJHV5S3sA65xpNEIvMYFaS+22OaibMmUXhnI6QjeG8mFNMti79lITuZeYJn+d6sLRZzkOdcOr2F9dTN3dOJn7ct4oKsheXWQXjjeE6syNbiWj/6LgnSYf1mRdpwnbGjrg8V5v6b9d7Dfi+4+fNbTLenZ5E2qqe7s4duwYXn319S6FdUXdfDpafKohMsQjdyJGW3piybn3CaNmfZlRjy7LaY5hBIab68gbVWdNtAV2tW3V0r3UUXbTXYbCIz6GYwcdBSZ79otjz3Ot3+9+Rr/rhutQLMab2/6op63eQ6O86bTwcn3DqF3tH943atNVby+RhG4yVbXuXzwoLhByMek68ybUEOMCYCT+IrVfYyIiopTp9Emn8iZJt6dvSrYncMogbnnyZsSnnJrrxfIUVLWufECQJaw7n6bq8sTQEBmijRDu3m+5uVwLe1qqY7mVc13Lcbk/DVU/qCl44OHHZH8SqhDhHDk/k1Q95XTy5BvVzadff/01fv/7lUnrMUY+5VRuW5JhffHiJfj222/VdDxk14aqZxdLSYrr00PDArjLY/fVE0NlF4mSXL4Q2WFPkTSeLFniCH4HLU8HDe7fyXI86rhdm49Dx+W2TsRH0NuOXThsPyexScaTTmXvLpOw/72pePiw8TTT8KecmozlqntHTbbM23uKMbqFDDmM99W2zWXmtF4cfI3smcZez66edmr5YUq2ysfa6m99yqnsZ93adaPTwIEXoXfvPmo89U875ZNOiYjOZNYnnXYa2Ons5Qztb7/9TlJKYOR2ZQ80XQnrlGzJCOxnJvl9feaZn+mp2D311NNJu8h1x8BORHQmswb21N10Sj2eszwmM9PSHNoFhw8fUS32b721iGGd0p78O5Ct5fGQ66c2rBMR0dmELezUqaysLBXW5U2mdKYyWthDHQ25lA2d5WRL+9ChQ9W/jen+GD16tOoNxrwxVYb0nTt3pjSsO8uuIpZKERFRj8aSGCKiLpIPVpJ9tctuG9kTDBERJRtLYoiIiIiIeggGdiKiBMhWdVmrztZ1IiJKNQZ2IqIE8QmmRETUHRjYiYiIiIjSGAM7EREREVEaY2AnIiIiIkpjDOxERERERGkso7Lyz9kPOxERERFRGqk98k3owUmZmVkM7EREREREaWTnReV8cBIRERERUU/AwE5ERERElMYY2ImIiIiIUux0di5ODRmGU+WXGYMYl/NiwcBORERERJQqvc4xwvlFxTidcyFO9R+qBjku58llcp1oeNMpEREREVGKqLDex4OTA0fj5LBrcDq7QM3PaDuAcz5fg3P2bUTG8Xb02v25mm/iTadERERERCl2Ojcf6N1bhPVKfPtnd+LkZX+GU8NLcap8KE5eMRbfjrlDBXm5TrTyGAZ2IiIiIqIUkCH89Pk5ODnsz3FqYLEI5iJ698owFp6fgVODBhut7mIdFe4jYEkMEREREVEEffr0waBBg1BeXqbnxO7QhYPR+ieF+PSi7+PohSKQm2HddOo0en1ej/NW/zN6HdqJXts+1QvsJTEM7ERERERELioqKvDQQz9G37599Zz41P9pNvYc740324pwMFtsI8HAHndJzHl9szFgxFg9FS5viBdZ+cV6ioiIiIio55Gt6o8//ljCYV06/9RJ5P7Jf6Og19fA1y5t5P8NZLQ2IePoQeDECT0zXNwt7OP/6l8w3HcHPl/9W/hf/h96rkEG9bt+tQVfH2vD8qdvRMvugF5CRERERNRzPPbYY7jqqgo13tzcjDVr1qhxp7KyMpSXl2Pp0qV6Tsh/9fXgmCcXX55XisYh49HSJ1PVrquWdhHge+3ZjXPX1eDcvR8j48tGZLQd1q/sYknMkO9NxnWz31TjbqH9hy/8B/KGXMrQTkREREQ91ksvvYj8fONG0Ecf/YkK7W5uvfUW3HLLLbj99jv0HDuzW8c/HTYBAyfdhcOnz8fJkyfRvDOAcz7/GOfs25D8bh13/+eKYEgfNv5O+B75X2rc9M7TN4iQ/hnO75uNKT/7vSqRISIiIiLqScywLsmwLuvZ33rrzeDw85//XC+NrteeehXIv97xHn6Y+yV+6NmLqn77cd7Hrxgt6zKsi3WiSahbR2vLujO0f3OsjaGdiIiIiM4o27ZtU2Uv1iEmp06q1nNZ8pJ3ztcY1OeEGjJav1LzVMu6WCeahPthZ2gnIiIiorPF8ePHsWTJ0uBQV1enl8RG1qcXfXMUJf/VpgYV4i0169EkHNglhnYiIiIiOhskWhKTDF0K7JIztFdM/xs1LrmFdtktJBERERFRT5JwSUwSdDmwx8boiEbe5UpERERE1NN0tSSmK7oc2K2lMDv8b6JuUejnAdma/gNdCvPN8Xa889QNqtWdiIiIiKgnkqUwPaokxhnWV//zQ2pccgvr7JOdiIiIiHqyHlUSw7BORERERGcbWQrTI0piGNaJiIiIiLpH3IGdYZ2IiIiIqPvEHdiHjJ6s/u0M65LngkEM60RERERESRR3YPe//BDem3NHWFiXZEB/5+kbsXjmGIZ1IiIiIuqxjh07pseA/Px8PZY46zaam5v1WGwyMjOzjE7SiYiIiIhIeeyxx3DVVRVqXAbsjz76SI07lZeXq2HJkiV6jrtx48YFQ/snn9ThF7/4hRqPZOdF5biibY96jhEDOxERERGRw6BBgzBnTmr6Wp89+2+wZ88ePeXOGtgT7taRiIiIiOhMJQP1Cy/8wlYa01VyW3KbnYV1J7awExERERFF0KdPHwwePBjl5WV6TmK2bduOhoYGHD9+XM+JjiUxRERERERpjCUxREREREQ9BAM7EREREVEaY2AnIiIiIkpjDOxERERERGmMgZ2IiIiIKI0xsBMRERERpTEGdiIiIiKiNMbATkRERESUxhjYiYiIiIjSGAM7EREREVEaY2AnIiIiIkpjDOxERERERGmMgZ2IiIiIKI0xsBMRERERpTEGdiIiIiKitAX8f3ycDxYjAkykAAAAAElFTkSuQmCC"},423:function(t,s){t.exports="data:image/png;base64,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"},424:function(t,s,a){t.exports=a.p+"assets/img/2.1-object_Text.f32fd356.png"},425:function(t,s){t.exports="data:image/png;base64,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L0XLHRdCZl6hXiIiIiIiop4mWyluuWVF0kmFNPjUSQz/7N8wasAJ4IRLO8TfgLS2ZvWEKPl0KMlXi8XMf34YEyu+hfc2P4WaB/5JrzXIhOLq3+zAiWPt2HDnZWjdV6+3EBERERFRT1mxYgUuuKBUzbe0tGDr1q1q3qm4uBiTJk3C888/r9dE/HVoFo5lDcdfBk1A47iZaE3PUGMrVMuFSDQGHNiHz9SuxWea/oi0vzSqd1r4SizGfXkO/n7l02reLbn45q/+B7njpjK5ICIiIiLqJatX34+8PGNA9bJl31PJhZuFCxdgwYIFuOqqb+k1dubjZj933iyMueRqfHJ6ME6ePImW9+sx8L0/YuCH22yPm/XVFWrfn6rDycR5M5eg4ub/UPOml+68VCQT72Lw0GzM+8krqmsUERERERH1HDOpkGRSIcdbPPPM0+Hp5z//ud4an3z5nUwcTuz+Pb45/C/4ZlYTFg87iEF/fMhoqZBJhXxBnub7cbPWlgpncvHpsXYmF0REREREfciuXbtUdyfr5Mmpk6o1QnZ1yh14AmPTj6spre0jtU61VOi3bktJvceCyQURERERUf/Q1dWFdeueD091dXV6izdy/ETBp0cx/q/talLJhljnlFRiITG5ICIiIiLq+5LtCuVX0omF5EwuShf9UM1LbsmFfFwtERERERH1nKS7QvmUUmLhjfHQqbQ0x0s1iIiIiIio26XaFcqrlBILaxeo3TVPo+7ZSLOKbJ34hu4C9WlXB16641LVikFERERERD1PdoHqk12hnEnF5l/fqOYlt6SC77QgIiIiIuo9fbIrFJMKIiIiIqL+RXaB6lNdoZhUEBERERGRk6/EgkkFERERERG58ZVYjLtwjvrTmVRIWSPHMqkgIiIiIjpL+Uosah64Eb9f9a2opEKSicRLd16G55aXM6kgIiIiIuolx44d03NAXl6enkue9RgtLS16LlpaRkam8aIJIiIiIiLq91asWIELLihV8zIR2LJli5p3mjRpkprWrVun17ibPn16OLl466063HvvvWreiYkFEREREdEZZOzYsVi1qnveVbFy5Q9x4MABvWQ3cNCgwT/W80RERERE1M+1t7er4L+kJIRBgwbptamR3aseeODXaGho0GuiscWCiIiIiOgMlJ6ejqKiIkyaVKzXJGfXrgbs378fXV1deo07JhZERERERJSypN68TUREREREZMXEgoiIiIiIUsbEgoiIiIiIUgT8P3Zg1mlYsCrRAAAAAElFTkSuQmCC"},426:function(t,s){t.exports="data:image/png;base64,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"},427:function(t,s,a){t.exports=a.p+"assets/img/3-click.154a0bfa.gif"},428:function(t,s,a){t.exports=a.p+"assets/img/4-input.65808a47.gif"},429:function(t,s,a){t.exports=a.p+"assets/img/5-post.439678c0.gif"},430:function(t,s,a){t.exports=a.p+"assets/img/6-buttons.a17f2e36.png"},431:function(t,s,a){t.exports=a.p+"assets/img/6-delete-button.7f767117.gif"},538:function(t,s,a){"use strict";a.r(s);var n=a(10),e=Object(n.a)({},(function(){var t=this,s=t._self._c;return s("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[s("h1",{attrs:{id:"素のjavascript-dom入門"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#素のjavascript-dom入門"}},[t._v("#")]),t._v(" 素のJavaScript + DOM入門")]),t._v(" "),s("p",[t._v("JavaScriptは、ウェブアプリケーションのフロントエンドに欠かせない、重要なプログラミング言語です。この講義では、ReactやVue.js、Svelteなど現代的なJavaScript用フレームワークを一切使わずに簡単なアプリケーションを作ってみることで、そうしたフレームワークが根本的な処理で何をしているのか、はたまたそうしたフレームワークがどのような処理を代替してくれているのか、理解する手がかりにすることを目指します。")]),t._v(" "),s("h2",{attrs:{id:"前提知識"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#前提知識"}},[t._v("#")]),t._v(" 前提知識")]),t._v(" "),s("p",[t._v("他のプログラミング言語によるプログラミング経験。JavaScriptの構文については軽く触れる程度にとどめますので、これまで学習したプログラミング言語について、その言語から類推できるほどの理解が備わっていると好ましいです。")]),t._v(" "),s("h2",{attrs:{id:"事前準備・注意事項"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#事前準備・注意事項"}},[t._v("#")]),t._v(" 事前準備・注意事項")]),t._v(" "),s("ul",[s("li",[t._v("適当なテキストエディターとブラウザーが動くパソコン\n"),s("ul",[s("li",[t._v("特にこだわりがなければ"),s("a",{attrs:{href:"https://azure.microsoft.com/ja-jp/products/visual-studio-code",target:"_blank",rel:"noopener noreferrer"}},[t._v("Visual Studio Codeをこちらからダウンロードしてインストール"),s("OutboundLink")],1),t._v("するのを推奨します")]),t._v(" "),s("li",[t._v("ブラウザーについては、次のいずれかのブラウザーの、比較的新しいバージョンの利用のみを想定します\n"),s("ul",[s("li",[t._v("Microsoft Edge （以下「Edge」）")]),t._v(" "),s("li",[t._v("Google Chrome")]),t._v(" "),s("li",[t._v("Safari")]),t._v(" "),s("li",[t._v("Mozilla Firefox （以下「Firefox」）")]),t._v(" "),s("li",[t._v("⚠️特に断りがない限り、ブラウザーのスクリーンショットを掲載する際はFirefoxで撮影したものを使用します。他のブラウザーを使用した場合やブラウザーなどの設定により、"),s("strong",[t._v("表示される内容が多かれ少なかれ異なります")]),t._v("のでご了承ください")])])])])])]),t._v(" "),s("h2",{attrs:{id:"作業用のディレクトリーを作る"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#作業用のディレクトリーを作る"}},[t._v("#")]),t._v(" 作業用のディレクトリーを作る")]),t._v(" "),s("p",[t._v("ここ以降本講義を通じて作るファイルをまとめるために、（例えば）以下のコマンドで専用のディレクトリーを作ってください:")]),t._v(" "),s("div",{staticClass:"language-bash line-numbers-mode"},[s("pre",{pre:!0,attrs:{class:"language-bash"}},[s("code",[s("span",{pre:!0,attrs:{class:"token comment"}},[t._v("# デスクトップにiij-bootcamp-domディレクトリーを作る")]),t._v("\n"),s("span",{pre:!0,attrs:{class:"token builtin class-name"}},[t._v("cd")]),t._v(" ~/Desktop\n"),s("span",{pre:!0,attrs:{class:"token function"}},[t._v("mkdir")]),t._v(" iij-bootcamp-dom\n")])]),t._v(" "),s("div",{staticClass:"line-numbers-wrapper"},[s("span",{staticClass:"line-number"},[t._v("1")]),s("br"),s("span",{staticClass:"line-number"},[t._v("2")]),s("br"),s("span",{staticClass:"line-number"},[t._v("3")]),s("br")])]),s("p",[t._v("以降、この節で作ったディレクトリーを、上記の例と同様に"),s("code",[t._v("iij-bootcamp-dom")]),t._v("ディレクトリーと呼びます。")]),t._v(" "),s("h2",{attrs:{id:"最初のブラウザーアプリケーション"}},[s("a",{staticClass:"header-anchor",attrs:{href:"#最初のブラウザーアプリケーション"}},[t._v("#")]),t._v(" 最初のブラウザーアプリケーション")]),t._v(" "),s("p",[t._v("とりあえず、最も単純なJavaScriptのアプリケーションを作ってみましょう。")]),t._v(" "),s("p",[t._v("前の節で作った"),s("code",[t._v("iij-bootcamp-dom")]),t._v("ディレクトリーに、"),s("code",[t._v("1.html")]),t._v("というファイルを作ります。「JavaScriptの勉強なのにHTMLファイル？」と疑問に持った方もいらっしゃるかも知れませんのでお答えしますと、次のような事情があります:")]),t._v(" "),s("ul",[s("li",[t._v("今回勉強するDOMを操作するJavaScriptは、原則HTMLファイルを経由して読み込まれるため。"),s("code",[t._v(".js")]),t._v("ファイルだけをブラウザーで開いてプログラムを起動することはできない")]),t._v(" "),s("li",[s("code",[t._v(".html")]),t._v("ファイルと"),s("code",[t._v(".js")]),t._v("ファイルを分割して読み込ませることもできるものの、1つのファイルに完結させた方が扱いが楽だから\n"),s("ul",[s("li",[t._v("細かい話: 特に今回紹介するモダンな"),s("code",[t._v(' +Inventory の分け方や変数の記述についても様々な形で記載しています。

これらの書式チェックに有効なansible-lintを活用するなど、できる限り「動くから良い」ではなく「他の人が使う可能性がある」と言ったことを考慮し、ベストプラクティスに沿った形で Playbook を作成して頂ければと思います。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
+ diff --git a/cicd_infra/ansible/CREATE_INVENTORY.html b/cicd_infra/ansible/CREATE_INVENTORY.html index ad39f4fe..03830672 100644 --- a/cicd_infra/ansible/CREATE_INVENTORY.html +++ b/cicd_infra/ansible/CREATE_INVENTORY.html @@ -8,7 +8,7 @@ - + @@ -55,7 +55,7 @@ host00: host01:
1
2
3
4
5
6

なお、YAML書式についてはiniファイルのインベントリファイルがあれば以下のようなコマンドで作成することが可能です

ansible-inventory -i inventories/hosts --list -y
-
1
- +
1
+ diff --git a/cicd_infra/ansible/CREATE_PLAYBOOK.html b/cicd_infra/ansible/CREATE_PLAYBOOK.html index 3c59e42e..9ddf6aa4 100644 --- a/cicd_infra/ansible/CREATE_PLAYBOOK.html +++ b/cicd_infra/ansible/CREATE_PLAYBOOK.html @@ -8,7 +8,7 @@ - + @@ -67,7 +67,7 @@
  • 記載する場所どこでも構いませんがhosts等のセクションと同じレベル（同じインデントレベル）で宣言する必要があります。
gather_facts: false
1

# 設定ファイルでの停止

  • ansible.cfg に以下の通り記載することでこのplaybookに宣言しなくともgatherを停止することができます
    • 宣言する箇所は[defaults]セクションに宣言してください
    gathering = explicit
-
    1
- +
1
+ diff --git a/cicd_infra/ansible/CREATE_SERVER.html b/cicd_infra/ansible/CREATE_SERVER.html index 0798ea55..f8a115b3 100644 --- a/cicd_infra/ansible/CREATE_SERVER.html +++ b/cicd_infra/ansible/CREATE_SERVER.html @@ -8,7 +8,7 @@ - + @@ -93,7 +93,7 @@ Ansibleにおけるdryrunの実装はモジュールに委ねられており、Ansible全体としての動作を保証していません。 例えば、コマンドモジュール(command)のようなモジュールはチェックモードの分岐がなく、処理そのものがスキップされてしまいます。 こういったタスクが含まれている場合、コマンドの結果を次のタスクに受け渡す、 -といったタスクが失敗してしまうので注意して使う必要があります。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
- +といったタスクが失敗してしまうので注意して使う必要があります。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
+ diff --git a/cicd_infra/ansible/INTRODUCTION.html b/cicd_infra/ansible/INTRODUCTION.html index d107a520..ae7a4ac7 100644 --- a/cicd_infra/ansible/INTRODUCTION.html +++ b/cicd_infra/ansible/INTRODUCTION.html @@ -8,7 +8,7 @@ - + @@ -39,7 +39,7 @@ executable location = /usr/local/bin/ansible python version = 3.9.16 (main, May 29 2023, 00:00:00) [GCC 11.3.1 20221121 (Red Hat 11.3.1-4)] (/usr/bin/python3) jinja version = 3. -
1
2
3
4
5
6
7
8
9

ansible-core の 2.5.13やそれぞれのバージョンには実行する時期によって異なることがありますが問題ありません。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
- +
1
2
3
4
5
6
7
8
9

ansible-core の 2.5.13やそれぞれのバージョンには実行する時期によって異なることがありますが問題ありません。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
+ diff --git a/cicd_infra/ansible/MANAGE_SETTINGS.html b/cicd_infra/ansible/MANAGE_SETTINGS.html index ae4d4c58..9cac1aad 100644 --- a/cicd_infra/ansible/MANAGE_SETTINGS.html +++ b/cicd_infra/ansible/MANAGE_SETTINGS.html @@ -8,7 +8,7 @@ - + @@ -43,7 +43,7 @@
1
2
3
4
5
6
7
8
9
10
11
12
13
14

正しく実行されれば SUCCESS と出力されます。

# 参考情報

# ansible.cfg パラメータの確認

Ansibleには様々な設定を施すことが可能な他、デフォルト値が定められている物もあります。 これらを確認するにはどうすれば良いのでしょうか。 また、どのような設定が可能なのか全ての設定値を覚えておくことは現実的ではありません。

こういったときのためにansible-config というコマンドを用いることができます。

 ansible-config
-
1
- +
1
+ diff --git a/cicd_infra/ansible/REVERSE_PROXY.html b/cicd_infra/ansible/REVERSE_PROXY.html index de41fd64..c99bfc64 100644 --- a/cicd_infra/ansible/REVERSE_PROXY.html +++ b/cicd_infra/ansible/REVERSE_PROXY.html @@ -8,7 +8,7 @@ - + @@ -211,7 +211,7 @@ 実は Ansible にはタグという機能があり、タスクやロールなどに任意の値（タグ）を付けることができます。 これを利用することで、Ansible 実行時に任意のタスクのみを実行する/しないことができます。 実はさきほどのplaybooks/rp.ymlにタグが設定してありました。

タグは増やしすぎても管理がたいへんになるので、ある程度のまとまりやよく使うタスクにのみ付与するのが良いでしょう。 -タグの詳細については公式ドキュメント (opens new window)をご覧ください。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
- +タグの詳細については公式ドキュメント (opens new window)をご覧ください。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
+ diff --git a/cicd_infra/ansible/SAMPLE_RUN.html b/cicd_infra/ansible/SAMPLE_RUN.html index 60595f9b..9747533c 100644 --- a/cicd_infra/ansible/SAMPLE_RUN.html +++ b/cicd_infra/ansible/SAMPLE_RUN.html @@ -8,7 +8,7 @@ - + @@ -32,7 +32,7 @@ "ping": "pong" }
1
2
3
4
5
6
7

Ansibleは基本的に実行すべき内容（task)を記載したplaybookを作成し、ansible-playbookコマンドを用いて実行するものですが、上記の通りplaybookを作成しなくとも実行できるコマンドもあるため、細かな日々の運用作業や確認作業などに使えます。

なお、ansible-playbookコマンド (opens new window)はplaybookと呼ばれるYAMLファイルにしたがってAnsibleを実行するコマンドになります。 -今回はAnsibleの実行イメージと出力のイメージを掴んで頂くためにアドホックで実行しましたが以後、このハンズオンでは主にansible-playbookコマンドを使っていきます。

- +今回はAnsibleの実行イメージと出力のイメージを掴んで頂くためにアドホックで実行しましたが以後、このハンズオンでは主にansible-playbookコマンドを使っていきます。

+ diff --git a/cicd_infra/ansible/USE_VARIABLE.html b/cicd_infra/ansible/USE_VARIABLE.html index 149de9a9..47a45b4b 100644 --- a/cicd_infra/ansible/USE_VARIABLE.html +++ b/cicd_infra/ansible/USE_VARIABLE.html @@ -8,7 +8,7 @@ - + @@ -48,7 +48,7 @@ tasks: ---ここにtaskを記載する---
1
2
3
4
5

# tasks作成のヒント

# 動作確認

playbookが作成できたならば以下の通り実行します

ansible-playbook use_variable.yml
-
1
CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
- +
1
CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
+ diff --git a/cicd_infra/ansible/index.html b/cicd_infra/ansible/index.html index ee7e4930..d8e6c879 100644 --- a/cicd_infra/ansible/index.html +++ b/cicd_infra/ansible/index.html @@ -8,7 +8,7 @@ - + @@ -22,7 +22,7 @@ vim等による開発でも問題ありませんが、講義においては講師の環境をvscodeにて説明を行うため、 vscode以外で開発を行う場合は適宜自身で読み替えてください。

# システム構成

この講義で使用するコンテナのネットワーク図です。 コンテナを VM（Virtual Machine）に見立て、ハンズオンを実施します。

ネットワーク図

この講義では図中の console コンテナから各ホストを管理します。

# 0. 事前準備

ハンズオン用の教材 (opens new window)を参照し -READMEに従ってansible演習環境のセットアップを行ってください。

# 1. Ansible 概要と導入

Ansibleの概要とインストール方法について学びます

# 2. インベントリの作成

Ansibleインベントリの概念とインベントリファイルの作成方法を学びます

# 3. Ansible 設定ファイルの管理

Ansibleの基本動作仕様とその変更方法について学びます

# 4. Ansible playbook の作成

Ansible playbookの概念と作成方法を学びます

# 5. Ansible によるサーバセットアップ

Ansible playbookを通じて実際にサーバに設定を加えていきます

# 6. 変数やループ処理の実行

Ansible playbookを通じてWebサーバを作ってみましょう

# 7. 正しい Playbook を書くために

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
- +READMEに従ってansible演習環境のセットアップを行ってください。

# 1. Ansible 概要と導入

Ansibleの概要とインストール方法について学びます

# 2. インベントリの作成

Ansibleインベントリの概念とインベントリファイルの作成方法を学びます

# 3. Ansible 設定ファイルの管理

Ansibleの基本動作仕様とその変更方法について学びます

# 4. Ansible playbook の作成

Ansible playbookの概念と作成方法を学びます

# 5. Ansible によるサーバセットアップ

Ansible playbookを通じて実際にサーバに設定を加えていきます

# 6. 変数やループ処理の実行

Ansible playbookを通じてWebサーバを作ってみましょう

# 7. 正しい Playbook を書くために

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
+ diff --git a/cicd_infra/drone/index.html b/cicd_infra/drone/index.html index 70106a5f..bbb235f7 100644 --- a/cicd_infra/drone/index.html +++ b/cicd_infra/drone/index.html @@ -8,7 +8,7 @@ - + @@ -177,7 +177,7 @@ socket: null database: drone-exercise-rails_test
1
2
3
4
5
6

このファイルで接続先MySQLサーバのホストを指定しているのですが、
-ここでは.drone.ymlで指定したdbがホスト名になっていて、この名前で接続できます。

チェックポイント7 🏁

テスト実行中にデータベースはどこで実行されているでしょうか？

# 8. 参考情報

# 続き

- +ここでは.drone.ymlで指定したdbがホスト名になっていて、この名前で接続できます。

チェックポイント7 🏁

テスト実行中にデータベースはどこで実行されているでしょうか？

# 8. 参考情報

# 続き

+ diff --git a/cicd_infra/github_actions/index.html b/cicd_infra/github_actions/index.html index d93ccab6..30867fde 100644 --- a/cicd_infra/github_actions/index.html +++ b/cicd_infra/github_actions/index.html @@ -8,7 +8,7 @@ - + @@ -244,7 +244,7 @@ Ruby をインストールします。 このあとの run では Ruby のコマンドを利用できます。

また、 一部 with で パラメータを与えられるものもあります。
(Ruby のバージョンを3にしてみるのもよいですね。)

なお、 この action の @v2 や @v1 は branch や tag などの Git 的 refs を意味します。
つまり、 GitHub 上の ある repository の内容を利用しているということです。
-そのため、 repository 側の更新により、意図せず振る舞いが変わる可能性があります。

TIP

公式でも「リリースされたアクションバージョンのコミットSHAを使用するのが、安定性とセキュリティのうえで最も安全です。」としています。

https://docs.github.com/ja/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsuses (opens new window)

# 5. ほかにも

GitHub Actions の最大の特徴は action を組み合わせて workflow を実現できる点でした。

https://github.com/marketplace (opens new window) では さまざまな action を探すことができます

さらには 自分で action を作ることも可能です。

いろいろ探してみてください。

ちなみに、この資料も GitHub Actions で作られています。

https://github.com/iij/bootcamp/actions (opens new window)
https://github.com/iij/bootcamp/tree/master/.github/workflows (opens new window)

# 6. 参考情報

- +そのため、 repository 側の更新により、意図せず振る舞いが変わる可能性があります。

TIP

公式でも「リリースされたアクションバージョンのコミットSHAを使用するのが、安定性とセキュリティのうえで最も安全です。」としています。

https://docs.github.com/ja/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsuses (opens new window)

# 5. ほかにも

GitHub Actions の最大の特徴は action を組み合わせて workflow を実現できる点でした。

https://github.com/marketplace (opens new window) では さまざまな action を探すことができます

さらには 自分で action を作ることも可能です。

いろいろ探してみてください。

ちなみに、この資料も GitHub Actions で作られています。

https://github.com/iij/bootcamp/actions (opens new window)
https://github.com/iij/bootcamp/tree/master/.github/workflows (opens new window)

# 6. 参考情報

+ diff --git a/cicd_infra/jenkins/index.html b/cicd_infra/jenkins/index.html index 38a974fd..716241ac 100644 --- a/cicd_infra/jenkins/index.html +++ b/cicd_infra/jenkins/index.html @@ -8,7 +8,7 @@ - + @@ -72,7 +72,7 @@ welcome to bootcamp bootcamp hogehoge <- パスワード -
1
2
3
4

ちなみに Jenkins の実行結果画面では、秘密情報はマスクされて見えないようになっています。

password3

# 最後に

Jenkins は非常にさまざまなことができますが、そのぶん使いこなすのが難しいです。さらに環境によってバージョンの違いや入っているプラグインの違いで微妙に使い勝手が違ったり、使い方が分かりにくかったり苦労することもあります。

ただしきちんと運用された Jenkins サーバを適切に使うと、さまざまなシステムと連携して自由度の高いビルドを実施できるため開発などの業務を効率化できます。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
- +
1
2
3
4

ちなみに Jenkins の実行結果画面では、秘密情報はマスクされて見えないようになっています。

password3

# 最後に

Jenkins は非常にさまざまなことができますが、そのぶん使いこなすのが難しいです。さらに環境によってバージョンの違いや入っているプラグインの違いで微妙に使い勝手が違ったり、使い方が分かりにくかったり苦労することもあります。

ただしきちんと運用された Jenkins サーバを適切に使うと、さまざまなシステムと連携して自由度の高いビルドを実施できるため開発などの業務を効率化できます。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
+ diff --git a/cicd_infra/prometheus/index.html b/cicd_infra/prometheus/index.html index 0a97baa6..71c5a9b9 100644 --- a/cicd_infra/prometheus/index.html +++ b/cicd_infra/prometheus/index.html @@ -8,7 +8,7 @@ - + @@ -216,7 +216,7 @@ replacement: blackbox_exporter:9115
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

relabel_configsの箇所ではblackbox_exporter自身のラベルを監視対象のラベルに置き換えてます。これをしないとPrometheusに収集されるデータがwordpressに関するものではなく、blackbox_exporterのものだと判断されてしまいます。

これで準備は完了です。docker-compose up -dでblackbox_exporterを起動させたのち、docker-compose restart prometheusでprometheusのコンフィグファイルを再読み込みしてください。localhost:9090でPrometheusサーバにアクセスし、StatusからTartgetを表示し、blackboxが存在すれば成功です。

blackbox_exporter

本当にPrometheusが取得できているかグラフを表示させてみましょう。まずPrometheusホーム画面のExpressionにprobe_successと入力し、Excuteを押してください。

probe_success_table

タブをTableからGraphにし、値が1になっていれば成功です。0は取得に失敗しています。

probe_success

他にもprobe_http_status_codeを使えばそのサイトのHTTPステータスコードを確認できます。

probe_status

最後にGrafanaでHTTPステータスコードを表示して終わりにします。Grafanaをlocalhost:3000で開き、追加したいダッシュボードを選択します。 次にAdd Panelからパネル追加画面を開き、Metricsにprobe_http_status_codeと入力します。

grafana_status_graph

このままだとステータスコードの数字をグラフにしてるだけで味気ないので、InstantをONにし、右のカラムのVisualizationをStatに変更します。

grafana_status

最後にステータスコードごとに色を変えます。右のカラムのタブをFieldにし、Thresholdsを開きます。

thresholds

既存の設定は削除し、300を黄色、400を赤とします。このように設定することでこの値を閾値として、HTTPステータスコードが値を超えると値の色が変ります。下の画像では「ベースは赤(ここでは200未満)」「200以上300未満は青」「300以上400未満は黄色」「400以上は赤」となるように設定しています。

http_status

試しにwordpressの中身を書き換えてみましょう。

# docker exec -it wordpress_1 mv /var/www/html/wp-admin /var/www/html/wp-admins
-
1

を実行すればWebサーバの中身が書き換えられ、HTTPステータスコードが500になり、赤くなるはずです。

http_status

最後にApplyすることで簡単な監視ダッシュボードが完成しました。

all

# 2-4. まとめ

Prometheusは非常に柔軟性の高い有力なツールです。実は今回の講義ではPrometheusの持つ機能の一つであるサービスディスカバリの恩恵を最大限体験することが出来ていません。ほかにも閾値を超えたらアラートを投げるAlertmanagerなど、重要な機能がまだまだたくさんありますが、dockerにて用意する環境に限界があるため、今回は省略しました。Kubernetes上ではサービスディスカバリやAlertmanagerを比較的簡単に体験することができるため、興味のある方は公式サイト (opens new window)などを参考に、体験してみてください。

# 3. 最後に

本講義では「監視そのものの概念説明」から「実際に監視システムを構築する」ところまでを簡単に紹介しました。今回Prometheusをハンズオンにて使用しましたが、Prometheusは決して銀の弾丸にはなりえないということに注意してください。これまでの章で紹介をしましたがツール依存は代表的なアンチパターンです。監視しなければならない対象を明確にし、必要な機能を組み合わせて(時には自分で開発して)監視システムを構築する必要があります。

例えばSRE(Site Reliability Engineering)という考えのエンジニアリング手法では「ユーザに対するサービスレベルの定義」がとても重要になります。サービスレベルを客観的に評価してサービス品質を継続改善するために、指標であるSLI(Indicator)、SLIから算出される目標値であるSLO(Objectives)、そして必要に応じて契約としての合意であるSLA(Agreement)が定義されます。測定できないことは評価することができないため、監視システムが重要視されます。（評価できないと、システムが良いのか悪いのか、良くなったのか悪くなったのか、がわからないので、次のアクションを取ることができません）

監視という概念について詳しく知りたい方はオーライリーの「入門 監視」を読んでみるといいと思います。Prometheusについてもっと詳しく知りたい方はまだまだ日本語のドキュメントが充実していないため、手探りにはなりますが公式サイトを漁ってみたり、「Prometheus Meetup(JP)」などに参加して導入事例を聞いてみるといいと思います。一応「入門Prometheus」という本が出ています。

参考文献

  1. 入門 監視/Mike Julian(オーライリージャパン)
  2. わかばちゃんと学ぶサーバー監視/湊川あい(C&R研究所)
  3. SREサイトリライアビリティエンジニアリング/Betsy Beyer,Chris Jones,Jennifer Petoff,Niall Richard Murphy(オーライリージャパン)
  4. クラウドネイティブ・アーキテクチャ/Tom Laszewki,Kamal Arora,Erik Farr,Piyum Zonooz(インプレス)
- +
1

を実行すればWebサーバの中身が書き換えられ、HTTPステータスコードが500になり、赤くなるはずです。

http_status

最後にApplyすることで簡単な監視ダッシュボードが完成しました。

all

# 2-4. まとめ

Prometheusは非常に柔軟性の高い有力なツールです。実は今回の講義ではPrometheusの持つ機能の一つであるサービスディスカバリの恩恵を最大限体験することが出来ていません。ほかにも閾値を超えたらアラートを投げるAlertmanagerなど、重要な機能がまだまだたくさんありますが、dockerにて用意する環境に限界があるため、今回は省略しました。Kubernetes上ではサービスディスカバリやAlertmanagerを比較的簡単に体験することができるため、興味のある方は公式サイト (opens new window)などを参考に、体験してみてください。

# 3. 最後に

本講義では「監視そのものの概念説明」から「実際に監視システムを構築する」ところまでを簡単に紹介しました。今回Prometheusをハンズオンにて使用しましたが、Prometheusは決して銀の弾丸にはなりえないということに注意してください。これまでの章で紹介をしましたがツール依存は代表的なアンチパターンです。監視しなければならない対象を明確にし、必要な機能を組み合わせて(時には自分で開発して)監視システムを構築する必要があります。

例えばSRE(Site Reliability Engineering)という考えのエンジニアリング手法では「ユーザに対するサービスレベルの定義」がとても重要になります。サービスレベルを客観的に評価してサービス品質を継続改善するために、指標であるSLI(Indicator)、SLIから算出される目標値であるSLO(Objectives)、そして必要に応じて契約としての合意であるSLA(Agreement)が定義されます。測定できないことは評価することができないため、監視システムが重要視されます。（評価できないと、システムが良いのか悪いのか、良くなったのか悪くなったのか、がわからないので、次のアクションを取ることができません）

監視という概念について詳しく知りたい方はオーライリーの「入門 監視」を読んでみるといいと思います。Prometheusについてもっと詳しく知りたい方はまだまだ日本語のドキュメントが充実していないため、手探りにはなりますが公式サイトを漁ってみたり、「Prometheus Meetup(JP)」などに参加して導入事例を聞いてみるといいと思います。一応「入門Prometheus」という本が出ています。

参考文献

  1. 入門 監視/Mike Julian(オーライリージャパン)
  2. わかばちゃんと学ぶサーバー監視/湊川あい(C&R研究所)
  3. SREサイトリライアビリティエンジニアリング/Betsy Beyer,Chris Jones,Jennifer Petoff,Niall Richard Murphy(オーライリージャパン)
  4. クラウドネイティブ・アーキテクチャ/Tom Laszewki,Kamal Arora,Erik Farr,Piyum Zonooz(インプレス)
+ diff --git a/database/mongodb/index.html b/database/mongodb/index.html index 34b0f8ef..a11e1bb9 100644 --- a/database/mongodb/index.html +++ b/database/mongodb/index.html @@ -8,7 +8,7 @@ - + @@ -216,7 +216,7 @@ mongo-set [direct: secondary] bootcamp-db> mongo-set [direct: secondary] bootcamp-db> -
1
2
3
4
5
6
7
8
9

これはrs.reconfig()で設定したpriorityというパラメータに従い、より値の大きいホストがPrimaryになるように設定されているためです。

このようにMongoDBのレプリカセットでは、一台が落ちても自動的に他がPrimaryに昇格し、データの保存を継続できる構成を簡単に作ることができます。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
- +
1
2
3
4
5
6
7
8
9

これはrs.reconfig()で設定したpriorityというパラメータに従い、より値の大きいホストがPrimaryになるように設定されているためです。

このようにMongoDBのレプリカセットでは、一台が落ちても自動的に他がPrimaryに昇格し、データの保存を継続できる構成を簡単に作ることができます。

CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
+ diff --git a/database/mysql/index.html b/database/mysql/index.html index 9a2ef782..a553625a 100644 --- a/database/mysql/index.html +++ b/database/mysql/index.html @@ -8,7 +8,7 @@ - + @@ -16,7 +16,7 @@ GitHub (opens new window)
このハンズオンでやることMySQL を立ち上げSQLを触ることで、RDBの勘所を学びます。
想定時間1h
前提知識・用語なし

# MySQLを触ってみる

資料はこちら (opens new window)

CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
- + (opens new window)

  • MySQLを触ってみる

このハンズオンでやることMySQL を立ち上げSQLを触ることで、RDBの勘所を学びます。
想定時間1h
前提知識・用語なし

# MySQLを触ってみる

資料はこちら (opens new window)

CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
+ diff --git a/database/overview/index.html b/database/overview/index.html index 1a97a088..63fb44bb 100644 --- a/database/overview/index.html +++ b/database/overview/index.html @@ -8,7 +8,7 @@ - + @@ -46,7 +46,7 @@
dead_lock_01
  • トランザクション2がBさんの口座をロックし5万円減額し15万円にする
    dead_lock_02
  • トランザクション1がBさんの口座を10万増額しようとするが、トランザクション2が口座をロック中のため待機
    dead_lock_03
  • トランザクション2がAさんの口座を5万増額しようとするが、トランザクション1が口座をロック中のため待機 -
    dead_lock_04

    • 上記例は、トランザクション1はBさんの口座のロック解除を待つ必要があるが、それにはトランザクション2が終了する必要があり、トランザクション2はAさんの口座のロック解除を待つしか無いが、それにはトランザクション1が終了する必要があり、処理が永久に進まなくなる。そのため、データベースには、デッドロック状態を検知し、デッドロックとなったトランザクションの片方を強制中断させることで、デッドロックを解消する機能が備えられている。

    デッドロックによって強制中断したトランザクションは、データベースによって再度トランザクションが実行されることはないので、アプリケーション側でデッドロックによる中断を検知したらトランザクションを再実行する必要がある。デッドロックは、複数トランザクションを同時実行するのであれば必ず発生するため、アプリケーション作成時にデッドロックが起きる想定で設計しておく必要がある。

    # 分離レベル(isolation level)とは

    トランザクション間の分離･独立性をどのぐらい緩めるか4段階で定義したもの。

    分離レベルの名称 分離レベルの詳細 ダーティーリード ノンリピータブルリード ファンタムリード
    READ UNCOMMITTED 他のトランザクションの確定してない(コミットされていない)データを読み取れる 起きる 起きる 起きる
    READ COMMITTED 他のトランザクションが確定した(コミットした)データを読み取れる - 起きる 起きる
    REPEATABLE READ トランザクション内では同じデータは何度読み取っても同じデータになる - - 起きる
    SERIALIZABLE 複数トランザクションを同時実行しても1つずつ逐次実行した時と同じ結果になる - - -

    SERIALIZABLE以外の分離レベルでは、分離性･独立性を緩めることになるため、分離性･独立性に違反する現象が発生することを理解する必要がある(データベースの実装によって上記表とは異なるケースもある。例えば、MySQLはREPEATABLE READでもファンタムリードは発生しない実装になっている)

    • ダーティーリード(dirty read)

      トランザクション1がデータAを更新した後、トランザクション2がデータAを読み取った状態で、トランザクション1が実行されなければ(ロールバックされる)、トランザクション2が読み取ったデータは実在しないデータを読み取ることになってしまう現象。

      取得データを元に何らかの処理を行う場合は、実在しないデータを元に処理を実施してしまう状況になるため、意図しない結果を出力してしまう恐れがある。

    • ノンリピーダブルリード(non-repeatable read)

      トランザクション1がデータAを読み取ったあと、トランザクション2がデータAを変更して確定(コミット)し、トランザクション1が再度データAを読み取った場合、1回目の読み取りと2回目の読み取り結果が異なってしまう現象。

      読み取るタイミングによってデータ異なってしまうため、アプリケーションの実装によっては、意図しない結果を出力してしまう恐れがある。

    • ファンタムリード(phantom read)

      トランザクション1が条件Aで検索してデータを読み取ると、データα・βが取得できるとする。トランザクション2が、条件Aに該当するデータγを追加し確定(コミット)した場合、トランザクション1が再び条件Aで検索してデータを読み取ると、データα・β以外に、1回目の読み取りでは存在してなかった、トランザクション2が追加したデータγも読み取ってしまうような現象。

      登録データ数などを根拠に処理を行うような実装などで意図しない結果を出力してしまう恐れがある。

    高い分離レベルを実現するためには、ロックをかけてデータを保護するため必要があるため、同時実行速度が犠牲になる。一方で低い分離レベルは、ロックをかける必要がなくなるため、同時実行時の速度が向上する。データベース製品ごとにどのように分離レベルが実装されているかを理解しつつ、上記のような現象が発生するリスクを許容できるかアプリケーション設計者がよく検討した上で、データの安全性よりも実行速度を重視したい場合、分離レベルを低くすることも1つの選択肢になる。

    # 永続性(Durability)とは

    永続性とは、トランザクションが確定(コミット)したら、それ以降にデータが失われないように保証する特性。

    トランザクションにおいて、処理が全て完了し確定(コミット)する場合、確定(コミット)が成功したら、それ以降は確定されたデータは永久に消えない状態になっている必要がある。

    しかし、一般的に永続ディスク(ハードディスク・SSDなど)への書き込みは低速で時間のかかる処理とされている。そのため、LinuxなどのOSは、書き込み処理を高速化するため、永続ディスクよりも高速に書き込みが可能なキャッシュ領域にデータを書き込むことでアプリケーションに対しては書き込み処理完了とするような実装になっている。そして、キャッシュ領域から永続ディスクへは、一定間隔でまとめて書き込みを行う(フラッシュ処理)実装になっているが、キャッシュ領域で使われるのは、揮発性のメモリー(RAM)であるため、電源断が生じるとデータが消失してしまう。

    仮に、確定(コミット)が成功したかの根拠となるデータの書き込み成功が、OSが用意しているキャッシュ(揮発性メモリー)領域への書き込みだった場合、電源断などの障害によってデータが消失する可能性があり、永続性の原則に違反する状況が発生してしまう。データベースでは、こうした状況を防ぐため確定(コミット)する際に、OSのキャッシュ領域ではなく、永続ディスクへの書き込みになるように制御するような機能が備わっている。

    # まとめ

    # データを扱うことの難しさを知る

    データを確実に保存し、必要な場面で確実に利用するためには、様々なことに注意を払う必要があります。アプリケーション開発者は、これまで見てきたようなデータに関して起きうる全ての状況を想定しながら、アプリケーションの設計・実装していく必要がありますが、データに関して起きうる全ての事象に対応したアプリケーションを1から実装するのは非現実的です(いわゆる車輪の再発明 (opens new window))。

    # データベースを学び利用する

    データベースを学ぶことは、データを扱う上で起きうる事象を学ぶことができ、アプリケーション開発の中でデータを扱う際に何に配慮すれば良いか見えて来ると思います。また、データベースを利用することで、データを扱う上で起きうる事象への配慮をデータベースに任せることができれば、アプリケーション開発者はアプリケーションに求められる本質的な機能の実装に集中でき、より良いアプリケーション開発を行うことができるようになると思います。

    # 必要な機能を備えたデータベース製品を選定する

    昨今、様々なデータベース製品がリリースされています。それらの製品ごとにメリット･デメリット、得意･不得意な領域が存在します。データの安全性を重視するのか、それとも速度を重視するかなど、アプリケーションごとにデータに対する要求の方向性は変わってきますが、求める方向性に合致するデータベース製品を選定できるようになるためにも、データベースの知識を持つことが重要だと思います。

    - +
    dead_lock_04

    上記例は、トランザクション1はBさんの口座のロック解除を待つ必要があるが、それにはトランザクション2が終了する必要があり、トランザクション2はAさんの口座のロック解除を待つしか無いが、それにはトランザクション1が終了する必要があり、処理が永久に進まなくなる。そのため、データベースには、デッドロック状態を検知し、デッドロックとなったトランザクションの片方を強制中断させることで、デッドロックを解消する機能が備えられている。

    デッドロックによって強制中断したトランザクションは、データベースによって再度トランザクションが実行されることはないので、アプリケーション側でデッドロックによる中断を検知したらトランザクションを再実行する必要がある。デッドロックは、複数トランザクションを同時実行するのであれば必ず発生するため、アプリケーション作成時にデッドロックが起きる想定で設計しておく必要がある。

    # 分離レベル(isolation level)とは

    トランザクション間の分離･独立性をどのぐらい緩めるか4段階で定義したもの。

    分離レベルの名称 分離レベルの詳細 ダーティーリード ノンリピータブルリード ファンタムリード
    READ UNCOMMITTED 他のトランザクションの確定してない(コミットされていない)データを読み取れる 起きる 起きる 起きる
    READ COMMITTED 他のトランザクションが確定した(コミットした)データを読み取れる - 起きる 起きる
    REPEATABLE READ トランザクション内では同じデータは何度読み取っても同じデータになる - - 起きる
    SERIALIZABLE 複数トランザクションを同時実行しても1つずつ逐次実行した時と同じ結果になる - - -

    SERIALIZABLE以外の分離レベルでは、分離性･独立性を緩めることになるため、分離性･独立性に違反する現象が発生することを理解する必要がある(データベースの実装によって上記表とは異なるケースもある。例えば、MySQLはREPEATABLE READでもファンタムリードは発生しない実装になっている)

    • ダーティーリード(dirty read)

      トランザクション1がデータAを更新した後、トランザクション2がデータAを読み取った状態で、トランザクション1が実行されなければ(ロールバックされる)、トランザクション2が読み取ったデータは実在しないデータを読み取ることになってしまう現象。

      取得データを元に何らかの処理を行う場合は、実在しないデータを元に処理を実施してしまう状況になるため、意図しない結果を出力してしまう恐れがある。

    • ノンリピーダブルリード(non-repeatable read)

      トランザクション1がデータAを読み取ったあと、トランザクション2がデータAを変更して確定(コミット)し、トランザクション1が再度データAを読み取った場合、1回目の読み取りと2回目の読み取り結果が異なってしまう現象。

      読み取るタイミングによってデータ異なってしまうため、アプリケーションの実装によっては、意図しない結果を出力してしまう恐れがある。

    • ファンタムリード(phantom read)

      トランザクション1が条件Aで検索してデータを読み取ると、データα・βが取得できるとする。トランザクション2が、条件Aに該当するデータγを追加し確定(コミット)した場合、トランザクション1が再び条件Aで検索してデータを読み取ると、データα・β以外に、1回目の読み取りでは存在してなかった、トランザクション2が追加したデータγも読み取ってしまうような現象。

      登録データ数などを根拠に処理を行うような実装などで意図しない結果を出力してしまう恐れがある。

    高い分離レベルを実現するためには、ロックをかけてデータを保護するため必要があるため、同時実行速度が犠牲になる。一方で低い分離レベルは、ロックをかける必要がなくなるため、同時実行時の速度が向上する。データベース製品ごとにどのように分離レベルが実装されているかを理解しつつ、上記のような現象が発生するリスクを許容できるかアプリケーション設計者がよく検討した上で、データの安全性よりも実行速度を重視したい場合、分離レベルを低くすることも1つの選択肢になる。

    # 永続性(Durability)とは

    永続性とは、トランザクションが確定(コミット)したら、それ以降にデータが失われないように保証する特性。

    トランザクションにおいて、処理が全て完了し確定(コミット)する場合、確定(コミット)が成功したら、それ以降は確定されたデータは永久に消えない状態になっている必要がある。

    しかし、一般的に永続ディスク(ハードディスク・SSDなど)への書き込みは低速で時間のかかる処理とされている。そのため、LinuxなどのOSは、書き込み処理を高速化するため、永続ディスクよりも高速に書き込みが可能なキャッシュ領域にデータを書き込むことでアプリケーションに対しては書き込み処理完了とするような実装になっている。そして、キャッシュ領域から永続ディスクへは、一定間隔でまとめて書き込みを行う(フラッシュ処理)実装になっているが、キャッシュ領域で使われるのは、揮発性のメモリー(RAM)であるため、電源断が生じるとデータが消失してしまう。

    仮に、確定(コミット)が成功したかの根拠となるデータの書き込み成功が、OSが用意しているキャッシュ(揮発性メモリー)領域への書き込みだった場合、電源断などの障害によってデータが消失する可能性があり、永続性の原則に違反する状況が発生してしまう。データベースでは、こうした状況を防ぐため確定(コミット)する際に、OSのキャッシュ領域ではなく、永続ディスクへの書き込みになるように制御するような機能が備わっている。

    # まとめ

    # データを扱うことの難しさを知る

    データを確実に保存し、必要な場面で確実に利用するためには、様々なことに注意を払う必要があります。アプリケーション開発者は、これまで見てきたようなデータに関して起きうる全ての状況を想定しながら、アプリケーションの設計・実装していく必要がありますが、データに関して起きうる全ての事象に対応したアプリケーションを1から実装するのは非現実的です(いわゆる車輪の再発明 (opens new window))。

    # データベースを学び利用する

    データベースを学ぶことは、データを扱う上で起きうる事象を学ぶことができ、アプリケーション開発の中でデータを扱う際に何に配慮すれば良いか見えて来ると思います。また、データベースを利用することで、データを扱う上で起きうる事象への配慮をデータベースに任せることができれば、アプリケーション開発者はアプリケーションに求められる本質的な機能の実装に集中でき、より良いアプリケーション開発を行うことができるようになると思います。

    # 必要な機能を備えたデータベース製品を選定する

    昨今、様々なデータベース製品がリリースされています。それらの製品ごとにメリット･デメリット、得意･不得意な領域が存在します。データの安全性を重視するのか、それとも速度を重視するかなど、アプリケーションごとにデータに対する要求の方向性は変わってきますが、求める方向性に合致するデータベース製品を選定できるようになるためにも、データベースの知識を持つことが重要だと思います。

    + diff --git a/database/postgresql/index.html b/database/postgresql/index.html index 82824354..40518256 100644 --- a/database/postgresql/index.html +++ b/database/postgresql/index.html @@ -8,7 +8,7 @@ - + @@ -213,7 +213,7 @@ ※再度利用する際には docker start some-postgres にて起動可能させます。

    docker stop some-postgres
 
 docker ps -a
-
    1
    2
    3

    以上

    - +
    1
    2
    3

    以上

    + diff --git a/database/redis/index.html b/database/redis/index.html index 959ba234..6d92d6f2 100644 --- a/database/redis/index.html +++ b/database/redis/index.html @@ -8,7 +8,7 @@ - + @@ -284,7 +284,7 @@ }
    1
    2
    3
    4
    5

    サンプル: https://github.com/iij/bootcamp/blob/master/src/database/redis/ex02.py (opens new window)

    # Expire を試してみる

    # メッセージキューを実装する

    • メッセージキュー的なものを実装してみよう

      • 依頼側: ランダム秒 sleep して、メッセージをキューに入れる
      • 取り出し側: ランダム秒 sleep して、メッセージをキューから取り出す

    • 使用例: web クローラー

      • 依頼側: URL をどんどんキューに入れる
      • 取り出し側: キューを見て URL が入っていたら、取得してファイルに保存する -
        • 結果(ファイルの場所)を別のキューで戻してもいいですね

    # Advanced: Redis Pub/Sub, Streams を使ってみよう

    # Advanced: GIS で遊んでみよう

    # 参考資料

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    - +
    • 結果(ファイルの場所)を別のキューで戻してもいいですね

    # Advanced: Redis Pub/Sub, Streams を使ってみよう

    # Advanced: GIS で遊んでみよう

    # 参考資料

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    + diff --git a/development/docker/docker-compose/index.html b/development/docker/docker-compose/index.html index 4402877c..9452660e 100644 --- a/development/docker/docker-compose/index.html +++ b/development/docker/docker-compose/index.html @@ -8,7 +8,7 @@ - + @@ -151,7 +151,7 @@
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37

    # 4. まとめ

    本講義では、Docker Compose を紹介し、実際にdocker compose コマンドを使って、複数のサービスを管理していただきました。 複数のDocker コンテナを管理する場合、Docker Compose を用いるとDocker単独で利用するよりも効率的に管理することができるためぜひ利用してください。 また、OSS の中ではDocker イメージを始め、docker-compose.yml を公開しているものも多いため、それらを使って簡単に検証作業や環境構築などを行うことができます。 -ぜひ有効活用してみてください。

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    - +ぜひ有効活用してみてください。

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    + diff --git a/development/docker/docker/BUILD.html b/development/docker/docker/BUILD.html index 382a227b..c01bff39 100644 --- a/development/docker/docker/BUILD.html +++ b/development/docker/docker/BUILD.html @@ -8,7 +8,7 @@ - + @@ -61,7 +61,7 @@ </html>
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12

    上記のように実際に作成したHTMLが表示されていれば成功です。 プロキシを設定している場合は下記のように--noproxyオプションを指定する必要があります。

    $ curl --noproxy localhost http://localhost:8888
-
    1

    # 参考情報

    # Docker イメージの共有方法

    皆さんが作成したDocker イメージなどを他の人に共有したい場合、Dockerfile をファイルサーバやGitHub 等で共有する以外に、Docker Hub (opens new window)を始めとする「Docker イメージレジストリ」で公開し、それを利用してもらうことが可能です。例えば、本講義で利用した「getting-started」や「ubuntu」のDocker イメージは、Docker Hubで公開されているものを利用しています。

    Docker イメージレジストリに自分のDocker イメージを公開する際には、docker push コマンドを利用します。逆に、Docker イメージをダウンロードしたい場合は、docker pull コマンドを利用します。また、Dockerイメージをdocker save コマンドでtarファイルとして保存し、docker load コマンドでtarからロードするといったことも行うことができます。

    # まとめ

    今回は、仮想環境プラットフォームであるDocker を実際に触っていただきました。Docker の基礎知識、Docker コンテナ、イメージの管理方法に加え、Dockerfile を作成し自身でコンテナを作っていただきました。仮想マシンに比べ軽く高速で作成することが可能なため使いどころは多いでしょう。しかしながら、実際のサービスでは、単一のアプリケーションのみで1つのコンテナで完成することはありえません。Web サーバやWeb アプリケーション、データベースなど様々なものが１つに組み合わさって初めてサービスとして完成します。Docker コンテナでは、「1コンテナ1プロセス」や「1コンテナ1ロール」が基本となっています。そのため複数のコンテナを組み合わせて構築する必要があります。次の講義「開発環境をdocker-composeで構築」では、複数のコンテナを組み合わせて管理する手法について学びます。

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    - +
    1

    # 参考情報

    # Docker イメージの共有方法

    皆さんが作成したDocker イメージなどを他の人に共有したい場合、Dockerfile をファイルサーバやGitHub 等で共有する以外に、Docker Hub (opens new window)を始めとする「Docker イメージレジストリ」で公開し、それを利用してもらうことが可能です。例えば、本講義で利用した「getting-started」や「ubuntu」のDocker イメージは、Docker Hubで公開されているものを利用しています。

    Docker イメージレジストリに自分のDocker イメージを公開する際には、docker push コマンドを利用します。逆に、Docker イメージをダウンロードしたい場合は、docker pull コマンドを利用します。また、Dockerイメージをdocker save コマンドでtarファイルとして保存し、docker load コマンドでtarからロードするといったことも行うことができます。

    # まとめ

    今回は、仮想環境プラットフォームであるDocker を実際に触っていただきました。Docker の基礎知識、Docker コンテナ、イメージの管理方法に加え、Dockerfile を作成し自身でコンテナを作っていただきました。仮想マシンに比べ軽く高速で作成することが可能なため使いどころは多いでしょう。しかしながら、実際のサービスでは、単一のアプリケーションのみで1つのコンテナで完成することはありえません。Web サーバやWeb アプリケーション、データベースなど様々なものが１つに組み合わさって初めてサービスとして完成します。Docker コンテナでは、「1コンテナ1プロセス」や「1コンテナ1ロール」が基本となっています。そのため複数のコンテナを組み合わせて構築する必要があります。次の講義「開発環境をdocker-composeで構築」では、複数のコンテナを組み合わせて管理する手法について学びます。

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    + diff --git a/development/docker/docker/GETSTART.html b/development/docker/docker/GETSTART.html index 5ff72d28..6b9166cd 100644 --- a/development/docker/docker/GETSTART.html +++ b/development/docker/docker/GETSTART.html @@ -8,7 +8,7 @@ - + @@ -51,7 +51,7 @@
    1
  • コンテナが停止したことの確認
    • ブラウザにて http://localhost (opens new window)にアクセスし、アクセスできないことを確認する
    • docker psコマンドを用いて、何も表示されないことを確認する
      docker ps
 CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES
-
      1
      2
    • CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    - +
    1
    2
    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    + diff --git a/development/docker/docker/OPERATION.html b/development/docker/docker/OPERATION.html index af0d552f..663da6e4 100644 --- a/development/docker/docker/OPERATION.html +++ b/development/docker/docker/OPERATION.html @@ -8,7 +8,7 @@ - + @@ -50,7 +50,7 @@ docker/getting-started
    1
    2

    # まとめ

    ここまで実施することでDockerコンテナの取得から後片付けまでの一通りの作業ができるようになりました。 しかし、実際に自分好みのDockerイメージを作るにはどうすれば良いでしょうか。 -次項ではDockerイメージの作り方について学びたいと思います。

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    - +次項ではDockerイメージの作り方について学びたいと思います。

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    + diff --git a/development/docker/docker/RUN_AS_IMAGE.html b/development/docker/docker/RUN_AS_IMAGE.html index 0fe9949c..caf43c19 100644 --- a/development/docker/docker/RUN_AS_IMAGE.html +++ b/development/docker/docker/RUN_AS_IMAGE.html @@ -8,7 +8,7 @@ - + @@ -50,7 +50,7 @@ CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
    1
    2

    # 参考

    # Docker イメージのビルド

    Dockerコンテナを使って仮想環境プラットフォームを作成するためには、Dockerイメージが必要となります。

    通常であれば、Dockerfileを使用して自分のアプリケーションのDockerイメージを作成します。 Dockerfileは、アプリケーションの依存関係や設定、実行コマンドなどを指定するためのテキストファイルです。 -DockerFileが作成できたらDockerイメージをビルドして作成します。その際に使うコマンドはdocker buildになります。

    通常であればテキストエディタを開いてDockerFileを作成しますが、完全にゼロの状態からDockerFileを作成するのは難しい為、先ずはチュートリアル用に公開されている物を使用すると良いでしょう

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    - +DockerFileが作成できたらDockerイメージをビルドして作成します。その際に使うコマンドはdocker buildになります。

    通常であればテキストエディタを開いてDockerFileを作成しますが、完全にゼロの状態からDockerFileを作成するのは難しい為、先ずはチュートリアル用に公開されている物を使用すると良いでしょう

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    + diff --git a/development/docker/docker/index.html b/development/docker/docker/index.html index 7e17c2cf..1e0f9bb5 100644 --- a/development/docker/docker/index.html +++ b/development/docker/docker/index.html @@ -8,7 +8,7 @@ - + @@ -23,7 +23,7 @@ Dockerのインストールが完了していない方は、「ハンズオン事前準備」を済ませてください。

    # Chapters

    # 参考

    # 仮想マシン vs コンテナ

    仮想マシンとコンテナ、どちらが優れており、どちらを使うべきなのでしょう？

    それは一概にどちらが優れているからそうすべき、といった類いの物ではありません。 コンテナは仮想マシンと比べて後発であるため、仮想マシンが抱えていた問題を解決しているのは確かですが、上位互換という事ではありません。 コンテナには仮想マシンには無いメリットもありますがデメリットもあります。 -コンテナは仮想マシンと異なり、OS の中で別のOSを起動するという事が無いため、セットアップや起動時においてもOSに関わる処理を必要としない為、時間を大幅に短縮することが可能です。また、ハードウェアにアクセスする際もゲストOSを介することが無いため、オーバーヘッドが少なく高速な動作が期待できます。

    しかし、その一方で仮想マシンと比べてホストOSとの独立性が少ないため、ホストOSとアーキテクチャが大きく異なるコンテナを共存させることはできません。

    例）Linux 上で Windows コンテナを起動・実行する

    # Docker のアーキテクチャ

    Docker Image

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    - +コンテナは仮想マシンと異なり、OS の中で別のOSを起動するという事が無いため、セットアップや起動時においてもOSに関わる処理を必要としない為、時間を大幅に短縮することが可能です。また、ハードウェアにアクセスする際もゲストOSを介することが無いため、オーバーヘッドが少なく高速な動作が期待できます。

    しかし、その一方で仮想マシンと比べてホストOSとの独立性が少ないため、ホストOSとアーキテクチャが大きく異なるコンテナを共存させることはできません。

    例）Linux 上で Windows コンテナを起動・実行する

    # Docker のアーキテクチャ

    Docker Image

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    + diff --git a/development/git/index.html b/development/git/index.html index 2460d717..74035527 100644 --- a/development/git/index.html +++ b/development/git/index.html @@ -8,7 +8,7 @@ - + @@ -171,7 +171,7 @@ こんにちは ぎっと おやすみ ぎっと
    1
    2
    3

    Git の基本操作を一通り流してやってみました。 -Git ハンズオンは以上で終了です。

    次は GitHub ハンズオン に進んでください。

    # 7. 参考文献

    さらに高度な使い方を知りたい方はPro Git (opens new window)が便利です。日本語版が公開されています。

    こんな説明じゃブランチがわからん！という人は Learn Git Branching (日本語版) (opens new window) で練習できます。

    # 7.1. GUIクライアント

    Gitには、機能が限定されますがGUIクライアントも用意されています。おすすめは以下の3つのクライアントです。

    また各種統合開発環境にもGitを操作する機能が含まれています。

    これらのクライアントの利用も検討してください。

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    - +Git ハンズオンは以上で終了です。

    次は GitHub ハンズオン に進んでください。

    # 7. 参考文献

    さらに高度な使い方を知りたい方はPro Git (opens new window)が便利です。日本語版が公開されています。

    こんな説明じゃブランチがわからん！という人は Learn Git Branching (日本語版) (opens new window) で練習できます。

    # 7.1. GUIクライアント

    Gitには、機能が限定されますがGUIクライアントも用意されています。おすすめは以下の3つのクライアントです。

    また各種統合開発環境にもGitを操作する機能が含まれています。

    これらのクライアントの利用も検討してください。

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    + diff --git a/development/github/index.html b/development/github/index.html index ec10ab9b..a65e4e8e 100644 --- a/development/github/index.html +++ b/development/github/index.html @@ -8,7 +8,7 @@ - + @@ -100,7 +100,7 @@ (opens new window)

    コラボレーターを個人リポジトリに招待する(GitHub Enterprise版) (opens new window)

    1. ローカルブランチを作成する
    2. なにかを修正する
    3. ローカルブランチにコミットする
    4. pushする
    5. mainブランチに対してPull Requestを作成する
    6. TAがレビューする
    7. 必要に応じてさらに修正する
    8. レビューが承認される
    9. mainにマージされる
    10. (オプション) TAがコミットするのであなたがレビューしてください！

    # 7. Gist

    Gist (opens new window) はテキストデータを保存し、公開することのできる「Pastebin」と呼ばれるサービスの一種です。 GitHubのアカウントを持っている人は自由に作成でき、参照は自由にできます。 コードハイライトを利用することもできます。

    IIJでは社内での情報共有のためConfluence (opens new window)が導入されていますが、 -confluenceにgistのURLを貼ると内容が自動で展開されるマクロが導入されています。

    gistをcfに貼り付けた様子

    # 8. Next Action

    このハンズオンが終わったら自分のメンターに相談して、所属部署のリポジトリにPull Requestをしてみましょう。

    # 9. 参考資料

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    - +confluenceにgistのURLを貼ると内容が自動で展開されるマクロが導入されています。

    gistをcfに貼り付けた様子

    # 8. Next Action

    このハンズオンが終わったら自分のメンターに相談して、所属部署のリポジトリにPull Requestをしてみましょう。

    # 9. 参考資料

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    + diff --git a/development/kubernetes/index.html b/development/kubernetes/index.html index 2546716a..67167a9b 100644 --- a/development/kubernetes/index.html +++ b/development/kubernetes/index.html @@ -8,7 +8,7 @@ - + @@ -415,7 +415,7 @@ prometheus_main-nemu これでKuberentes上の各コンポーネントに対して監視を行うことが出来ました。

    【Prometheus講義を受講した人向け】

    式ブラウザから各種APIオブジェクトのメトリクス情報を取得してみてください。 また、Kubernetes上で動くアプリケーションの監視にはkube-state-metricsやcAdvidsorといったエクスポートを利用します。余裕のある人はPodの監視も行ってみてください。

    # 5. 最後に

    Kubernetesの紹介と代表的なオブジェクトであるDeploymentとServiceについて簡単に触ってみました。 -Kubetenetesでは他にも様々なオブジェクトや設定を使います。

    例えば

    • アプリケーションの環境変数を設定するためにenvを使う
    • データベースなどステートフルなpodを稼働させるためにStatefulSetを使う
    • データの永続化のためPersistentVolumeやPersistentVolumeClaimを使う
    • アプリケーションのコンフィグファイルを管理するのにConfigMapを使う
    • APIキーやパスワードなど秘密情報を扱うためにSecretを使う(ただしキー値はbase64でエンコードされた文字列)

    などなどです。PersistentVolumeやPersistentVolumeClaimなどはディストリビューションごとに扱い方が違ったりしますし、構築したいアプリケーションによってマニフェストファイルの書き方は様々なので今回は割愛しました。

    社内でKubetenetesを使ってアプリケーションを構築する場合はIKEが使いやすいかと思いますので、ぜひチュートリアルなどを眺めてみてください。

    【参考文献】

    1. Kubernetes完全ガイド/青山信也(インプレス)
    2. イラストでわかるDockerとKubernetes/徳永航平(技術評論社)
    3. Docker/Kubernetes実践コンテナ開発入門/山田明憲(技術評論社)
    4. Kubernetes公式ドキュメント (opens new window)/CNCF
    5. Prometheus実践ガイド/仲亀拓馬(テッキーメディア)
    - +Kubetenetesでは他にも様々なオブジェクトや設定を使います。

    例えば

    • アプリケーションの環境変数を設定するためにenvを使う
    • データベースなどステートフルなpodを稼働させるためにStatefulSetを使う
    • データの永続化のためPersistentVolumeやPersistentVolumeClaimを使う
    • アプリケーションのコンフィグファイルを管理するのにConfigMapを使う
    • APIキーやパスワードなど秘密情報を扱うためにSecretを使う(ただしキー値はbase64でエンコードされた文字列)

    などなどです。PersistentVolumeやPersistentVolumeClaimなどはディストリビューションごとに扱い方が違ったりしますし、構築したいアプリケーションによってマニフェストファイルの書き方は様々なので今回は割愛しました。

    社内でKubetenetesを使ってアプリケーションを構築する場合はIKEが使いやすいかと思いますので、ぜひチュートリアルなどを眺めてみてください。

    【参考文献】

    1. Kubernetes完全ガイド/青山信也(インプレス)
    2. イラストでわかるDockerとKubernetes/徳永航平(技術評論社)
    3. Docker/Kubernetes実践コンテナ開発入門/山田明憲(技術評論社)
    4. Kubernetes公式ドキュメント (opens new window)/CNCF
    5. Prometheus実践ガイド/仲亀拓馬(テッキーメディア)
    + diff --git a/frontend/angular/index.html b/frontend/angular/index.html index 7d000767..6c82e414 100644 --- a/frontend/angular/index.html +++ b/frontend/angular/index.html @@ -8,7 +8,7 @@ - + @@ -307,7 +307,7 @@ ).subscribe(num => { console.log(num); // 「6」「8」「10」 が順番に表示される }); -
    1
    2
    3
    4
    5
    6
    7

    やはり詳しくは 公式ドキュメント (opens new window) を参照してください（若干分かりにくいかもしれません）。

    Angular ではHTTPリクエストはもちろん、URLの変更やform要素の入力、ユーザーイベントなど全ての変更がObservableで処理されています。

    - +
    1
    2
    3
    4
    5
    6
    7

    やはり詳しくは 公式ドキュメント (opens new window) を参照してください（若干分かりにくいかもしれません）。

    Angular ではHTTPリクエストはもちろん、URLの変更やform要素の入力、ユーザーイベントなど全ての変更がObservableで処理されています。

    + diff --git a/frontend/dom/index.html b/frontend/dom/index.html index 14f040c6..1320c911 100644 --- a/frontend/dom/index.html +++ b/frontend/dom/index.html @@ -8,7 +8,7 @@ - + @@ -469,7 +469,7 @@
    1

    最後に、ここまでで中身を組み立てたp要素が画面上で見えるよう、bodyに追加します。bodyもDOM要素の一つなので、やることは先ほどと同様.appendChildを、今度はp要素に対して呼ぶだけです:

    document.body.appendChild(p);
    1

    これで、メッセージを投稿するSNSっぽいものができました🎉！

    # 🚩チェックポイント

    スクリーンショットのように、「投稿」と書かれたボタンをクリックする度、入力欄に入力したメッセージを追記する機能が実装できた。

    # 要素を削除する

    人生、誰しもやり直したいことがありますよね。メッセージを追記する機能を実装したまではよかったものの、もしかしたら間違ってあらぬことを投稿してしまって、削除したくなるかも知れません。そこで最後は、DOM要素を削除する方法を学ぶことで、追記したメッセージを削除する機能を作ってみましょう！

    まずは下準備として、前節で作成した5.htmlを6.htmlという名前にコピーします。それから、再び投稿するbutton要素のイベントリスナーの本体を編集します。

    下準備ができたら、先ほどのイベントリスナーでp要素を作った後、コード例で言うところのconst p = document.createElement("p");という行の下で、新しくbutton要素を作り、p要素にappendChildしてください。そうすることで、一つ一つのメッセージの左側にボタンが作られます。button要素の中身は、Xと一文字だけ入ったテキストノードにしましょう。後でこれにイベントリスナーを追加することで、「削除ボタン」として機能してもらいます。

    これまでの総復習のようなコードになるのでよく思い出しながら書いてください。うまくいっていれば、次👇のスクリーンショットにあるようなボタンが、各メッセージの左に表示されるはずです。うまくいかなかったら、TAの方などに聞いてみてください！

    あと一歩です。仕上げとして、新たに追加したボタンの、clickイベントに対してイベントリスナーを追加します。そして、そのイベントリスナーの関数本体で、removeChild (opens new window)というメソッドを呼び出します:

    document.body.removeChild(p);
    1

    上記のremoveChildというメソッドが、まさしく要素を削除するためのメソッドです。removeChildは、呼び出し元の要素における直接の子ノードを引数として与えることで、引数として指定したノードを削除します。

    上記の場合、削除するp要素はbodyに属しているので、document.bodyからremoveChildを呼び出すことで、削除しています。

    全てがうまくいっていれば、下記のように動作する削除ボタンができてるはずです！

    # 🚩チェックポイント

    スクリーンショットのように、「X」と書かれたボタンをクリックすると、追記した要素を削除する機能を実装できた。

    # ここまでのまとめ

    • ユーザーなどがDOMの要素に対して何らかの操作を行った際実行するJavaScriptのコードを設定するには、要素のaddEventListenerというメソッドを使う
    • addEventListenerに渡した関数が受け取るEventオブジェクトは、対象のイベントが発生したときの詳細な情報を含む -
      • 例えば、イベントオブジェクトのtargetというキーを通じて、イベントが発生した要素を取得することができる
    • DOMツリーにおける、決まった要素に簡単にアクセスするには、HTMLのid属性やclass属性と、document.getElementByIdメソッドやdocument.getElementsByClassNameメソッドを組み合わせて使う
    • 新しく要素を作ってDOMツリーに追加するには、document.createElementメソッドと、親の要素.appendChildメソッドを使う
    • 新しく作った要素の内容として、テキストノードを作りたい場合はdocument.createTextNodeメソッドを使う
    • 要素を削除するには親の要素.removeChildメソッドを使う

    # 参考文献（本文中で言及しなかったもののみ）

    - +
    • 例えば、イベントオブジェクトのtargetというキーを通じて、イベントが発生した要素を取得することができる
  • DOMツリーにおける、決まった要素に簡単にアクセスするには、HTMLのid属性やclass属性と、document.getElementByIdメソッドやdocument.getElementsByClassNameメソッドを組み合わせて使う
  • 新しく要素を作ってDOMツリーに追加するには、document.createElementメソッドと、親の要素.appendChildメソッドを使う
  • 新しく作った要素の内容として、テキストノードを作りたい場合はdocument.createTextNodeメソッドを使う
  • 要素を削除するには親の要素.removeChildメソッドを使う

    • # 参考文献（本文中で言及しなかったもののみ）

    + diff --git a/frontend/jquery/index.html b/frontend/jquery/index.html index 6fbd0875..bcfe720d 100644 --- a/frontend/jquery/index.html +++ b/frontend/jquery/index.html @@ -8,7 +8,7 @@ - + @@ -295,7 +295,7 @@ console.log($p.get(0)); // p == $p.get(0) であり、 $p == $(p) == $($p.get(0)) です -
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16

    一般的にはあまり推奨されませんが、jQuery を使った JavaScript コードでは（システム）ハンガリアン記法がしばしば採用されます。jQuery オブジェクトを保持する変数は $p のように変数名を $ から始めるというものです。これは好みの問題なので変数名はどのように書いても構いません。

    # おわりに

    今回は DOM 操作以外のテーマについてあまり触れられませんでした。

    • DOM 操作
    • スクロール制御（ページ内リンクのスムーススクロール）
    • jQuery アニメーション（フェード、スライドショー、イージング）
    • Ajax 通信（ajax メソッド、load メソッド）

    jQuery は DOM Manipulator ライブラリであり、DOM 操作を中心に上記のような応用をする際には有用なライブラリです。

    一方で、途中でも述べましたが Angular や React, Vue.js は JavaScript ベースの Web アプリケーションを開発する際に有用なフレームワークです。それらの使い方は jQuery とは目的が異なるため、「Vue.js と jQuery のどちらを使うべきか」という単純な比較はあまり意味がありません。

    また、最近では IE6 〜 IE8 のような古いブラウザを考慮する必要がなくなったため、jQuery を使わずともネイティブの JavaScript メソッドや HTML5, CSS3 の時代に使えるようになった機能を用いることで、ブラウザごとの実装状況や不具合に悩まされずに JavaScript 開発ができるようになってきました。

    ブラウザ戦争の歴史や JavaScript の歴史を知ると、どういう JavaScript フレームワークがなぜ便利で、どのような場面で使うべきなのかというのを判断できるようになるかもしれません。そのような歴史や背景についても興味を持っていただけたら幸いです。

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    - +
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16

    一般的にはあまり推奨されませんが、jQuery を使った JavaScript コードでは（システム）ハンガリアン記法がしばしば採用されます。jQuery オブジェクトを保持する変数は $p のように変数名を $ から始めるというものです。これは好みの問題なので変数名はどのように書いても構いません。

    # おわりに

    今回は DOM 操作以外のテーマについてあまり触れられませんでした。

    • DOM 操作
    • スクロール制御（ページ内リンクのスムーススクロール）
    • jQuery アニメーション（フェード、スライドショー、イージング）
    • Ajax 通信（ajax メソッド、load メソッド）

    jQuery は DOM Manipulator ライブラリであり、DOM 操作を中心に上記のような応用をする際には有用なライブラリです。

    一方で、途中でも述べましたが Angular や React, Vue.js は JavaScript ベースの Web アプリケーションを開発する際に有用なフレームワークです。それらの使い方は jQuery とは目的が異なるため、「Vue.js と jQuery のどちらを使うべきか」という単純な比較はあまり意味がありません。

    また、最近では IE6 〜 IE8 のような古いブラウザを考慮する必要がなくなったため、jQuery を使わずともネイティブの JavaScript メソッドや HTML5, CSS3 の時代に使えるようになった機能を用いることで、ブラウザごとの実装状況や不具合に悩まされずに JavaScript 開発ができるようになってきました。

    ブラウザ戦争の歴史や JavaScript の歴史を知ると、どういう JavaScript フレームワークがなぜ便利で、どのような場面で使うべきなのかというのを判断できるようになるかもしれません。そのような歴史や背景についても興味を持っていただけたら幸いです。

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    + diff --git a/frontend/overview/index.html b/frontend/overview/index.html index 073f2ba8..bc69ef61 100644 --- a/frontend/overview/index.html +++ b/frontend/overview/index.html @@ -8,7 +8,7 @@ - + @@ -31,7 +31,7 @@ VueやReactなどにはSSR用のライブラリが存在しており、SSRでの生成と表示後の動的な書き換えそれぞれをスムーズに実装できるようになっています。

    SSRはSEO対策だけでなく、初期読み込み時の何も表示されない時間を減らすなど、ユーザ体験向上にも有効です。 一方でSEO対策がほぼ不要で初期読み込みよりも利用中の挙動を優先するWebサービスの管理画面では、これまで通りSPAが有効です。

    # wasm

    最近ではC言語やRust, Goなどで書かれたプログラムをバイナリファイルにコンパイルし、それをブラウザ上で動作させるwasmという仕組みが存在します。 JavaScriptのコードはどうしてもパフォーマンスに限界がありますが、wasmの場合はほぼネイティブコンパイルされたプログラムと同じようなパフォーマンスで動作させることができます。 -問題になったBitcoinのマイニングプログラムや機械学習系など、CPUパワーが必要な場合に利用されます。

    # JavaScript体験

    今回はjQueryを利用し、DOMを書き換える体験をしてみましょう。

    DOMとjQuery

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    - +問題になったBitcoinのマイニングプログラムや機械学習系など、CPUパワーが必要な場合に利用されます。

    # JavaScript体験

    今回はjQueryを利用し、DOMを書き換える体験をしてみましょう。

    DOMとjQuery

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    + diff --git a/frontend/react/index.html b/frontend/react/index.html index 76255cda..e826dab7 100644 --- a/frontend/react/index.html +++ b/frontend/react/index.html @@ -8,7 +8,7 @@ - + @@ -1030,7 +1030,7 @@ # コンテナを動かし9000番ポートでウェブアプリを公開する。 docker run --rm -p 9000:80 todo-web -
    1
    2
    3
    4
    5
    6
    7
    8

    この状態でhttp://localhost:9000 (opens new window)にアクセスして、今までと同様のウェブアプリが表示されれば成功です😉

    アプリをコンテナイメージとしてまとめることで、利用者がアプリを動かすためのセットアップが簡単にできたり、Kubernetes環境でアプリを動作させることができます。

    えっ、ここまでできたんですか？

    ちょっと、できる人すぎですよ😉

    # 参考になるサイト

    # React

    # JavaScript

    # TypeScript

    以上で講義は終わりです。よいReactライフを😉

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    - +
    1
    2
    3
    4
    5
    6
    7
    8

    この状態でhttp://localhost:9000 (opens new window)にアクセスして、今までと同様のウェブアプリが表示されれば成功です😉

    アプリをコンテナイメージとしてまとめることで、利用者がアプリを動かすためのセットアップが簡単にできたり、Kubernetes環境でアプリを動作させることができます。

    えっ、ここまでできたんですか？

    ちょっと、できる人すぎですよ😉

    # 参考になるサイト

    # React

    # JavaScript

    # TypeScript

    以上で講義は終わりです。よいReactライフを😉

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    + diff --git a/frontend/svelte/index.html b/frontend/svelte/index.html index ff4bddb4..07060305 100644 --- a/frontend/svelte/index.html +++ b/frontend/svelte/index.html @@ -8,7 +8,7 @@ - + @@ -194,7 +194,7 @@ </label> <br /> <NabeatsuButton onClick={incrementCount} count={count} divisor={divisor}/> -
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16

    <input>要素にはbind:value={divisor}と書くだけでよくなり、updateDivisorのような<input>要素の値をdivisorにセットするだけの関数もなくなりました！bind:value={divisor}は、対象の<input>要素のvalue属性と変数divisorを双方向に紐付ける（バインドする）ための設定です。紐付けた変数divisorの値をvalue属性で表示して、ユーザーの入力によってvalue属性が更新されたらdivisorの値も更新し、また新たな値をvalue属性の値として表示する...という処理をこれ一つで賄ってくれます。

    補足

    更にSvelteは気を遣ってくれまして、type="number"な<input>要素については、入力された値を自動で数値に変換した上で紐付けた変数に代入してくれます。

    動作例:

    ※ステップ10と同じなので省略

    # 🚩ここまでにできたこと

    • 「双方向バインディング」を使うことで、紐付けた変数と<input>要素のvalue属性の値を簡単に同期させることができた

    # おわりに

    Svelteの機能はまだまだたくさんあります。気になる方は、とてもうまく翻訳された日本語のチュートリアル (opens new window)を軽く通してみるといいでしょう。

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    - +
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16

    <input>要素にはbind:value={divisor}と書くだけでよくなり、updateDivisorのような<input>要素の値をdivisorにセットするだけの関数もなくなりました！bind:value={divisor}は、対象の<input>要素のvalue属性と変数divisorを双方向に紐付ける（バインドする）ための設定です。紐付けた変数divisorの値をvalue属性で表示して、ユーザーの入力によってvalue属性が更新されたらdivisorの値も更新し、また新たな値をvalue属性の値として表示する...という処理をこれ一つで賄ってくれます。

    補足

    更にSvelteは気を遣ってくれまして、type="number"な<input>要素については、入力された値を自動で数値に変換した上で紐付けた変数に代入してくれます。

    動作例:

    ※ステップ10と同じなので省略

    # 🚩ここまでにできたこと

    • 「双方向バインディング」を使うことで、紐付けた変数と<input>要素のvalue属性の値を簡単に同期させることができた

    # おわりに

    Svelteの機能はまだまだたくさんあります。気になる方は、とてもうまく翻訳された日本語のチュートリアル (opens new window)を軽く通してみるといいでしょう。

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    + diff --git a/frontend/vue/index.html b/frontend/vue/index.html index a9045544..d509d83a 100644 --- a/frontend/vue/index.html +++ b/frontend/vue/index.html @@ -8,7 +8,7 @@ - + @@ -310,7 +310,7 @@ } }) </script> -
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49

    ここでは1個目のscriptタグでpeople-tableというコンポーネントを定義しています。コンポーネントはtemplateというプロパティがあるのが特徴で、ここにコンポーネント内に表示したいHTMLを記述します。

    さらにpropsでこのコンポーネントのインプットを定義しています。今回のpeople-tableは、peoplesという変数で配列を受け取り、それをテーブルとして表示するコンポーネントです。

    このようにアプリケーションをコンポーネントと呼ばれる小さな単位に分割していくとで、１つ１つのコンポーネントをシンプルに保ちつつ、アプリケーション全体を構築していくことが可能です。

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    - +
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49

    ここでは1個目のscriptタグでpeople-tableというコンポーネントを定義しています。コンポーネントはtemplateというプロパティがあるのが特徴で、ここにコンポーネント内に表示したいHTMLを記述します。

    さらにpropsでこのコンポーネントのインプットを定義しています。今回のpeople-tableは、peoplesという変数で配列を受け取り、それをテーブルとして表示するコンポーネントです。

    このようにアプリケーションをコンポーネントと呼ばれる小さな単位に分割していくとで、１つ１つのコンポーネントをシンプルに保ちつつ、アプリケーション全体を構築していくことが可能です。

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    + diff --git a/index.html b/index.html index 8a3c8277..39a0aadf 100644 --- a/index.html +++ b/index.html @@ -8,7 +8,7 @@ - + @@ -25,6 +25,6 @@

    # 2023年度カリキュラム一覧

    カテゴリ 1枠目 2枠目 3枠目 4枠目 5枠目 6枠目
    イントロ イントロダクション
    (資料非公開)    		 事前準備
    (資料非公開)    		 事前準備
    (資料非公開)
    開発 Gitの使い方+GitHubを使った開発手法
    (最新版は非公開)    		 開発環境をDockerで構築+docker-compose Jenkinsを触ってみる
    CI/CD + 構成管理 GitHub Actions でCIテスト・デプロイを回す ansibleによるIT自動化 Kubernetes でアプリケーション開発
    監視・モニタリング 監視Overview Prometheusでアプリケーションを監視してみよう
    (監視Overviewと資料共通)    		 Splunkハンズオン
    (資料非公開)
    データベース データベース界隈Overview リレーショナルDBを触ってみる MongoDBを触ってみる redisを触ってみる
    Webサーバー HTTP Overview
    (資料非公開)    		 Apache + Nginx を触ってみよう
    バックエンドアプリ サーバアプリケーション界隈Overview FastAPIでWebアプリを作る Java: Spring でWebアプリを作る GoでWebアプリを作る 並行処理ハンズオン テストプログラミングハンズオン
    フロントエンド 素のJavaScript + DOM入門 Svelteを触ってみよう Reactを触ってみよう Angularを触ってみよう
    (過去講座)    		 Vueを触ってみよう
    (過去講座)
    セキュリティ WebアプリとセキュリティOverview Webアプリの脆弱性を解消してみよう
    (資料未公開)    		 アプリに認証を導入するハンズオン
    (資料未公開)
    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    - + diff --git a/init/hello-bootcamp/index.html b/init/hello-bootcamp/index.html index 514a97af..26b6f4ff 100644 --- a/init/hello-bootcamp/index.html +++ b/init/hello-bootcamp/index.html @@ -8,7 +8,7 @@ - + @@ -86,7 +86,7 @@
    1
    2
    3

    エラーなく起動できたら 起動したコンテナのID が表示されます。ここは実行ごとに変わります。

    ブラウザを開き、localhost:8080 (opens new window) （localhostまたは ssh 先の IP アドレス）にアクセスしてみましょう。「Hello Bootcamp!」が表示されていれば成功です。

    なお、-d オプションを付けているので、 バックグラウンドで起動し続けています。 再度起動し直してみたい場合は 一度 docker stop する必要があります。お掃除の手順を参照してください。

    # HTML ファイルを書き換える

    先ほど作成したindex.htmlを編集してみましょう。

    Hello Bootcamp!!!!!!
    1

    保存してブラウザをリロードしてみてください。ページが更新されていれば成功です。

    # Docker コンテナのお掃除

    最後に Docker コンテナを止めて掃除しておきます。

    $ docker stop test-nginx
 $ docker rm test-nginx
-
    1
    2

    以上で事前準備は完了です。お疲れ様でした。

    - +
    1
    2

    以上で事前準備は完了です。お疲れ様でした。

    + diff --git a/security/overview/index.html b/security/overview/index.html index 2f9c6b0f..4e0e6556 100644 --- a/security/overview/index.html +++ b/security/overview/index.html @@ -8,7 +8,7 @@ - + @@ -16,7 +16,7 @@ GitHub (opens new window)

    # Webアプリとセキュリティ Overview

    資料はこちら

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    - + (opens new window)

    • Webアプリとセキュリティ Overview

    # Webアプリとセキュリティ Overview

    資料はこちら

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    + diff --git a/server-app/concurrent/index.html b/server-app/concurrent/index.html index fc5c3eb3..e69f97da 100644 --- a/server-app/concurrent/index.html +++ b/server-app/concurrent/index.html @@ -8,7 +8,7 @@ - + @@ -327,7 +327,7 @@
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37

    # 最後に

    この資料で伝えたいのは以下のことです。

    • ライブラリやフレームワークを利用する際はその仕組みをきちんと理解しましょう
      • webプログラミングにおいては特に並行・並列処理をどのように実装しているのか確認しましょう
    • スレッドプログラミングを書いているという認識を持ち、書こうとしている処理がスレッドセーフなのか常に確認しましょう
      • Webフレームワークが推奨する書き方に習うことで、トラブルを防ぐことができます
    • ロックなど排他制御の実装を行う際は自前で実装せず、必ずライブラリを利用しましょう

    並行・並列処理、スレッドプログラミングは非常に複雑になります（これは実行するまで処理がどのような順番で実行されるか分からない非決定性から来ています）。

    Webフレームワークはこの並行・並列処理の複雑性を隠蔽するために発達しているという側面があり、推奨される書き方をすることで複雑性を意識しなくても実装が可能なようになっています。 -しかし自分が今どのような仕組みの上で実装しているのかを意識していないと、思わぬ事故を起こす可能性があります。

    フレームワークが提供するレールに乗りながらも、自分がスレッドプログラミングをしていることを常に意識することが大切です。

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    - +しかし自分が今どのような仕組みの上で実装しているのかを意識していないと、思わぬ事故を起こす可能性があります。

    フレームワークが提供するレールに乗りながらも、自分がスレッドプログラミングをしていることを常に意識することが大切です。

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    + diff --git a/server-app/fastapi/index.html b/server-app/fastapi/index.html index 18d429dd..383f5c17 100644 --- a/server-app/fastapi/index.html +++ b/server-app/fastapi/index.html @@ -8,7 +8,7 @@ - + @@ -265,7 +265,7 @@ background_tasks.add_task(print_wait_time, count) return {"status": "See the console log for wait time."}
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12

    参考: https://fastapi.tiangolo.com/ja/tutorial/background-tasks/ (opens new window)

    *)ASGIの公式ドキュメントにもspiritualと書いてあり、「精神的な」後継である事が明記されている。

    # まとめ

    今回は、FastAPIを使ってWebアプリケーションを作ってみました。 -FastAPIは決して大規模なWebアプリケーションを作るために作られた物ではありませんが、作り方次第で多くの処理を任せることができます。

    BootCampではあくまでチュートリアルのような形で作成したため、全てを一つのmain.pyに記載しましたが開発をスムーズに行う上ではpydanticで定義するモデルファイルは分ける。エンドポイントも階層化に合わせてファイルを分ける、といったテクニックが必要になってきますのでそういった所を今後は学んでいって頂ければと思います。

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    - +FastAPIは決して大規模なWebアプリケーションを作るために作られた物ではありませんが、作り方次第で多くの処理を任せることができます。

    BootCampではあくまでチュートリアルのような形で作成したため、全てを一つのmain.pyに記載しましたが開発をスムーズに行う上ではpydanticで定義するモデルファイルは分ける。エンドポイントも階層化に合わせてファイルを分ける、といったテクニックが必要になってきますのでそういった所を今後は学んでいって頂ければと思います。

    CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
    + diff --git a/server-app/go/index.html b/server-app/go/index.html index ec1c7c12..ff086fa4 100644 --- a/server-app/go/index.html +++ b/server-app/go/index.html @@ -8,7 +8,7 @@ - + @@ -869,7 +869,7 @@ より素晴らしい例を見つけたら、本リポジトリにPRしていただいても大丈夫です。

    また、Go言語の構造から迫るアプローチ以外として、その他外部のコミュニティから情報を得るのも良いでしょう。

    もちろん、本講義開催の講師陣に質問くださっても問題ありません。
    情報源はたくさんあるので、貪欲にGoを知ってみてください。
    -ではみなさん、Let's Go!!

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    - +ではみなさん、Let's Go!!

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    + diff --git a/server-app/go/src/go-tutor/index.html b/server-app/go/src/go-tutor/index.html index a9a53909..6cf0cf13 100644 --- a/server-app/go/src/go-tutor/index.html +++ b/server-app/go/src/go-tutor/index.html @@ -8,7 +8,7 @@ - + @@ -36,7 +36,7 @@ docker buildx stop <buildername> docker buildx rm <buildername>
    1
    2
    3
    4

    # 6. リンクの更新

    - +
    + diff --git a/server-app/go/var/md/init.html b/server-app/go/var/md/init.html index a00824d6..90660834 100644 --- a/server-app/go/var/md/init.html +++ b/server-app/go/var/md/init.html @@ -8,7 +8,7 @@ - + @@ -24,7 +24,7 @@ root@<container id>:/go/src/# emacs
    1
    2
    3

    # 4.2. VSCodeで作業する場合

    # 4.2.1. VSCode Serverを起動します
    :# VSCode Server の起動
 $  docker compose up -d 
-
    1
    2
    # 4.2.2. ブラウザでhttp://localhost:80にアクセス

    パスワードを聞かれた場合はiij-bootcampと入力

    VScodeの画面が表示されたら /go/src/go_tutorial/ ディレクトリを開いてください。

    - +
    1
    2
    # 4.2.2. ブラウザでhttp://localhost:80にアクセス

    パスワードを聞かれた場合はiij-bootcampと入力

    VScodeの画面が表示されたら /go/src/go_tutorial/ ディレクトリを開いてください。

    + diff --git a/server-app/java/DI.html b/server-app/java/DI.html index 55c0ca6d..15ccb04a 100644 --- a/server-app/java/DI.html +++ b/server-app/java/DI.html @@ -8,7 +8,7 @@ - + @@ -173,7 +173,7 @@ this.slackClient.execute(...); } } -
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    - +
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    + diff --git a/server-app/java/index.html b/server-app/java/index.html index 4f52a340..796c0e6d 100644 --- a/server-app/java/index.html +++ b/server-app/java/index.html @@ -8,7 +8,7 @@ - + @@ -16,28 +16,43 @@ GitHub (opens new window)
    このハンズオンでやることSpring Bootを使ったアプリ開発を体験するハンズオンです
    想定時間2h
    前提知識・用語Java

    # Java; Spring Boot

    # 始めに

    • Javaの基本
    • Spring Bootの基本
    • Spring Bootハンズオン

    本講義では上記について紹介し、Javaというプログラミング言語とそのWebフレームワークであるSpring Bootといった技術的な選択肢を増やすことを目的としています。

    # 本講義の前提

    本講義ではプログラム言語共通の制御構文や概念、たとえばif文や型など、の解説は行いません。そのため、受講者は何らかのプログラミング言語で簡単な制御構文が書けることを前提とさせてください。

    # この資料のお約束

    💻 は自分で操作する箇所を示しています。 また$はホストマシンのプロンプトを意味し、❯はコンテナ内部でのプロンプトを意味します。

    たとえば下記の通りです。

    # ホストマシン上で git clone git@github.com:iij/bootcamp.git を実行する
+       (opens new window)    
     
    このハンズオンでやることSpring Bootを使ったアプリ開発を体験するハンズオンです
     
    想定時間2h
     
    前提知識・用語Java
     
    # Java; Spring Boot
     
    # 始めに
     
    • Java の基本
      •  
    • Spring Boot の基本
      •  
    • Spring Boot ハンズオン
     
    本講義では上記について紹介し、Java というプログラミング言語とその Web フレームワークである Spring Boot といった技術的な選択肢を増やすことを目的としています。
     
    # 本講義の前提
     
    本講義ではプログラム言語共通の制御構文や概念、たとえば if 文や型など、の解説は行いません。そのため、受講者は何らかのプログラミング言語で簡単な制御構文が書けることを前提とさせてください。
     
    また、ファイルの編集については VSCode を使って編集することを前提として進めていきます。もちろん、vim などのお好きなエディタを使って頂いても問題ありませんが、その場合は適宜資料を読み替えて対応をお願いします。
     
    # この資料のお約束
     
    💻 は自分で操作する箇所を示しています。 また$はホストマシンのプロンプトを意味し、❯はコンテナ内部でのプロンプトを意味します。
     
    たとえば下記の通りです。
     
    # ホストマシン上で git clone git@github.com:iij/bootcamp.git を実行する
 $ git clone git@github.com:iij/bootcamp.git
 
 # コンテナ上で curl localhost:8080 を実行する
 ❯ curl localhost:8080
-
     
    1
    2
    3
    4
    5
    # 下準備
     
    講義を受講する前にコンテナイメージのpullと起動をしておくことをお勧めしています。
-また、Dockerの実行環境があることを前提として本講義を進めます。
     
    # 手順
     
    1. ハンズオン用のDockerイメージをpullしてくる
     
    # やや重たいので注意してください
-$ docker pull tamago0224/bootcamp-springboot:2023
-
     
    1
    2
    1. コンテナを起動する
     
    # プロキシ環境下にいる人はプロキシの設定をする
-$ PROXY_HOST=YOUR.PROXY.HOST
-$ PROXY_PORT=YOUR_PROXY_PORT
-$ JAVA_OPT="-Dhttp.proxyHost=${PROXY_HOST} -Dhttp.proxyPort=${PROXY_PORT} -Dhttps.proxyHost=${PROXY_HOST} -Dhttps.proxyPort=${PROXY_PORT}"
-# プロキシ設定ここまで
-# コンテナを起動する
-$ docker run --name bootcamp-springboot -it -p 8080:8080 -e JAVA_OPT="${JAVA_OPT}" tamago0224/bootcamp-springboot:2023
-
     
    1
    2
    3
    4
    5
    6
    7
    1. アプリケーションの起動チェック
     
    # Spring Bootを起動する
+
     
    1
    2
    3
    4
    5
    # 下準備
     
    講義を受講する前にコンテナイメージの pull と起動をしておくことをお勧めしています。
+また、Docker の実行環境があることを前提として本講義を進めます。
     
    # 手順
     
    1. ハンズオン用の Docker イメージを pull してくる
       
      # やや重たいので注意してください
+$ docker pull tamago0224/bootcamp-springboot:2024
+
       
      1
      2
      2.  
    2. ハンズオン用の作業ディレクトを作成する
       
      # 適当な場所に作業用ディレクトリを作成し、その中に work ディレクトリを作成してください。
+$ mkdir bootcamp-java-2024 # このディレクトリ名は何でも良い
+$ cd bootcamp-java-2024
+$ mkdir work
+
       
      1
      2
      3
      4
      3.  
    3. ハンズオン用の docker-compose.yml を用意する
       
      $ curl -o docker-compose.yml https://raw.githubusercontent.com/iij/bootcamp/master/src/server-app/java/server-app/docker-compose.yml
+
       
      1
      services:
+  java:
+    image: tamago0224/bootcamp-springboot:2024
+    volumes:
+      - ./work:/work
+    working_dir: /work
+    tty: true
+
       
      1
      2
      3
      4
      5
      6
      7
      4.  
    4. コンテナを起動する
       
      # コンテナを起動する
+$ docker compose up -d
+# コンテナに入る
+$ docker compose exec java /bin/bash
+> pwd
+/work
+
       
      1
      2
      3
      4
      5
      6
      5.  
    5. 必要なプロジェクトファイルの用意。別画面のターミナルで以下のコマンドを実行
       
      $ cd bootcamp-java-2024
+$ docker exec cp java:/app/. ./work
+$ ls ./work # 以下のファイル群が確認できる
+build  build.gradle  gradle  gradlew  settings.gradle  src
+
       
      1
      2
      3
      4
      6.  
    6. アプリケーションの起動チェック
       
      # Spring Bootを起動する
 ❯ ./gradlew bootrun
 # ...
 # いろんなログが流れる
-
       
      1
      2
      3
      4
      1. 動作チェック
       
      ホストマシンの適当なブラウザからlocalhost:8080 (opens new window)にアクセスし、下記のようなエラーページが表示されることを確認してください。
       
      初回起動 - WhitelabelErrorPage
       
      # Javaの基本
       
      JavaはOpenJDKコミュニティによって開発され、各ベンダからリリースされているプログラミング言語です。
-古くから利用されているプログラミング言語/プラットフォームである一方、2022年現在でもSIや大規模開発の現場などでよく利用されています。
       
      # 言語としての特徴
       
      JavaはC言語やRustと同じ静的型付き言語です。そのため文法や記法はC言語を踏襲した書き方となっています。
      
-Javaの言語のパラダイムとしては、クラスの継承の概念やインタフェースなどの言語仕様を持つためオブジェクト指向プログラミングであります。その一方、Javaのバージョン8以降は関数型インタフェースやパターンマッチなど、関数型プログラミングを楽しめるような仕様も導入されています。
       
      Javaのサンプルコード 
      package com.github.iij.bootcamp.serverapp; // パッケージ名(世界でユニークであると良い)
+
       
      1
      2
      3
      4
      7.  
    7. 動作チェック
     
    ホストマシンの適当なブラウザからlocalhost:8080 (opens new window)にアクセスし、下記のようなエラーページが表示されることを確認してください。
     
    初回起動 - WhitelabelErrorPage
     
    # Java の基本
     
    Java は OpenJDK コミュニティによって開発され、各ベンダからリリースされているプログラミング言語です。
+古くから利用されているプログラミング言語/プラットフォームである一方、2022 年現在でも SI や大規模開発の現場などでよく利用されています。
     
    # 言語としての特徴
     
    Java は C 言語や Rust と同じ静的型付き言語です。そのため文法や記法は C 言語を踏襲した書き方となっています。
    
+Java の言語のパラダイムとしては、クラスの継承の概念やインタフェースなどの言語仕様を持つためオブジェクト指向プログラミングであります。その一方、Java のバージョン 8 以降は関数型インタフェースやパターンマッチなど、関数型プログラミングを楽しめるような仕様も導入されています。
     
    Java のサンプルコード 
    package com.github.iij.bootcamp.serverapp; // パッケージ名(世界でユニークであると良い)
 
 // 自社ドメインを持つ企業での製造物には自社ドメインをそのまま利用することが多い
 
@@ -85,7 +100,7 @@
     ins.getFinalizedString(); // → hello
   }
 }
-
     
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
     
    # プロジェクト構成
     
    Javaのプロジェクトのディレクトリ構成は、ほかのプログラミング言語と異なり言語として定められています。名前空間として定義できる"パッケージ"がそのままディレクトリに反映されるようにディレクトリを構成する必要があります。
     
    参考: https://docs.oracle.com/javase/tutorial/java/package/managingfiles.html (opens new window)
     
    たとえばcom.github.iij.bootcampパッケージ(=名前空間)配下にHogeとHugaというクラスを作成する場合、下記のようなディレクトリ構造/ファイル構造になります。
     
    .
+
     
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
     
    # プロジェクト構成
     
    Java のプロジェクトのディレクトリ構成は、ほかのプログラミング言語と異なり言語として定められています。名前空間として定義できる"パッケージ"がそのままディレクトリに反映されるようにディレクトリを構成する必要があります。
     
    参考: https://docs.oracle.com/javase/tutorial/java/package/managingfiles.html (opens new window)
     
    たとえばcom.github.iij.bootcampパッケージ(=名前空間)配下にHogeとHugaというクラスを作成する場合、下記のようなディレクトリ構造/ファイル構造になります。
     
    .
 ├── build.gradle
 └── src
     └── main
@@ -98,9 +113,8 @@
                             │   └── class Hoge { ... }
                             └── Huga.java
                                 └── class Huga { ... }
-
     
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    パッケージ
     
    Javaにおけるパッケージとは、DNS形式で定義できる名前空間のような概念です。.で区切ることでパッケージ間の親子関係を定義できます。たとえばcom.example.iijパッケージとcom.example.iij.bootcampパッケージでは前者が親で後者が子といった関係があります。
     
    # Gradle
     
    Pythonであればpip、Rustであればcargo、Node.jsであればnpmのようにプログラミング言語にはそれぞれ依存関係を解決しビルドを自動化する自動化システムツールが用意されています。
     
    JavaではMavenとGradleという2つの種類の自動化システムツールがよく利用されています。本講義ではGradleを利用して話を進めていきます。
     
    WARNING
     
    Mavenを使わずにGradleを利用する理由は、Gradleの方が優れている/イケているからではなく、単に筆者がXMLが嫌いであるためである。
     
    # Spring Bootの基本
     
    Spring BootはJavaのWebフレームワークのひとつです。Spring Bootの規約に従ってアプリケーションロジックを実装することで簡単にWebアプリケーションを構築できます。
     
    このフレームワークは大規模な主幹システムやWebアプリケーションを実装/構築する際によく利用されており、IIJがホストしているいくつかのサービスもSpring Bootを利用して実装されています。
     
    # 特徴
     
    Spring Bootは複雑な業務要件や非機能要件をクリアするためのさまざまな機能を有しています。依存関係を宣言して注入してくれるDIコンテナや横断的な関心事を解決するAOPのサポート、数多く公開されているstarterパッケージなどはその最たる例です。
     
    残念ながらこのBootcampですべての要素に触れることはできないため、興味のあるほうはドキュメントを読んでみることをお勧めします。
     
    # Spring Bootハンズオン
     
    本ハンズオンではブラウザで閲覧できるWeb UIの機能を持たない、HTTP API(Application Programming Interface)だけを持つAPIサーバを構築していきます。
     
    それでは始めましょう。
     
    # 簡単なクラスを作ってみる
     
    まず始めに、Java言語のウォーミングアップとして純粋なJavaのクラスを作ってみましょう。
     
    💻 Userクラスを作成します。
     
    # 下記の通りに修正する
-❯ vim src/main/java/com/github/iij/bootcamp/serverapp/User.java
-
     
    1
    2
    package com.github.iij.bootcamp.serverapp;
+
     
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    パッケージ
     
    Java におけるパッケージとは、DNS 形式で定義できる名前空間のような概念です。.で区切ることでパッケージ間の親子関係を定義できます。たとえばcom.example.iijパッケージとcom.example.iij.bootcampパッケージでは前者が親で後者が子といった関係があります。
     
    # Gradle
     
    Python であれば pip、Rust であれば cargo、Node.js であれば npm のようにプログラミング言語にはそれぞれ依存関係を解決しビルドを自動化する自動化システムツールが用意されています。
     
    Java では Maven と Gradle という 2 つの種類の自動化システムツールがよく利用されています。本講義では Gradle を利用して話を進めていきます。
     
    # Spring Boot の基本
     
    Spring Boot は Java の Web フレームワークのひとつです。Spring Boot の規約に従ってアプリケーションロジックを実装することで簡単に Web アプリケーションを構築できます。
     
    このフレームワークは大規模な主幹システムや Web アプリケーションを実装/構築する際によく利用されており、IIJ がホストしているいくつかのサービスも Spring Boot を利用して実装されています。
     
    # 特徴
     
    Spring Boot は複雑な業務要件や非機能要件をクリアするためのさまざまな機能を有しています。依存関係を宣言して注入してくれる DI コンテナや横断的な関心事を解決する AOP のサポート、数多く公開されている starter パッケージなどはその最たる例です。
     
    残念ながらこの Bootcamp ですべての要素に触れることはできないため、興味のあるほうはドキュメントを読んでみることをお勧めします。
     
    # Spring Boot ハンズオン
     
    本ハンズオンではブラウザで閲覧できる Web UI の機能を持たない、HTTP API(Application Programming Interface)だけを持つ API サーバを構築していきます。
     
    それでは始めましょう。
     
    # 簡単なクラスを作ってみる
     
    まず始めに、Java 言語のウォーミングアップとして純粋な Java のクラスを作ってみましょう。
     
    💻 Userクラスを作成します。
     
    下記の通りに修正してみましょう。
     
    // src/main/java/com/github/iij/bootcamp/serverapp/User.java
+package com.github.iij.bootcamp.serverapp;
 
 public class User {
 
@@ -132,12 +146,9 @@
     return "name: " + this.name + "," + "id: " + this.id;
   }
 }
-
     
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    これでUserクラスを作成できました。次にこのクラスを実際にインスタンス化してみます。
    
-Spring Bootアプリケーションのmain関数はcom.github.iij.bootcamp.serverapp.ServerAppApplicationにあります。ためしにこのmain関数の中でUserクラスをインスタンス化してみます。
     
    💻 ServerAppApplication.javaを修正してください。
     
    # 下記の通りに修正する
-❯ vim src/main/java/com/github/iij/bootcamp/serverapp/ServerAppApplication.java 
-# Spring Bootサーバーを再起動する
-❯ ./gradlew bootRun
-
     
    1
    2
    3
    4









     
     
     
     




    package com.github.iij.bootcamp.serverapp;
+
     
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    これでUserクラスを作成できました。次にこのクラスを実際にインスタンス化してみます。
    
+Spring Boot アプリケーションの main 関数はcom.github.iij.bootcamp.serverapp.ServerAppApplicationにあります。ためしにこの main 関数の中でUserクラスをインスタンス化してみます。
     
    💻 ServerAppApplication.java を修正してください。
     









     
     
     
     





    // src/main/java/com/github/iij/bootcamp/serverapp/ServerAppApplication.java
+package com.github.iij.bootcamp.serverapp;
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
@@ -153,12 +164,10 @@
 		SpringApplication.run(ServerAppApplication.class, args);
 	}
 }
-
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    再起動時にログに"name: アリス,id: alice"と表示されていればOKです。
     
    # チェックポイント
     
    • Javaのクラスを作成した
      •  
    • クラスをインスタンス化し、標準出力に文字列を表示した
     
    # 解説
     
    純粋なJavaのクラスを作成し、インスタンス化とメソッドの呼び出しを行いました。Userクラスを眺めてもらうとわかるとおり、getNameやgetIdなどJavaにはかなり冗長なコードが多いです。これらのコードはよく「ボイラープレート」と呼ばれ、開発者が嫌うコードです。
     
    JavaにはLombokなどのボイラープレートを解消するツールなどありますが、本講義はあえて紹介しません。興味がある人は調べてみてください。
     
    # 簡単なHTTPのインタフェースを作成してみる
     
    それではSpring Bootを使ってみましょう。
    
-簡単なHTTPのインタフェースを作成し、実際にSpring Bootがどのように動作しているのかを見てみます。
     
    💻 ServerAppApplication.javaを修正し、サーバを再起動してみてください。
     
    # 下記の通りに修正する
-❯ vim src/main/java/com/github/iij/bootcamp/serverapp/ServerAppApplication.java
-# Spring Bootサーバーを再起動する
-❯ ./gradlew bootRun
-
     
    1
    2
    3
    4




     
     
     
     










     
     
     
     
     
     
     
     
     


    package com.github.iij.bootcamp.serverapp;
+
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    編集が完了したら以下のコマンドをコンテナから実行してサーバを起動しましょう。
     
    ❯ ./gradlew bootRun
+
     
    1
    再起動時にログに"name: アリス,id: alice"と表示されていれば OK です。
     
    # チェックポイント その 1
     
    • Java のクラスを作成した
      •  
    • クラスをインスタンス化し、標準出力に文字列を表示した
     
    # 解説
     
    純粋な Java のクラスを作成し、インスタンス化とメソッドの呼び出しを行いました。Userクラスを眺めてもらうとわかるとおり、getNameやgetIdなど Java にはかなり冗長なコードが多いです。これらのコードはよく「ボイラープレート」と呼ばれ、開発者が嫌うコードです。
     
    Java には Lombok などのボイラープレートを解消するツールなどありますが、本講義はあえて紹介しません。興味がある人は調べてみてください。
     
    # 簡単な HTTP のインタフェースを作成してみる
     
    それでは Spring Boot を使ってみましょう。
    
+簡単な HTTP のインタフェースを作成し、実際に Spring Boot がどのように動作しているのかを見てみます。
     
    💻 ServerAppApplication.java を修正し、サーバを再起動してみてください。
     




     
     
     
     










     
     
     
     
     
     
     
     
     



    // src/main/java/com/github/iij/bootcamp/serverapp/ServerAppApplication.java
+package com.github.iij.bootcamp.serverapp;
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
@@ -186,15 +195,14 @@
   }
   // 追記END
 }
-
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    # 動作確認
-$ curl localhost:8080 -X GET
-hello world
-
     
    1
    2
    3
    "hello world"が返ってきたら成功です。
     
    # チェックポイント
     
    • @RestControllerアノテーションをクラスに付与してHTTPのインタフェースを作成した
     
    # 解説
     
    bootRunコマンドによりSpring Bootが起動します。すると、Spring Bootの機能により @RestControllerアノテーションが付いているServerAppApplication.HelloControllerがHTTPのインタフェースとして登録されます。
     
    handler
     
    その結果、このSpring Bootが動いている8080番ポート宛のHTTPリクエストとServerAppApplication.HelloController#helloWorldが紐づけられることになり、GET /へのリクエストのレスポンスとして"hello world"が返ってきました。
     
    Spring BootとDIコンテナ 
    Spring Bootは起動時に起動クラスのパッケージ配下のJavaファイルから特殊なアノテーション(@Contoroller / @Component / etc...)がついたクラスを探し出します。そしてSpring Bootはそのクラスを適当な方法でインスタンス化し、自身の管理下(=DI コンテナ)に置きます。
     
    (「適当な方法」を指定することもできます > Bean Annotation (opens new window))
     
    DIコンテナに格納されたインスタンスは、後述する@Autowiredアノテーションを使って引き出すことができます。
     
    特に、@Controller @RestControllerアノテーションが付与されたクラスから生成されたインスタンスはHTTPのインタフェースとして働くことになります。
     
    今回の例では、 ServerAppApplicationクラスに@SpringBootApplicationアノテーションが付与されているのでServerAppApplicationクラスのパッケージcom.github.iij.bootcamp.serverapp配下のクラスから上述の特殊なアノテーションがついているクラスを探索します。
     
    HelloControllerクラスは@RestControllerアノテーションが付与されているため、Spring Boot起動時にHelloControllerがSpring Bootによってインスタンス化されDIコンテナに登録されました。
-その結果、GET /のリクエストをSpring Bootが受け取るとHelloController#helloWorld が実行されるようになっていたというわけです。
     
    # 簡単なリクエストを受け取ってみる
     
    次にクエリパラメータから情報を取得してみましょう。
     
    💻 UserController.javaを作成し、サーバを再起動してみてください。
     
    # 下記の通りに修正する
-❯ vim src/main/java/com/github/iij/bootcamp/serverapp/UserController.java
-# Spring Bootサーバーを再起動する
+
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    # Spring Bootサーバーを再起動する
 ❯ ./gradlew bootRun
-
     
    1
    2
    3
    4
    package com.github.iij.bootcamp.serverapp;
+
     
    1
    2
    # 動作確認
+$ curl localhost:8080 -X GET
+hello world
+
     
    1
    2
    3
    "hello world"が返ってきたら成功です。
     
    # チェックポイント その 2
     
    • @RestControllerアノテーションをクラスに付与して HTTP のインタフェースを作成した
     
    # 解説
     
    bootRunコマンドにより Spring Boot が起動します。すると、Spring Boot の機能により @RestControllerアノテーションが付いているServerAppApplication.HelloControllerが HTTP のインタフェースとして登録されます。
     
    handler
     
    その結果、この Spring Boot が動いている 8080 番ポート宛の HTTP リクエストとServerAppApplication.HelloController#helloWorldが紐づけられることになり、GET /へのリクエストのレスポンスとして"hello world"が返ってきました。
     
    Spring Boot と DI コンテナ 
    Spring Boot は起動時に起動クラスのパッケージ配下の Java ファイルから特殊なアノテーション(@Contoroller / @Component / etc...)がついたクラスを探し出します。そして Spring Boot はそのクラスを適当な方法でインスタンス化し、自身の管理下(=DI コンテナ)に置きます。
     
    (「適当な方法」を指定することもできます > Bean Annotation (opens new window))
     
    DI コンテナに格納されたインスタンスは、後述する@Autowiredアノテーションを使って引き出すことができます。
     
    特に、@Controller @RestControllerアノテーションが付与されたクラスから生成されたインスタンスは HTTP のインタフェースとして働くことになります。
     
    今回の例では、 ServerAppApplicationクラスに@SpringBootApplicationアノテーションが付与されているのでServerAppApplicationクラスのパッケージcom.github.iij.bootcamp.serverapp配下のクラスから上述の特殊なアノテーションがついているクラスを探索します。
     
    HelloControllerクラスは@RestControllerアノテーションが付与されているため、Spring Boot 起動時にHelloControllerが Spring Boot によってインスタンス化され DI コンテナに登録されました。
+その結果、GET /のリクエストを Spring Boot が受け取るとHelloController#helloWorld が実行されるようになっていたというわけです。
     
    # 簡単なリクエストを受け取ってみる
     
    次にクエリパラメータから情報を取得してみましょう。
     
    💻 UserController.java を作成し、サーバを再起動してみてください。
     
    // src/main/java/com/github/iij/bootcamp/serverapp/UserController.java
+package com.github.iij.bootcamp.serverapp;
 
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
@@ -214,17 +222,14 @@
     }
   }
 }
-
     
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    # 動作確認
+
     
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    # Spring Bootサーバーを再起動する
+❯ ./gradlew bootRun
+
     
    1
    2
    # 動作確認
 $ curl 'localhost:8080/user?id=bob'
 {"name":"ボブ","id":"bob"}
-
     
    1
    2
    3
    # チェックポイント
     
    • @GetMappingアノテーションを持つメソッドを作成し、HTTPのハンドラとして登録した
      •  
    • HTTPのハンドラとして登録されたメソッドの引数に@RequestParamアノテーションを付与することでクエリパラメータを実装した
     
    # 解説
     
    新しいクラスUserControllerを作成しました。このクラスにも@RestControllerアノテーションが付いているためHTTPのインタフェースとして振る舞います。
     
    UserControllerクラスの持つメソッドfindには@GetMappingアノテーションがついているため、GET /user宛のリクエストのハンドラとして登録されることになります。そのため、Spring Bootアプリケーションの/userへGETリクエストを送ることでこのfindメソッドがコールされます。
     
    さらにfindメソッドの引数idに@RequestParamアノテーションが付与されています。これにより、HTTPリクエストのクエリパラメータの値がこの変数に注入されます。つまりGET /user?id=bobへのリクエストをSpring Bootアプリケーションへ送ることでfindメソッドがコールされ引数id=bobが引き渡されます。
     
    # 責任を分離する
     
    さて、前章まで基本的なHTTPのインタフェースの作り方と使い方について解説してきました。もう少し実装を深めていきましょう。
    
-現在UserControllerクラスはHTTPのインタフェースとデータソースの管理の2つの責務を持っています。これは単一責務の原理から外れているためリファクタリングする対象です。
     
    今回はシンプルにUserController#findの処理を抽出して別のクラスに分離、処理そのものをUserControllerクラスの外から与えてあげるようにしましょう。
     
    💻 UserService.javaを作成、UserController.javaを修正し、サーバを再起動してください。
     
    # 新しいクラスUserServiceを作成する
-❯ vim src/main/java/com/github/iij/bootcamp/serverapp/UserService.java
-# UserControllerクラスを修正する
-❯ vim src/main/java/com/github/iij/bootcamp/serverapp/UserController.java
-# Spring Bootサーバーを再起動する
-❯ ./gradlew bootRun
-
     
    1
    2
    3
    4
    5
    6
    package com.github.iij.bootcamp.serverapp;
+
     
    1
    2
    3
    # チェックポイント その 3
     
    • @GetMappingアノテーションを持つメソッドを作成し、HTTP のハンドラとして登録した
      •  
    • HTTP のハンドラとして登録されたメソッドの引数に@RequestParamアノテーションを付与することでクエリパラメータを実装した
     
    # 解説
     
    新しいクラスUserControllerを作成しました。このクラスにも@RestControllerアノテーションが付いているため HTTP のインタフェースとして振る舞います。
     
    UserControllerクラスの持つメソッドfindには@GetMappingアノテーションがついているため、GET /user宛のリクエストのハンドラとして登録されることになります。そのため、Spring Boot アプリケーションの/userへ GET リクエストを送ることでこのfindメソッドがコールされます。
     
    さらにfindメソッドの引数idに@RequestParamアノテーションが付与されています。これにより、HTTP リクエストのクエリパラメータの値がこの変数に注入されます。つまりGET /user?id=bobへのリクエストを Spring Boot アプリケーションへ送ることでfindメソッドがコールされ引数id=bobが引き渡されます。
     
    # 責任を分離する
     
    さて、前章まで基本的な HTTP のインタフェースの作り方と使い方について解説してきました。もう少し実装を深めていきましょう。
    
+現在UserControllerクラスは HTTP のインタフェースとデータソースの管理の 2 つの責務を持っています。これは単一責務の原理から外れているためリファクタリングする対象です。
     
    今回はシンプルにUserController#findの処理を抽出して別のクラスに分離、処理そのものをUserControllerクラスの外から与えてあげるようにしましょう。
     
    💻 UserService.java を作成、UserController.java を修正し、サーバを再起動してください。
     
    // src/main/java/com/github/iij/bootcamp/serverapp/UserService.java
+package com.github.iij.bootcamp.serverapp;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -237,7 +242,7 @@
 
   // データソースに該当する部分
   private List<User> userPool = new ArrayList<User>(Arrays.asList(new User("ボブ", "bob")));
-  
+
   /**
    * ユーザープールからid値で検索し、その結果を返却します idと一致するユーザーが見つからない場合nullを返却します
    * TODO 本当にこの実装で問題ないか、考えてみましょう
@@ -255,7 +260,8 @@
   }
 }
 
-
     
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31





     
     
     




     
     
     
     
     
     
     
     
     


    package com.github.iij.bootcamp.serverapp;
+
     
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32





     
     
     




     
     
     
     
     
     
     
     
     



    // src/main/java/com/github/iij/bootcamp/serverapp/UserController.java
+package com.github.iij.bootcamp.serverapp;
 
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -277,15 +283,13 @@
   }
   // 修正END
 }
-
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    # 動作確認
+
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    # Spring Bootサーバーを再起動する
+❯ ./gradlew bootRun
+
     
    1
    2
    # 動作確認
 $ curl 'localhost:8080/user?id=bob'
 {"name":"ボブ","id":"bob"}
-
     
    1
    2
    3
    # チェックポイント
     
    • @Componentアノテーションをクラスに付与し、Spring Boot起動時に自動的にインスタンス化した
      •  
    • @Autowiredアノテーションをフィールドに付与し、そのフィールドにSpring Bootがインスタンス化したインスタンスの中から適切なインスタンスを注入した
     
    # 解説
     
    新しいクラスUserServiceを作成しました。このクラスには@Componentアノテーションが付与されているため、Spring Boot起動時にSpring Bootによって自動的にインスタンス化されSpring Bootの管理下に入ります。このようにSpring Bootに管理されるようになったインスタンスはほかのクラスから@Autowiredを利用することで利用されます。
     
    今回の例ではUserControllerクラスがuserServiceフィールドに@Autowiredアノテーションを付与しているため自動的に作成されたUserServiceクラスのインスタンスがUserController.userServiceに代入されることになりました。このように依存関係を分離、外から依存関係を持ち込む構成のことをDI(Dependency Injection)と呼びます。
     
    注意点として、デフォルトの挙動ではSpring Bootが管理するインスタンスは各クラス"1つ"となっています。つまりUserControllerクラスが引っ張ってきているuserServiceとほかのクラスが引っ張ってこれるUserServiceインスタンスは完全に一致しています。このようにひとつのインスタンスを使い回す構成のことを"シングルトン"と呼びます。
     
    # 少し複雑なリクエストを受け取ってみる
     
    最後に、POSTリクエストとリクエストボディを指定してUserインスタンスを登録してみましょう。
     Userインスタンスにはidとnameの値を指定する必要があるので、これらを与えられるエンドポイントを用意します。
     
    💻 UserService.javaとUserController.javaを修正し、サーバを再起動してください。
     
    # 下記の通りに修正する
-❯ vim src/main/java/com/github/iij/bootcamp/serverapp/UserService.java
-❯ vim src/main/java/com/github/iij/bootcamp/serverapp/UserController.java
-# Spring Bootサーバーを再起動する
-❯ ./gradlew bootRun
-
     
    1
    2
    3
    4
    5


























     
     
     
     
     
     
     
     
     


    package com.github.iij.bootcamp.serverapp;
+
     
    1
    2
    3
    # チェックポイント その 4
     
    • @Componentアノテーションをクラスに付与し、Spring Boot 起動時に自動的にインスタンス化した
      •  
    • @Autowiredアノテーションをフィールドに付与し、そのフィールドに Spring Boot がインスタンス化したインスタンスの中から適切なインスタンスを注入した
     
    # 解説
     
    新しいクラスUserServiceを作成しました。このクラスには@Componentアノテーションが付与されているため、Spring Boot 起動時に Spring Boot によって自動的にインスタンス化され Spring Boot の管理下に入ります。このように Spring Boot に管理されるようになったインスタンスはほかのクラスから@Autowiredを利用することで利用されます。
     
    今回の例ではUserControllerクラスがuserServiceフィールドに@Autowiredアノテーションを付与しているため自動的に作成されたUserServiceクラスのインスタンスがUserController.userServiceに代入されることになりました。このように依存関係を分離、外から依存関係を持ち込む構成のことを DI(Dependency Injection)と呼びます。
     
    注意点として、デフォルトの挙動では Spring Boot が管理するインスタンスは各クラス"1 つ"となっています。つまりUserControllerクラスが引っ張ってきているuserServiceとほかのクラスが引っ張ってこれるUserServiceインスタンスは完全に一致しています。このようにひとつのインスタンスを使い回す構成のことを"シングルトン"と呼びます。
     
    # 少し複雑なリクエストを受け取ってみる
     
    最後に、POST リクエストとリクエストボディを指定してUserインスタンスを登録してみましょう。
     Userインスタンスにはidとnameの値を指定する必要があるので、これらを与えられるエンドポイントを用意します。
     
    💻 UserService.java と UserController.java を修正し、サーバを再起動してください。
     


























     
     
     
     
     
     
     
     
     



    // src/main/java/com/github/iij/bootcamp/serverapp/UserService.java
+package com.github.iij.bootcamp.serverapp;
 
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -298,7 +302,7 @@
 
   // データソースに該当する部分
   private List<User> userPool = new ArrayList<User>(Arrays.asList(new User("ボブ", "bob")));
-  
+
   /**
    * ユーザープールからid値で検索し、その結果を返却します idと一致するユーザーが見つからない場合nullを返却します
    */
@@ -321,7 +325,8 @@
   }
   // 追記END
 }
-
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36






     
     
     
     












     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     



    package com.github.iij.bootcamp.serverapp;
+
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37






     
     
     
     












     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     




    // src/main/java/com/github/iij/bootcamp/serverapp/UserController.java
+package com.github.iij.bootcamp.serverapp;
 
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
@@ -375,13 +380,15 @@
   // 追記END
 
 }
-
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    # 動作確認
+
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    # Spring Bootサーバーを再起動する
+❯ ./gradlew bootRun
+
     
    1
    2
    # 動作確認
 $ curl localhost:8080/user -X POST -H 'Content-Type: application/json' -d '{"name": "アリス", "id": "alice"}'
 {"name": "アリス", "id": "alice"}
 
 $ curl 'localhost:8080/user?id=alice'
 {"name": "アリス", "id": "alice"}
-
     
    1
    2
    3
    4
    5
    6
    # チェックポイント
     
    • @PostMappingアノテーションをメソッドに付与し、POSTリクエストのHTTPハンドラとして登録した
      •  
    • JavaのPOJOを用いてPOSTリクエストのリクエストボディのスキーマを表現した
     
    # まとめ
     
    以上でSpring Bootのハンズオンは終了です。
     
    本講義ではJavaの基本的な知識や書き方、Spring Bootの使い方など、基本的な機能や文法に触れてもらいました。しかしSpring Bootには多様な機能がまだまだ存在しており、データベースとの接続や非同期処理などさまざまなプロダクション環境で活躍できるポテンシャルを持っているフレームワークです。
     
    本講義が、受講者のみなさまの今後の技術選定の手助けになれれば幸いです。
     
    # 追加の資料
     
    • Spring Bootリファレンスドキュメント (opens new window) 
      • 多くのSpring Boot開発者がお世話になる公式ドキュメントです。アプリケーションの開発からデプロイ方法まで、幅広く情報が提供されています。
      •  
    • Spring Boot Guides (opens new window) 
      • Spring Bootの各種機能を試してみるチュートリアルが公開されています。Pub/SubやMongoDB、Dockerとの連携などSpring Bootの拡張が多種公開されています。興味のある項目に触ってみてください。
     
     CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    - +
    1
    2
    3
    4
    5
    6

    # チェックポイント その 5

    • @PostMappingアノテーションをメソッドに付与し、POST リクエストの HTTP ハンドラとして登録した
    • Java の POJO を用いて POST リクエストのリクエストボディのスキーマを表現した

    # まとめ

    以上で Spring Boot のハンズオンは終了です。

    本講義では Java の基本的な知識や書き方、Spring Boot の使い方など、基本的な機能や文法に触れてもらいました。しかし Spring Boot には多様な機能がまだまだ存在しており、データベースとの接続や非同期処理などさまざまなプロダクション環境で活躍できるポテンシャルを持っているフレームワークです。

    本講義が、受講者のみなさまの今後の技術選定の手助けになれれば幸いです。

    # 追加の資料

    • Spring Boot リファレンスドキュメント (opens new window)
      • 多くの Spring Boot 開発者がお世話になる公式ドキュメントです。アプリケーションの開発からデプロイ方法まで、幅広く情報が提供されています。
    • Spring Boot Guides (opens new window)
      • Spring Boot の各種機能を試してみるチュートリアルが公開されています。Pub/Sub や MongoDB、Docker との連携など Spring Boot の拡張が多種公開されています。興味のある項目に触ってみてください。
    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    + diff --git a/server-app/node/index.html b/server-app/node/index.html index b6185773..cfd56a31 100644 --- a/server-app/node/index.html +++ b/server-app/node/index.html @@ -8,7 +8,7 @@ - + @@ -131,7 +131,7 @@
    1
    2
    3

    一覧で取得

    $ curl 127.0.0.1:3000/peoples
 
 [{"_id":"5cf3f435a47f5c0cdb9023a6","name":"Alice","__v":0}]
-
    1
    2
    3

    # 最後に

    ここまで簡単なNode.jsを使ったAPIサーバーの実装を行ってみました。なんとなくNode.jsのやり方が掴めたでしょうか。

    ただし実際のプロダクトで使用する場合は、TypeScriptを使って開発したりAPIのcallback関数を別ファイルにする、ロギングの仕組みを整えるなど様々なことを考える必要があります。

    今回の内容は本当に基礎的なものでしかないため、もし興味があれば様々なフレームワークや実装例を調べてみてください。

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    - +
    1
    2
    3

    # 最後に

    ここまで簡単なNode.jsを使ったAPIサーバーの実装を行ってみました。なんとなくNode.jsのやり方が掴めたでしょうか。

    ただし実際のプロダクトで使用する場合は、TypeScriptを使って開発したりAPIのcallback関数を別ファイルにする、ロギングの仕組みを整えるなど様々なことを考える必要があります。

    今回の内容は本当に基礎的なものでしかないため、もし興味があれば様々なフレームワークや実装例を調べてみてください。

    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    + diff --git a/server-app/overview/index.html b/server-app/overview/index.html index 8f3e6260..fbd87df0 100644 --- a/server-app/overview/index.html +++ b/server-app/overview/index.html @@ -8,7 +8,7 @@ - + @@ -322,7 +322,7 @@ string profile = 3; } } -
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20

    このproto定義から各言語向けに型定義を含めたコードを生成するため、実装が自由なOpenAPIに比べるとより厳密にAPIを実装できます。

    CC BY-SA Licensed | Copyright, Internet Initiative Japan Inc.
    - +
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20

    このproto定義から各言語向けに型定義を含めたコードを生成するため、実装が自由なOpenAPIに比べるとより厳密にAPIを実装できます。

    CC BY-SA Licensed | Copyright, Internet Initiative Japan Inc.
    + diff --git a/server-app/rails/index.html b/server-app/rails/index.html index 63a58db8..286f97fa 100644 --- a/server-app/rails/index.html +++ b/server-app/rails/index.html @@ -8,7 +8,7 @@ - + @@ -228,7 +228,7 @@ めには数百時間の学習と実践が必要になると思われます。

    Railsは、しかし、その後のWebアプリケーション開発のお手本になった部分が 多々あり、Railsを学んでおくと、後発のWebアプリケーション開発フレームワー クの習得が容易になるという側面もあります。

    機会を見つけて、Railsにチャレンジしてみることは、現在でも意義のあるこ -とだと思います。

    CC BY-SA Licensed | Copyright (c) 2019, Internet Initiative Japan Inc.
    - +とだと思います。

    CC BY-SA Licensed | Copyright (c) 2019, Internet Initiative Japan Inc.
    + diff --git a/server-app/test-hands-on/index.html b/server-app/test-hands-on/index.html index 68fe425b..306416d9 100644 --- a/server-app/test-hands-on/index.html +++ b/server-app/test-hands-on/index.html @@ -8,7 +8,7 @@ - + @@ -348,7 +348,7 @@ got_data = get_current_number() # got_data = 579
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10

    dockerコンテナ内の/test-hands-on/exercises/exercise3/test_challenge.pyには、本APIが完成すると通るようになる、テストtest_success()が定義されています。

    上記のテストがOKになるよう、各種APIをTDDを使って作成してみましょう。


    # おわりに

    一般的にソフトウェアテストというと、専門のテスト部隊があって「Excelにスクショをペタペタ貼るだけでしょ？」というようなイメージを持ち、敬遠される方も少なくはないと思います。

    開発者がテストについて知識を持ち、単体テストで可能な限りの不具合をなくしておくと、後の工程で不具合が少なく済ますことができたり、メリットがあります。
    -また、後の工程で発生した不具合の内容を聞いた・見ただけで、どのモジュール同士で問題が起こっているのか目星がつくなど、効率的なトラブルシュートやソフトウェアの理解にも繋がります。

    冒頭でも述べましたが、ソフトウェアにも品質というものがあり、この品質次第で会社の売上に影響が出たり、企業のセキュリティや人命に影響を及ぼしてしまう懸念もあります。

    そのため。開発を行う際には是非テストにも注力をしていただき、ユーザーの満足できるソフトウェアを作れるよう、目指してみてください。

    良いエンジニアライフを！👍

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    - +また、後の工程で発生した不具合の内容を聞いた・見ただけで、どのモジュール同士で問題が起こっているのか目星がつくなど、効率的なトラブルシュートやソフトウェアの理解にも繋がります。

    冒頭でも述べましたが、ソフトウェアにも品質というものがあり、この品質次第で会社の売上に影響が出たり、企業のセキュリティや人命に影響を及ぼしてしまう懸念もあります。

    そのため。開発を行う際には是非テストにも注力をしていただき、ユーザーの満足できるソフトウェアを作れるよう、目指してみてください。

    良いエンジニアライフを！👍

    CC BY-SA Licensed | Copyright (c) 2022, Internet Initiative Japan Inc.
    + diff --git a/web-server/apache/index.html b/web-server/apache/index.html index d4f2faab..dba42744 100644 --- a/web-server/apache/index.html +++ b/web-server/apache/index.html @@ -8,7 +8,7 @@ - + @@ -167,7 +167,7 @@ apachectl -V | grep MPM #Server MPM: prefork -
    1
    2
    3
    4
    5
    6
    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    - +
    1
    2
    3
    4
    5
    6
    CC BY-SA Licensed | Copyright (c) 2020, Internet Initiative Japan Inc.
    + diff --git a/web-server/apache_nginx/index.html b/web-server/apache_nginx/index.html index 33d0e743..4dd31543 100644 --- a/web-server/apache_nginx/index.html +++ b/web-server/apache_nginx/index.html @@ -8,7 +8,7 @@ - + @@ -250,7 +250,7 @@ apachectl -V | grep MPM #Server MPM: prefork -
    1
    2
    3
    4
    5
    6
    CC BY-SA Licensed | Copyright, Internet Initiative Japan Inc.
    - +
    1
    2
    3
    4
    5
    6
    CC BY-SA Licensed | Copyright, Internet Initiative Japan Inc.
    + diff --git a/web-server/hosting/index.html b/web-server/hosting/index.html index 9e0aaae2..3ab2686b 100644 --- a/web-server/hosting/index.html +++ b/web-server/hosting/index.html @@ -8,7 +8,7 @@ - + @@ -118,7 +118,7 @@ </Directory>
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19

    apacheを起動します。ServerNameについて警告が出ますがひとまず問題ありません。

    root@0111e4e14e6d:/app# apachectl restart
    1

    無事起動できたらホストのブラウザなどからアクセスしてみましょう。sinatraアプリが動いていれば成功です。

    $ curl -H 'Content-Type:application/json' -d "{"bootcamp":"true"}" localhost
-
    1

    １つ目の例と違うのは、sinatraアプリケーションが単体で起動してlocalhostなどをlistenしているのではなく、apacheの一部として起動している点です。この場合はechoアプリケーションを再起動するためにはApacheごと再起動しなければいけません。

    # 追加

    • apacheが起動している状態で/app以下のapp.rbを変更してみましょう。
    • pumaまたはunicornを使ってapacheまたはnginxとrubyアプリケーションを連携させてみましょう。
    CC BY-SA Licensed | Copyright (c) 2019, Internet Initiative Japan Inc.
    - +
    1

    １つ目の例と違うのは、sinatraアプリケーションが単体で起動してlocalhostなどをlistenしているのではなく、apacheの一部として起動している点です。この場合はechoアプリケーションを再起動するためにはApacheごと再起動しなければいけません。

    # 追加

    • apacheが起動している状態で/app以下のapp.rbを変更してみましょう。
    • pumaまたはunicornを使ってapacheまたはnginxとrubyアプリケーションを連携させてみましょう。
    CC BY-SA Licensed | Copyright (c) 2019, Internet Initiative Japan Inc.
    + diff --git a/web-server/nginx/index.html b/web-server/nginx/index.html index a9d0e98d..a6519bc8 100644 --- a/web-server/nginx/index.html +++ b/web-server/nginx/index.html @@ -8,7 +8,7 @@ - + @@ -16,7 +16,7 @@ GitHub (opens new window)
    このハンズオンでやることnginxの紹介と実際に動かしてみるハンズオンです
    想定時間1h
    前提知識・用語なし

    # nginxを触ってみよう

    資料はこちら

    CC BY-SA Licensed | Copyright (c) 2019, Internet Initiative Japan Inc.
    - + (opens new window)

    • nginxを触ってみよう

    このハンズオンでやることnginxの紹介と実際に動かしてみるハンズオンです
    想定時間1h
    前提知識・用語なし

    # nginxを触ってみよう

    資料はこちら

    CC BY-SA Licensed | Copyright (c) 2019, Internet Initiative Japan Inc.
    + diff --git a/web-server/overview/index.html b/web-server/overview/index.html index f0d3daa0..8a6cbad5 100644 --- a/web-server/overview/index.html +++ b/web-server/overview/index.html @@ -8,7 +8,7 @@ - + @@ -16,7 +16,7 @@ GitHub (opens new window)
    このハンズオンでやること世の中で使われるWebサーバーの種類や実際に使う際の構成例について紹介します
    想定時間1h
    前提知識・用語なし

    # Webサーバー Overview

    資料はこちら

    CC BY-SA Licensed | Copyright (c) 2019, Internet Initiative Japan Inc.
    - + (opens new window)

    • Webサーバー Overview

    このハンズオンでやること世の中で使われるWebサーバーの種類や実際に使う際の構成例について紹介します
    想定時間1h
    前提知識・用語なし

    # Webサーバー Overview

    資料はこちら

    CC BY-SA Licensed | Copyright (c) 2019, Internet Initiative Japan Inc.
    + diff --git a/web-server/tls/index.html b/web-server/tls/index.html index 45317f24..b5c0c785 100644 --- a/web-server/tls/index.html +++ b/web-server/tls/index.html @@ -8,7 +8,7 @@ - + @@ -324,7 +324,7 @@ 利用してみたい場合も証明書を使用するサービスで使えるかどうか確認してから発行するようにしましょう。

    # 安全とされている設定

    日本における暗号設定のセキュリティ上の最低ラインは先の暗号設定ガイドラインの3.1に記載されています。  TLS 暗号設定ガイドライン (opens new window)

    表14がわかりやすいでしょう。ビットセキュリティについては、2.6の表11がわかりやすいです。

    mozilla の推奨暗号スイートも参考になります。

    mozilla Server Side TLS (opens new window)

    今回のcipher設定についてはmozilla のintermediate のものを利用しています。 -こちら (opens new window)で対応する設定を出力してくれるのも便利です。

    - +こちら (opens new window)で対応する設定を出力してくれるのも便利です。

    +