声明报告 - 如何排除少量API并包含来自同一个类的少量API

Question

我想从Enunciate文档中排除类中的一些API方法。

有没有办法用enunciate来实现它？

先谢谢

Answer 1

Enunciate 1.27 has a feature "Facet"(http://docs.codehaus.org/display/ENUNCIATE/Enunciate+API+Facets) which helps in achieving the above. 
Requires following changes

1.) pom.xml
Added the plugin
<plugin>
<groupId>org.codehaus.enunciate</groupId>
<artifactId>maven-enunciate-plugin</artifactId>
<version>1.27</version>
<executions>
    <execution>
        <goals>
            <goal>assemble</goal>
        </goals>
    </execution>
</executions>
</plugin>


2.) In the API Method you want to exclude, add Facet annotation like below

    @GET
    @Path("/{memberId}")
    @Produces(APPLICATION_JSON)
    @Facet(name = "external")


3.) Change enunciate xml to refer to 1.27 enunciate xsd

4.) Add Facets tag in your enunciate xml

   <facets>
    <exclude name ="external"/>
   </facets>


Result - Enunciate report excludes selected APIs methods in class "A" and includes the rest.