org.apache.jena.sparql.modify.UpdateEngineWorker Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jena-arq Show documentation
Show all versions of jena-arq Show documentation
ARQ is a SPARQL 1.1 query engine for Apache Jena
/*
* 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.jena.sparql.modify;
import static org.apache.jena.sparql.modify.TemplateLib.remapDefaultGraph ;
import static org.apache.jena.sparql.modify.TemplateLib.template ;
import java.util.ArrayList ;
import java.util.Collection ;
import java.util.Iterator ;
import java.util.List ;
import org.apache.jena.atlas.data.BagFactory ;
import org.apache.jena.atlas.data.DataBag ;
import org.apache.jena.atlas.data.ThresholdPolicy ;
import org.apache.jena.atlas.data.ThresholdPolicyFactory ;
import org.apache.jena.atlas.iterator.Iter ;
import org.apache.jena.atlas.lib.Pair ;
import org.apache.jena.atlas.lib.Sink ;
import org.apache.jena.atlas.web.TypedInputStream ;
import org.apache.jena.graph.Graph ;
import org.apache.jena.graph.GraphUtil ;
import org.apache.jena.graph.Node ;
import org.apache.jena.graph.Triple ;
import org.apache.jena.query.Query ;
import org.apache.jena.query.QueryExecutionFactory ;
import org.apache.jena.riot.Lang ;
import org.apache.jena.riot.RDFDataMgr ;
import org.apache.jena.riot.RDFLanguages ;
import org.apache.jena.riot.system.SerializationFactoryFinder ;
import org.apache.jena.riot.system.StreamRDF ;
import org.apache.jena.riot.system.StreamRDFLib ;
import org.apache.jena.sparql.ARQInternalErrorException ;
import org.apache.jena.sparql.SystemARQ ;
import org.apache.jena.sparql.core.* ;
import org.apache.jena.sparql.engine.Plan ;
import org.apache.jena.sparql.engine.binding.Binding ;
import org.apache.jena.sparql.engine.binding.BindingRoot ;
import org.apache.jena.sparql.graph.GraphFactory ;
import org.apache.jena.sparql.graph.GraphOps ;
import org.apache.jena.sparql.graph.NodeTransform;
import org.apache.jena.sparql.graph.NodeTransformLib ;
import org.apache.jena.sparql.modify.request.* ;
import org.apache.jena.sparql.syntax.Element ;
import org.apache.jena.sparql.syntax.ElementGroup ;
import org.apache.jena.sparql.syntax.ElementNamedGraph ;
import org.apache.jena.sparql.syntax.ElementTriplesBlock ;
import org.apache.jena.sparql.util.Context ;
import org.apache.jena.update.UpdateException ;
/** Implementation of general purpose update request execution */
public class UpdateEngineWorker implements UpdateVisitor
{
protected final DatasetGraph datasetGraph ;
protected final boolean alwaysSilent = true ;
protected final Binding inputBinding; // Used for UpdateModify only
protected final Context context ;
public UpdateEngineWorker(DatasetGraph datasetGraph, Binding inputBinding, Context context) {
this.datasetGraph = datasetGraph ;
this.inputBinding = inputBinding ;
this.context = context ;
}
@Override
public void visit(UpdateDrop update)
{ execDropClear(update, false) ; }
@Override
public void visit(UpdateClear update)
{ execDropClear(update, true) ; }
protected void execDropClear(UpdateDropClear update, boolean isClear) {
if ( update.isAll() ) {
execDropClear(update, null, true); // Always clear.
execDropClearAllNamed(update, isClear);
} else if ( update.isAllNamed() )
execDropClearAllNamed(update, isClear);
else if ( update.isDefault() )
execDropClear(update, null, true);
else if ( update.isOneGraph() )
execDropClear(update, update.getGraph(), isClear);
else
throw new ARQInternalErrorException("Target is undefined: " + update.getTarget());
}
protected void execDropClear(UpdateDropClear update, Node g, boolean isClear) {
if ( !alwaysSilent ) {
if ( g != null && !datasetGraph.containsGraph(g) && !update.isSilent() )
error("No such graph: " + g);
}
if ( isClear ) {
if ( g == null || datasetGraph.containsGraph(g) )
graph(datasetGraph, g).clear();
} else
datasetGraph.removeGraph(g);
}
protected void execDropClearAllNamed(UpdateDropClear update, boolean isClear) {
// Avoid ConcurrentModificationException
List list = Iter.toList(datasetGraph.listGraphNodes());
for ( Node gn : list )
execDropClear(update, gn, isClear);
}
@Override
public void visit(UpdateCreate update) {
Node g = update.getGraph();
if ( g == null )
return;
if ( datasetGraph.containsGraph(g) ) {
if ( !alwaysSilent && !update.isSilent() )
error("Graph store already contains graph : " + g);
return;
}
// In-memory specific
datasetGraph.addGraph(g, GraphFactory.createDefaultGraph());
}
@Override
public void visit(UpdateLoad update) {
// LOAD SILENT? iri ( INTO GraphRef )?
String source = update.getSource();
Node dest = update.getDest();
try {
// Read into temporary storage to protect against parse errors.
TypedInputStream s = RDFDataMgr.open(source);
Lang lang = RDFDataMgr.determineLang(source, s.getContentType(), null);
if ( RDFLanguages.isTriples(lang) ) {
// Triples
Graph g = GraphFactory.createGraphMem();
StreamRDF stream = StreamRDFLib.graph(g);
RDFDataMgr.parse(stream, s, source);
Graph g2 = graph(datasetGraph, dest);
GraphUtil.addInto(g2, g);
} else {
// Quads
if ( dest != null )
throw new UpdateException("Attempt to load quads into a graph");
DatasetGraph dsg = DatasetGraphFactory.create();
StreamRDF stream = StreamRDFLib.dataset(dsg);
RDFDataMgr.parse(stream, s, source);
Iterator iter = dsg.find();
for ( ; iter.hasNext() ; ) {
Quad q = iter.next();
datasetGraph.add(q);
}
}
}
catch (RuntimeException ex) {
if ( !update.getSilent() ) {
if ( ex instanceof UpdateException )
throw (UpdateException)ex;
throw new UpdateException("Failed to LOAD '" + source + "'", ex);
}
}
}
@Override
public void visit(UpdateAdd update) {
// ADD SILENT? (DEFAULT or GRAPH) TO (DEFAULT or GRAPH)
if ( !validBinaryGraphOp(update) )
return;
if ( update.getSrc().equals(update.getDest()) )
return;
// Different source and destination.
gsAddTriples(datasetGraph, update.getSrc(), update.getDest());
}
@Override
public void visit(UpdateCopy update) {
// COPY SILENT? (DEFAULT or GRAPH) TO (DEFAULT or GRAPH)
if ( !validBinaryGraphOp(update) )
return;
if ( update.getSrc().equals(update.getDest()) )
return;
gsCopy(datasetGraph, update.getSrc(), update.getDest(), update.getSilent());
}
@Override
public void visit(UpdateMove update) {
// MOVE SILENT? (DEFAULT or GRAPH) TO (DEFAULT or GRAPH)
if ( !validBinaryGraphOp(update) )
return;
if ( update.getSrc().equals(update.getDest()) )
return;
// MOVE (DEFAULT or GRAPH) TO (DEFAULT or GRAPH)
// Difefrent source and destination.
gsCopy(datasetGraph, update.getSrc(), update.getDest(), update.getSilent());
gsDrop(datasetGraph, update.getSrc(), true);
}
private boolean validBinaryGraphOp(UpdateBinaryOp update) {
if ( update.getSrc().isDefault() )
return true;
if ( update.getSrc().isOneNamedGraph() ) {
Node gn = update.getSrc().getGraph();
if ( !datasetGraph.containsGraph(gn) ) {
if ( !update.getSilent() )
error("No such graph: " + gn);
return false;
}
return true;
}
error("Invalid source target for oepration; " + update.getSrc());
return false;
}
// ----
// Core operations
/** Copy from src to dst : copy overwrites (= deletes) the old contents */
protected static void gsCopy(DatasetGraph dsg, Target src, Target dest, boolean isSilent)
{
if ( dest.equals(src) )
return ;
gsClear(dsg, dest, true) ;
gsAddTriples(dsg, src, dest) ;
}
/** Add triples from src to dest */
protected static void gsAddTriples(DatasetGraph dsg, Target src, Target dest) {
Graph gSrc = graph(dsg, src);
Graph gDest = graph(dsg, dest);
// Avoids concurrency problems by reading fully before writing
ThresholdPolicy policy = ThresholdPolicyFactory.policyFromContext(dsg.getContext());
DataBag db = BagFactory.newDefaultBag(policy, SerializationFactoryFinder.tripleSerializationFactory());
try {
Iterator triples = gSrc.find(null, null, null);
db.addAll(triples);
Iter.close(triples);
GraphOps.addAll(gDest, db.iterator());
}
finally {
db.close();
}
}
/** Clear target */
protected static void gsClear(DatasetGraph dsg, Target target, boolean isSilent) {
// No create - we tested earlier.
Graph g = graph(dsg, target);
g.clear();
}
/** Remove the target graph */
protected static void gsDrop(DatasetGraph dsg, Target target, boolean isSilent) {
if ( target.isDefault() )
dsg.getDefaultGraph().clear();
else
dsg.removeGraph(target.getGraph());
}
// ----
@Override
public Sink createInsertDataSink() {
return new Sink() {
@Override
public void send(Quad quad) {
addToDatasetGraph(datasetGraph, quad);
}
@Override
public void flush() {
SystemARQ.sync(datasetGraph);
}
@Override
public void close() {}
};
}
@Override
public void visit(UpdateDataInsert update) {
for ( Quad quad : update.getQuads() )
addToDatasetGraph(datasetGraph, quad);
}
@Override
public Sink createDeleteDataSink() {
return new Sink() {
@Override
public void send(Quad quad) {
deleteFromDatasetGraph(datasetGraph, quad);
}
@Override
public void flush() {
SystemARQ.sync(datasetGraph);
}
@Override
public void close() {}
};
}
@Override
public void visit(UpdateDataDelete update) {
for ( Quad quad : update.getQuads() )
deleteFromDatasetGraph(datasetGraph, quad);
}
@Override
public void visit(UpdateDeleteWhere update) {
List quads = update.getQuads() ;
// Removed from SPARQL : Convert bNodes to named variables first.
//quads = convertBNodesToVariables(quads) ;
// Convert quads to a pattern.
Element el = elementFromQuads(quads) ;
// Decided to serialize the bindings, but could also have decided to
// serialize the quads after applying the template instead.
ThresholdPolicy policy = ThresholdPolicyFactory.policyFromContext(datasetGraph.getContext());
DataBag db = BagFactory.newDefaultBag(policy, SerializationFactoryFinder.bindingSerializationFactory());
try {
Iterator bindings = evalBindings(el);
db.addAll(bindings);
Iter.close(bindings);
Iterator it = db.iterator();
execDelete(datasetGraph, quads, null, it);
Iter.close(it);
}
finally {
db.close();
}
}
@Override
public void visit(UpdateModify update) {
Node withGraph = update.getWithIRI();
Element elt = update.getWherePattern();
// null or a dataset for USING clause.
// USING/USING NAMED
DatasetGraph dsg = processUsing(update);
// -------------------
// WITH
// USING overrides WITH
if ( dsg == null && withGraph != null ) {
// Subtle difference : WITH ... WHERE {}
// and an empty/unknown graph
// rewrite with GRAPH -> no match.
// redo as dataset with different default graph -> match
// SPARQL is unclear about what happens when the graph does not exist.
// but the rewrite with ElementNamedGraph is closer to SPARQL.
// Better, treat as
// WHERE { GRAPH { ... } }
// This is the SPARQL wording (which is a bit loose).
elt = new ElementNamedGraph(withGraph, elt) ;
}
// WITH :
// The quads from deletion/insertion are altered when streamed
// into the templates later on.
// -------------------
if ( dsg == null )
dsg = datasetGraph ;
Query query = elementToQuery(elt) ;
ThresholdPolicy policy = ThresholdPolicyFactory.policyFromContext(datasetGraph.getContext());
DataBag db = BagFactory.newDefaultBag(policy, SerializationFactoryFinder.bindingSerializationFactory()) ;
try {
Iterator bindings = evalBindings(query, dsg, inputBinding, context);
if ( false ) {
List x = Iter.toList(bindings);
System.out.printf("====>> Bindings (%d)\n", x.size());
Iter.print(System.out, x.iterator());
System.out.println("====<<");
bindings = Iter.iter(x);
}
db.addAll(bindings);
Iter.close(bindings);
Iterator it = db.iterator();
execDelete(datasetGraph, update.getDeleteQuads(), withGraph, it);
Iter.close(it);
Iterator it2 = db.iterator();
execInsert(datasetGraph, update.getInsertQuads(), withGraph, it2);
Iter.close(it2);
}
finally {
db.close();
}
}
// Indirection for subsystems to support USING/USING NAMED.
protected DatasetGraph processUsing(UpdateModify update) {
if ( update.getUsing().size() == 0 && update.getUsingNamed().size() == 0 )
return null;
return DynamicDatasets.dynamicDataset(update.getUsing(), update.getUsingNamed(), datasetGraph, false);
}
private Graph graphOrDummy(DatasetGraph dsg, Node gn) {
Graph g = graph(datasetGraph, gn);
if ( g == null )
g = GraphFactory.createGraphMem();
return g;
}
protected static List unused_convertBNodesToVariables(List quads) {
NodeTransform bnodesToVariables = new NodeTransformBNodesToVariables();
return NodeTransformLib.transformQuads(bnodesToVariables, quads);
}
protected Element elementFromQuads(List quads) {
ElementGroup el = new ElementGroup();
ElementTriplesBlock x = new ElementTriplesBlock();
// Maybe empty??
el.addElement(x);
Node g = Quad.defaultGraphNodeGenerated;
for ( Quad q : quads ) {
if ( q.getGraph() != g ) {
g = q.getGraph();
x = new ElementTriplesBlock();
if ( g == null || g == Quad.defaultGraphNodeGenerated )
el.addElement(x);
else {
ElementNamedGraph eng = new ElementNamedGraph(g, x);
el.addElement(eng);
}
}
x.addTriple(q.asTriple());
}
return el;
}
// JENA-1059 : optimization : process templates for ground triples and do these once.
// execDelete ; execInsert
// Quads involving only IRIs and literals do not change from binding to
// binding so any inserts, rather than repeatedly if they are going to be
// done at all. Note bNodes (if legal at this point) change from template
// instantiation to instantiation.
/**
* Split quads into ground terms (no variables) and templated quads.
* @param quads
* @return Pair of (ground quads, templated quads)
*/
private static Pair, List> split(Collection quads) {
// Guess size.
// Pre-size in case large (i.e. 10K+).
List constQuads = new ArrayList<>(quads.size()) ;
// ... in which case we assume the templated triples are small / non-existent.
List templateQuads = new ArrayList<>() ;
quads.forEach((q)-> {
if ( constQuad(q))
constQuads.add(q) ;
else
templateQuads.add(q) ;
}) ;
return Pair.create(constQuads, templateQuads);
}
private static boolean constQuad(Quad quad) {
return constTerm(quad.getGraph()) && constTerm(quad.getSubject()) &&
constTerm(quad.getPredicate()) && constTerm(quad.getObject());
}
private static boolean constTerm(Node n) {
return n.isURI() || n.isLiteral() ;
}
protected static void execDelete(DatasetGraph dsg, List quads, Node dftGraph, Iterator bindings) {
Pair, List> p = split(quads) ;
execDelete(dsg, p.getLeft(), p.getRight(), dftGraph, bindings) ;
}
protected static void execDelete(DatasetGraph dsg, List onceQuads, List templateQuads, Node dftGraph, Iterator bindings) {
if ( onceQuads != null && bindings.hasNext() ) {
onceQuads = remapDefaultGraph(onceQuads, dftGraph) ;
onceQuads.forEach(q->deleteFromDatasetGraph(dsg, q)) ;
}
Iterator it = template(templateQuads, dftGraph, bindings) ;
if ( it == null )
return ;
it.forEachRemaining(q->deleteFromDatasetGraph(dsg, q)) ;
}
protected static void execInsert(DatasetGraph dsg, List quads, Node dftGraph, Iterator bindings) {
Pair, List> p = split(quads) ;
execInsert(dsg, p.getLeft(), p.getRight(), dftGraph, bindings) ;
}
protected static void execInsert(DatasetGraph dsg, List onceQuads, List templateQuads, Node dftGraph, Iterator bindings) {
if ( onceQuads != null && bindings.hasNext() ) {
onceQuads = remapDefaultGraph(onceQuads, dftGraph) ;
onceQuads.forEach((q)->addToDatasetGraph(dsg, q)) ;
}
Iterator it = template(templateQuads, dftGraph, bindings) ;
if ( it == null )
return ;
it.forEachRemaining((q)->addToDatasetGraph(dsg, q)) ;
}
// Catch all individual adds of quads
private static void addToDatasetGraph(DatasetGraph datasetGraph, Quad quad) {
// Check legal triple.
if ( quad.isLegalAsData() )
datasetGraph.add(quad);
// Else drop.
// Log.warn(UpdateEngineWorker.class, "Bad quad as data: "+quad) ;
}
// Catch all individual deletes of quads
private static void deleteFromDatasetGraph(DatasetGraph datasetGraph, Quad quad) {
if ( datasetGraph instanceof DatasetGraphReadOnly )
System.err.println("READ ONLY") ;
datasetGraph.delete(quad);
}
protected Query elementToQuery(Element pattern) {
if ( pattern == null )
return null;
Query query = new Query();
query.setQueryPattern(pattern);
query.setQuerySelectType();
query.setQueryResultStar(true);
query.setResultVars();
return query;
}
protected Iterator evalBindings(Element pattern) {
Query query = elementToQuery(pattern);
return evalBindings(query, datasetGraph, inputBinding, context);
}
protected static Iterator evalBindings(Query query, DatasetGraph dsg, Binding inputBinding, Context context) {
// The UpdateProcessorBase already copied the context and made it safe
// ... but that's going to happen again :-(
Iterator toReturn;
if ( query != null ) {
Plan plan = QueryExecutionFactory.createPlan(query, dsg, inputBinding, context);
toReturn = plan.iterator();
} else {
toReturn = Iter.singleton((null != inputBinding) ? inputBinding : BindingRoot.create());
}
return toReturn;
}
protected static Graph graph(DatasetGraph datasetGraph, Node gn) {
if ( gn == null || gn == Quad.defaultGraphNodeGenerated )
return datasetGraph.getDefaultGraph();
else
return datasetGraph.getGraph(gn);
}
protected static Graph graph(DatasetGraph datasetGraph, Target target) {
if ( target.isDefault() )
return datasetGraph.getDefaultGraph();
if ( target.isOneNamedGraph() )
return graph(datasetGraph, target.getGraph());
error("Target does not name one graph: " + target);
return null;
}
protected static void error(String msg) {
throw new UpdateException(msg);
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy