nicht angemeldet
Hello,
http://framework.zend.com/wiki/display/ZFDEV2/Coding+Standards#CodingStandards-InlineDocumentation fand ich immer ganz nützlich. Aber hilft hier vielleicht nicht direkt, oder?
Nein das hilft nicht wirklich weiter.
So wie dort beschrieben mache ich es ja bereits bei Methoden die direkt (also selbst) eine Exception werfen.
Mir geht es um Methoden die andere Methoden aufrufen die Exceptions werfen und um den Umstand ob und wie in der aufrufenden Methode darauf hingewiesen werden soll.
Also ich würde nur dokumentieren:
- Exceptions, die von der Methode selbst ausgelöst werden
- Exceptions, die von der Methode gefangen werden und was dann warum _hier_ zu geschehen hat
- Exceptions, die von der Methode keinesfalls gefangen werden dürfen, und !warum! nicht.
Alles Andere ist bei Verwendung des das Exception-Model sowieso einheitlich zu regeln, sonst kann man auch gleich wieder auf diskrete Fehlerwerte von Funktionen zurückfallen.
Exceptions sind solange in Richtung Programmwurzel durchzureichen, bis sie behandelt werden können. Und die Ausnahmen der Ausnahmen-Behandlung sollte man daher dokumentieren.
Da lob ich mir meine Runtime-Errors :-P
Liebe Grüße aus dem schönen Oberharz
Tom vom Berg
