Используя WCF в .NET, как сделать так, чтобы он автоматически генерировал документы SOAP, как это делал ASMX? - PullRequest
5 голосов
/ 07 июня 2010

В настоящее время я пишу веб-сервис с использованием WCF в VB.NET.

Предыдущие веб-сервисы, которые я написал, использовали ASMX, но я хотел изучить WCF, и пока все идет хорошо. Я на самом деле предпочитаю, как WCF делает вещи.

Однако мне не хватает одного способа, который ASMX использовал для генерации примеров запросов и ответов SOAP. Это было похоже на бесплатное получение документации.

Есть ли способ автоматически генерировать документацию SOAP для WCF?

Если нет, есть ли способ сгенерировать его на странице .NET с использованием WSDL?

Ответы [ 2 ]

3 голосов
/ 09 января 2012

Я в конце концов нашел ответ. WCFExtras . Библиотека WCFExtras позволяет документировать ваш API с использованием XML-комментариев, а также читает эти комментарии и вставляет их в WSDL в качестве комментариев документации. Затем мы читаем это и генерируем документацию HTML, используя приложение под названием TechWriter.

3 голосов
/ 07 июня 2010

Я полагаю, что WCF не поддерживает это так же, как для ASMX, потому что WCF поддерживает несколько типов конечных точек, а не только веб-службы SOAP (например, Net TCP, именованные каналы и т. Д.).

SoapUI - хороший небольшой инструмент, который может автоматически генерировать сообщения SOAP из WSDL. Или вы можете создать небольшое тестовое клиентское приложение, включить трассировку WCF и использовать Service Trace Viewer Tool для просмотра отправленных сообщений.

...