Home General Staff Contact Partners Alumni Research Areas Projects Papers Books Reports Awards Teaching Lectures Exams B.Theses M.Theses PhD Theses Go Abroad Misc Talks Library Gallery Links Search Webmaster |
Ein Framework zur Erzeugung von Dokumentationen für SoftwareschnittstellenChristian Wohlfahrtstätter Die Schnittstelle eines Softwarebausteins (z.B. einer Klasse) besteht aus allen exportierten Datenfeldern und Methoden des Bausteins sowie aus deren Spezifikation. Während sich die Syntax der Schnittstelle aus dem Quellcode extrahieren läßt, muß die Spezifikation vom Programmierer angegeben werden. In Java hat es sich eingebürgert, die Spezifikation in Form spezieller Dokumentationskommentare in den Quellcode zu schreiben und ein Werkzeug zu benutzen, das diese Kommentare extrahiert und zu einer Schnittstellendokumentation verarbeitet. Javadoc ist ein Werkzeug von Sun Micrsosystems, welches eine Schnittstellendokumentation nach dem oben beschriebenen Verfahren generiert [Sun2001a]. In der aktuellen Version von Javadoc lässt sich die Schnittstellendokumentation in verschiedenen Ausgabeformaten erzeugen (z.B. HTML, XML, PS, PDF etc.). Das Werkzeug hat jedoch einen großen Nachteil: Die Dokumentation kann nur aus dem Quellcode einer ganz bestimmten Programmiersprache, nämlich Java, generiert werden. Ziel dieser Diplomarbeit ist ein erweiterbares Framework zu implementierien, welches erlaubt, Schnittstellendokumentation aus dem Quellcode beliebiger Programmiersprachen zu generieren. Dabei sind folgende Bedingungen zu beachten:
[Sun2001a] http://java.sun.com/j2se/javadoc/index.html [Sun2001b] http://java.sun.com/j2se/javadoc/writingdoccomments/index.html Betreuer: Prof. Dr. H. Mössenböck Ausgabe: 1. März 2001 |