2010-06-07 16 views
5

Actualmente estoy escribiendo un servicio web usando WCF en VB.NET.Usando WCF en .NET, ¿cómo puedo hacer que autogenere documentos SOAP como lo hizo ASMX?

Los servicios web anteriores que escribí usaban ASMX, pero quería aprender WCF y hasta ahora todo va bien. En realidad, prefiero la forma en que WCF hace las cosas.

Sin embargo, una cosa que echo de menos es la forma en que ASMX solía generar solicitudes y respuestas SOAP de ejemplo. Fue como obtener la documentación de forma gratuita.

¿Hay alguna forma de generar automáticamente la documentación de SOAP para WCF?

Si no, ¿hay alguna forma de generarlo en una página .NET utilizando WSDL?

Respuesta

3

Finalmente encontré la respuesta. WCFExtras. La biblioteca WCFExtras le permite documentar su API usando comentarios XML y lee esos comentarios y los inserta en el WSDL como comentarios de documentación. Luego leemos esto y generamos documentación HTML usando una aplicación llamada TechWriter.

3

Supongo que esto no es compatible con WCF de la misma forma que lo fue para ASMX porque WCF admite múltiples tipos de punto final, no solo servicios web SOAP (por ejemplo, TCP de red, canalizaciones con nombre, etc.).

SoapUI es una buena herramienta pequeña que puede autogenerar mensajes SOAP desde WSDL. O bien, puede crear una pequeña aplicación cliente de prueba, habilitar el seguimiento WCF y usar el Service Trace Viewer Tool para ver los mensajes que se enviaron.

+2

Lo que estoy buscando es algo que pueda autogenerar los documentos sobre la marcha, de modo que si agrego nuevos métodos a mi API, se documentan automáticamente y algunos ejemplos de sapd se dan ... ¿hay alguna biblioteca .net que lo haga? ¿esta? – Hades

Cuestiones relacionadas