設計– tag –
-
React 深掘り
カスタムフック — 似ているだけでは共通化しない
「同じような処理が2箇所にあるから共通化しよう」で切り出した自作フックが、結局どこでも使えず、引数だけが増えていった。原因は「見た目が同じ」と「意味が同じ」を取り違えたことにある。この記事では ~/reactlab を新しく作り、切り出してよいものと、よくないものの境目を実物で確かめる。そのうえで useToggle・useLocalStorage・useDebounce の3つを実際に作り、使う側のコードが before/after でどう短くなるかを見る。さらに「同じフックを2箇所で呼んでも状態は共有されない」ことを実演し、返り値を配列にするかオブジェクトにするかの判断基準と、renderHook を使ったテストの書き方までやる。 -
コンピュータ科学 深掘り
UML図とMermaid記法 — 図はすぐ嘘になる
設計図を描いても、3週間後には嘘になっています。画像で描いた図は誰も直さないからです。この記事では「テキストで書けて、Gitで差分が見えて、コードと突き合わせられる図」だけを扱います。クラス図・シーケンス図・ER図の3つを、アスキー図とMermaid記法の両方で書きます。ER図はCREATE TABLEを読んで関係を機械で出し、多対多に中間テーブルが要ることを確かめます。最後にステートマシン図を状態遷移表としてコードに落とし、node --test で「図に描いていない矢印は1本も通れない」ことをテストします。図がそのままテストになると、図は腐りません。 -
バックエンド
URLに動詞を入れない — REST APIの設計
/api/deleteTask?id=3 と書きたくなるのを、なぜ DELETE /api/tasks/3 にするのか。URLはモノ、メソッドが動詞。PUTとPATCHの違い、2回打っても壊れない設計(冪等性)、そして「無いIDを消したとき何を返すか」まで、前回のtasks APIを完成させながら決めていきます。
1