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!
Stellungnahme:Der Inhalt dieses Artikels wird freiwillig von Internetnutzern beigesteuert und das Urheberrecht liegt beim ursprünglichen Autor. Diese Website übernimmt keine entsprechende rechtliche Verantwortung. Wenn Sie Inhalte finden, bei denen der Verdacht eines Plagiats oder einer Rechtsverletzung besteht, wenden Sie sich bitte an admin@php.cn