メソッドや関数からメソッド等を呼ぶ、入れ子になってるような場合の命名について。

Question

###質問
うまく説明できないのですが例えば、以下のようなDBからデータを取ってくるようなプログラムがあるとします。

class Service {
  private Dao dao;

  Data fetchXXX(key) {
    dao.selectXXX(key)
  }
}

class Dao {
  Data selectXXX(key) {
    //DB処理
    return data;
}

Serviceはよりクライアントに近い層から呼ばれるとします。
上記のようにServiceではDaoを利用して具体的な処理を移譲しています。
そこで親となるメソッド、例だとfetchXXX(key)の名前は子のselectXXX(key)と同じにすべきでしょうか。
Serviceでデータに対するなんらかの処理をしてそれを返す場合は異なった名前になるのが予想されますが、
上記のようにServiceをインターフェースとしてDaoを利用するような(処理を単純に移譲するだけ）場合、
名前は同じなのが良いのか、よくないのか教えていただきたいです。

Answer 1

メソッドの命名における重要なポイントの1つは「利用者に対するインターフェイス」という観点です。つまり提示の例では、Daoクラスを利用する側がどのような名前でメソッドを呼び出せるようにするか？が重要です。Serviceクラスのメソッド名はServiceクラスを利用する側にとって重要な名前であり、それは本来Daoクラスのメソッド名とは関係のないことです。

また、クラス名には適切な「役割名」を、メソッド名には適切な「責務名」を付けなければなりません。その意味からは、ある関係のみ（今回の例ではServiceとDao）に着目して名前を付けるのは適切ではありません。可能な限り1つのクラスは他のクラスと密結合にならないように独立した存在として設計すべきです。

したがって、Serviceクラスから単に移譲で呼び出されるからという理由だけでDaoクラスのメソッドをServiceクラスのメソッド名と同じにしなければならないという必然性はないし、また場合によっては同じ名前になることもありうるということです。
あくまでも、そのクラスの役割と責務、そして外部に対するインターフェイスに着目して名前を検討すればよいでしょう。

Comments

[LokiTick]

非常にわかりやすく、私の知りたかったことをお答えしていただきありがとうございました。
"利用者に対するインターフェイス"という観点はとてもわかり易く、今後はこのコトを肝に銘じて良い設計を心がけます。