yDoc - Javadoc™ UML Erweiterung

yDoc Shareware Version herunterladen.
yDoc evaluieren und den vollen Funktionsumfang 14 Tage lang ausgiebig testen.
yDoc in unserem Online Shop kaufen.

yDoc ist eine Javadoc™ Erweiterung, die automatisch klare und übersichtliche UML Diagramme von den Klassen Ihres Software Projekts generiert und diese in die erzeugte Java API Dokumentation integriert.

yDoc bedient sich der ausgezeichneten Layoutalgorithmen unserer Visualisierungsbibliothek yFiles, um die UML-Diagramme zu erzeugen.

Neue Merkmale in Version 3.0

• Neuer Übersichtsdiagrammtyp, der die Vererbungsstruktur von Klassen und Schnittstellen über Paketgrenzen hinweg zeigt.
• UML Diagramme können im SWF (Shockwave Flash) Dateiformat erzeugt werden.
• Neue Stiloptionen, um die Darstellung von Diagrammelementen zu beeinflussen.
• Eigene Diagramme (im GraphML Dateiformat) können in die generierte Dokumentation eingebunden werden.
• Neue XML-basierte Konfiguration.
• Viele neue Layoutoptionen für Übersichtsdiagrammtypen.
• Neue Ausrichtungsoptionen für Assoziationen und Abhängigkeiten in Klassendiagrammen.
• StyleEd wurde erheblich verbessert und nutzt die neue XML-basierte Konfiguration. Die Anwendung ermöglicht einfaches Testen von Stil- und Layoutoptionen.

Herausragende Merkmale

Die Liste der yDoc Merkmale beinhaltet:

• Einen XML-basierten Mechanismus, um eigene Javadoc-Tags zu definieren.
• Die Möglichkeit gezielt Klassen, Methoden und Felder von der Dokumentation auszuschließen. Dies wird einfach durch einen Exklusions-Tag an den unerwünschten Klassen, Methoden oder Feldern erreicht. Darüberhinaus stellen wir ein Interface zur Verfügung, das den Einsatz von anspruchsvollen und individuellen Exklusionskriterien erlaubt.
• Automatische Generierung von UML Diagrammen für alle dokumentierten Klassen und Pakete.
  • Die Diagramme können als SVG (Scalable Vector Graphics), SWF, PNG, GIF oder JPG in die erzeugten HTML-Seiten eingebunden werden.
  • Alle Diagramme sind mit Hyperlinks hinterlegt, die direkt auf die Dokumentation der dargestellten Pakete, Typen, Methoden und Felder verweisen.
  • Alle Diagramme können über Stildefinitionen an Benutzerwünsche angepasst werden.

• StyleEd, ein einfach zu bedienender Editor mit graphischer Oberfläche zum Erstellen von Diagrammstilen:

• Unterstützung für Java 5.0 Spracherweiterungen:
  • Namen von parametrisierten Typen werden vollständig angezeigt.
  • Typsichere Aufzählungen werden als Klassen mit enum constraint-Markierung dargestellt.
  • Annotationstypen werden als Interfaces mit annotation Stereotypen-Markierung dargestellt.
  • Variable Parameterlisten werden erkannt und als ... dargestellt.

Beispiele

UML Klassendiagramme, die von yDoc erzeugt werden, zeigen Generalisierungs- und Realisierungsbeziehungen ebenso wie Assoziationen und Abhängigkeiten zwischen Klassen und Schnittstellen.
Die Darstellung von Diagrammelementen kann dabei mit Hilfe vorgegebener bzw. Benutzer-definierter Stile einfach angepasst werden.
Ein real-world Beispiel aus der yFiles API Dokumentation ist etwa dieses Klassendiagramm für eine der Klassen der yFiles Bibliothek.

original Stil		gradient Stil		dark-matter Stil
dotnet Stil		muted-colors Stil		yFiles Stil

Die von yDoc erzeugten Paketdiagramme verdeutlichen die Klassenhierarchie in den Paketen. Über die Stildefinitionen und viele Layoutoptionen kann das Aussehen der Diagramme einfach angepasst werden; u.a. sind verschiedene Layoutrichtungen möglich.
Ein real-world Beispiel aus der yFiles API Dokumentation ist etwa dieses Paketdiagramm für eines der Pakete der yFiles Bibliothek.

Layoutrichtung links-nach-rechts
gradient Stil		dotnet Stil
Layoutrichtung unten-nach-oben
original Stil		theBlues Stil

Mit den Übersichtsdiagrammen, die von yDoc erzeugt werden können, lassen sich Abhängigkeiten von Paketen untereinander bzw. die Vererbungsstruktur von Klassen und Schnittstellen über Paketgrenzen hinweg veranschaulichen:
Real-world Beispiele aus der yFiles API Dokumentation sind etwa die Übersichtsdiagramme für die Pakete der yFiles Bibliothek.

Paketabhängigkeiten

Vererbungsstruktur über Paketgrenzen hinweg

Dokumentation

• yDoc Installations- und Benutzerhandbuch HTML Version, PDF Version (englisch)
• API Dokumentation der DocFilter Klasse (englisch)

Voraussetzungen

yDoc benötigt das Javadoc-Tool von JDK 1.5.0/JDK 1.6.0.

Damit Ihr HTML-Browser die in der API Dokumentation eingebetteten UML-Klassendiagramme im SVG Format anzeigen kann, benötigen Sie ein SVG-Plugin. Für den Microsoft Internet Explorer kann man ein solches bei Adobe kostenfrei herunterladen.

Damit Ihr HTML-Browser die in der API Dokumentation eingebetteten UML-Klassendiagramme im SWF Format anzeigen kann, benötigen Sie das Adobe Flash Player-Plugin. Dieses kann bei Adobe kostenfrei heruntergeladen werden.