宣布不生成文档

Question

我正试图从各种类中生成清晰的文档，所有的JAX-RS都有注释，一些用java编写，一些用clojure编写。

我构建了一个maven项目，它只是依赖于包含服务类的war文件：

<build>
    <plugins>
        <plugin>
            <groupId>org.codehaus.enunciate</groupId>
            <artifactId>maven-enunciate-plugin</artifactId>
            <version>1.27</version>
            <configuration>
                <configFile>src/conf/enunciate.xml</configFile>
                <additionalClasspathEntries>
                    ${settings.localRepository}/com/ws/scholar/0.96-SNAPSHOT/scholar-0.96-SNAPSHOT.war
                </additionalClasspathEntries>
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>assemble</goal>
                    </goals>
                </execution>
            </executions>
            <dependencies>
                <dependency>
                    <groupId>com.ws</groupId>
                    <artifactId>scholar</artifactId>
                    <version>0.96-SNAPSHOT</version>
                    <type>war</type>
                </dependency>
                <dependency>
                    <groupId>javax.ws.rs</groupId>
                    <artifactId>javax.ws.rs-api</artifactId>
                    <version>2.0</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

我无法生成任何服务文档。

当运行mvn发音：docs-X时，我看到我的类“注意到了”：

[调试]注意到类 WEB-INF.classes.com.ws.scholar.resources.ClientResource in /.m2/repository/com/ws/scholar/0.96-SNAPSHOT.war。

有人能为我的配置提供指导或更正吗？

Answer 1

不幸的是，您不能只是将战争添加为依赖项，然后让其中的类在类路径中被拾取。战争不是罐子。

相反，您可能需要使用maven-war-plugin的attachClass参数来将您的类导出为战之外的jar。然后你可以像这样依赖那个jar：

            <dependency>
                <groupId>com.ws</groupId>
                <artifactId>scholar</artifactId>
                <version>0.96-SNAPSHOT</version>
                <classifier>classes</classifier>
            </dependency>