Wie dokumentierter WSDL mit XFire erstellen

Question

Ich benutze XFire einen Webservice-Wrapper um meine Anwendung zu erstellen. XFire bietet die Webservice-Schnittstelle und WSDL zur Laufzeit (oder erstellt sie bei der Kompilierung, weiß nicht genau).

Viele unserer Kunden wissen nicht, einen Web Service sehr gut und zusätzlich einfach sie lesen keine externe Dokumentation wie Javadoc. Ich weiß, dass es möglich Dokumentation hinzufügen (für Parameter und Methoden) direkt an die WSDL-Datei.

Ich dachte über Anmerkungen oder Aegis XML-Dateien, aber ich weiß nicht, wie ... Kennen Sie einen Weg?

Edit: Ich habe gerade dieses JIRA Ausgabe aber die letzte Aktivität war 2006. Irgendwelche Ideen?

Answer 1

XFire wird langsam für / dev / null geleitet. Verwenden Sie CXF statt. Mit anderen Worten wird XFire für CXF veraltet - es ist so ziemlich die gleichen Entwickler

.

Da Sie die Java-First-Ansatz verwenden, empfehle ich Ihnen zu generieren, sobald Sie WSDL und für alle mit CXF des java2wsdl Werkzeug, dann setzen Sie Ihre Dokumentation in das und sagen CXF zu verwenden, die dokumentiert WSDL statt die Vermietung CXF seinen eigenen (undokumentiert) WSDL zur Laufzeit generieren / deploy-Zeit.

Diese Seite so ziemlich alles hat müssen Sie darüber wissen Erstellen einer Web-Service in CXF.

Answer 2

  

Und mein letzter Hinweis in Bezug auf CXF - verwenden Aegis für Daten anstelle von JAXB verbindlich. Es ist nicht für komplexe POJO arbeiten.

Nach meiner Erfahrung haben wir kein Problem mit komplexen POJO und JAXB, ist das einzige Problem, dass der Code mit JAXBElements zu überladen beginnt. Auf der anderen Seite ist Aegis Dokumentation ziemlich spärlich und nicht gut gepflegt mit Bezug auf CXF.

Answer 3

Lassen Sie uns mich meine zwei Cent in Bezug auf XFire hinzuzufügen. Wir hatten sehr ernstes Problem mit XFie unter JDK6 (beide Tomcat 6.0 und 5.5) .Bitte einen Blick nehmen an diese Frage . In unserem Fall XFire mit 4+ Web-Service unter JDK6 führt zu hängen Anwendungsservern (Thread-Deadlocks etc.). Es ist interessant, aber unter JDK5 alles war in Ordnung.

Und ich mit Christian Vest in Bezug auf die Migration zu CXF von XFire vollständig zustimmen. Es hat Sinn, in vielen Fällen z.B. ESB Mule 2 unterstützt keine nativen XFire-Anschlüsse mehr ( sehen ).

Und ich wünsche, dass die Migration von XFire zu CXF hinzuzufügen, ist nicht straitforward Art und Weise (zB CXF hat jar abhängigkeit, dass ein Konflikt mit einigen Hibernate Releases siehe auch), aber es ist machbar. In unserem Fall haben wir es für ein paar Tage ohne Codekorrektur (Frühling nur Konfiguration).

Und mein letzter Hinweis in Bezug auf CXF - verwenden Aegis für Daten anstelle von JAXB verbindlich. Es ist nicht für komplexe POJO arbeiten.