You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by an...@apache.org on 2015/08/24 10:13:47 UTC
[38/50] jena git commit: Add execConstructDadset(Dataset)
Add execConstructDadset(Dataset)
Project: http://git-wip-us.apache.org/repos/asf/jena/repo
Commit: http://git-wip-us.apache.org/repos/asf/jena/commit/62bc52f8
Tree: http://git-wip-us.apache.org/repos/asf/jena/tree/62bc52f8
Diff: http://git-wip-us.apache.org/repos/asf/jena/diff/62bc52f8
Branch: refs/heads/master
Commit: 62bc52f87acd77156d18e42a541d00074c8178e3
Parents: fe19b4b
Author: Andy Seaborne <an...@apache.org>
Authored: Thu Aug 20 11:28:13 2015 +0100
Committer: Andy Seaborne <an...@apache.org>
Committed: Thu Aug 20 11:28:13 2015 +0100
----------------------------------------------------------------------
.../org/apache/jena/query/QueryExecution.java | 20 +++++++++++++++++---
1 file changed, 17 insertions(+), 3 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/jena/blob/62bc52f8/jena-arq/src/main/java/org/apache/jena/query/QueryExecution.java
----------------------------------------------------------------------
diff --git a/jena-arq/src/main/java/org/apache/jena/query/QueryExecution.java b/jena-arq/src/main/java/org/apache/jena/query/QueryExecution.java
index 2707675..5322ddd 100644
--- a/jena-arq/src/main/java/org/apache/jena/query/QueryExecution.java
+++ b/jena-arq/src/main/java/org/apache/jena/query/QueryExecution.java
@@ -102,15 +102,29 @@ public interface QueryExecution extends AutoCloseable
public Iterator<Triple> execConstructTriples();
/**
- * Similar to execConstructTriples(), except that constructing {@link Quad}.
+ * Execute a CONSTRUCT query, returning the results as an iterator of {@link Quad}.
+ * <p>
+ * <b>Caution:</b> This method may return duplicate Quads. This method may be useful if you only
+ * need the results for stream processing, as it can avoid having to place the results in a Model.
+ * </p>
+ * @return An iterator of Quad objects (possibly containing duplicates) generated
+ * by applying the CONSTRUCT template of the query to the bindings in the WHERE clause.
+ * </p>
+ * <p>
+ * See {@link #execConstructTriples} for usage and features.
*/
public Iterator<Quad> execConstructQuads();
- /**
- * Similar to execConstructTriples(), except that constructing {@link Dataset}.
+ /** Execute a CONSTRUCT query, putting the statements into 'dataset'.
+ * This maybe an exetended synatx query (if supported).
*/
public Dataset execConstructDataset();
+ /** Execute a CONSTRUCT query, putting the statements into 'dataset'.
+ * This maybe an exetended synatx query (if supported).
+ */
+ public Dataset execConstructDataset(Dataset dataset);
+
/** Execute a DESCRIBE query */
public Model execDescribe();