plugins - Maven Artifacts の javadoc/source を確認してアクセスする方法

Question

特定のプロジェクトの依存関係に javadocs とソースが利用可能かどうかを確認する必要がある Maven プラグインを作成しています...もしそうなら、それらをダウンロードしてサーバーにアーカイブしたいと思います。

javadocs とソースが利用可能かどうかを確認する方法、またはそれらにアクセスする方法がわかりません。

どんな助けでも大歓迎です。

Answer 1

分類子タグを依存関係に追加することで、追加のアーティファクトを参照できます。分類子は、リポジトリ内のアーティファクトの名前の追加部分です (junit-4.5-sources.jar など) 。

したがって、junit ソース jar への依存関係を直接宣言するには、次のように指定できます。

<dependency>
  <groupId>junit</groupId>
  <artifactId>junit</artifactId>
  <version>4.5</version>
  <classifier>sources</classifier>
  <scope>test</scope>
</dependency>

すべての依存関係ソースをダウンロードする場合は、分類子ソースを指定する maven-dependency-plugin の copy-dependencies ゴールを使用します。次の例では、ソース用と javadocs 用の 2 つの実行を定義しています。

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-dependency-plugin</artifactId>
      <executions>
        <execution>
          <id>sources</id>
          <phase>package</phase>
          <goals>
            <goal>copy-dependencies</goal>
          </goals>
          <configuration>
            <classifier>sources</classifier>
            <failOnMissingClassifierArtifact>false</failOnMissingClassifierArtifact>
            <outputDirectory>${project.build.directory}/sources</outputDirectory>
          </configuration>
        </execution>
        <execution>
          <id>javadocs</id>
          <phase>package</phase>
          <goals>
            <goal>copy-dependencies</goal>
          </goals>
          <configuration>
            <classifier>javadoc</classifier>
            <failOnMissingClassifierArtifact>false</failOnMissingClassifierArtifact>
            <outputDirectory>${project.build.directory}/javadocs</outputDirectory>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

ダウンロードしたすべてのアーティファクトを zip にパッケージ化する場合は、maven-assembly-plugin を使用してプロジェクトのアーカイブを作成できます。次の例は、sources および javadocs ディレクトリを含めるためのアセンブリ記述子ファイルの内容です。

<assembly>
  <id>project</id>
  <formats>
    <format>zip</format>
  </formats>
  <fileSets>
    <fileSet>
      <directory>${project.basedir}</directory>
      <useDefaultExcludes>true</useDefaultExcludes>
      <includes>
        <include>${project.build.directory}/sources</include>
        <include>${project.build.directory}/javadocs</include>
      </includes>
    </fileSet>
  </fileSets>
</assembly>

アセンブリを参照するには、pom にプラグイン構成を追加します。これは、上記のコンテンツが src/main/assembly/sources.xml に配置されていることを前提としています (上記の依存関係の構成の後に定義されていることを確認してください)。

<plugin>
  <artifactId>maven-assembly-plugin</artifactId>
  <version>2.2-beta-4</version>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>single</goal>
      </goals>
      <configuration>
        <descriptors>
           <descriptor>src/main/assembly/sources.xml</descriptor>
        </descriptors>
      </configuration>
    </execution>
  </executions>
</plugin>