Use InternalRDF4JFactory for constructing

and reduce visibiliy of  *Impl to package protected


Project: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/repo
Commit: 
http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/commit/f9c298a9
Tree: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/tree/f9c298a9
Diff: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/diff/f9c298a9

Branch: refs/heads/rdf4j
Commit: f9c298a9656de2a23f569285e578d7f78095becb
Parents: cbb5ca5
Author: Stian Soiland-Reyes <[email protected]>
Authored: Tue Oct 4 01:40:22 2016 +0100
Committer: Stian Soiland-Reyes <[email protected]>
Committed: Tue Oct 4 01:40:22 2016 +0100

----------------------------------------------------------------------
 .../apache/commons/rdf/rdf4j/RDF4JGraph.java    |   4 -
 .../commons/rdf/rdf4j/RDF4JTermFactory.java     |  75 +++-----
 .../rdf4j/impl/AbstractRepositoryGraphLike.java |   8 +-
 .../commons/rdf/rdf4j/impl/BlankNodeImpl.java   |   4 +-
 .../apache/commons/rdf/rdf4j/impl/IRIImpl.java  |   4 +-
 .../rdf/rdf4j/impl/InternalRDF4JFactory.java    | 178 +++++++++++++++++++
 .../commons/rdf/rdf4j/impl/LiteralImpl.java     |   4 +-
 .../commons/rdf/rdf4j/impl/ModelGraphImpl.java  |   9 +-
 .../apache/commons/rdf/rdf4j/impl/QuadImpl.java |   7 +-
 .../rdf/rdf4j/impl/RepositoryDatasetImpl.java   |  28 ++-
 .../rdf/rdf4j/impl/RepositoryGraphImpl.java     |  34 ++--
 .../commons/rdf/rdf4j/impl/TripleImpl.java      |   5 +-
 12 files changed, 248 insertions(+), 112 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JGraph.java
----------------------------------------------------------------------
diff --git a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JGraph.java 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JGraph.java
index e0b7a29..93886a4 100644
--- a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JGraph.java
+++ b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JGraph.java
@@ -25,8 +25,6 @@ import org.apache.commons.rdf.api.Graph;
 import org.apache.commons.rdf.api.IRI;
 import org.apache.commons.rdf.api.RDFTerm;
 import org.apache.commons.rdf.api.Triple;
-import org.apache.commons.rdf.rdf4j.impl.ModelGraphImpl;
-import org.apache.commons.rdf.rdf4j.impl.RepositoryGraphImpl;
 import org.eclipse.rdf4j.model.Model;
 import org.eclipse.rdf4j.model.Resource;
 import org.eclipse.rdf4j.repository.Repository;
@@ -41,8 +39,6 @@ import org.eclipse.rdf4j.repository.Repository;
  * @see RDF4JTermFactory#asRDFTermGraphUnion(Repository)
  * @see RDF4JDataset#getGraph()
  * @see RDF4JDataset#getGraph(BlankNodeOrIRI)
- * @see ModelGraphImpl
- * @see RepositoryGraphImpl
  */
 public interface RDF4JGraph extends Graph, RDF4JGraphLike<Triple> {
        

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java
----------------------------------------------------------------------
diff --git 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java
index 1b4f1bd..7869cbf 100644
--- a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java
+++ b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/RDF4JTermFactory.java
@@ -23,25 +23,17 @@ import java.util.UUID;
 
 // To avoid confusion, avoid importing
 // classes that are in both
-// commons.rdf and openrdf.model (e.g. IRI)
+// commons.rdf and openrdf.model (e.g. IRI, Literal)
 import org.apache.commons.rdf.api.BlankNode;
 import org.apache.commons.rdf.api.BlankNodeOrIRI;
 import org.apache.commons.rdf.api.Dataset;
 import org.apache.commons.rdf.api.Graph;
-import org.apache.commons.rdf.api.IRI;
 import org.apache.commons.rdf.api.Quad;
 import org.apache.commons.rdf.api.RDFTerm;
 import org.apache.commons.rdf.api.RDFTermFactory;
 import org.apache.commons.rdf.api.Triple;
 import org.apache.commons.rdf.api.TripleLike;
-import org.apache.commons.rdf.rdf4j.impl.BlankNodeImpl;
-import org.apache.commons.rdf.rdf4j.impl.IRIImpl;
-import org.apache.commons.rdf.rdf4j.impl.LiteralImpl;
-import org.apache.commons.rdf.rdf4j.impl.ModelGraphImpl;
-import org.apache.commons.rdf.rdf4j.impl.QuadImpl;
-import org.apache.commons.rdf.rdf4j.impl.RepositoryDatasetImpl;
-import org.apache.commons.rdf.rdf4j.impl.RepositoryGraphImpl;
-import org.apache.commons.rdf.rdf4j.impl.TripleImpl;
+import org.apache.commons.rdf.rdf4j.impl.InternalRDF4JFactory;
 import org.eclipse.rdf4j.model.BNode;
 import org.eclipse.rdf4j.model.Model;
 import org.eclipse.rdf4j.model.Resource;
@@ -101,7 +93,12 @@ import org.eclipse.rdf4j.sail.memory.MemoryStore;
  * therefore uses a unique {@link RDF4JTermFactory} internally.
  *
  */
-public class RDF4JTermFactory implements RDFTermFactory {
+public final class RDF4JTermFactory implements RDFTermFactory {
+       
+       /**
+        * InternalRDF4JFactory is deliberately abstract
+        */
+       private static InternalRDF4JFactory rdf4j = new 
InternalRDF4JFactory(){};
 
        /**
         * Adapt a RDF4J {@link Value} as a Commons RDF {@link RDFTerm}.
@@ -131,13 +128,13 @@ public class RDF4JTermFactory implements RDFTermFactory {
        @SuppressWarnings("unchecked")
        public static <T extends Value> RDF4JTerm<T> asRDFTerm(final T value, 
UUID salt) {
                if (value instanceof BNode) {
-                       return (RDF4JTerm<T>) new BlankNodeImpl((BNode) value, 
salt);
+                       return (RDF4JTerm<T>) rdf4j.createBlankNodeImpl((BNode) 
value, salt);
                }
                if (value instanceof org.eclipse.rdf4j.model.Literal) {
-                       return (RDF4JTerm<T>) new 
LiteralImpl((org.eclipse.rdf4j.model.Literal) value);
+                       return (RDF4JTerm<T>) 
rdf4j.createLiteralImpl((org.eclipse.rdf4j.model.Literal) value);
                }
                if (value instanceof org.eclipse.rdf4j.model.IRI) {
-                       return (RDF4JTerm<T>) new 
IRIImpl((org.eclipse.rdf4j.model.IRI) value);
+                       return (RDF4JTerm<T>) 
rdf4j.createIRIImpl((org.eclipse.rdf4j.model.IRI) value);
                }
                throw new IllegalArgumentException("Value is not a BNode, 
Literal or IRI: " + value.getClass());
        }
@@ -153,12 +150,17 @@ public class RDF4JTermFactory implements RDFTermFactory {
        public RDF4JTermFactory(ValueFactory valueFactory) {
                this(valueFactory, UUID.randomUUID());
        }
+       
+       public RDF4JTermFactory(UUID salt) {
+               this(SimpleValueFactory.getInstance(), salt);
+       }
 
        public RDF4JTermFactory(ValueFactory valueFactory, UUID salt) {
                this.valueFactory = valueFactory;
                this.salt = salt;
        }
        
+
        /**
         * Adapt a RDF4J {@link Statement} as a Commons RDF {@link Quad}.
         * <p>
@@ -180,28 +182,9 @@ public class RDF4JTermFactory implements RDFTermFactory {
         * @return A {@link RDF4JQuad} that is equivalent to the statement
         */
        public RDF4JQuad asQuad(final Statement statement) {
-               return new QuadImpl(statement, salt);
-       }
-
-       /**
-        * Adapt a RDF4J {@link Statement} as a Commons RDF {@link Quad}.
-        *
-        * @see #asQuad(Statement)
-        * @param statement
-        *            The statement to convert
-        * @param salt
-        *            A {@link UUID} salt to use for uniquely mapping any
-        *            {@link BNode}s. The salt should typically be the same for
-        *            multiple statements in the same {@link Repository} or
-        *            {@link Model} to ensure {@link BlankNode#equals(Object)} 
and
-        *            {@link BlankNode#uniqueReference()} works as intended.
-        * @return A {@link RDF4JQuad} that is equivalent to the statement
-        */
-       public static RDF4JQuad asQuad(final Statement statement, UUID salt) {
-               return new QuadImpl(statement, salt);
+               return rdf4j.createQuadImpl(statement, salt);
        }
 
-
        /**
         *
         * Adapt a RDF4J {@link Value} as a Commons RDF {@link RDFTerm}.
@@ -246,7 +229,7 @@ public class RDF4JTermFactory implements RDFTermFactory {
         * @return A {@link Dataset} backed by the RDF4J repository.
         */
        public RDF4JDataset asRDFTermDataset(Repository repository) {
-               return new RepositoryDatasetImpl(repository, false, false);
+               return rdf4j.createRepositoryDatasetImpl(repository, false, 
false);
        }
 
        /**
@@ -261,7 +244,7 @@ public class RDF4JTermFactory implements RDFTermFactory {
         * @return A {@link Dataset} backed by the RDF4J repository.
         */
        public RDF4JDataset asRDFTermDataset(Repository repository, boolean 
includeInferred) {
-               return new RepositoryDatasetImpl(repository, false, 
includeInferred);
+               return rdf4j.createRepositoryDatasetImpl(repository, false, 
includeInferred);
        }
 
        /**
@@ -274,7 +257,7 @@ public class RDF4JTermFactory implements RDFTermFactory {
         * @return Adapted {@link Graph}.
         */
        public RDF4JGraph asRDFTermGraph(Model model) {
-               return new ModelGraphImpl(model);
+               return rdf4j.createModelGraphImpl(model, this);
        }
 
        /**
@@ -290,7 +273,7 @@ public class RDF4JTermFactory implements RDFTermFactory {
         * @return A {@link Graph} backed by the RDF4J repository.
         */
        public RDF4JGraph asRDFTermGraph(Repository repository) {
-               return new RepositoryGraphImpl(repository, false, false);
+               return rdf4j.createRepositoryGraphImpl(repository, false, 
false);
        }
 
        /**
@@ -307,7 +290,7 @@ public class RDF4JTermFactory implements RDFTermFactory {
         * @return A union {@link Graph} backed by the RDF4J repository.
         */
        public RDF4JGraph asRDFTermGraphUnion(Repository repository) {
-               return new RepositoryGraphImpl(repository, false, true);
+               return rdf4j.createRepositoryGraphImpl(repository, false, true);
        }
        
        /**
@@ -333,7 +316,7 @@ public class RDF4JTermFactory implements RDFTermFactory {
                /** NOTE: asValue() deliberately CAN handle <code>null</code> */
                Resource[] resources = contexts.stream()
                                .map(g -> (Resource) 
asValue(g)).toArray(Resource[]::new);
-               return new 
RepositoryGraphImpl(Objects.requireNonNull(repository), 
+               return 
rdf4j.createRepositoryGraphImpl(Objects.requireNonNull(repository), 
                                false, true, resources);                
        }
        
@@ -348,14 +331,10 @@ public class RDF4JTermFactory implements RDFTermFactory {
         *            RDF4J {@link Repository} to connect to.
         * @param includeInferred
         *            If true, any inferred triples are included in the graph
-        * @param unionGraph
-        *            If true, triples from any context is included in the 
graph,
-        *            otherwise only triples in the default context
-        *            <code>null</code>.
         * @return A {@link Graph} backed by the RDF4J repository.
         */
-       public RDF4JGraph asRDFTermGraph(Repository repository, boolean 
includeInferred, boolean unionGraph) {
-               return new RepositoryGraphImpl(repository, includeInferred, 
unionGraph);
+       public RDF4JGraph asRDFTermGraph(Repository repository, boolean 
includeInferred) {
+               return rdf4j.createRepositoryGraphImpl(repository, false, 
includeInferred);
        }
 
        /**
@@ -413,7 +392,7 @@ public class RDF4JTermFactory implements RDFTermFactory {
         * @return A {@link RDF4JTriple} that is equivalent to the statement
         */
        public RDF4JTriple asTriple(final Statement statement) {
-               return new TripleImpl(statement, salt);
+               return rdf4j.createTripleImpl(statement, salt);
        }
 
        /**
@@ -535,7 +514,7 @@ public class RDF4JTermFactory implements RDFTermFactory {
        }
 
        @Override
-       public Quad createQuad(BlankNodeOrIRI graphName, BlankNodeOrIRI 
subject, IRI predicate, RDFTerm object)
+       public Quad createQuad(BlankNodeOrIRI graphName, BlankNodeOrIRI 
subject, org.apache.commons.rdf.api.IRI predicate, RDFTerm object)
                        throws IllegalArgumentException, 
UnsupportedOperationException {
                final Statement statement = getValueFactory().createStatement(
                                (org.eclipse.rdf4j.model.Resource) 
asValue(subject),

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/AbstractRepositoryGraphLike.java
----------------------------------------------------------------------
diff --git 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/AbstractRepositoryGraphLike.java
 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/AbstractRepositoryGraphLike.java
index 4ae7d5b..a0c577f 100644
--- 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/AbstractRepositoryGraphLike.java
+++ 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/AbstractRepositoryGraphLike.java
@@ -30,7 +30,7 @@ import org.eclipse.rdf4j.model.Statement;
 import org.eclipse.rdf4j.repository.Repository;
 import org.eclipse.rdf4j.repository.RepositoryConnection;
 
-public abstract class AbstractRepositoryGraphLike<T extends 
TripleLike<BlankNodeOrIRI, IRI, RDFTerm>>
+abstract class AbstractRepositoryGraphLike<T extends 
TripleLike<BlankNodeOrIRI, IRI, RDFTerm>>
                implements RDF4JGraphLike<T> {
 
        protected final Repository repository;
@@ -38,11 +38,7 @@ public abstract class AbstractRepositoryGraphLike<T extends 
TripleLike<BlankNode
        protected final boolean handleInitAndShutdown;
        protected final RDF4JTermFactory rdf4jTermFactory;
 
-       public AbstractRepositoryGraphLike(Repository repository) {
-               this(repository, true, false);
-       }
-
-       public AbstractRepositoryGraphLike(Repository repository, boolean 
handleInitAndShutdown, boolean includeInferred) {
+       AbstractRepositoryGraphLike(Repository repository, boolean 
handleInitAndShutdown, boolean includeInferred) {
                this.repository = repository;
                this.includeInferred = includeInferred;
                this.handleInitAndShutdown = handleInitAndShutdown;

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/BlankNodeImpl.java
----------------------------------------------------------------------
diff --git 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/BlankNodeImpl.java 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/BlankNodeImpl.java
index 625088a..bdb82d1 100644
--- a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/BlankNodeImpl.java
+++ b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/BlankNodeImpl.java
@@ -25,14 +25,14 @@ import org.apache.commons.rdf.rdf4j.RDF4JBlankNode;
 import org.eclipse.rdf4j.model.BNode;
 import org.eclipse.rdf4j.rio.turtle.TurtleUtil;
 
-public final class BlankNodeImpl extends AbstractRDFTerm<BNode>
+final class BlankNodeImpl extends AbstractRDFTerm<BNode>
        implements RDF4JBlankNode {
        
        private transient int hashCode = 0;
        private long saltUUIDleast;
        private long saltUUIDmost;
        
-       public BlankNodeImpl(BNode bNode, UUID salt) {
+       BlankNodeImpl(BNode bNode, UUID salt) {
                super(bNode);                   
                // Space-efficient storage of salt UUID
                saltUUIDmost = salt.getMostSignificantBits();

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/IRIImpl.java
----------------------------------------------------------------------
diff --git a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/IRIImpl.java 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/IRIImpl.java
index 9ae6741..e88ac27 100644
--- a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/IRIImpl.java
+++ b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/IRIImpl.java
@@ -19,10 +19,10 @@ package org.apache.commons.rdf.rdf4j.impl;
 
 import org.apache.commons.rdf.rdf4j.RDF4JIRI;
 
-public final class IRIImpl extends 
AbstractRDFTerm<org.eclipse.rdf4j.model.IRI> 
+final class IRIImpl extends AbstractRDFTerm<org.eclipse.rdf4j.model.IRI> 
        implements RDF4JIRI {
 
-       public IRIImpl(org.eclipse.rdf4j.model.IRI iri) {
+       IRIImpl(org.eclipse.rdf4j.model.IRI iri) {
                super(iri);                     
        }
        @Override

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/InternalRDF4JFactory.java
----------------------------------------------------------------------
diff --git 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/InternalRDF4JFactory.java
 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/InternalRDF4JFactory.java
new file mode 100644
index 0000000..2616226
--- /dev/null
+++ 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/InternalRDF4JFactory.java
@@ -0,0 +1,178 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.rdf.rdf4j.impl;
+
+import java.util.UUID;
+
+import org.apache.commons.rdf.api.BlankNode;
+import org.apache.commons.rdf.rdf4j.RDF4JBlankNode;
+import org.apache.commons.rdf.rdf4j.RDF4JDataset;
+import org.apache.commons.rdf.rdf4j.RDF4JGraph;
+import org.apache.commons.rdf.rdf4j.RDF4JIRI;
+import org.apache.commons.rdf.rdf4j.RDF4JLiteral;
+import org.apache.commons.rdf.rdf4j.RDF4JQuad;
+import org.apache.commons.rdf.rdf4j.RDF4JTerm;
+import org.apache.commons.rdf.rdf4j.RDF4JTermFactory;
+import org.apache.commons.rdf.rdf4j.RDF4JTriple;
+import org.eclipse.rdf4j.model.BNode;
+import org.eclipse.rdf4j.model.IRI;
+import org.eclipse.rdf4j.model.Literal;
+import org.eclipse.rdf4j.model.Model;
+import org.eclipse.rdf4j.model.Resource;
+import org.eclipse.rdf4j.model.Statement;
+import org.eclipse.rdf4j.repository.Repository;
+
+/**
+ * Factory for {@link RDF4JTerm} instances.
+ * <p>
+ * <strong>Internal class:</strong> This "abstract" class is intended for
+ * internal use by Commons RDF and may change in any minor update. Use instead
+ * {@link RDF4JTermFactory} methods like
+ * {@link RDF4JTermFactory#createBlankNode()},
+ * {@link RDF4JTermFactory#asRDFTerm(org.eclipse.rdf4j.model.Value)} and
+ * {@link RDF4JTermFactory#asRDFTermGraph(Repository)}.
+ * <p>
+ * This class exists as a <code>public</code> bridge between the packages
+ * {@link org.apache.commons.rdf.rdf4j} and
+ * {@link org.apache.commons.rdf.rdf4j.impl} by exposing the package-public
+ * constructors.
+ * 
+ * @see RDF4JTermFactory
+ */
+public abstract class InternalRDF4JFactory {
+
+       /**
+        * Construct a {@link RDF4JBlankNode} from a RDF4J {@link BNode}.
+        * 
+        * @param bNode
+        *            RDF4J {@link BNode} to adapt
+        * @param salt
+        *            {@link UUID} to use for {@link 
BlankNode#uniqueReference()} in
+        *            combination with {@link BNode#getID()}
+        * @return Adapted {@link RDF4JBlankNode}
+        */
+       public RDF4JBlankNode createBlankNodeImpl(BNode bNode, UUID salt) {
+               return new BlankNodeImpl(bNode, salt);
+       }
+
+       /**
+        * Construct a {@link RDF4JIRI} from a RDF4J {@link IRI}.
+        * 
+        * @param iri
+        *            RDF4J {@link IRI} to adapt
+        * @return Adapted {@link RDF4JIRI}
+        */
+       public RDF4JIRI createIRIImpl(IRI iri) {
+               return new IRIImpl(iri);
+       }
+
+       /**
+        * Construct a {@link RDF4JLiteral} from a RDF4J {@link Literal}.
+        * 
+        * @param bNode
+        *            RDF4J {@link Literal}
+        * @return Adapted {@link RDF4JLiteral}
+        */
+       public RDF4JLiteral createLiteralImpl(Literal literal) {
+               return new LiteralImpl(literal);
+       }
+
+       /**
+        * Construct a {@link RDF4JGraph} from a RDF4J {@link Model}.
+        * <p>
+        * Changes in the graph will be reflected in the model, and vice versa.
+        * 
+        * @param model
+        *            RDF4J {@link Model} to adapt
+        * @param rdf4jTermFactory
+        *            factory to use for adapting graph triples
+        * @return Adapted {@link RDF4JGraph}
+        */
+       public RDF4JGraph createModelGraphImpl(Model model, RDF4JTermFactory 
rdf4jTermFactory) {
+               return new ModelGraphImpl(model, rdf4jTermFactory);
+       }
+
+       /**
+        * Construct a {@link RDF4JQuad} from a RDF4J {@link Statement}.
+        * 
+        * @param statement
+        *            RDF4J {@link Statement} to adapt
+        * @param uuid
+        *            {@link UUID} for adapting any {@link BNode}s
+        * @return Adapted {@link RDF4JQuad}
+        */
+       public RDF4JQuad createQuadImpl(Statement statement, UUID salt) {
+               return new QuadImpl(statement, salt);
+       }
+
+       /**
+        * Construct a {@link RDF4JDataset} from a RDF4J {@link Repository}.
+        * <p>
+        * Changes in the dataset will be reflected in the repsitory, and vice
+        * versa.
+        * 
+        * @param repository
+        *            RDF4J {@link Repository} to adapt
+        * @param handleInitAndShutdown
+        *            If <code>true</code>, the {@link RDF4JDataset} will 
initialize
+        *            the repository (if needed), and shut it down on
+        *            {@link RDF4JDataset#close()}.
+        * @param includeInferred
+        *            If true, any inferred quads are included in the dataset
+        * 
+        * @return Adapted {@link RDF4JDataset}
+        */
+       public RDF4JDataset createRepositoryDatasetImpl(Repository repository, 
boolean handleInitAndShutdown,
+                       boolean includeInferred) {
+               return new RepositoryDatasetImpl(repository, 
handleInitAndShutdown, includeInferred);
+       }
+
+       /**
+        * Construct a {@link RDF4JGraph} from a RDF4J {@link Model}.
+        * <p>
+        * Changes in the graph will be reflected in the model, and vice versa.
+        * 
+        * @param repository
+        *            RDF4J {@link Repository} to adapt
+        * @param handleInitAndShutdown
+        *            If <code>true</code>, the {@link RDF4JGraph} will 
initialize
+        *            the repository (if needed), and shut it down on
+        *            {@link RDF4JGraph#close()}.
+        * @param includeInferred
+        *            If true, any inferred quads are included in the dataset
+        * @return Adapted {@link RDF4JGraph}
+        */
+       public RDF4JGraph createRepositoryGraphImpl(Repository repository, 
boolean handleInitAndShutdown,
+                       boolean includeInferred, Resource... contextMask) {
+               return new RepositoryGraphImpl(repository, 
handleInitAndShutdown, includeInferred, contextMask);
+       }
+
+       /**
+        * Construct a {@link RDF4JTriple} from a RDF4J {@link Statement}.
+        * 
+        * @param statement
+        *            RDF4J {@link Statement} to adapt
+        * @param uuid
+        *            {@link UUID} for adapting any {@link BNode}s
+        * @return Adapted {@link RDF4JTriple}
+        */
+       public RDF4JTriple createTripleImpl(Statement statement, UUID salt) {
+               return new TripleImpl(statement, salt);
+       }
+
+}

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/LiteralImpl.java
----------------------------------------------------------------------
diff --git 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/LiteralImpl.java 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/LiteralImpl.java
index 0305059..aef298d 100644
--- a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/LiteralImpl.java
+++ b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/LiteralImpl.java
@@ -24,13 +24,13 @@ import org.apache.commons.rdf.rdf4j.RDF4JLiteral;
 import org.eclipse.rdf4j.model.vocabulary.XMLSchema;
 import org.eclipse.rdf4j.rio.turtle.TurtleUtil;
 
-public final class LiteralImpl 
+final class LiteralImpl 
        extends AbstractRDFTerm<org.eclipse.rdf4j.model.Literal>
     implements RDF4JLiteral {          
 
        private static final String QUOTE = "\"";
        
-       public LiteralImpl(org.eclipse.rdf4j.model.Literal literal) {
+       LiteralImpl(org.eclipse.rdf4j.model.Literal literal) {
                super(literal);                 
        }
        @Override

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/ModelGraphImpl.java
----------------------------------------------------------------------
diff --git 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/ModelGraphImpl.java 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/ModelGraphImpl.java
index 994bf81..e207007 100644
--- a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/ModelGraphImpl.java
+++ b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/ModelGraphImpl.java
@@ -33,17 +33,12 @@ import org.eclipse.rdf4j.model.Model;
 import org.eclipse.rdf4j.model.Resource;
 import org.eclipse.rdf4j.repository.Repository;
 
-public final class ModelGraphImpl implements RDF4JGraph {
+final class ModelGraphImpl implements RDF4JGraph {
        
        private Model model;
        private RDF4JTermFactory rdf4jTermFactory;
 
-       public ModelGraphImpl(Model model) {
-               this.model = model;     
-               this.rdf4jTermFactory = new RDF4JTermFactory();
-       }
-
-       public ModelGraphImpl(Model model, RDF4JTermFactory rdf4jTermFactory) {
+       ModelGraphImpl(Model model, RDF4JTermFactory rdf4jTermFactory) {
                this.model = model;     
                this.rdf4jTermFactory = rdf4jTermFactory;
        }

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/QuadImpl.java
----------------------------------------------------------------------
diff --git 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/QuadImpl.java 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/QuadImpl.java
index ce39f61..18a0c84 100644
--- a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/QuadImpl.java
+++ b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/QuadImpl.java
@@ -29,16 +29,17 @@ import org.apache.commons.rdf.rdf4j.RDF4JQuad;
 import org.apache.commons.rdf.rdf4j.RDF4JTermFactory;
 import org.eclipse.rdf4j.model.Statement;
 
-public final class QuadImpl implements Quad, RDF4JQuad {
+final class QuadImpl implements Quad, RDF4JQuad {
                private transient int hashCode = 0;     
                private UUID salt;
                private final Statement statement;
                
-               public QuadImpl(Statement statement, UUID salt) {
+               QuadImpl(Statement statement, UUID salt) {
                        this.statement = statement;
                        this.salt = salt;
                }
        
+               @Override
                public Statement asStatement() { 
                        return statement;
                }
@@ -63,7 +64,7 @@ public final class QuadImpl implements Quad, RDF4JQuad {
                public Optional<BlankNodeOrIRI> getGraphName() {
                        if (statement.getContext() == null) { 
                                return Optional.empty();
-                       }
+                       }                       
                        BlankNodeOrIRI g = (BlankNodeOrIRI) 
RDF4JTermFactory.asRDFTerm(statement.getContext(), salt);
                        return Optional.of(g);
                }

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/RepositoryDatasetImpl.java
----------------------------------------------------------------------
diff --git 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/RepositoryDatasetImpl.java
 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/RepositoryDatasetImpl.java
index 04d685c..936dae8 100644
--- 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/RepositoryDatasetImpl.java
+++ 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/RepositoryDatasetImpl.java
@@ -36,17 +36,12 @@ import org.eclipse.rdf4j.repository.Repository;
 import org.eclipse.rdf4j.repository.RepositoryConnection;
 import org.eclipse.rdf4j.repository.RepositoryResult;
 
-public class RepositoryDatasetImpl extends AbstractRepositoryGraphLike<Quad> 
implements RDF4JDataset, Dataset {
+class RepositoryDatasetImpl extends AbstractRepositoryGraphLike<Quad> 
implements RDF4JDataset, Dataset {
 
-       public RepositoryDatasetImpl(Repository repository, boolean 
handleInitAndShutdown, boolean includeInferred) {
+       RepositoryDatasetImpl(Repository repository, boolean 
handleInitAndShutdown, boolean includeInferred) {
                super(repository, handleInitAndShutdown, includeInferred);
        }
 
-       public RepositoryDatasetImpl(Repository repository) {
-               this(repository, false, false);
-       }
-
-
        @Override
        public void add(Quad tripleLike) {
                Statement statement = rdf4jTermFactory.asStatement(tripleLike);
@@ -155,10 +150,11 @@ public class RepositoryDatasetImpl extends 
AbstractRepositoryGraphLike<Quad> imp
                Value obj = rdf4jTermFactory.asValue(object);
                Resource[] contexts = asContexts(graphName);
 
-               RepositoryConnection conn = getRepositoryConnection();
-               // NOTE: connection will be closed outside by the 
Iterations.stream()
-               RepositoryResult<Statement> statements = 
conn.getStatements(subj, pred, obj, includeInferred, contexts);
-               return Iterations.stream(statements).map(this::asTripleLike);
+               try (RepositoryConnection conn = getRepositoryConnection()) {
+                       RepositoryResult<Statement> statements = 
conn.getStatements(subj, pred, obj, includeInferred, contexts);
+                       // NOTE: RepositoryResult will be closed outside by the 
Iterations.stream()
+                       return 
Iterations.stream(statements).map(this::asTripleLike);
+               }
        }
 
        @Override
@@ -181,10 +177,12 @@ public class RepositoryDatasetImpl extends 
AbstractRepositoryGraphLike<Quad> imp
 
        @Override
        public Stream<BlankNodeOrIRI> getGraphNames() {
-               RepositoryConnection conn = getRepositoryConnection();
-               RepositoryResult<Resource> contexts = conn.getContextIDs();
-               // NOTE: connection will be closed outside by the 
Iterations.stream()
-               return Iterations.stream(contexts).map(g -> (BlankNodeOrIRI) 
rdf4jTermFactory.asRDFTerm(g));
+               // FIXME: Will the below close the connection before the stream 
has been consumed outside? 
+               try (RepositoryConnection conn = getRepositoryConnection()) {
+                       RepositoryResult<Resource> contexts = 
conn.getContextIDs();
+                       // NOTE: connection will be closed outside by the 
Iterations.stream()
+                       return Iterations.stream(contexts).map(g -> 
(BlankNodeOrIRI) rdf4jTermFactory.asRDFTerm(g));
+               }
        }
 
 }

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/RepositoryGraphImpl.java
----------------------------------------------------------------------
diff --git 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/RepositoryGraphImpl.java
 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/RepositoryGraphImpl.java
index 4c09110..5238cca 100644
--- 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/RepositoryGraphImpl.java
+++ 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/RepositoryGraphImpl.java
@@ -39,22 +39,11 @@ import org.eclipse.rdf4j.repository.Repository;
 import org.eclipse.rdf4j.repository.RepositoryConnection;
 import org.eclipse.rdf4j.repository.RepositoryResult;
 
-public class RepositoryGraphImpl extends AbstractRepositoryGraphLike<Triple> 
implements Graph, RDF4JGraph {
+class RepositoryGraphImpl extends AbstractRepositoryGraphLike<Triple> 
implements Graph, RDF4JGraph {
 
        private final Resource[] contextMask;
 
-       public RepositoryGraphImpl(Repository repository, boolean 
handleInitAndShutdown, boolean includeInferred, boolean unionGraph) {
-               super(repository, handleInitAndShutdown, includeInferred);
-               if (unionGraph) {
-                       // no context mask, aka any context
-                       this.contextMask = new Resource[] { };
-               } else {
-                       // default context: null
-                       this.contextMask = new Resource[] { null };
-               }
-       }
-
-       public RepositoryGraphImpl(Repository repository, boolean 
handleInitAndShutdown, boolean includeInferred, Resource... contextMask) {
+       RepositoryGraphImpl(Repository repository, boolean 
handleInitAndShutdown, boolean includeInferred, Resource... contextMask) {
                super(repository, handleInitAndShutdown, includeInferred);
                this.contextMask = Objects.requireNonNull(contextMask);
        }
@@ -97,15 +86,18 @@ public class RepositoryGraphImpl extends 
AbstractRepositoryGraphLike<Triple> imp
 
        @Override
        public long size() {
-               try (RepositoryConnection conn = getRepositoryConnection()) {
-                       if (! includeInferred && contextMask.length == 0) { 
+               if (!includeInferred && contextMask.length == 0) {
+                       try (RepositoryConnection conn = 
getRepositoryConnection()) {
                                return conn.size();
-                       } else {
-                               return stream().count();
+                       }
+               } else {
+                       try (Stream<RDF4JTriple> stream = stream()) {
+                               long s = stream.count();
+                               stream.close();
+                               return s;
                        }
                }
        }
-
        
        @Override
        public void add(BlankNodeOrIRI subject, IRI predicate, RDFTerm object) {
@@ -150,9 +142,9 @@ public class RepositoryGraphImpl extends 
AbstractRepositoryGraphLike<Triple> imp
                org.eclipse.rdf4j.model.IRI pred = 
(org.eclipse.rdf4j.model.IRI) rdf4jTermFactory.asValue(predicate);
                Value obj = rdf4jTermFactory.asValue(object);
                RepositoryConnection conn = getRepositoryConnection();
-               // FIXME: Is it OK that we don't close the connection?
-               RepositoryResult<Statement> statements = 
conn.getStatements(subj, pred, obj, includeInferred, contextMask);
-               return Iterations.stream(statements).map(this::asTripleLike);
+                       RepositoryResult<Statement> statements = 
conn.getStatements(subj, pred, obj, includeInferred, contextMask);
+                       // NOTE: Iterations.stream should close 
RepositoryResult as long as our caller closes the stream
+                       return 
Iterations.stream(statements).map(this::asTripleLike);
        }
        
        @Override

http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/f9c298a9/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/TripleImpl.java
----------------------------------------------------------------------
diff --git 
a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/TripleImpl.java 
b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/TripleImpl.java
index bddd7f3..e1dcb60 100644
--- a/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/TripleImpl.java
+++ b/rdf4j/src/main/java/org/apache/commons/rdf/rdf4j/impl/TripleImpl.java
@@ -27,15 +27,16 @@ import org.apache.commons.rdf.rdf4j.RDF4JTermFactory;
 import org.apache.commons.rdf.rdf4j.RDF4JTriple;
 import org.eclipse.rdf4j.model.Statement;
 
-public final class TripleImpl implements Triple, RDF4JTriple {
+final class TripleImpl implements Triple, RDF4JTriple {
                private UUID salt;      
                private final Statement statement;
                
-               public TripleImpl(Statement statement, UUID salt) {
+               TripleImpl(Statement statement, UUID salt) {
                        this.statement = statement;
                        this.salt = salt;
                }
        
+               @Override
                public Statement asStatement() { 
                        return statement;
                }

Reply via email to