Деактивировать примеры XML и XML-документацию в enunciate.

У меня есть служба REST, которая задокументирована с помощью enunciate. Ни одна из моих конечных точек не предоставляет вывод приложения/xml. Тем не менее я получаю документацию, подобную этой: http://enunciate.codehaus.org/wannabecool/step4/el_persona_persona.html (пример XML) и здесь: http://enunciate.codehaus.org/wannabecool/step4/persona_persona.html (атрибуты XML).

Я предоставляю услугу только с выводом JSON (не спрашивайте меня, почему, это не мое решение). Таким образом, мне не нужен вывод XML, так как он подскажет пользователю интерфейса, что можно использовать интерфейс с данными XML.

Ниже вы можете найти мой enunciate.xml. Вы можете видеть, что я уже пытался отключить генерацию XML, поместив только application/json типа контента в типы контента и поставив xml/disabled=true:

<?xml version="1.0" encoding="UTF-8"?>
<enunciate label="blubb" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:noNamespaceSchemaLocation="http://enunciate.codehaus.org/schemas/enunciate-1.28.xsd">
    <deployment protocol="https" host="blubb" context="blubbService/v1"/>
    <namespaces>
        <namespace id="api" uri="https://blubb.com/blubbService/v1/"/>
    </namespaces>
    <services>
        <rest>
            <content-types>
                <content-type type="application/json" id="json" />
            </content-types>
        </rest>
    </services>
    <modules>
        <docs splashPackage="blubbService.api" title="blubb API" copyright="blubb"/>
        <jersey useSubcontext="false" usePathBasedConneg="false"/>
        <xml disabled="true"/>
        <jaxws disabled="true" />
        <jaxws-client disabled="true" />
        <jaxws-ri disabled="true" />
    </modules>
</enunciate>

Как правильно деактивировать XML-документацию?


enunciate
person Shirky    schedule 31.03.2014    source источник

Ответы (1)


arrow_upward
4
arrow_downward

Попробуйте применить к файлу конфигурации enunciate.xml следующее:

  <enunciate>
    ...
    <modules>
      ...
      <docs includeExampleXml="false">
      ...
person Ryan Heaton    schedule 09.04.2014
comment
Не могли бы вы объяснить этот код (в вашем ответе)? Так вы можете получить больше голосов! - person The Guy with The Hat; 10.04.2014