ベタープログラマを読もう

ベタープログラマ ―優れたプログラマになるための38の考え方とテクニック

読みながらブログを書いてみようと思いたちました。去年ポチって届いたまま積んでた。とりあえず今回は目次流しして、部ごとにブログ書いていこうかなーとか思ってます。思ってるだけかも。

どんな本かというと

コードを気にかける人の姿勢みたいなものかしらね。著者はCodeCraftと同じPeteGoodliffeなので、読んだことがある人は想像できるのかもしれない。

Code Craft　エクセレントなコードを書くための実践的技法 . (Mynavi Advanced Library)

対象はたぶん「この本が気になる人」と幅広い感じ。それだけに専門的ではない（「はじめに」にもそう書いてる）、エモい方の内容なんでしょうね。では目次を読みましょか。

目次流し

5部、38章で構成されています。全章を書きだすのはだるいので、部単位でざっと書いていきます。

第I部 you.write(code)

部タイトルが you.write(code) とコードっぽく書かれてて素敵ですね。最後まで部のタイトルはこれで行って欲しい感がありましたが、残念ながら最初だけです。そういえばサインをお願いするとこのスタイルでメッセージを書いてくれる方がいて、格好いいなーと思ってます。

各章のタイトルはそれ一言で内容がわかり、「そうそう」と言いたくなるもの。4章の「取り除くことでコードを改善する」とかをドヤ顔で言うといいかもしれません。5章の「コードベースの過去の幽霊」なんかは、削除していないコードに悩まされる話*1かと思ったら、サブタイトルに「過去に書いたコードから学ぶ」なのでどうも口寄せとかそんな感じのようです。8章の「そのエラーを無視するな！」などから思うのは、エラーを主体に取り扱うのは解決策を扱う本や記事では取り扱いにくいのか、あまり見ない少ない印象なので特徴と言えるのかもしれない。ここは読もう。

内容が予想しづらいのは6章の「航路を航行する」と11章の「テストの時代」、13章の「二つのシステムの物語」あたり。ということで、5,6,8,11,13章を読もうと思います。

第II部 練習することで完璧になる

練習と言われるとアプレンティスシップパターンの「練習、練習、練習」はいい名付けだなと思い出します。

アプレンティスシップ・パターン　―徒弟制度に学ぶ熟練技術者の技と心得 (THEORY/IN/PRACTICE)

練習の方法が書かれているのかなと章タイトルを見て見ると、そうでもなさそう。どうも実戦の中で練習するスタイルのよう？「本番でなければ練習にならない」みたいなことを言ってる方もいらっしゃいますし、それはそれでわかります。隔離されたクリーンな環境での練習は、それはそれで役に立ちますが、予期しないことに極端に弱いものですので。さて、この部は14章の「ソフトウェア開発とは」から始まるので、第I部よりは少し俯瞰した感じ。16章に「単純に保つ」などもありますが、3章にあった「少ないコードを書く」や4章「取り除くことでコードを改善する」を受けて実際どうしていくかとかを書いてそう。19章の「コードを再利用するケース」、再利用はいっとき喧伝されていましたが、悪影響も大きいので取り扱いは慎重になるべきところだと考えています。共通化も同じで、前に書いたエントリ*2とかもその一端ですね。再利用について考察されているものはあまり記憶にないので、ケースが書かれていそうなのは期待。あと気になるのは22章の「凍結されたコードの数奇な人生」かな。コード凍結ってよくあるのだけど、バージョン管理システムを前提としてリリースブランチをもつブランチ戦略をとっていれば不要のはずだし、フィーチャートグルなどの抽象ブランチを活用したアクティブメインラインだと凍結したら開発止まるよなーとか思ってて、そう言う点を整理してくれてるのかなーと。あ、20章に「効果的なバージョンコントロール」があるので、バージョン管理システムの活用は前提、のはず。

17章の「頭を使いなさい」は、うん、まあそう言うことなんだろう。この手の本を読む人に改めて言う必要はあるんだろうか。あれかな、本の内容を真に受けて従えばいいみたいなところへの警鐘？ということで、16,17,19,22章を読みましょかね。

第Ⅲ部 個人的なこと

ふわっとした部タイトルが来た。さて各章は・・・あーうん、エモい。読み物として全体をさらっと読むところな気がする。25章「試験に基づく開発者」は別にテスト駆動開発者のことではなさそう。サブタイトルに自動車運転とか書いてるけど、なにを試験と言ってるのかは気になる。あとは26章「チャレンジを楽しむ」や27章「停滞を避ける」などはテーマとしてはよく言われることで、それに対してどう考えてるかって事が書いてるんだろう。プログラミング言語に対する姿勢についてかかれた29章の「言語への愛」あたりは面白そう。複数言語を学びつつ得意言語があるって人は多いと思うけど、そう言う所も書いてるのかな。得意言語とかを考えると、先にもあげたアプレンティスシップパターンの「得意領域へ撤退」が思い出されます。これもいいネーミング。

ちょっと面白いのが30章の「プログラマの姿勢」で、サブタイトルが「プログラマの健康の改善：姿勢、目の疲労、元気の維持」です。心構え的な姿勢じゃなく、物理的な姿勢のようですね。テスト駆動開発でKentBeckが「Cheap Desk, Nice Chair（いい椅子を買え）」と書いていたのを思い出します。

テスト駆動開発

第Ⅳ部 成し遂げる

この部は31章「一生懸命ではなく、賢く」、32章「完了したときが完了」、33章「今度こそ分かった……」の3章だけです。だけどよく似たような事を人に言ってる気がする（自分できてないくせに）。そんなタイトルが並んでるので、全部読むかな。

第Ⅴ部 人々の営み

チームワークについて、この部も少なくて5章だけです。いずれも気にはなるけれど、特に挙げるなら説明責任について書かれている35章「原因は思考」と、36章の「遠慮なく話す」ですかね。遠慮はチームワークを阻害する害悪で、チームメンバーには「遠慮するのがあなたの仕事ですか？」みたいなことをうっかり言ったりしてました。そのまま言うとどう考えてもパワハラなので、いい方はもう少し考えたほうがいい。ってところで35,36章は読もう。

さー読むぞー

この手の本は前から順番に読むのもいいのだけど、つまみ食いして飛び回る（どうせ各章から他の章への言及があるんでしょ？）のも一つの読み方だと思います。ってことで気になる所をピックアップしてみたけど、どうも半分くらい挙がってますね……。これは上で挙げたのを読み終わったら結局全部読み終えてたりするよーな。まあいいか。

てことでぼちぼち読んでいきます。

*1:よくありますよね

*2:http://irof.hateblo.jp/entry/20120709/p1

「現場で役立つシステム設計の原則」の目次流し

本日発売された @masuda220 さんの「現場で役立つシステム設計の原則」が気になってる方へ。

紙の本。

現場で役立つシステム設計の原則 ~変更を楽で安全にするオブジェクト指向の実践技法

こっちはkindle。

現場で役立つシステム設計の原則 〜変更を楽で安全にするオブジェクト指向の実践技法

まだ全部読めてないけれど、精読するといつ読み終わるかわからない・・・。 なので、まったく読んでない気分になって目次ベースで紹介してみます。 どう言うことが書いてそうかの参考にはなるかなと。

しかしこの内容、よくこのサイズの本で、それほど小さくない字なのに入りましたね。要約力のなせる技なんでしょうか。

目次流し: 期待とつまみ食い

目次をさらっと読んで、こんなこと書いてるのかなーって妄想を交えて書き連ねます。たまに実際開いて。 なお、 「太文字のカギカッコ」 は目次からの引用です。

Chapter1 小さくまとめてわかりやすくする

ソフトウェアはソフトなのに変更が大変になるのはなぜだろう。 これには大きくしてしまった時点で負けと言う原則がある。 大きくせざるをえないものがないとは言わないけれど、小さくする、小さく保つ努力を怠っていい理由にはならない。

このChapterでは小さくあるためにどのようにするかが書かれていそうな雰囲気。 難しい言葉で言えば高凝集で疎結合なのだが、抽象的な話に逸れがちなテーマ。 これに対してメソッドやクラスを作成する上での一般指針や、ファーストクラスコレクションをあげているので、抽象ではなく具象で語っているのだろう。

Chapter2 場合分けのロジックを整理する

組み合わせられるように作成できるのはソフトウェアの強みではある。 一方で簡単に組み合わせ爆発を起こしてしまい、気づいたら制御できなくなっているものである。 C2カバレッジが現実的でないと言われたりする話もある。

このChapterでは、組み合わせを発生させないためにできることを詰め込んでいるようだ。 そんな何でもかんでも組み合わせる必要はない、こうすれば余計な複雑性を放置せず済む、と区分や種別の引力に対峙している。 また、本書はJavaを使っているため、強力な機能であるenumの実践も記述されている。 私自身、増田さんと仕事をさせていただいた時に「enumをそう使えばいいのか！」とショックを受けた。 その内容はわずか2ページにエッセンスが詰め込まれているのだが、このChapterだけでなく前Chapterも理解して身についていなければ、単に「ふーん」で読み流してしまう。

Chapter3 業務ロジックをわかりやすく整理する

神クラスが生まれるのはなぜだろう。 他言語にあるプロパティ構文やLombokが欲しくなるような、getter/setterだけを持っているクラスに何の価値があるだろう。 余計な複雑性を持ち込んでいるんじゃないか。 データとロジックが同じ場所にあることがカプセル化だったんじゃないか。 あれはただの教科書的なもので、実務では使えない机上の空論なんだろうか。

・・・なんて話に真っ向勝負を挑んでいるのが、このChapterの見出しを眺めた印象である。 重要なのは、ここで記載されていることが全て実際のシステムからの知見であること。 また、海の向こうの関わりが少ないものではなく、日本のシステム開発で実践されたことであることかもしれない。 文化が違うから実現できるんだ、ウチではそういうのはできないんだ、なんて言い訳をいつまでも続けるのは難しい気がする。

Chapter4 ドメインモデルの考え方で設計する

増田亨と言えばDDDの人と認識されている方も結構いるはず。 DDDは「エリック・エヴァンスのドメイン駆動設計」が有名で、本書が登場してからよく聞くようになった言葉である。

エリック・エヴァンスのドメイン駆動設計

とは言え「DDD＝エリック・エヴァンスのドメイン駆動設計」でもなく、増田さんは増田さんのDDDを実践していると思っている。 つまるところ、このChapterは「増田亨のドメイン駆動設計」なんだろうなーと。

見出しを眺めると、エヴァンスの言葉はほとんど使われておらず、むしろ「コト」などの聞き慣れた言葉が使われている。 どう解釈するか、などに悩まずに素直に内容と向き合えるのじゃないかなと。

そして教科書的に済まないのが本書の特徴。 前半で一通り説明したのち、最後 「業務の理解がドメインモデルを洗練させる」 では 「形式的な資料はかえって危険」「言葉のあいまいさを具体的にする工夫」 など、現場で向き合ったこともあります。 現在進行形で取っ組み合いしてるところなので重点的に読みたい。

Chapter5 アプリケーションの機能を組み立てる

サービスクラスを作ると、ドメインモデルの責務がサービス側にうっかり漏れ出して、ドメインモデルが空洞化するなんて話はよく聞くところで。 また、業務システムはデータベースありきな文化も強くあります。 これらの慣習的な作り方の引力への抗い方について書かれてそうな感じがします。

「初期のドメインモデルは力不足」 と言うまぎれもない事実を事実として認め、それからどうするか。 決して"最初から完璧なドメインモデルを作ろう"ではないはず。

Chapter6 データベースの設計とドメインオブジェクト

データベースに関わるよくある問題と、テーブル設計の一般則、そして工夫と言う感じで書かれているようだ。 問題点などはSQLアンチパターンとも絡むのかな（参考書籍にもあげられてるし）

SQLアンチパターン

「参照をわかりやすくする工夫」 のところでは、当然のようにイミュータブルデータモデルや、結果整合性が書かれている感じがする。 そしてChapter5でデータベースに引っ張られないようにと説明していたはずが、ここで 「オブジェクトとテーブルは似てくる」 と言われてしまい、え？となっているところに 「オブジェクトはオブジェクトらしく、テーブルはテーブルらしく」 と続けてくるのは面白い。

Chapter7 画面とドメインオブジェクトの設計を連動させる

DDDで捉えたつもりのドメインモデルと、画面の要件がズレていることは珍しくない。 そこには色々な関心ごとが混じり合っているから。 画面向けのドメインと実際のドメインが別にあり、それらが複雑に絡み合っているんじゃないか、なんて考えたこともあるのだけれど、そんなことをしているとシステムを作るのに莫大なコストがかかることになってしまうので、違うんじゃないかなーとか思ってた。

このChapterでは 「画面とドメインオブジェクトと連動させる」 として、画面都合のロジックをどのようにしてドメインオブジェクトに記述しつつ、ドメインオブジェクトの独立性を維持するのかが書かれてそう。 なおWebアプリケーションの画面なのでHTMLが前提になってます。

Chapter8 アプリケーション間の連携

流行り？のマイクロサービス的な話がはいってるのかなーと眺めてみたけれど、そのような記述はないです。 ここでの連携は素直にアプリケーション間の連携で、対象はファイル転送、データベース共有、Web API、（非同期）メッセージングを指しています。 その中でも特にWeb APIに重点が置かれているようで、7割くらいはWeb APIの話っぽい。

Chapter9 オブジェクト指向の開発のプロセス

ここで開発プロセスの話に飛ぶのか。 開発プロセスのソフトウェアに対する影響などの一般則から、 「ソースコードを第一級のドキュメントとして活用する」 の転換。 そして 「更新すべきドキュメント」 として、現実で必要になるソースコード以外のドキュメントの話。 決してドキュメントは全て不要！なんて言ってないのがわかる。

なぜ開発プロセスの話になるんだろうと思ったので少し先読みしたところ、どうやらプロセスを変えないとオブジェクト指向の開発はできないようなことが書いてそう。 初期のドメインモデルが力不足なのだから、当然と言えば当然で、それを通すためにはプロセスも当然あったようにしないとね。

Chapter10 オブジェクト指向設計の学び方と教え方

リファクタリングやオブジェクト指向エクササイズなどなどの話。 これだけで一冊書けるところですが、車輪の再発明ではなく、主に本の紹介で構成されてるChapterです。

全体通して

本を受け取った時は、あれ、本小さくね？軽くね？？って思いました。 こうしていざ目次を見てみると、思った以上に広い。そして深い。びっくりした。

タイトルの「現場で役立つ」ですが、実際役立てるかは読んだ方ご自身の責務です。 あたりまえですが、読んでも使わないと役に立ちません。装備しないとダメとかそう言うやつです。

あと参考文献のページに書影入ってるのが地味にいいですね。

対象読者層

読みやすい文で、分量は多くなく、コードや図は多め。 そしてそれほど高くなく、このカバー範囲。

「システム設計の原則」と言うと身構えるかもしれないけれど、新人から少し脱したくらいから読んでもいいんじゃないかなと思います。 おそらく、難しくて全く理解できないなんてことにはならない。

一方、書いている内容の理解の仕方は、背景の知識の広さや深さで大きく変わる印象を受けました。 どのChapterをとっても、完全に理解していて何も得るものがない、なんてことはそう無いでしょう。

そのため、システムを開発するあらゆる方に読んで貰いたいと思いました。 現場でもこの本を読んでる前提で、どうしようって話ができると楽しそう。

読書会とかするといいんじゃないかなー

対象読者が幅広くて、コンテキストによって理解の仕方が変わりそうなので、持ち寄って「自分はこう読んだ」なんて話をすると面白いんじゃないかなーと。 と言うのも、平易な文でボリュームが少ないので、さらっと読んでしまおうと思えばそれで終われるんです。 でもそうしちゃうにはちょっともったいない感じもする。

ネタ: タイトルについて

「現場で役立つシステム設計の原則」なんですが、増田さんの会社名って「システム設計」なんですよね。。。 なので、会社名が他のだったら、 現場で役立つXXXの原則 （XXXは任意の会社名）となったのだろうか、とかなんとか。 いや、どうでもいいんですが。

"ふつうのJavaコーディング"を話しました

2017/5/20にあったJJUG CCC 2017 Springで登壇させていただきました。 8回目の参加です。

毎回パワーアップしているなーと言うのは前回のブログでも書きましたが、今回は目に見えて参加人数が増えたんだなーと体感しました。 入れないセッションもありましたし、懇親会も超満員でした。運営の皆様に本当に感謝です。 今後も楽しみにしています。

話したもの

ごくふつうの話、のつもり。ふつうって一体なんだとか思わなくはないですが、ただの枕詞なので意味はないです。

結局のところ九段に集約されるんですが、強い意思を持つには色々必要で、まあそんな感じです。

「coming soon」となっている61スライド目

先日（6/24）発売のWEB+DB PRESS Vol.99 で書いてます。

WEB+DB PRESS Vol.99

連載のJavaの新定石、第8回となる Optional/Stream適材適所 です。 内容が気になる方は、よろしくおねがいします！