Sorgfältige Auswahl der Methodennamen:
- Namen müssen den Konventionen entsprechen (Punkt 68).
- Priorisieren Sie Namen, die verständlich sind und mit dem Paket und dem allgemeinen Konsens übereinstimmen.
- Vermeiden Sie lange Namen.
Übertreiben Sie nicht mit praktischen Methoden:
- Jede Methode muss „ihren Teil der Arbeit erledigen“.
- Viele Methoden erschweren die Verwendung, Wartung und Dokumentation der API.
- Bieten Sie abgekürzte Methoden nur an, wenn sie häufig verwendet werden.
Vermeiden Sie lange Parameterlisten:
- Beschränken Sie sich auf vier oder weniger Parameter.
- Lange Listen sind schwer zu merken und fehleranfällig.
- Parameter des gleichen Typs in Folge können zu Verwirrung führen.
Drei Techniken zur Reduzierung langer Parameterlisten:
- Teilen Sie die Methode in mehrere kleinere Methoden auf.
- Erstellen Sie Hilfsklassen für Parametergruppen.
- Verwenden Sie das Builder-Muster für Methoden mit vielen Parametern, insbesondere optionalen.
Schnittstellen gegenüber Klassen in Parametern bevorzugen:
- Verwenden Sie für mehr Flexibilität Schnittstellen wie Map anstelle spezifischer Klassen wie HashMap.
Enums gegenüber Booleschen Werten in Parametern bevorzugen:
- Enums machen den Code besser lesbar und erleichtern zukünftige Erweiterungen der Optionen, wie im Beispiel des Thermometers mit Temperaturskala.
- Diese Vorgehensweisen tragen dazu bei, APIs zu erstellen, die einfacher zu verwenden und weniger fehleranfällig sind.
Das obige ist der detaillierte Inhalt vonSignaturen der Item-Design-Methode sorgfältig durchführen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!