バックエンド– tag –
-
データベース
プロセスを止めても消えない場所 — MySQLとSQLの基本
前回のAPIは、サーバーを止めるとデータが消えた。なぜファイルに書くだけでは駄目なのかから始めて、MySQLを入れ、SQLの4つを覚え、最後にNode.jsから繋いで「再起動しても残る」ところまで持っていく。WHEREを忘れたUPDATEで全行が飛ぶ話つき。 -
バックエンド
実行ファイル1つで動く — Goで同じAPIを書く
言語を1つしか知らないと、「その言語の性質」と「プログラミング一般」の区別が付かなくなる。だから2つ目を触る。ただしGoの入門はしない。第5段階の最初に書いた15行のNode.jsサーバーと、同じ/api/tasksを返すGoを、行ごとに並べて比べるだけ。コンパイルすると実行ファイルが1つできて、Node.jsもGoも入っていない環境でそのまま動く。ldd と ls -lh で確かめて、Dockerイメージが小さくなる理由まで繋げます。このサイトは引き続き Node.js で進めます。 -
バックエンド
1画面のために3回叩く — GraphQLとRESTの違い
一覧画面を1つ作るのに、いまのREST APIは何回叩くことになるのか。実際に数えて、過剰取得と不足取得を目で見るところから始めます。GraphQLは「1つのURLにPOSTするだけ」でRESTと同じHTTPの上に乗っていること、スキーマが契約になること、既存のRESTを消さずに /graphql を足す実装、そしてGraphQLが極端にN+1を起こしやすいことを101本のSQLログで確かめます。最後に、失われるもの(HTTPキャッシュ・エラーが200で返る・認可が複雑になる)を正直に並べて、個人のサービスならRESTで十分だという結論まで書きます。 -
バックエンド
gRPCはcurlで叩けない — 関数を呼ぶようにAPIを呼ぶ
REST・GraphQLに続く3つ目の選択肢としてgRPCを触ります。ただしこれはブラウザ向けではなく、サービス同士が話すための道具です。RPCという古い考え方の系譜をSOAPから辿り、.protoを書いてスキーマを先に決め、@grpc/proto-loaderで動的に読み込んでサーバーとクライアントを両方書き、~/server とは別ポートで共存させます。山場はJSONとProtocol Buffersのバイト数を実測して比べるところ。なぜ小さいのかがフィールド名を送らないことだと分かると、代償として人間が読めないことも同時に納得できます。curlで叩けないことを実際に体験してgrpcurlを入れ、4つの通信の形を整理し、ブラウザから直接使えない理由をHTTP/2の制御が要ることから説明して、最後に「個人のサービスには要らない」と正直に結論します。 -
バックエンド
3つ目で言語の地図ができる — Pythonを触る
2つ目のGoで「言語の性質」と「共通のもの」を分ける線は引けた。ただし2点では地図にならない。3つ目のPythonを置いて、はじめて面になる。Python入門はしない。同じ/api/tasksを3列に並べて、インデントが文法であること、型は書かなくていいが書けること、そして同じ計算ループをGo・Node.js・Pythonで実際に測って「遅い」を数字で見る。そのうえで、遅い言語が駄目ではない理由(動く時間より書く時間が高いことがある)まで。Ubuntuの Python を sudo pip install で壊さない話と、venv も必ず通ります。最後に9つの言語を4象限に置いて、次に何を学ぶかの判断軸を作ります。 -
バックエンド
APIの正体はJSONを返すHTTP — Node.jsで作る
前回の15行のサーバーを、そのままAPIに育てる。生のNodeでPOSTの本文を受け取り、第3段階で「フロントでは直せない」と書いたCORSを今度はサーバー側から解除する。最後にExpressで書き直して、ライブラリが何を肩代わりしていたのかを確かめる。 -
バックエンド
URLに動詞を入れない — REST APIの設計
/api/deleteTask?id=3 と書きたくなるのを、なぜ DELETE /api/tasks/3 にするのか。URLはモノ、メソッドが動詞。PUTとPATCHの違い、2回打っても壊れない設計(冪等性)、そして「無いIDを消したとき何を返すか」まで、前回のtasks APIを完成させながら決めていきます。 -
バックエンド
サーバーとは待ち続けるプログラム — 手で書いて確かめる
python3 -m http.server と打つたびに何が起きていたのか。netcatで人間が手でサーバーになり、次に15行のNode.jsで置き換え、最後にsystemdで常駐させる。「サーバー=すごい機械」という誤解を、ここで捨てます。
1