HN 日本語サマリー

← 一覧へ戻る
プログラミング

不適切な抽象化よりも重複を優先する (2016)

Prefer duplication over the wrong abstraction (2016) (sandimetz.com)

461 pointsby rafaepta310 コメント

要約

この記事は、「不適切な抽象化は重複よりもはるかにコストがかかる」という主張を展開しています。プログラマーが安易に抽象化を行うと、後の要件変更で複雑な条件分岐やパラメーターが増え、コードが理解不能になる問題を指摘しています。著者は、不適切な抽象化に直面した際は、重複を再導入してコードを単純化し、正しい抽象化を再検討することを推奨しています。

全文翻訳

誤った抽象化

これは元々私のChainline Newsletterのために書いたものですが、このアイデアについてツイートで度々言及されるため、ブログで再掲載します。このバージョンは軽めに編集されています。


私は「誤った抽象化」の結果について考えてきました。私のRailsConf 2014の“all the little things”というトークでは、次のように主張したセクションがありました。

重複は誤った抽象化よりもはるかに安価である

そして要約では、次のようにアドバイスしました。

誤った抽象化よりも重複を優先する

この、より大きなトークの小さな一部は、驚くほど強い反応を呼びました。数名は私が正気を失ったと示唆しましたが、さらに多くの人々が次のような意見を表明しました。

これだよ、百万回これだよ! "@BonzoESC: "重複は誤った抽象化よりもはるかに安価です" @sandimetz @rbonales pic.twitter.com/3qMI0waqWb

— 41 shades of blue (@pims) 2014年3月7日

この反応の強さから、私は「誤った抽象化」という問題がいかに広範で、解決が困難であるかを実感しました。私は質問を始め、以下のパターンに気づきました。

  1. プログラマーAが重複に気づく。
  2. プログラマーAは重複を抽出し、名前を付ける。
    これにより新しい抽象化が作成されます。新しいメソッドや、場合によっては新しいクラスになることもあります。
  3. プログラマーAは重複を新しい抽象化に置き換える。
    ああ、コードは完璧です。プログラマーAは幸せそうに立ち去ります。
  4. 時間が経過する。
  5. 現在の抽象化にほぼ完璧に合致する新しい要件が現れる。
  6. プログラマーBがこの要件の実装を担当する。
    プログラマーBは既存の抽象化を維持する義務を感じますが、すべてのケースでまったく同じではないため、パラメータを受け取るようにコードを変更し、そのパラメータの値に基づいて条件付きで正しいことを行うロジックを追加します。
    かつて普遍的だった抽象化は、今やケースごとに異なる振る舞いをするようになります。
  7. さらに別の新しい要件が現れる。
    プログラマーX。
    さらに別のパラメータ。
    さらに別の条件分岐。
    コードが理解不能になるまで繰り返す。
  8. あなたは物語のこのあたりに登場し、あなたの人生は劇的に悪化します。

既存のコードは強力な影響力を持っています。その存在自体が、それが正しく、かつ必要であると主張します。コードは費やされた労力を表していることを私たちは知っており、その労力の価値を維持しようと強く動機づけられます。そして残念ながら、悲しい真実は、コードが複雑で理解不能であればあるほど、つまり、それを生成するために費やされた投資が深ければ深いほど、それを維持しようとするプレッシャーを強く感じるということです(サンクコスト(埋没費用)の誤謬)。まるで私たちの無意識が「なんてこった、それはとても紛らわしい。きっと得るのに何年もかかったに違いない。それは絶対に、絶対に重要に違いない。そのすべての労力を無駄にするのは罪だ」と語りかけてくるかのようです。

あなたが上記のステップ8で物語に登場するとき、このプレッシャーはあなたを前進させる、つまり既存のコードを変更して新しい要件を実装するように駆り立てるかもしれません。しかし、そうしようとすることは過酷です。コードはもはや単一の共通の抽象化を表すのではなく、互いに漠然と関連付けられた複数のアイデアをインターリーブする、条件付きの手続きになってしまっています。理解するのが難しく、壊しやすいのです。

もしあなたがこの状況に陥ったなら、サンクコストに駆り立てられるのを拒んでください。誤った抽象化に対処する場合、前進する最速の方法は後退することです。以下の手順を実行してください。

  1. 抽象化されたコードをすべての呼び出し元にインライン化して、重複を再導入します。
  2. 各呼び出し元内で、渡されているパラメータを使用して、その呼び出し元が実行する抽象化コードのサブセットを決定します。
  3. この特定の呼び出し元に必要ない部分を削除します。

これにより、抽象化と条件分岐の両方が削除され、各呼び出し元は必要なコードのみに削減されます。このように決定を巻き戻すと、各呼び出し元が表向きは共有の抽象化を呼び出していたとしても、実行されていたコードはかなりユニークであったことがよくわかります。古い抽象化を完全に削除したら、新たに開始し、重複を再分離し、抽象化を再抽出することができます。

私は、人々が誤った抽象化で懸命に進もうとしていたにもかかわらず、ほとんど成功していなかった問題を目の当たりにしてきました。新機能の追加は非常に困難で、それぞれの成功がコードをさらに複雑にし、次の機能の追加をさらに困難にしていました。彼らが視点を「このコードへの投資を守らなければならない」から「このコードはしばらくの間は理にかなっていたが、おそらく私たちはそこから学べるすべてを学んだ」に変え、現在の要件に照らして抽象化を再考することを自分自身に許可したとき、すべてが簡単になりました。コードをインライン化すると、前進する道が明らかになり、新機能の追加はより速く、より簡単になりました。

この物語の教訓は?サンクコストの誤謬に囚われないでください。パラメータを渡し、共有コードを通じて条件分岐を追加していることに気づいたら、その抽象化は間違っています。最初はそのままで正しかったかもしれませんが、その日は過ぎ去りました。抽象化が間違っていると証明されたら、最善の戦略は重複を再導入し、それが正しいものを示してくれるようにすることです。洞察を得るために少数の条件分岐を蓄積することが時折理にかなうこともありますが、誤った抽象化を早期に放棄すれば、より少ない苦痛で済みます。

抽象化が間違っているとき、前進する最速の方法は後退することです。これは撤退ではなく、より良い方向への前進です。実行してください。あなた自身の人生、そして後に続くすべての人々の人生を改善することになるでしょう。

ニュース: 99 Bottles of OOP が JS, PHP, Ruby で登場!

99 Bottles of OOP の第2版がリリースされました!

第2版には3つの新しい章が含まれており、第1版よりも約50%長くなっています。また、99 Bottles of OOP は特定の言語ではなくオブジェクト指向設計全般について扱っているため、今回は例に異なるプログラミング言語を使用した、技術的には同一だが別々の書籍を作成しました。

99 Bottles of OOP は現在、Ruby、JavaScript、PHP のバージョンで、ビールとミルクの飲み物として利用可能です。epub、kepub、mobi、pdf フォーマットで提供されます。これにより、6冊の異なる書籍と(3x2x4)24通りの可能なダウンロードが可能になります。すべてユニークですが、同じものです。1回の購入で、すべてまたは一部のダウンロード権が得られます。