Генерація документації про SOAP із WSDL-документу

Ви створюєте архітектуру підприємства на основі Web-сервісів із використанням SOAP та WSDL. Потрібно, щоб розробники могли знайти повну та корисну інформацію про наявні сервіси.

У цьому рішенні ми створимо на основі WSDL-опису сервер документації з Web-сервісів, тобто сервіс, який надає інформацію про сервіси [3] . Ми напишемо CGI-сценарій мовою Perl, яка буде за допомогою

XSLT обробляти один файл WSDL. Цей файл містить сам або включає інформацію про всі послуги, що працюють на підприємстві. У разі CGI-сценарий викликає процесор XSLT з допомогою функції system. Такий спосіб ще підходить для створення прототипу, але ніяк не для промислового розгортання. Краще було б скористатися Perl-модулями XML::LibXML та XML::LibXSLT. А ще краще вдатися до розвиненої серверної підсистеми на базі XSLT, наприклад Cocoon. Ми прийняли спрощений підхід для того, щоб зосередитися на тих аспектах, які стосуються XSLT та WSDL, а не архітектури CGI.

Головна сторінка сайту генерується CGI-сценарієм, який показує наявні сервіси та порти. Про те, що це таке, див. Ми в такий спосіб викликаємо процесор Saxon з Perl:

print "Content-type: text/html\n\n" ;

system "saxon StockServices.wsdl wsdlServiceList.xslt" ;

Наступне перетворення будує форму, в якій описані послуги, порти, прив'язки та типи портів:

Сервіси в компанії ACME Web Services, Inc. Документація з WSDL: згенерована

---