Comment créer un document WSDL documenté à l'aide de XFire

Question

J'utilise XFire pour créer un wrapper de service Web autour de mon application. XFire fournit l'interface de service Web et WSDL au moment de l'exécution (ou les crée au moment de la compilation, ne sait pas exactement).

Beaucoup de nos clients ne connaissent pas très bien les services Web et ne lisent simplement aucune documentation externe comme Javadoc. Je sais qu'il est possible d'ajouter de la documentation (pour les paramètres et les méthodes) directement dans le fichier WSDL.

J'ai pensé aux annotations ou aux fichiers XML Aegis mais je ne sais pas comment… connaissez-vous un moyen?

Modifier: Je viens de trouver ce numéro JIRA , mais la dernière activité remonte à 2006. Des idées?

Answer 1

XFire se dirige lentement vers / dev / null. Utilisez plutôt CXF . En d'autres termes, XFire est devenu obsolète au profit de CXF. Ce sont à peu près les mêmes développeurs.

Puisque vous utilisez l'approche Java-first, je vous suggère de générer votre fichier WSDL une fois pour toutes avec l'outil java2wsdl de CXF, puis placez votre documentation dans cet environnement et dites à CXF d'utiliser documenté WSDL au lieu de laisser CXF générer son propre WSDL (non documenté) au moment de l'exécution / deploy-time.

Cette page contient à peu près tout ce que vous devez savoir sur création d'un service Web dans CXF.

Answer 2

  

Et mon dernier conseil concernant CXF - utilisez Aegis pour la liaison de données au lieu de JAXB. Cela ne fonctionne pas pour les POJO complexes.

D'après mon expérience, nous n'avons aucun problème avec les POJO et JAXB complexes, le seul problème est que le code commence à être encombré de JAXBElements. Par ailleurs, la documentation Aegis est plutôt rare et mal entretenue par rapport à CXF.

Answer 3

Ajoutons mes deux cents concernant XFire. Nous avions un problème très sérieux avec XFie sous JDK6 (Tomcat 6.0 et 5.5) .Veuillez jeter un coup d’œil à ce problème . Dans notre cas, XFire avec 4+ services Web sous JDK6 conduit à des serveurs d’applications suspendus (interblocages de threads, etc.). C'est intéressant, mais sous JDK5, tout allait bien.

Et je suis tout à fait d’accord avec Christian Vest en ce qui concerne la migration de XFire vers CXF. Cela a du sens dans de nombreux cas, par exemple. ESB Mule 2 ne prend plus en charge les connecteurs XFire natifs ( voir aussi ).

Et je souhaite ajouter que la migration de XFire vers CXF n’est pas une méthode simple (par exemple, CXF a des dépendances jar en conflit avec certaines versions d’Hibernate voir aussi ), mais c'est faisable. Dans notre cas, nous l'avons fait pendant quelques jours sans correction de code (configuration Spring only).

Et mon dernier conseil concernant CXF - utilisez Aegis pour la liaison de données au lieu de JAXB. Cela ne fonctionne pas pour les POJO complexes.