Add OrasModel for better Quarkus reflective support (#277)

Author: jonesbusy

pom.xml

@@ -69,6 +69,7 @@
     <wiremock.version>3.12.1</wiremock.version>
     <mockito.version>5.17.0</mockito.version>
     <system.stubs.version>2.1.8</system.stubs.version>
+    <classgraph.version>4.8.177</classgraph.version>
 
     <!-- Plugin version -->
     <build.helper-maven-plugin.version>3.6.0</build.helper-maven-plugin.version>
@@ -115,6 +116,11 @@
         <artifactId>gson</artifactId>
         <version>${gson.version}</version>
       </dependency>
+      <dependency>
+        <groupId>io.github.classgraph</groupId>
+        <artifactId>classgraph</artifactId>
+        <version>${classgraph.version}</version>
+      </dependency>
       <dependency>
         <groupId>org.apache.commons</groupId>
         <artifactId>commons-compress</artifactId>
@@ -211,6 +217,11 @@
       <artifactId>logback-classic</artifactId>
       <scope>test</scope>
     </dependency>
+    <dependency>
+      <groupId>io.github.classgraph</groupId>
+      <artifactId>classgraph</artifactId>
+      <scope>test</scope>
+    </dependency>
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>

src/main/java/land/oras/Annotations.java

@@ -35,6 +35,7 @@
  * @param filesAnnotations    Annotations for the layers/files
  */
 @NullMarked
+@OrasModel
 public record Annotations(
         Map<String, String> configAnnotations,
         Map<String, String> manifestAnnotations,

src/main/java/land/oras/ArtifactType.java

@@ -29,6 +29,7 @@
  * Class for artifact type
  */
 @NullMarked
+@OrasModel
 public class ArtifactType {
 
     private final String mediaType;

src/main/java/land/oras/Config.java

@@ -32,6 +32,7 @@
  * Class for config
  */
 @NullUnmarked
+@OrasModel
 public final class Config extends Descriptor {
 
     /**

src/main/java/land/oras/ContainerRef.java

@@ -34,6 +34,7 @@
  * A referer of a container on a {@link Registry}.
  */
 @NullMarked
+@OrasModel
 public final class ContainerRef extends Ref<ContainerRef> {
 
     /**

src/main/java/land/oras/Describable.java

@@ -23,6 +23,7 @@
 /**
  * Interface for describable objects
  */
+@OrasModel
 public interface Describable {
 
     /**

src/main/java/land/oras/Descriptor.java

@@ -30,6 +30,7 @@
 /**
  * Main class for descriptor
  */
+@OrasModel
 public sealed class Descriptor permits Config, Manifest, Layer, Index {
 
     /**
@@ -42,15 +43,35 @@ public sealed class Descriptor permits Config, Manifest, Layer, Index {
      */
     protected final @Nullable Map<String, String> annotations;
 
+    /**
+     * The digest of the layer
+     */
     protected final @Nullable String digest;
+
+    /**
+     * The size of the layer
+     */
     protected final @Nullable Long size;
+
+    /**
+     * The artifact type
+     */
     protected final @Nullable String artifactType;
 
     /**
      * Original json
      */
     protected transient String json;
 
+    /**
+     * Constructor
+     * @param digest The digest
+     * @param size The size
+     * @param mediaType The media type
+     * @param annotations The annotations
+     * @param artifactType The artifact type
+     * @param json The original JSON
+     */
     protected Descriptor(
             String digest,
             Long size,

src/main/java/land/oras/Index.java

@@ -32,6 +32,7 @@
 /**
  * Index from an OCI layout
  */
+@OrasModel
 public final class Index extends Descriptor implements Describable {
 
     private final int schemaVersion;

src/main/java/land/oras/Layer.java

@@ -36,6 +36,7 @@
  * Class for layer
  */
 @NullMarked
+@OrasModel
 public final class Layer extends Descriptor {
 
     /**

src/main/java/land/oras/LayoutRef.java

@@ -30,6 +30,7 @@
  * A referer of a container on a {@link OCILayout}.
  */
 @NullMarked
+@OrasModel
 public final class LayoutRef extends Ref<LayoutRef> {
 
     private final Path folder;