Repository: incubator-commonsrdf Updated Branches: refs/heads/parser-with-quads cbfb670b6 -> bfcead4f8
target(Consumer<Quad>) includes all triples Project: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/commit/72016682 Tree: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/tree/72016682 Diff: http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/diff/72016682 Branch: refs/heads/parser-with-quads Commit: 72016682262ca1e696bf8af78e27dc54f759544a Parents: cbfb670 Author: Stian Soiland-Reyes <st...@apache.org> Authored: Tue Sep 13 00:07:49 2016 +0100 Committer: Stian Soiland-Reyes <st...@apache.org> Committed: Tue Sep 13 00:09:52 2016 +0100 ---------------------------------------------------------------------- .../commons/rdf/api/RDFParserBuilder.java | 21 +++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-commonsrdf/blob/72016682/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 0494502..dde92ac 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 @@ -21,6 +21,7 @@ import java.io.IOException; import java.io.InputStream; import java.nio.charset.StandardCharsets; import java.nio.file.Path; +import java.util.Optional; import java.util.concurrent.Future; import java.util.function.Consumer; @@ -43,7 +44,7 @@ import java.util.function.Consumer; * parsing. * <p> * Setting a method that has already been set will override any existing value - * in the returned builder - irregardless of the parameter type (e.g. + * in the returned builder - regardless of the parameter type (e.g. * {@link #source(IRI)} will override a previous {@link #source(Path)}. Settings * can be unset by passing <code>null</code> - note that this may * require casting, e.g. <code>contentType( (RDFSyntax) null )</code> @@ -220,6 +221,13 @@ public interface RDFParserBuilder { /** * Specify a consumer for parsed quads. * <p> + * The quads will include triples in all named graphs of the parsed + * source, including any triples in the default graph. + * When parsing a source format which do not support datasets, all quads + * delivered to the consumer will be in the default graph + * (e.g. their {@link Quad#getGraphName()} will be + * as {@link Optional#empty()}), while for a source + * <p> * It is undefined if any quads are consumed if {@link #parse()} throws any * exceptions. On the other hand, if {@link #parse()} does not indicate an * exception, the implementation SHOULD have produced all parsed quads to @@ -243,7 +251,6 @@ public interface RDFParserBuilder { * A {@link Consumer} of {@link Quad}s * @return An {@link RDFParserBuilder} that will call the consumer for into * the specified dataset. - * @return */ RDFParserBuilder target(Consumer<Quad> consumer); @@ -355,7 +362,7 @@ public interface RDFParserBuilder { * <p> * The source set will not be read before the call to {@link #parse()}. * <p> - * If this builder does not support the given IRI (e.g. + * If this builder does not support the given IRI protocol (e.g. * <code>urn:uuid:ce667463-c5ab-4c23-9b64-701d055c4890</code>), this method * should succeed, while the {@link #parse()} should throw an * {@link IOException}. @@ -425,9 +432,9 @@ public interface RDFParserBuilder { * method) MUST have been called before calling this method, otherwise an * {@link IllegalStateException} will be thrown. * <p> - * A target method (e.g. {@link #target(Consumer)}, {@link #target(Dataset)} - * , {@link #target(Graph)} or an equivalent subclass method) MUST have been - * called before calling this method, otherwise an + * A target method (e.g. {@link #target(Consumer)}, {@link #target(Dataset)}, + * {@link #target(Graph)} or an equivalent subclass method) MUST have been + * called before calling parse(), otherwise an * {@link IllegalStateException} will be thrown. * <p> * It is undefined if this method is thread-safe, however the @@ -449,7 +456,7 @@ public interface RDFParserBuilder { * parsing succeeded. * <p> * If an exception occurs during parsing, (e.g. {@link IOException} or - * {@link org.apache.commons.rdf.simple.AbstractRDFParserBuilder.RDFParseException}), + * {@link org.apache.commons.rdf.simple.RDFParseException}), * it should be indicated as the * {@link java.util.concurrent.ExecutionException#getCause()} in the * {@link java.util.concurrent.ExecutionException} thrown on
