メソッド名は慎重に選択してください:
- 名前は規則 (項目 68) に従う必要があります。
- 理解しやすく、パッケージおよび一般的なコンセンサスと一致する名前を優先します。
- 長い名前は避けてください。
便利なメソッドを誇張しないでください:
- 各メソッドは「作業の一部を実行」する必要があります。
- 多くのメソッドにより、API の使用、保守、文書化が困難になります。
- 頻繁に使用される場合にのみ、省略されたメソッドを提供します。
長いパラメータリストを避ける:
- パラメーターは 4 つ以下に制限します。
- 長いリストは覚えにくく、間違いが発生しやすくなります。
- 同じタイプのパラメータが連続して存在すると、混乱が生じる可能性があります。
長いパラメータリストを削減する 3 つのテクニック:
- メソッドをいくつかの小さなメソッドに分割します。
- パラメータ グループのヘルパー クラスを作成します。
- 多くのパラメーター、特にオプションのパラメーターを持つメソッドには、ビルダー パターンを使用します。
パラメータ内のクラスよりもインターフェイスを優先します:
- 柔軟性を高めるために、HashMap などの特定のクラスではなく、Map などのインターフェイスを使用します。
パラメータではブール値より列挙型を優先します:
- 列挙型を使用すると、コードが読みやすくなり、温度スケール付きの温度計の例のように、将来のオプションの拡張が容易になります。
- これらのプラクティスは、使いやすく、エラーが発生しにくい API を作成するのに役立ちます。
以上がアイテムのデザイン方法署名を慎重にの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。