如何将JSON响应体的格式包含在experience生成的文档中？

Question

目前，expertion生成REST API文档，但是响应体不包含关于响应的JSON结构的信息。在我的理解中，如果我包含由Jersey序列化/反序列化到JSON的数据实体的类，expertion将能够生成那部分文档。

数据实体在不同的模块中，按照清晰的留档-多模块项目中的建议，将其源打包

...
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-source-plugin</artifactId>
    <version>2.1.2</version>
    <executions>
        <execution>
            <id>attach-sources</id>
            <phase>package</phase>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>
...

这是我的发音.xml的样子：

<?xml version="1.0"?>
<enunciate label="someapi" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://enunciate.codehaus.org/schemas/enunciate-1.25.xsd">

    <api-import pattern="com.something.business.vo.**"/>
    <api-import pattern="com.something.business.domain.**"/>

    <api-classes>
        <include pattern="com.something.web.ssoApi.rest.*"/>
        <include pattern="com.something.business.vo.**"/>
        <include pattern="com.something.business.domain.**"/>
    </api-classes>

</enunciate>

文档的样子是这样的：

如您所见，响应体仅包含< code >元素:(custom)。

如何使包含JSON结构的响应？

Answer 1

为了生成“数据模型”部分的文档，应使用@XmlRootElement对实体进行批注。