在enunciate中停用XML示例和XML文档

时间:2014-03-31 14:03:14

标签: enunciate

我有一个使用enunciate记录的REST服务。我的端点都没有提供application / 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。您可以看到我已经尝试通过仅在内容类型中放入内容类型的application / json并通过放置xml / disabled = true来禁用XML生成:

<?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文档?

1 个答案:

答案 0 :(得分:4)

尝试将以下内容应用于enunciate.xml配置文件:

  <enunciate>
    ...
    <modules>
      ...
      <docs includeExampleXml="false">
      ...