我有一个使用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文档?
答案 0 :(得分:4)
尝试将以下内容应用于enunciate.xml
配置文件:
<enunciate>
...
<modules>
...
<docs includeExampleXml="false">
...