This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/jena-site.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new 4723519 Staged site from more-doc
(6b7028018921a92202ca916ecdace25f124afbc0)
4723519 is described below
commit 4723519c9d29635c136683eadfb84937b27a801a
Author: jenkins <[email protected]>
AuthorDate: Mon Nov 15 19:53:21 2021 +0000
Staged site from more-doc (6b7028018921a92202ca916ecdace25f124afbc0)
---
content/documentation/index.xml | 10 ++++----
content/documentation/io/rdf-input.html | 27 +++++++++----------
content/documentation/io/rdf-output.html | 6 ++---
content/documentation/query/algebra.html | 4 +--
content/documentation/query/arq-query-eval.html | 14 +++++-----
content/documentation/query/construct-quad.html | 3 ++-
content/documentation/query/custom_aggregates.html | 3 ++-
content/documentation/query/programmatic.html | 8 ++----
content/documentation/query/update.html | 3 ++-
content/documentation/rdfconnection/index.html | 6 ++---
content/documentation/shacl/index.html | 2 +-
content/documentation/shex/index.html | 2 +-
content/documentation/sparql-apis/http-auth.html | 4 ++-
content/documentation/sparql-apis/index.html | 2 +-
content/documentation/tdb/quadfilter.html | 26 ++++++++-----------
content/index.xml | 10 ++++----
content/sitemap.xml | 30 +++++++++++-----------
17 files changed, 79 insertions(+), 81 deletions(-)
diff --git a/content/documentation/index.xml b/content/documentation/index.xml
index d3a1227..2b0c32c 100644
--- a/content/documentation/index.xml
+++ b/content/documentation/index.xml
@@ -252,8 +252,8 @@ SERVICE is a feature of SPARQL 1.1 that allows an executing
query to make a SPAR
<guid>https://jena.apache.org/documentation/query/programmatic.html</guid>
<description>It is possible to build queries by building and abstract
syntax tree (as the parser does) or by building the algebra expression for the
query. It is usually better to work with the algebra form as it is more regular.
-See the examples in the ARQ src-examples/ directory of the ARQ distribution,
particularly arq.examples.AlgebraExec.
- src-examples at gitbox.apache.org src-examples at github.com See also ARQ -
SPARQL Algebra
+See the examples such as arq.examples.algrebra.AlgebraExec at
jena-examples:arq/examples
+See also ARQ - SPARQL Algebra
ARQ documentation index</description>
</item>
@@ -295,7 +295,7 @@ In order to eliminate this limitation, Jena ARQ extends the
grammar of the CONST
<guid>https://jena.apache.org/documentation/query/custom_aggregates.html</guid>
<description>ARQ supports custom aggregate functions as allowed by the
SPARQL 1.1 specification.
-See example code.</description>
+See jena-examples:arq/examples/aggregates.</description>
</item>
<item>
@@ -435,7 +435,7 @@ Expressions are enclosed in () and can be optionally named
using AS. If no name
<guid>https://jena.apache.org/documentation/query/update.html</guid>
<description>SPARQL Update is a W3C standard for an RDF update language
with SPARQL syntax. It is described in &ldquo;SPARQL 1.1 Update&quot;.
A SPARQL Update request is composed of a number of update operations, so in a
single request graphs can be created, loaded with RDF data and modified.
-Some examples of ARQ&rsquo;s SPARQL Update support are to be found in the
download in src-examples/arq/examples/update.
+Some examples of ARQ&rsquo;s SPARQL Update support are to be found in the
download in jena-examples:arq/examples/update.
The main API classes are:
UpdateRequest - A list of Update to be performed.</description>
</item>
@@ -1753,7 +1753,7 @@ For the preferred statistics strategy, the TDB optimizer
uses information captur
<guid>https://jena.apache.org/documentation/tdb/quadfilter.html</guid>
<description>This page describes how to filter quads at the lowest level
of TDB. It can be used to hide certain quads (triples in named graphs) or
triples.
-The code for the example on this page can be found in the TDB download:
src-examples/tdb.examples/ExQuadFilter.java Filtering quads should be used with
care. The performance of the tuple filter callback is critical.
+The code for the example on this page can be found in the TDB examples
Filtering quads should be used with care. The performance of the tuple filter
callback is critical.
See also Dynamic Datasets to select only certain specified named graphs for a
query.</description>
</item>
diff --git a/content/documentation/io/rdf-input.html
b/content/documentation/io/rdf-input.html
index 9cb50bc..42efcec 100644
--- a/content/documentation/io/rdf-input.html
+++ b/content/documentation/io/rdf-input.html
@@ -445,30 +445,31 @@ contain ‘:'.</p>
configuration file is necessary.</p>
<p>The base URI for reading models will be the original URI, not the
alternative location.</p>
<h2 id="advanced-examples">Advanced examples</h2>
-<p>Example code may be found in <a
href="https://github.com/apache/jena/tree/main/jena-arq/src-examples/arq/examples/riot/";>jena-arq/src-examples</a>.</p>
+<p>Example code may be found in <a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/arq/examples/riot/";>jena-examples:arq/examples</a>.</p>
<h3 id="iterating-over-parser-output">Iterating over parser output</h3>
<p>One of the capabilities of the RIOT API is the ability to treat parser
output as an iterator,
this is useful when you don’t want to go to the trouble of writing a
full sink implementation and can easily express your
logic in normal iterator style.</p>
-<p>To do this you use one of the subclasses of
-<a
href="https://github.com/apache/jena/tree/main/jena-arq/src/main/java/org/apache/jena/riot/lang/PipedRDFIterator.java?view=markup";>PipedRDFIterator</a>
-in conjunction with a <a
href="https://github.com/apache/jena/tree/main/jena-arq/src/main/java/org/apache/jena/riot/lang/PipedRDFStream.java?view=markup";>PipedRDFStream</a>.</p>
-<p>This <code>PipedRDFStream</code> provides an implementation of
<code>StreamRDF</code> which allows it to consume parser output and this is
consumed by
-the <code>PipedRDFIterator</code> implementation. This has some advantages
over a direct <code>StreamRDF</code> implementation since it allows the parser
-production of data to run ahead of your consumption of data which may result
in better overall throughput.</p>
-<p>The only complication is that you need to ensure that the thread feeding
the <code>PipedRDFStream</code> and the consumer of the iterator are on
different threads
-as otherwise you can run into a deadlock situation where one is waiting on
data from the other which is never started.</p>
-<p>See <a
href="https://github.com/apache/jena/blob/main/jena-arq/src-examples/arq/examples/riot/ExRIOT6_AddNewReader.java";>RIOT
example 6</a>
-which shows an example usage including a simple way to push the parser onto a
different thread to avoid the possible deadlock.</p>
+<p>To do this you use <code>AsyncParser.asyncParseTriples</code> which parses
the input on
+another thread:</p>
+<pre><code> Iterator<Triple> iter =
AsyncParser.asyncParseTriples(filename);
+ iter.forEachRemaining(triple->{
+ // Do something with triple
+ });
+</code></pre>
+<p>For N-Triples and N-Quads, you can use
+<code>RiotParsers.createIteratorNTriples(input)</code> which parses the input
on the
+calling thread.</p>
+<p><a
href="https://github.com/apache/jena/blob/main/jena-examples/src/main/java/arq/examples/arq/examples/riot/ExRIOT9_AsyncParser.java";>RIOT
example 9</a>.</p>
<h3 id="filter-the-output-of-parsing">Filter the output of parsing</h3>
<p>When working with very large files, it can be useful to
process the stream of triples or quads produced
by the parser so as to work in a streaming fashion.</p>
-<p>See <a
href="https://github.com/apache/jena/blob/main/jena-arq/src-examples/arq/examples/riot/ExRIOT4_StreamRDF_Filter.java";>RIOT
example 4</a></p>
+<p>See <a
href="https://github.com/apache/jena/blob/main/jena-examples/src/main/java/arq/examples/arq/examples/riot/ExRIOT4_StreamRDF_Filter.java";>RIOT
example 4</a></p>
<h3 id="add-a-new-language">Add a new language</h3>
<p>The set of languages is not fixed. A new language,
together with a parser, can be added to RIOT as shown in
-<a
href="https://github.com/apache/jena/tree/main/jena-arq/src-examples/arq/examples/riot/ExRIOT5_StreamRDFCollect.java";>RIOT
example 5</a></p>
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/arq/examples/riot/ExRIOT5_StreamRDFCollect.java";>RIOT
example 5</a></p>
</div>
diff --git a/content/documentation/io/rdf-output.html
b/content/documentation/io/rdf-output.html
index d2980cd..a05cb91 100644
--- a/content/documentation/io/rdf-output.html
+++ b/content/documentation/io/rdf-output.html
@@ -674,7 +674,7 @@ by using one of the following RDFFormats:</p>
pass the “frame” in the <code>JSONLD_FRAME_PRETTY</code> and
<code>JSONLD_FRAME_FLAT</code>
cases.</p>
<p>What can be done, and how it can be, is explained in the
-<a
href="https://github.com/apache/jena/tree/main/jena-arq/src-examples/arq/examples/riot/Ex_WriteJsonLD.java";>sample
code</a>.</p>
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/arq/examples/riot/Ex_WriteJsonLD.java";>sample
code</a>.</p>
<h3 id="rdf-binary">RDF Binary</h3>
<p><a href="rdf-binary.html">This is a binary encoding</a> using
<a href="https://thrift.apache.org/";>Apache Thrift</a> or
@@ -732,7 +732,7 @@ while the jena writer name defaults to a streaming plain
output.</p>
</tbody>
</table>
<h2 id="examples">Examples</h2>
-<p>Example code may be found in <a
href="https://github.com/apache/jena/tree/main/jena-arq/src-examples/arq/examples/riot/";>jena-arq/src-examples</a>.</p>
+<p>Example code may be found in <a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/arq/examples/riot/";>jena-examples:arq/examples</a>.</p>
<h3 id="ways-to-write-a-model">Ways to write a model</h3>
<p>The follow ways are different ways to write a model in Turtle:</p>
<pre><code> Model model = ... ;
@@ -778,7 +778,7 @@ RDFDataMgr.write(System.out, m, Lang.TRIG) ;
</code></pre>
<h3 id="adding-a-new-output-format">Adding a new output format</h3>
<p>A complete example of adding a new output format is given in the example
file:
-<a
href="https://github.com/apache/jena/blob/main/jena-arq/src-examples/arq/examples/riot/ExRIOT7_AddNewWriter.java";>RIOT
Output example 7</a>.</p>
+<a
href="https://github.com/apache/jena/blob/main/jena-examples/src/main/java/arq/examples/arq/examples/riot/ExRIOT7_AddNewWriter.java";>RIOT
Output example 7</a>.</p>
<h2 id="notes">Notes</h2>
<p>Using <code>OutputStream</code>s is strongly encouraged. This allows the
writers
to manage the character encoding using UTF-8. Using
<code>java.io.Writer</code>
diff --git a/content/documentation/query/algebra.html
b/content/documentation/query/algebra.html
index f4c0903..89c909a 100644
--- a/content/documentation/query/algebra.html
+++ b/content/documentation/query/algebra.html
@@ -245,11 +245,11 @@ output stream (it manages the conversion to UTF-8) and
ARQ own
SSE is simply passing the calls to the writer operation from the
<code>org.apache.jena.sparql.sse.writer</code> package.</p>
<h2 id="creating-an-algebra-expression-programmatically">Creating an algebra
expression programmatically</h2>
-<p>See the example in <code>src-examples/arq.examples.AlgebraExec</code>.</p>
+<p>See the example in
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/algebra/AlgebraExec.java";>AlgebraExec</a>.</p>
<p>To produce the complete javadoc for ARQ, download an ARQ
distribution and run the ant task ‘javadoc-all’.</p>
<h2 id="evaluating-a-algebra-expression">Evaluating a algebra expression</h2>
-<p>See the example in <code>src-examples/arq.examples.AlgebraExec</code>.</p>
<pre><code>QueryIterator qIter = Algebra.exec(op,graph) ;
QueryIterator qIter = Algebra.exec(op,datasetGraph) ;
diff --git a/content/documentation/query/arq-query-eval.html
b/content/documentation/query/arq-query-eval.html
index cc691f4..db8afd9 100644
--- a/content/documentation/query/arq-query-eval.html
+++ b/content/documentation/query/arq-query-eval.html
@@ -202,8 +202,8 @@ For higher SPARQL performance, ARQ can be extended at the
<a href="#opexecutor">algebra level</a>.</p>
<p>Applications writers who extend ARQ at the query execution level
should be prepared to work with the source code for ARQ for
-specific details and for finding code to reuse. Some example can be
-found in the <code>src-examples</code> directory in the ARQ download.</p>
+specific details and for finding code to reuse. Some examples can be
+found <a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/";>arq/examples
directory</a></p>
<ul>
<li><a href="#overview-of-arq-query-processing">Overview of ARQ Query
processing</a></li>
<li><a href="#the-main-query-engine">The Main Query Engine</a></li>
@@ -373,8 +373,8 @@ no further engine factories are checked.</p>
called to return a <code>Plan</code> object for the execution. The main
operation of the <code>Plan</code> interface is to get the
<code>QueryIterator</code> for
the query.</p>
-<p>See the example in
-<code>src-examples/arq.examples.engine.MyQueryEngine</code>.</p>
+<p>See the example <code>arq.examples.engine.MyQueryEngine</code> at
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/";>jena-examples:arq/examples</a>.</p>
<h2 id="the-main-query-engine">The Main Query Engine</h2>
<p>The main query engine can execute any query. It contains a number
of basic graph pattern matching implementations including one that
@@ -486,7 +486,8 @@ has a convenience operation to do this):</p>
// Register it
StageBuilder.setGenerator(ARQ.getContext(), myStageGenerator) ;
</code></pre>
-<p>Example: <code>src-examples/arq.examples.bgpmatching</code>.</p>
+<p>Example:
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/bgpmatching/";>jena-examples:arq/examples/bgpmatching</a></p>
<h2 id="opexecutor">OpExecutor</h2>
<p>A <code>StageGenerator</code> provides matching for a basic graph pattern.
If
an extension wishes to take responsibility for more of the
@@ -589,7 +590,8 @@ normal algorithm or a custom <code>OpExecutor</code> or a
custom Stage
Generator or a combination of all three extension mechanism.</p>
<p>Only a small, skeleton custom query engine is needed to intercept
the initial setup. See the example in
-<code>src-examples/arq.examples.engine.MyQueryEngine</code>.</p>
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/";>jena-examples:arq/examples</a>
+<code>arq.examples.engine.MyQueryEngine</code>.</p>
<p>While it is possible to replace the entire process of query
evaluation, this is a substantial endeavour. <code>QueryExecutionBase</code>
provides the machinery for result presentation (<code>SELECT</code>,
diff --git a/content/documentation/query/construct-quad.html
b/content/documentation/query/construct-quad.html
index c46edae..5474b45 100644
--- a/content/documentation/query/construct-quad.html
+++ b/content/documentation/query/construct-quad.html
@@ -290,7 +290,8 @@ on the default graph. For instance:</p>
// The part of "GRAPH ?g1 { ?s1 ?p1 ?o1 }" will be ignored. Only
"?s ?p ?o" in the default graph will be returned.
Iterator<Triple> triples = qexec.execConstructTriples();
</code></pre>
-<p>More examples can be found at <code>ExampleConstructQuads.java</code> under
<code>jena-arq/src-examples</code></p>
+<p>More examples can be found at <code>ExampleConstructQuads.java</code> at
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/constructquads/";>jena-examples:arq/examples/constructquads/</a>.</p>
<h2 id="fuseki-support">Fuseki Support</h2>
<p>Jena <a href="/documentation/fuseki2/index.html">Fuseki</a> is also
empowered with Construct Quad query as a built-in
function. No more additional configuration is required to switch it on.
diff --git a/content/documentation/query/custom_aggregates.html
b/content/documentation/query/custom_aggregates.html
index 2476220..886e4aa 100644
--- a/content/documentation/query/custom_aggregates.html
+++ b/content/documentation/query/custom_aggregates.html
@@ -177,7 +177,8 @@
<h1 class="title">ARQ - Custom aggregates</h1>
<p>ARQ supports custom aggregate functions as allowed by the SPARQL 1.1
specification.</p>
-<p>See <a
href="https://github.com/apache/jena/tree/main/jena-arq/src-examples/arq/examples/aggregates";>example
code</a>.</p>
+<p>See
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/aggregates/";>jena-examples:arq/examples/aggregates</a>.</p>
</div>
diff --git a/content/documentation/query/programmatic.html
b/content/documentation/query/programmatic.html
index 56e87c2..e103805 100644
--- a/content/documentation/query/programmatic.html
+++ b/content/documentation/query/programmatic.html
@@ -180,12 +180,8 @@
tree (as the parser does) or by building the algebra expression for
the query. It is usually better to work with the algebra form as
it is more regular.</p>
-<p>See the examples in the ARQ <code>src-examples/</code> directory of the ARQ
-distribution, particularly <code>arq.examples.AlgebraExec</code>.</p>
-<ul>
-<li><a
href="https://gitbox.apache.org/repos/asf?p=jena.git;a=tree;f=jena-arq/src-examples/arq/examples";>src-examples
at gitbox.apache.org</a></li>
-<li><a
href="https://github.com/apache/jena/tree/main/jena-arq/src-examples/arq/examples";>src-examples
at github.com</a></li>
-</ul>
+<p>See the examples such as <code>arq.examples.algrebra.AlgebraExec</code> at
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/";>jena-examples:arq/examples</a></p>
<p>See also <a href="algebra.html">ARQ - SPARQL Algebra</a></p>
<p><a href="index.html">ARQ documentation index</a></p>
diff --git a/content/documentation/query/update.html
b/content/documentation/query/update.html
index c48a319..2c045f4 100644
--- a/content/documentation/query/update.html
+++ b/content/documentation/query/update.html
@@ -183,7 +183,8 @@ SPARQL syntax. It is described in
operations, so in a single request graphs can be created, loaded
with RDF data and modified.</p>
<p>Some examples of ARQ’s SPARQL Update support are to be found in the
-download in src-examples/arq/examples/update.</p>
+download in
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/update";>jena-examples:arq/examples/update</a>.</p>
<p>The main API classes are:</p>
<ul>
<li>UpdateRequest - A list of Update to be performed.</li>
diff --git a/content/documentation/rdfconnection/index.html
b/content/documentation/rdfconnection/index.html
index fcb2986..5592c46 100644
--- a/content/documentation/rdfconnection/index.html
+++ b/content/documentation/rdfconnection/index.html
@@ -266,9 +266,9 @@ builder to construct <code>RDFConnectionRemote</code>s.</p>
.destination("http://host/triplestore");
</code></pre>
<p>which uses default settings used by
<code>RDFConenctionFactory.connect</code>.</p>
-<p>See <a
href="https://github.com/apache/jena/blob/main/jena-rdfconnection/src/main/java/org/apache/jena/rdfconnection/examples/RDFConnectionExample4.java";>example
+<p>See <a
href="https://github.com/apache/jena/blob/main/jena-examples/src/main/java/rdfconnection/examples/RDFConnectionExample4.java";>example
4</a>
-and <a
href="https://github.com/apache/jena/blob/main/jena-rdfconnection/src/main/java/org/apache/jena/rdfconnection/examples/RDFConnectionExample5.java";>example
+and <a
href="https://github.com/apache/jena/blob/main/jena-examples/src/main/java/rdfconnection/examples/RDFConnectionExample5.java";>example
5</a>.</p>
<p>There are many options, including setting HTTP headers for content types
(<a href="/documentation/javadoc/rdfconnection/index.html">javadoc</a>)
@@ -282,7 +282,7 @@ default general settings work but it is possible to have a
specialised connectio
</code></pre>
<p>which uses settings tuned to Fuseki, including round-trip handling of
blank nodes.</p>
-<p>See <a
href="https://github.com/apache/jena/blob/main/jena-rdfconnection/src/main/java/org/apache/jena/rdfconnection/examples/RDFConnectionExample6.java";>example
+<p>See <a
href="https://github.com/apache/jena/blob/main/jena-examples/src/main/java/rdfconnection/examples/RDFConnectionExample6.java";>example
6</a>.</p>
<h2 id="graph-store-protocol">Graph Store Protocol</h2>
<p>The <a href="https://www.w3.org/TR/sparql11-http-rdf-update/";>SPARQL Graph
diff --git a/content/documentation/shacl/index.html
b/content/documentation/shacl/index.html
index 92dc755..a51dc05 100644
--- a/content/documentation/shacl/index.html
+++ b/content/documentation/shacl/index.html
@@ -236,7 +236,7 @@ all named graphs in the dataset.</p>
<li><code>GraphValidation</code> for updating graphs with validation</li>
</ul>
<h2 id="api-examples">API Examples</h2>
-<p><a
href="https://github.com/apache/jena/tree/main/jena-shacl/src/main/java/org/apache/jena/shacl/examples";>https://github.com/apache/jena/tree/main/jena-shacl/src/main/java/org/apache/jena/shacl/examples</a></p>
+<p><a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/shacl/examples/";>https://github.com/apache/jena/tree/main/jena-examples/src/main/java/shacl/examples/</a></p>
<p>Example
<a
href="https://github.com/apache/jena/tree/main/jena-shacl/src/main/java/org/apache/jena/shacl/examples/Shacl01_validateGraph.java";><code>Shacl01_validateGraph</code></a>
shows validation and printing of the validation report in a text form and in
RDF:</p>
diff --git a/content/documentation/shex/index.html
b/content/documentation/shex/index.html
index 758a82a..971b156 100644
--- a/content/documentation/shex/index.html
+++ b/content/documentation/shex/index.html
@@ -210,7 +210,7 @@ can be given, separated by "," and format `all` outputs all
3 formats.
</ul>
<h2 id="api-examples">API Examples</h2>
<p>Examples:</p>
-<p><a
href="https://github.com/apache/jena/tree/main/jena-shex/src/main/java/org/apache/jena/shex/examples/";>https://github.com/apache/jena/tree/main/jena-shex/src/main/java/org/apache/jena/shex/examples/</a></p>
+<p><a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/shex/examples/";>https://github.com/apache/jena/tree/main/jena-examples/src/main/java/shex/examples/</a></p>
<pre><code> public static void main(String ...args) {
String SHAPES = "examples/schema.shex";
String SHAPES_MAP = "examples/shape-map.shexmap";
diff --git a/content/documentation/sparql-apis/http-auth.html
b/content/documentation/sparql-apis/http-auth.html
index 9e982a3..0fe84a7 100644
--- a/content/documentation/sparql-apis/http-auth.html
+++ b/content/documentation/sparql-apis/http-auth.html
@@ -273,7 +273,9 @@ used.</p>
ResultSet rs <span style="color:#666">=</span> qExec<span
style="color:#666">.</span><span style="color:#b44">execSelect</span><span
style="color:#666">();</span>
ResultSetFormatter<span style="color:#666">.</span><span
style="color:#b44">out</span><span style="color:#666">(</span>rs<span
style="color:#666">);</span>
<span style="color:#666">}</span>
-</code></pre></div>
+</code></pre></div><h2 id="examples">Examples</h2>
+<p><a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/auth";>jena-examples:arq/examples/auth/</a>.</p>
+
</div>
</div>
diff --git a/content/documentation/sparql-apis/index.html
b/content/documentation/sparql-apis/index.html
index 7f6a91d..64103cc 100644
--- a/content/documentation/sparql-apis/index.html
+++ b/content/documentation/sparql-apis/index.html
@@ -334,7 +334,7 @@ for both local and remote cases.</p>
that is correct syntax. This means is does not apply to <code>INSERT
DATA</code> or <code>DELETE DATA</code> but can be used with <code>INSERT { ?s
?p ?o } WHERE {}</code> and
<code>DELETE { ?s ?p ?o } WHERE {}</code>.</p>
<p>Full example:
-<a
href="https://github.com/afs/jena/tree/main/jena-arq/src-examples/arq/examples/ExQuerySubstitute_01.java";>ExQuerySubstitute_01.java</a>.</p>
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/arq/examples/ExQuerySubstitute_01.java";>ExQuerySubstitute_01.java</a>.</p>
<pre><code> ResultSet resultSet1 = QueryExecution.dataset(dataset)
.query(prefixes+"SELECT * { ?person foaf:name ?name }")
.substitution("name", name1)
diff --git a/content/documentation/tdb/quadfilter.html
b/content/documentation/tdb/quadfilter.html
index 47f5479..6b57aab 100644
--- a/content/documentation/tdb/quadfilter.html
+++ b/content/documentation/tdb/quadfilter.html
@@ -179,8 +179,9 @@
<p>This page describes how to filter quads at the lowest level of TDB.
It can be used to hide certain quads (triples in named graphs) or
triples.</p>
-<p>The code for the example on this page can be found in the TDB
-download: <code>src-examples/tdb.examples/ExQuadFilter.java</code> Filtering
+<p>The code for the example on this page can be found in the
+<a
href="https://github.com/apache/jena/tree/main/jena-examples/src/main/java/tdb";>TDB
examples</a>
+Filtering
quads should be used with care. The performance of the tuple filter
callback is critical.</p>
<p>See also
@@ -193,18 +194,12 @@ accept or reject the quad or triple. This happens during
basic
graph pattern processing.</p>
<p>A rejected quad is simply not processed further in the basic graph
pattern and it is as if it is not in the dataset.</p>
-<p>The filter has a signature of:</p>
-<pre><code> // org.apache.jena.atlas.iterator.Filter
- interface Filter<T>
- {
- public boolean accept(T item) ;
- }
-</code></pre>
-<p>with a type parameter of <code>Tuple<NodeId></code>.
<code>NodeId</code> is the low level
+<p>The filter has a signature of:
<code>java.util.function.Predicate<Tuple<NodeId>></code>
+with a type parameter of <code>Tuple<NodeId></code>. <code>NodeId</code>
is the low level
internal identifier TDB uses for RDF terms. <code>Tuple</code> is a class for
an immutable tuples of values of the same type.</p>
<pre><code> /** Create a filter to exclude the graph http://example/g2 */
- private static Filter<Tuple<NodeId>> createFilter(Dataset ds)
+ private static Predicate<Tuple<NodeId>> createFilter(Dataset ds)
{
DatasetGraphTransaction dst =
(DatasetGraphTransaction)(ds.asDatasetGraph()) ;
DatasetGraphTDB dsg = dst.getBaseDatasetGraph();
@@ -215,8 +210,7 @@ an immutable tuples of values of the same type.</p>
final NodeId target =
nodeTable.getNodeIdForNode(Node.createURI("http://example/g2")) ;
// Filter for accept/reject as quad as being visible.
- Filter<Tuple<NodeId>> filter = new
Filter<Tuple<NodeId>>() {
- public boolean accept(Tuple<NodeId> item)
+ Predicate<Tuple<NodeId>> filter = item ->
{
// Quads are 4-tuples, triples are 3-tuples.
if ( item.size() == 4 && item.get(0).equals(target) )
@@ -224,19 +218,19 @@ an immutable tuples of values of the same type.</p>
return false ;
// Accept
return true ;
- } } ;
+ } ;
return filter ;
}
</code></pre>
<p>To install a filter, put it in the context of a query execution
under the symbol <code>SystemTDB.symTupleFilter</code> then execute the query
as normal.</p>
<pre><code> Dataset ds = ... ;
- Filter<Tuple<NodeId>> filter = createFilter(ds) ;
+ Predicate<Tuple<NodeId>> filter = createFilter(ds) ;
Query query = ... ;
try (QueryExecution qExec = QueryExecution.dataset(ds)
.query(query)
.set(SystemTDB.symTupleFilter, filter)
- .build() ) {}
+ .build() ) {
ResultSet rs = qExec.execSelect() ;
...
}
diff --git a/content/index.xml b/content/index.xml
index 0c2b2c3..3bed1e4 100644
--- a/content/index.xml
+++ b/content/index.xml
@@ -295,8 +295,8 @@ SERVICE is a feature of SPARQL 1.1 that allows an executing
query to make a SPAR
<guid>https://jena.apache.org/documentation/query/programmatic.html</guid>
<description>It is possible to build queries by building and abstract
syntax tree (as the parser does) or by building the algebra expression for the
query. It is usually better to work with the algebra form as it is more regular.
-See the examples in the ARQ src-examples/ directory of the ARQ distribution,
particularly arq.examples.AlgebraExec.
- src-examples at gitbox.apache.org src-examples at github.com See also ARQ -
SPARQL Algebra
+See the examples such as arq.examples.algrebra.AlgebraExec at
jena-examples:arq/examples
+See also ARQ - SPARQL Algebra
ARQ documentation index</description>
</item>
@@ -338,7 +338,7 @@ In order to eliminate this limitation, Jena ARQ extends the
grammar of the CONST
<guid>https://jena.apache.org/documentation/query/custom_aggregates.html</guid>
<description>ARQ supports custom aggregate functions as allowed by the
SPARQL 1.1 specification.
-See example code.</description>
+See jena-examples:arq/examples/aggregates.</description>
</item>
<item>
@@ -478,7 +478,7 @@ Expressions are enclosed in () and can be optionally named
using AS. If no name
<guid>https://jena.apache.org/documentation/query/update.html</guid>
<description>SPARQL Update is a W3C standard for an RDF update language
with SPARQL syntax. It is described in &ldquo;SPARQL 1.1 Update&quot;.
A SPARQL Update request is composed of a number of update operations, so in a
single request graphs can be created, loaded with RDF data and modified.
-Some examples of ARQ&rsquo;s SPARQL Update support are to be found in the
download in src-examples/arq/examples/update.
+Some examples of ARQ&rsquo;s SPARQL Update support are to be found in the
download in jena-examples:arq/examples/update.
The main API classes are:
UpdateRequest - A list of Update to be performed.</description>
</item>
@@ -2026,7 +2026,7 @@ For the preferred statistics strategy, the TDB optimizer
uses information captur
<guid>https://jena.apache.org/documentation/tdb/quadfilter.html</guid>
<description>This page describes how to filter quads at the lowest level
of TDB. It can be used to hide certain quads (triples in named graphs) or
triples.
-The code for the example on this page can be found in the TDB download:
src-examples/tdb.examples/ExQuadFilter.java Filtering quads should be used with
care. The performance of the tuple filter callback is critical.
+The code for the example on this page can be found in the TDB examples
Filtering quads should be used with care. The performance of the tuple filter
callback is critical.
See also Dynamic Datasets to select only certain specified named graphs for a
query.</description>
</item>
diff --git a/content/sitemap.xml b/content/sitemap.xml
index 2c1d0a0..03a750d 100644
--- a/content/sitemap.xml
+++ b/content/sitemap.xml
@@ -99,17 +99,17 @@
<url>
<loc>https://jena.apache.org/documentation/shacl/</loc>
- <lastmod>2021-09-27T16:55:34+01:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
<loc>https://jena.apache.org/documentation/shex/</loc>
- <lastmod>2021-09-19T09:51:17+01:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
<loc>https://jena.apache.org/documentation/sparql-apis/</loc>
- <lastmod>2021-11-15T17:04:25+00:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
@@ -139,7 +139,7 @@
<url>
<loc>https://jena.apache.org/documentation/query/programmatic.html</loc>
- <lastmod>2021-02-19T15:39:55+13:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
@@ -154,17 +154,17 @@
<url>
<loc>https://jena.apache.org/documentation/query/construct-quad.html</loc>
- <lastmod>2021-11-05T16:04:36+00:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
<loc>https://jena.apache.org/documentation/query/custom_aggregates.html</loc>
- <lastmod>2021-02-19T15:39:55+13:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
<loc>https://jena.apache.org/documentation/query/arq-query-eval.html</loc>
- <lastmod>2021-11-15T17:04:25+00:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
@@ -219,12 +219,12 @@
<url>
<loc>https://jena.apache.org/documentation/query/algebra.html</loc>
- <lastmod>2020-05-01T11:11:56+12:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
<loc>https://jena.apache.org/documentation/query/update.html</loc>
- <lastmod>2020-02-28T13:09:12+01:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
@@ -324,7 +324,7 @@
<url>
<loc>https://jena.apache.org/documentation.html</loc>
- <lastmod>2021-11-15T17:04:25+00:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
@@ -474,7 +474,7 @@
<url>
<loc>https://jena.apache.org/documentation/sparql-apis/http-auth.html</loc>
- <lastmod>2021-11-05T16:04:36+00:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
@@ -664,7 +664,7 @@
<url>
<loc>https://jena.apache.org/documentation/rdfconnection/</loc>
- <lastmod>2021-11-05T16:04:36+00:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
@@ -684,7 +684,7 @@
<url>
<loc>https://jena.apache.org/documentation/io/rdf-input.html</loc>
- <lastmod>2021-09-26T09:54:06+01:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
@@ -964,7 +964,7 @@
<url>
<loc>https://jena.apache.org/documentation/tdb/quadfilter.html</loc>
- <lastmod>2021-11-05T16:04:36+00:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
<url>
@@ -1144,7 +1144,7 @@
<url>
<loc>https://jena.apache.org/documentation/io/rdf-output.html</loc>
- <lastmod>2021-09-26T09:54:06+01:00</lastmod>
+ <lastmod>2021-11-15T19:40:46+00:00</lastmod>
</url>
</urlset>
\ No newline at end of file
