oop - クリーンなインターフェースを設計するためのガイドライン

Question

ソフトウェア開発に関する記事を読んでいると、「クリーンなインターフェース」という言葉をよく耳にします。人々は、API とクラスのクリーンなインターフェースについて話しました。

「クリーンなインターフェース」をどのように定義しますか? クリーンなインターフェイスを備えたシステムを設計するためのガイドラインはありますか?

Answer 1

これについては何冊もの本が書かれており、Framework Design Guidelines (.NET-centric) は私のお気に入りの 1 つです。それには多くのことがあり、簡単な答えはありませんが、簡単な答えを求められている場合は、開発者が拡張ドキュメントを読まなくても簡単なことを実行できるように API を設計することをお勧めします。これは、理にかなった説明的な名前を使用した、単純で一貫したインターフェイスを意味します。基本的なことを難しくしないでください。

Answer 2

「クリーンなインターフェース」とは、実装の詳細を漏らさないインターフェースです。理解しやすく、プライベートな部分を公開せず、ユーザーとインターフェイスしているコードとの間に過度の結合が生じることはありません。厳密な定義というよりは、コードの匂いです...

Answer 3

シンプルに保ち、無駄のない迅速な、一目瞭然のコードを記述します。読みやすく、維持しやすいもの。