Effective Java, 3rd Edition

4.5Thema 19: Entwerfen und dokumentieren Sie für Vererbung oder verbieten Sie sie

In Thema 18 wurden Sie auf die Gefahren hingewiesen, wenn Sie eine Klasse von einer fremden Klasse ableiten, die nicht für die Vererbung konzipiert und dokumentiert wurde. Was bedeutet es also, wenn eine Klasse für die Vererbung entworfen und dokumentiert ist?

Erstens muss die Klasse genau dokumentieren, welche Auswirkungen das jeweilige Überschreiben der einzelnen Methoden hat. Mit anderen Worten, die Klasse muss dokumentieren, wie sie selbst die überschreibbaren Methoden verwendet. Für jede öffentliche oder geschützte Methode muss in der Dokumentation angegeben werden, welche überschreibbaren Methoden diese Methode aufruft, in welcher Reihenfolge und wie sich ...