commonsrdf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From st...@apache.org
Subject [1/5] incubator-commonsrdf git commit: BlankNode RDFTermFactory warning
Date Sun, 03 Apr 2016 02:12:15 GMT
Repository: incubator-commonsrdf
Updated Branches:
  refs/heads/parser-writer-interface 528af9976 -> 13a6b07d8


BlankNode RDFTermFactory warning


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

Branch: refs/heads/parser-writer-interface
Commit: b1597ff7bac433f23a78b0eacbf5a5b5e7ffb089
Parents: 528af99
Author: Stian Soiland-Reyes <stain@apache.org>
Authored: Sun Apr 3 02:47:31 2016 +0100
Committer: Stian Soiland-Reyes <stain@apache.org>
Committed: Sun Apr 3 02:47:31 2016 +0100

----------------------------------------------------------------------
 .../apache/commons/rdf/api/RDFParserBuilder.java  | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/b1597ff7/api/src/main/java/org/apache/commons/rdf/api/RDFParserBuilder.java
----------------------------------------------------------------------
diff --git a/api/src/main/java/org/apache/commons/rdf/api/RDFParserBuilder.java b/api/src/main/java/org/apache/commons/rdf/api/RDFParserBuilder.java
index 6d2d1d0..03dcc48 100644
--- a/api/src/main/java/org/apache/commons/rdf/api/RDFParserBuilder.java
+++ b/api/src/main/java/org/apache/commons/rdf/api/RDFParserBuilder.java
@@ -55,6 +55,12 @@ public interface RDFParserBuilder {
 	 * <p>
 	 * This option may be used together with {@link #intoGraph(Graph)} to
 	 * override the implementation's default factory and graph.
+	 * <p>
+	 * <strong>Warning:</strong> Using the same {@link RDFTermFactory} for 
+	 * multiple {@link #parse()} calls  may accidentally merge 
+	 * {@link BlankNode}s having the same label, as the parser may 
+	 * use the {@link RDFTermFactory#createBlankNode(String)} method
+	 * from the parsed blank node labels.
 	 * 
 	 * @see #intoGraph(Graph)
 	 * @param rdfTermFactory
@@ -323,13 +329,13 @@ public interface RDFParserBuilder {
 	 * call and return a Future that is already {@link Future#isDone()}.
 	 * <p>
 	 * If {@link #intoGraph(Graph)} has been specified, this SHOULD be the same
-	 * {@link Graph} instance returned from {@link Future#get() once parsing has
+	 * {@link Graph} instance returned from {@link Future#get()} once parsing has
 	 * completed successfully.
 	 * <p>
 	 * If an exception occurs during parsing, (e.g. {@link IOException} or
-	 * {@link java.text.ParseException}, it should be indicated as the
-	 * {@link java.util.concurrent.ExecutionException#getCause()) in the
-	 * {@link java.util.concurrent.ExecutionException) thrown on
+	 * {@link java.text.ParseException}), it should be indicated as the
+	 * {@link java.util.concurrent.ExecutionException#getCause()} in the
+	 * {@link java.util.concurrent.ExecutionException} thrown on
 	 * {@link Future#get()}.
 	 * 
 	 * @return A Future that will return the populated {@link Graph} when the
@@ -338,8 +344,8 @@ public interface RDFParserBuilder {
 	 *             If an error occurred while starting to read the source (e.g.
 	 *             file not found, unsupported IRI protocol). Note that IO
 	 *             errors during parsing would instead be the
-	 *             {@link java.util.concurrent.ExecutionException#getCause()) of
-	 *             the {@link java.util.concurrent.ExecutionException) thrown on
+	 *             {@link java.util.concurrent.ExecutionException#getCause()} of
+	 *             the {@link java.util.concurrent.ExecutionException} thrown on
 	 *             {@link Future#get()}.
 	 * @throws IllegalStateException
 	 *             If the builder is in an invalid state, e.g. a


Mime
View raw message