com.bigdata.rdf.sail.sparql

Class UpdateExprBuilder

java.lang.Object

com.bigdata.rdf.sail.sparql.ASTVisitorBase

com.bigdata.rdf.sail.sparql.BigdataASTVisitorBase

com.bigdata.rdf.sail.sparql.ValueExprBuilder

com.bigdata.rdf.sail.sparql.TriplePatternExprBuilder

com.bigdata.rdf.sail.sparql.GroupGraphPatternBuilder

com.bigdata.rdf.sail.sparql.BigdataExprBuilder

com.bigdata.rdf.sail.sparql.UpdateExprBuilder

All Implemented Interfaces:

SyntaxTreeBuilderVisitor

public class UpdateExprBuilder
extends BigdataExprBuilder

Extension of BigdataExprBuilder that builds Update Expressions.

Author:

Jeen Broekstra, Bryan Thompson

Field Summary

Fields inherited from class com.bigdata.rdf.sail.sparql.ValueExprBuilder

graphPattern

Fields inherited from class com.bigdata.rdf.sail.sparql.BigdataASTVisitorBase

context

Constructor Summary

Constructors

Constructor and Description
UpdateExprBuilder(BigdataASTContext context)

Method Summary

Methods

Modifier and Type	Method and Description
AddGraph	visit(ASTAdd node, Object data)
ClearGraph	visit(ASTClear node, Object data) Note: DROP and CLEAR have the identical semantics for bigdata since it does not support empty graphs.
CopyGraph	visit(ASTCopy node, Object data)
CreateEntailments	visit(ASTCreateEntailments node, Object data)
CreateGraph	visit(ASTCreate node, Object data)
QuadData	visit(ASTDeleteClause node, Object data)
DeleteData	visit(ASTDeleteData node, Object data) Note: For DELETE DATA, QuadData denotes triples to be removed and is as described in INSERT DATA, with the difference that in a DELETE DATA operation neither variables nor blank nodes are allowed (see Notes 8+9 in the grammar).
DeleteInsertGraph	visit(ASTDeleteWhere node, Object data) This handles the "DELETE WHERE" syntax short hand.
DisableEntailments	visit(ASTDisableEntailments node, Object data)
DropEntailments	visit(ASTDropEntailments node, Object data)
DropGraph	visit(ASTDrop node, Object data) Note: DROP and CLEAR have the identical semantics for bigdata since it does not support empty graphs.
EnableEntailments	visit(ASTEnableEntailments node, Object data)
QuadData	visit(ASTInsertClause node, Object data)
InsertData	visit(ASTInsertData node, Object data) Note: Variables in QuadDatas are disallowed in INSERT DATA requests (see Notes 8 in the grammar).
LoadGraph	visit(ASTLoad node, Object data)
DeleteInsertGraph	visit(ASTModify node, Object data) The DELETE/INSERT operation can be used to remove or add triples from/to the Graph Store based on bindings for a query pattern specified in a WHERE clause:
MoveGraph	visit(ASTMove node, Object data)
QuadData	visit(ASTQuadsNotTriples node, Object data)
VarNode	visit(ASTSolutionsRef node, Object data) Solution set names get modeled as variables which report true for VarNode.isSolutionSet().

Methods inherited from class com.bigdata.rdf.sail.sparql.BigdataExprBuilder

handleSelect, verifyAggregate, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit

Methods inherited from class com.bigdata.rdf.sail.sparql.GroupGraphPatternBuilder

visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit

Methods inherited from class com.bigdata.rdf.sail.sparql.TriplePatternExprBuilder

visit, visit, visit, visit, visit, visit, visit, visit, visit, visit

Methods inherited from class com.bigdata.rdf.sail.sparql.ValueExprBuilder

aggregate, binary, left, nary, noneary, quadary, right, ternary, unary, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit

Methods inherited from class com.bigdata.rdf.sail.sparql.BigdataASTVisitorBase

depth, firstASTGraphGraphAncestor, indent, indent, scopedGroupGraphPattern, visit, visit, visit, visit, visit, visit, visit, visit, visit

Methods inherited from class com.bigdata.rdf.sail.sparql.ASTVisitorBase

visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit, visit

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UpdateExprBuilder

public UpdateExprBuilder(BigdataASTContext context)

Method Detail

visit

public InsertData visit(ASTInsertData node,
               Object data)
                 throws VisitorException

Note: Variables in QuadDatas are disallowed in INSERT DATA requests (see Notes 8 in the grammar). That is, the INSERT DATA statement only allows to insert ground triples. Blank nodes in QuadDatas are assumed to be disjoint from the blank nodes in the Graph Store, i.e., will be inserted with "fresh" blank nodes.

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public DeleteData visit(ASTDeleteData node,
               Object data)
                 throws VisitorException

Note: For DELETE DATA, QuadData denotes triples to be removed and is as described in INSERT DATA, with the difference that in a DELETE DATA operation neither variables nor blank nodes are allowed (see Notes 8+9 in the grammar).

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public QuadData visit(ASTQuadsNotTriples node,
             Object data)
               throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public DeleteInsertGraph visit(ASTDeleteWhere node,
                      Object data)
                        throws VisitorException

This handles the "DELETE WHERE" syntax short hand.

 DELETE WHERE  QuadPattern
 

This is similar to a CONSTRUCT without an explicit template. The WHERE clause provides both the pattern to match and the template for the quads to be removed.

Note: The grammar production for the WHERE clause for the DELETE WHERE shortcut form is the same production that is used for the DELETE and INSERT clauses. This results in a QuadData object containing StatementPatternNodes. That object must be transformed into a JoinGroupNode in order to be valid as a WHERE clause.

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

See Also:

(DELETE WHERE fails with Java AssertionError)

visit

public LoadGraph visit(ASTLoad node,
              Object data)
                throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public ClearGraph visit(ASTClear node,
               Object data)
                 throws VisitorException

Note: DROP and CLEAR have the identical semantics for bigdata since it does not support empty graphs.

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public DropGraph visit(ASTDrop node,
              Object data)
                throws VisitorException

Note: DROP and CLEAR have the identical semantics for bigdata since it does not support empty graphs.

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public CreateGraph visit(ASTCreate node,
                Object data)
                  throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public CopyGraph visit(ASTCopy node,
              Object data)
                throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public MoveGraph visit(ASTMove node,
              Object data)
                throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public AddGraph visit(ASTAdd node,
             Object data)
               throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public DeleteInsertGraph visit(ASTModify node,
                      Object data)
                        throws VisitorException

The DELETE/INSERT operation can be used to remove or add triples from/to the Graph Store based on bindings for a query pattern specified in a WHERE clause:

 ( WITH IRIref )?
 ( ( DeleteClause InsertClause? ) | InsertClause )
 ( USING ( NAMED )? IRIref )*
 WHERE GroupGraphPattern
 

The DeleteClause and InsertClause forms can be broken down as follows:

 DeleteClause ::= DELETE  QuadPattern 
 InsertClause ::= INSERT  QuadPattern
 

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public QuadData visit(ASTDeleteClause node,
             Object data)
               throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public QuadData visit(ASTInsertClause node,
             Object data)
               throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public final VarNode visit(ASTSolutionsRef node,
            Object data)
                    throws VisitorException

Solution set names get modeled as variables which report true for VarNode.isSolutionSet().

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public DropEntailments visit(ASTDropEntailments node,
                    Object data)
                      throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public CreateEntailments visit(ASTCreateEntailments node,
                      Object data)
                        throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public EnableEntailments visit(ASTEnableEntailments node,
                      Object data)
                        throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException

visit

public DisableEntailments visit(ASTDisableEntailments node,
                       Object data)
                         throws VisitorException

Specified by:

visit in interface SyntaxTreeBuilderVisitor

Overrides:

visit in class ASTVisitorBase

Throws:

VisitorException