ソースコードでのクラスの記述順序
ひとつのクラスのコードを記述するときに、プロパティやメソッドなどの順序をどう決めているだろうか。
昔、C/C++を使っていた頃は、コンパイラが「ソースコードのそれまでに出現した行から定義を探す」のでその制約から順序を決めていた。このときは
- #include
- #define
- using namespace
- static inline functions
- static functions
- class definitions
- fields
- private fields
- protected fields
- public fields
- operators
- cast operators
- binary operators
- methods
- private methods
- protected methods
- public methods
- global functions
としていた。public 要素は private 要素の組み合わせから成り立つことが多いので、private な要素から書いていくと宣言文を書かなくていいから、この順が楽なのである。(楽というのは、ミスが減ると言うことに直結するので重要。)
でも、最近のコンパイラは定義を自動的に探してくれるので、コンパイラの都合に合わせなくてもいい。そんなわけで、最近はこんな風にしている。
- using
- main class
- constant values
- fields
- static fields
- instance fields
- readonly fields
- private fields
- protected fields
- public fields
- (temporary fields)
- events
- constructors
- disposers/finalizers
- properties
- operators
- methods
- public methods
- protected methods
- private methods
- supplimentary class
フィールド、コンストラクタ、ファイナライザ、プロパティ、イベント、メソッドの順序は重要。データはカプセル化の本質なので最初に来る。コンストラクタとデストラクタはオブジェクトのライフサイクルと安定性を決めるので前のほうかつペアに書く。プロパティは副作用がなく、対外的な性質の公開になるので、短くなることからもここら辺でまとめておく。メソッドは、ユースケース/テスト/APIである public なものから書く。
こうすると、変更されやすい箇所はソースコードの後ろの方にまとまります。