Читать книгу API-Design - Kai Spichale - Страница 44

Versuchen Sie nicht alles neu zu erfinden, sondern versuchen Sie etablierte Konzepte und Bezeichner wiederzuverwenden, die die Benutzer Ihrer API vermutlich schon kennen. Beispielsweise hat jeder Java-Entwickler eine intuitive Erwartung, wie sich die Methode add einer Klasse namens OrderSet verhält. Nutzen Sie dieses Wissen für sich aus. Berücksichtigen Sie beispielsweise auch die bekannten Namenskonventionen von JavaBeans.

Wiederverwendung heißt auch, von anderen guten APIs zu lernen. Nutzen Sie die Namen und Muster von APIs von Bibliotheken oder Diensten, die Sie bereits kennen oder die von vielen anderen Entwicklern verwendet werden.

Falls die Anwendung, an der Sie arbeiten, bereits andere Schnittstellen hat, dann sollten Sie diese beim Entwurf der neuen berücksichtigen. Denn die Benutzer der neuen API kennen bereits die Namen und Konzepte der existierenden APIs. Versuchen Sie eine dazu passende API zu entwerfen, sodass die Lernkurve der Benutzer möglichst flach bleibt.