Chapter 8. Managing Apicurio Registry content using a SDK

Procedure

1. Add the following dependency to your Maven project:

   <dependency>
       <groupId>io.apicurio</groupId>
       <artifactId>apicurio-registry-java-sdk</artifactId>
       <version>${apicurio-registry.version}</version>
   </dependency>

2. Create the Apicurio Registry client as follows:

   import io.vertx.core.Vertx;public class ClientExample {
   
       public static void main(String[] args) throws Exception {
           // Create a registry client
           String registryUrl = "https://my-registry.my-domain.com/apis/registry/v3"; 

   1

   
           Vertx vertx = Vertx.vertx(); 

   2

   
           VertXRequestAdapter vertXRequestAdapter = new VertXRequestAdapter(vertx);
           vertXRequestAdapter.setBaseUrl(REGISTRY_URL);
   
           RegistryClient client = new RegistryClient(vertXRequestAdapter); 

   3

   
   
           // Use client here
   
           vertx.close(); 

   4

   
       }
   }

   1

   If you specify an example Apicurio Registry URL of https://my-registry.my-domain.com, the client will automatically append /apis/registry/v3.

   2

   Create a new Vertx object (needed by the VertxRequestAdapter)

   3

   For more options when creating a Apicurio Registry client, see the Java client configuration in the next section.

   4

   When you are done with the client, close the Vertx object to free its resources.