Feature/152 n triples n quads serializer

src/main/java/fr/inria/corese/core/next/api/FormatSerializer.java

@@ -0,0 +1,22 @@
+package fr.inria.corese.core.next.api;
+
+import java.io.Writer;
+
+import fr.inria.corese.core.next.impl.exception.SerializationException;
+
+public interface FormatSerializer {
+
+    /**
+     * A serializer that converts a {@link Model} instance
+     * into a specific output format and writes it to a character stream.
+     *
+     * Implementations may follow standard RDF serialization formats
+     * (e.g., Turtle, N-Triples, JSON-LD), or define custom formats.
+     *
+     * @param writer the destination {@link Writer} for the serialized
+     *               output
+     * @throws SerializationException if an error occurs during the serialization
+     *                                process
+     */
+    void write(Writer writer) throws SerializationException;
+}

src/main/java/fr/inria/corese/core/next/api/Resource.java

@@ -1,7 +1,8 @@
 package fr.inria.corese.core.next.api;
 
 /**
- * Super interface of all resources of an RDF graph (statements, IRI, blank nodes) as defined for RDF 1.2.
+ * Super interface of all resources of an RDF graph (statements, IRI, blank
+ * nodes) as defined for RDF 1.2.
  */
 public interface Resource extends Value {
 

src/main/java/fr/inria/corese/core/next/impl/common/serialization/FileFormat.java

@@ -0,0 +1,103 @@
+package fr.inria.corese.core.next.impl.common.serialization;
+
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * Represents a general file format, including its name, associated file
+ * extensions, and MIME types.
+ */
+public class FileFormat {
+
+    private final String name;
+    private final List<String> extensions;
+    private final List<String> mimeTypes;
+
+    /**
+     * Constructs a new FileFormat instance.
+     *
+     * @param name       The human-readable name of the format.
+     * @param extensions The list of file extensions.
+     * @param mimeTypes  The list of MIME types.
+     * @throws NullPointerException if name, extensions or mimeTypes is null or
+     *                              empty.
+     */
+    public FileFormat(String name, List<String> extensions, List<String> mimeTypes) {
+        this.name = Objects.requireNonNull(name, "Format name cannot be null");
+        this.extensions = List.copyOf(Objects.requireNonNull(extensions, "Extensions list cannot be null"));
+        this.mimeTypes = List.copyOf(Objects.requireNonNull(mimeTypes, "MIME types list cannot be null"));
+
+        if (extensions.isEmpty()) {
+            throw new IllegalArgumentException("At least one file extension must be provided");
+        }
+        if (mimeTypes.isEmpty()) {
+            throw new IllegalArgumentException("At least one MIME type must be provided");
+        }
+    }
+
+    /**
+     * Returns the name of the format.
+     *
+     * @return The format name.
+     */
+    public String getName() {
+        return name;
+    }
+
+    /**
+     * Returns the list of known file extensions.
+     *
+     * @return A list of extensions.
+     */
+    public List<String> getExtensions() {
+        return extensions;
+    }
+
+    /**
+     * Returns the list of associated MIME types.
+     *
+     * @return A list of MIME types.
+     */
+    public List<String> getMimeTypes() {
+        return mimeTypes;
+    }
+
+    /**
+     * Returns the default (primary) file extension.
+     *
+     * @return The first extension in the list.
+     */
+    public String getDefaultExtension() {
+        return extensions.get(0);
+    }
+
+    /**
+     * Returns the default (primary) MIME type.
+     *
+     * @return The first MIME type in the list.
+     */
+    public String getDefaultMimeType() {
+        return mimeTypes.get(0);
+    }
+
+    @Override
+    public String toString() {
+        return "FileFormat{name='%s', extensions=%s, mimeTypes=%s}".formatted(name, extensions, mimeTypes);
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj)
+            return true;
+        if (!(obj instanceof FileFormat other))
+            return false;
+        return name.equalsIgnoreCase(other.name)
+                && extensions.equals(other.extensions)
+                && mimeTypes.equals(other.mimeTypes);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(name.toLowerCase(), extensions, mimeTypes);
+    }
+}

src/main/java/fr/inria/corese/core/next/impl/common/serialization/FormatConfig.java

@@ -0,0 +1,69 @@
+package fr.inria.corese.core.next.impl.common.serialization;
+
+import java.util.Objects;
+
+/**
+ * Configuration options for the {@link NTriplesFormat} serializer.
+ * Use {@link FormatConfig # Builder} to create instances.
+ */
+public class FormatConfig {
+
+    private final String blankNodePrefix;
+
+
+    /**
+     * Private constructor to enforce usage of the Builder.
+     *
+     * @param builder The builder instance.
+     */
+    private FormatConfig(Builder builder) {
+        this.blankNodePrefix = builder.blankNodePrefix;
+
+    }
+
+    /**
+     * Returns the prefix to use for blank nodes.
+     *
+     * @return The blank node prefix.
+     */
+    public String getBlankNodePrefix() {
+        return blankNodePrefix;
+    }
+
+    /**
+     * Builder class for {@link FormatConfig}.
+     */
+    public static class Builder {
+
+        private String blankNodePrefix = "_:";
+
+        /**
+         * Default constructor for the Builder.
+         * Initializes fields with default values.
+         */
+        Builder() {
+
+        }
+
+        /**
+         * Sets the prefix to use for blank nodes. Default is "_:".
+         *
+         * @param blankNodePrefix The desired blank node prefix.
+         * @return The builder instance.
+         */
+        public Builder blankNodePrefix(String blankNodePrefix) {
+            this.blankNodePrefix = Objects.requireNonNull(blankNodePrefix, "Blank node prefix cannot be null");
+            return this;
+        }
+
+
+        /**
+         * Builds a new {@link FormatConfig} instance.
+         *
+         * @return A new NFormatConfig instance.
+         */
+        public FormatConfig build() {
+            return new FormatConfig(this);
+        }
+    }
+}