5

我编写了一个 doclet,它收集一些数据并将其传递给记者。我希望这个记者是可以交换的。我尝试使用 AdditionalDependency 和/或 pluginDependency 将报告器实现添加到 doclet 类路径。我无法使用 Java 6 服务加载器加载报告器实现,并且使用 doclets 类加载器或线程上下文类加载器获取类也不起作用。

如何将 test.TestReporterImpl 放入 test-doclet 类路径?

在 doclet 中:

apiReporterServiceLoader = ServiceLoader.load(TestReporter.class); // test.TestReporter

apiReporterServiceLoader.iterator().hasNext(); // false

Thread.currentThread().getContextClassLoader().loadClass("test.TestReporterImpl"); // ClassNotFoundException

getClass().getClassLoader().loadClass("test.TestReporterImpl"); // ClassNotFoundException

在执行 doclet 的 pom 中

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.10.3</version>
    <executions>
        <execution>
            <id>run-my-doclet</id>
            <goals>
                <goal>javadoc</goal>
            </goals>
            <phase>generate-resources</phase>
        </execution>
    </executions>
    <dependencies>
        <dependency>
            <groupId>test</groupId>
            <artifactId>test-doclet-test-reporter</artifactId>
            <version>${project.version}</version>
        </dependency>
    </dependencies>
    <configuration>
        <doclet>test.TestDoclet</doclet>
        <docletArtifact>
            <groupId>test</groupId>
            <artifactId>test-doclet</artifactId>
            <version>${project.version}</version>
        </docletArtifact>
        <additionalDependencies>
            <additionalDependency>
                <groupId>test</groupId>
                <artifactId>test-doclet-test-reporter</artifactId>
                <version>${project.version}</version>
            </additionalDependency>
        </additionalDependencies>
        <useStandardDocletOptions>false</useStandardDocletOptions>
    </configuration>
</plugin>

test-doclet-test-reporter/src/main/resources/META-INF/services/test.TestReporter

test.TestReporterImpl
4

2 回答 2

1

您必须通过将以下内容添加到构建下的任何位置的 POM 来指定要包含在类路径中的目录。这适用于资源下 meta-inf 文件夹下的类,以防出现从默认隐式资源文件夹中提取的错误。

 <project>
     ...
     <build>
       ...
       <resources>
         <resource>
           <directory>[your folder containing the class or to be in the classpath here]</directory>
         </resource>
       </resources>
       ...
     </build>
     ...
    </project>
于 2015-05-21T01:26:48.227 回答
0

我在为 Java 8 和 Java9+ 提供 Doclet 实现的多版本 jar 中遇到了类似的问题。我使用了 javadoc 插件选项docletPath

                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <id>javadoc9-test1</id>
                        <goals>
                            <goal>javadoc-no-fork</goal>
                        </goals>
                        <phase>test</phase>
                        <configuration>
                            <doclet>de.ohmesoftware.javadoctoproperties.Converter9</doclet>
                            <additionalOptions>-prefix rest.description -output mydocs.properties</additionalOptions>
                            <debug>true</debug>
                            <docletPath>${project.build.outputDirectory}/META-INF/versions/9</docletPath>
                            <sourcepath>${project.basedir}/src/test/java/de/ohmesoftware/javadoctoproperties/model
                            </sourcepath>
                        </configuration>
                    </execution>
             <configuration>
                    <useStandardDocletOptions>false</useStandardDocletOptions>
                    <javadocExecutable>${java.home}/bin/javadoc</javadocExecutable>
                </configuration>
            </plugin>
于 2021-12-20T19:30:17.237 回答