Comments

Author: nk2IsHere

core-java/src/main/java/eu/neverblink/jelly/core/JellyConverterFactory.java

@@ -52,7 +52,7 @@ public final ProtoEncoder<TNode> encoder(ProtoEncoder.Params params) {
      * @return decoder
      */
     public final ProtoDecoder<TNode, TDatatype> triplesDecoder(
-        RdfHandler.TripleStatementHandler<TNode> tripleProtoHandler,
+        RdfHandler.TripleHandler<TNode> tripleProtoHandler,
         RdfStreamOptions supportedOptions
     ) {
         return new ProtoDecoderImpl.TriplesDecoder<>(decoderConverter(), tripleProtoHandler, supportedOptions);
@@ -67,7 +67,7 @@ public final ProtoDecoder<TNode, TDatatype> triplesDecoder(
      * @return decoder
      */
     public final ProtoDecoder<TNode, TDatatype> quadsDecoder(
-        RdfHandler.QuadStatementHandler<TNode> quadProtoHandler,
+        RdfHandler.QuadHandler<TNode> quadProtoHandler,
         RdfStreamOptions supportedOptions
     ) {
         return new ProtoDecoderImpl.QuadsDecoder<>(decoderConverter(), quadProtoHandler, supportedOptions);
@@ -82,7 +82,7 @@ public final ProtoDecoder<TNode, TDatatype> quadsDecoder(
      * @return decoder
      */
     public final ProtoDecoder<TNode, TDatatype> graphsAsQuadsDecoder(
-        RdfHandler.QuadStatementHandler<TNode> graphProtoHandler,
+        RdfHandler.QuadHandler<TNode> graphProtoHandler,
         RdfStreamOptions supportedOptions
     ) {
         return new ProtoDecoderImpl.GraphsAsQuadsDecoder<>(decoderConverter(), graphProtoHandler, supportedOptions);
@@ -97,7 +97,7 @@ public final ProtoDecoder<TNode, TDatatype> graphsAsQuadsDecoder(
      * @return decoder
      */
     public final ProtoDecoder<TNode, TDatatype> graphsDecoder(
-        RdfHandler.GraphStatementHandler<TNode> graphProtoHandler,
+        RdfHandler.GraphHandler<TNode> graphProtoHandler,
         RdfStreamOptions supportedOptions
     ) {
         return new ProtoDecoderImpl.GraphsDecoder<>(decoderConverter(), graphProtoHandler, supportedOptions);
@@ -112,7 +112,7 @@ public final ProtoDecoder<TNode, TDatatype> graphsDecoder(
      * @return decoder
      */
     public final ProtoDecoder<TNode, TDatatype> anyDecoder(
-        RdfHandler.AnyStatementHandler<TNode> anyProtoHandler,
+        RdfHandler.AnyRdfHandler<TNode> anyProtoHandler,
         RdfStreamOptions supportedOptions
     ) {
         return new ProtoDecoderImpl.AnyStatementDecoder<>(decoderConverter(), anyProtoHandler, supportedOptions);

core-java/src/main/java/eu/neverblink/jelly/core/ProtoEncoder.java

@@ -11,7 +11,7 @@
  */
 public abstract class ProtoEncoder<TNode>
     extends ProtoEncoderBase<TNode>
-    implements RowBufferAppender, RdfHandler.AnyStatementHandler<TNode> {
+    implements RowBufferAppender, RdfHandler.AnyRdfHandler<TNode> {
 
     /**
      * Parameters passed to the Jelly encoder.
@@ -46,6 +46,4 @@ protected ProtoEncoder(ProtoEncoderConverter<TNode> converter, Params params) {
         this.enableNamespaceDeclarations = params.enableNamespaceDeclarations;
         this.appendableRowBuffer = params.appendableRowBuffer;
     }
-
-    public abstract void handleNamespace(String prefix, String namespace);
 }

core-java/src/main/java/eu/neverblink/jelly/core/RdfHandler.java

@@ -19,7 +19,7 @@ default void handleNamespace(String prefix, TNode namespace) {
      * Extension of the ProtoHandler interface to handle triples.
      * @param <TNode> The type of the nodes in the RDF data structure, as bound by library.
      */
-    interface TripleStatementHandler<TNode> extends RdfHandler<TNode> {
+    interface TripleHandler<TNode> extends RdfHandler<TNode> {
         /**
          * Handle a triple.
          * @param subject The subject of the triple, as represented by node in the RDF data structure.
@@ -33,7 +33,7 @@ interface TripleStatementHandler<TNode> extends RdfHandler<TNode> {
      * Extension of the ProtoHandler interface to handle quads.
      * @param <TNode> The type of the nodes in the RDF data structure, as bound by library.
      */
-    interface QuadStatementHandler<TNode> extends RdfHandler<TNode> {
+    interface QuadHandler<TNode> extends RdfHandler<TNode> {
         /**
          * Handle a quad.
          * @param subject The subject of the quad, as represented by node in the RDF data structure.
@@ -48,7 +48,7 @@ interface QuadStatementHandler<TNode> extends RdfHandler<TNode> {
      * Extension of the ProtoHandler interface to handle graphs.
      * @param <TNode> The type of the nodes in the RDF data structure, as bound by library.
      */
-    interface GraphStatementHandler<TNode> extends RdfHandler<TNode> {
+    interface GraphHandler<TNode> extends RdfHandler<TNode> {
         /**
          * Handle a graph start.
          * @param graph The graph node, as represented by node in the RDF data structure.
@@ -74,12 +74,12 @@ interface GraphStatementHandler<TNode> extends RdfHandler<TNode> {
      * Extension of the ProtoHandler interface to handle Triples and Quads.
      * @param <TNode> The type of the nodes in the RDF data structure, as bound by library.
      */
-    interface TripleOrQuadStatementHandler<TNode> extends TripleStatementHandler<TNode>, QuadStatementHandler<TNode> {}
+    interface AnyStatementHandler<TNode> extends TripleHandler<TNode>, QuadHandler<TNode> {}
 
     /**
      * Extension of the ProtoHandler interface to handle any RDF data structure.
      * @param <TNode> The type of the nodes in the RDF data structure, as bound by library.
      */
-    interface AnyStatementHandler<TNode>
-        extends TripleStatementHandler<TNode>, QuadStatementHandler<TNode>, GraphStatementHandler<TNode> {}
+    interface AnyRdfHandler<TNode>
+        extends TripleHandler<TNode>, QuadHandler<TNode>, GraphHandler<TNode> {}
 }

core-java/src/main/java/eu/neverblink/jelly/core/RdfProtoDeserializationError.java

@@ -1,5 +1,9 @@
 package eu.neverblink.jelly.core;
 
+/**
+ * This exception is thrown when there is an error during the deserialization of a
+ * protocol buffer message from RDF.
+ */
 public final class RdfProtoDeserializationError extends RuntimeException {
 
     public RdfProtoDeserializationError(String msg) {

core-java/src/main/java/eu/neverblink/jelly/core/RdfProtoSerializationError.java

@@ -1,8 +1,16 @@
 package eu.neverblink.jelly.core;
 
+/**
+ * This exception is thrown when there is an error during the serialization of a
+ * protocol buffer message to RDF.
+ */
 public final class RdfProtoSerializationError extends RuntimeException {
 
     public RdfProtoSerializationError(String msg) {
         super(msg);
     }
+
+    public RdfProtoSerializationError(String msg, Throwable cause) {
+        super(msg, cause);
+    }
 }

core-java/src/main/java/eu/neverblink/jelly/core/RdfProtoTranscodingError.java

@@ -1,8 +1,15 @@
 package eu.neverblink.jelly.core;
 
+/**
+ * Exception thrown when an error occurs during the transcoding of RDF ProtoBuf data.
+ */
 public final class RdfProtoTranscodingError extends RuntimeException {
 
     public RdfProtoTranscodingError(String msg) {
         super(msg);
     }
+
+    public RdfProtoTranscodingError(String msg, Throwable cause) {
+        super(msg, cause);
+    }
 }