Como criar WSDL documentada utilizando XFire

Question

Eu uso XFire para criar um wrapper webservice em torno da minha candidatura. XFire fornece a interface webservice e WSDL em tempo de execução (ou cria-los em tempo de compilação, não sei exatamente).

Muitos de nossos clientes não sei webservices muito bem e além disso eles simplesmente não ler qualquer documentação externa como Javadoc. Eu sei que é possível adicionar a documentação (para os parâmetros e métodos) diretamente para o arquivo WSDL.

Eu pensei sobre anotações ou arquivos XML Aegis mas eu não sei como ... Você sabe uma maneira?

Edit: Eu encontrei este JIRA questão mas a última atividade foi 2006. Alguma ideia?

Answer 1

XFire está lentamente se dirigiu para / dev / null. Use CXF . Em outras palavras, XFire está sendo preterido em favor do CXF - é praticamente os mesmos desenvolvedores

.

Uma vez que você usar o Java primeira abordagem, sugiro que você gerar WSDL uma vez por todas com a ferramenta java2wsdl do CXF, então você colocar sua documentação em que e dizer CXF para uso que WSDL documentado vez de deixar CXF gerar seu próprio WSDL (indocumentados) em tempo de execução / deploy-time.

Esta página tem praticamente tudo o que você precisa saber sobre criação de um serviço web em CXF.

Answer 2

E a minha última dica sobre CXF - usar Aegis para vinculação de dados em vez de JAXB. Ele não funciona para POJO complexo.

Na minha experiência, não temos nenhum problema com POJO complexo e JAXB, o único problema é que o código começa a ser desordenado com JAXBElements. Por outro lado, a documentação Aegis é muito escassa e não bem mantida com relação ao CXF.

Answer 3

Vamos me adicionar meus dois centavos sobre XFire. Tivemos problema muito sério com XFie sob JDK6 (ambos Tomcat 6.0 e 5.5) .Por favor, dar uma olhada em essa questão . No nosso caso XFire com 4+ serviços da Web em leads JDK6 para pendurar servidores de aplicação (thread impasses etc.). É interessante, mas sob JDK5 tudo estava OK.

E eu concordo completamente com Christian Vest sobre a migração para CXF de XFire. Tem sentido em muitos casos, por exemplo, O ESB Mule 2 não suporta conectores XFire nativas mais ( ver também ).

E eu gostaria de acrescentar que a migração do XFire para CXF não é o caminho straitforward (por exemplo CXF tem jar dependências que o conflito com alguns hibernação lançamentos ver também ), mas é factível. No nosso caso, fiz isso por dois dias sem correção de código (somente configuração do Spring).

E a minha última dica sobre CXF - usar Aegis para vinculação de dados em vez de JAXB. Ele não funciona para POJO complexo.