Ich habe mehrere Camel-Kontexte in meinem Projekt und möchte die Routen möglichst reverse-engineering-mäßig dokumentieren, da wir die Dokumentation aktuell im Kontext halten wollen. Was wäre der beste Ansatz?Dokumentieren von Kamelrouten
Wir neigen dazu, die Routen im Voraus zu entwerfen und sie mit der Ikonographie aus der EIP book zu modellieren. Das gibt uns eine Anleitung, um dann unsere Routen zu testen. Ändern sich Ihre Routen wirklich so oft, dass Reverse Engineering erforderlich ist? Wir suchen langsam nach einem dynamischen UI für unsere Routen - aber das wird nicht vor 2011 sein :)
Sie können nur Dokumentation in der tatsächlichen DSL hinzufügen und dann einige Werkzeuge oder was auch immer, die diese Route extrahiert und Dokumentation.
Im Frühjahr XML DSL sollten Sie Elemente zu den EIPs in der Route hinzufügen können. Sie können auch allgemeine XML-Kommentare hinzufügen.
Auch wie oben erwähnt ist einige GUI-Tooling auch, was einige Leute verwenden möchten. Dann ist oft das visuelle Diagramm der Routen mit den EIP-Icons die Dokumentation.
FuseSource erstellt derzeit ein GUI-Tool namens FuseSource Rider. Es wird in diesem Monat in der öffentlichen Betaversion sein.
Bei Apache Camel gibt es einige Maven Werkzeuge für http://camel.apache.org/visualisation.html
Die ursprüngliche Dokumentation gui Diagramme zu erzeugen erfolgt Business Process Modeling Notation (BPMN) und eine Menge Arbeit getan wurde, verwendet wird, die Wege sind nicht mehr im Einklang mit die BPMN. Unser Problem kommt, weil einer der Teammitglieder gegangen ist und keine Zeit hatte, seine Arbeit zu dokumentieren. Die Routen sind nicht vollständig definiert, da es ein sehr großes Projekt ist (EU-Forschungsprojekt) und die Spezifikationen sich ändern, wenn neue Anforderungen identifiziert werden. – Monachus