アイテムのデザイン方法署名を慎重に

メソッド名は慎重に選択してください:

• 名前は規則 (項目 68) に従う必要があります。
• 理解しやすく、パッケージおよび一般的なコンセンサスと一致する名前を優先します。
• 長い名前は避けてください。

便利なメソッドを誇張しないでください:

• 各メソッドは「作業の一部を実行」する必要があります。
• 多くのメソッドにより、API の使用、保守、文書化が困難になります。
• 頻繁に使用される場合にのみ、省略されたメソッドを提供します。

長いパラメータリストを避ける:

• パラメーターは 4 つ以下に制限します。
• 長いリストは覚えにくく、間違いが発生しやすくなります。
• 同じタイプのパラメータが連続して存在すると、混乱が生じる可能性があります。

長いパラメータリストを削減する 3 つのテクニック:

• メソッドをいくつかの小さなメソッドに分割します。
• パラメータ グループのヘルパー クラスを作成します。
• 多くのパラメーター、特にオプションのパラメーターを持つメソッドには、ビルダー パターンを使用します。

パラメータ内のクラスよりもインターフェイスを優先します:

• 柔軟性を高めるために、HashMap などの特定のクラスではなく、Map などのインターフェイスを使用します。

パラメータではブール値より列挙型を優先します:

• 列挙型を使用すると、コードが読みやすくなり、温度スケール付きの温度計の例のように、将来のオプションの拡張が容易になります。
• これらのプラクティスは、使いやすく、エラーが発生しにくい API を作成するのに役立ちます。

以上がアイテムのデザイン方法署名を慎重にの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。