5.2. Maven プラグインを使用したスキーマおよび API アーティファクトのダウンロード

手順

1. Maven pom.xml ファイルを更新して、apicurio-registry-maven-plugin を使用してアーティファクトをダウンロードします。以下の例は、Apache Avro および GraphQL スキーマのダウンロードを示しています。

   Copy to Clipboard Toggle word wrap

   <plugin>
     <groupId>io.apicurio</groupId>
     <artifactId>apicurio-registry-maven-plugin</artifactId>
     <version>${apicurio.version}</version>
     <executions>
       <execution>
         <phase>generate-sources</phase>
         <goals>
           <goal>download</goal> 

   1

   
         </goals>
         <configuration>
             <registryUrl>MY-REGISTRY-URL/apis/registry/v2</registryUrl> 

   2

   
             <authServerUrl>MY-AUTH-SERVER</authServerUrl>
             <clientId>MY-CLIENT-ID</clientId>
             <clientSecret>MY-CLIENT-SECRET</clientSecret> 

   3

   
             <clientScope>MY-CLIENT-SCOPE</clientScope>
             <artifacts>
                 <artifact>
                     <groupId>TestGroup</groupId> 

   4

   
                     <artifactId>FullNameRecord</artifactId> 

   5

   
                     <file>${project.build.directory}/classes/record.avsc</file>
                     <overwrite>true</overwrite>
                 </artifact>
                 <artifact>
                     <groupId>TestGroup</groupId>
                     <artifactId>ExampleAPI</artifactId>
                     <version>1</version>
                     <file>${project.build.directory}/classes/example.graphql</file>
                     <overwrite>true</overwrite>
                 </artifact>
             </artifacts>
         </configuration>
       </execution>
     </executions>
   </plugin>

   1

   実行目標として download を指定します。

   2

   ../apis/registry/v2 エンドポイントで Apicurio Registry URL を指定します。

   3

   認証が必要な場合は、認証サーバーおよびクライアントの認証情報を指定できます。

   4

   Apicurio Registry アーティファクトグループ ID を指定します。一意のグループを使用しない場合は、default のグループを指定できます。

   5

   アーティファクト ID を使用すると、複数のアーティファクトを指定したディレクトリーにダウンロードできます。

2. たとえば、mvn package コマンドを使用して、Maven プロジェクトをビルドします。