Class SPARQLUpdateDataBlockParser

java.lang.Object

org.eclipse.rdf4j.rio.helpers.AbstractRDFParser

org.eclipse.rdf4j.rio.turtle.TurtleParser

org.eclipse.rdf4j.rio.trig.TriGParser

org.eclipse.rdf4j.rio.trigstar.TriGStarParser

org.eclipse.rdf4j.query.parser.sparql.SPARQLUpdateDataBlockParser

All Implemented Interfaces:

RDFParser

Direct Known Subclasses:

SPARQLUpdateDataBlockParser

public class SPARQLUpdateDataBlockParser
extends TriGStarParser

An extension of TriGStarParser that processes data in the format specified in the SPARQL 1.1 grammar for Quad data (assuming no variables, as is the case for INSERT DATA and DELETE DATA operations). This format is almost completely compatible with TriG, except for three differences:

• it introduces the 'GRAPH' keyword in front of each named graph identifier
• it does not allow the occurrence of blank nodes.
• it does not require curly braces around the default graph.
• it adds support for RDF-star triples (from TriG-star).

Author:

Jeen Broekstra

See Also:

• SPARQL 1.1 Grammar production for INSERT DATA
• SPARQL 1.1 Grammar production for DELETE DATA

Field Summary

Fields inherited from class TurtleParser

object, predicate, subject

Modifier and Type	Field	Description
protected Value	object
protected IRI	predicate
protected Resource	subject

Fields inherited from class AbstractRDFParser

rdfHandler, valueFactory

Modifier and Type	Field	Description
protected RDFHandler	rdfHandler	The RDFHandler that will handle the parsed RDF.
protected ValueFactory	valueFactory	The ValueFactory to use for creating RDF model objects.

Constructor Summary

Constructors

Constructor	Description
SPARQLUpdateDataBlockParser()	Creates a new parser that will use a SimpleValueFactory to create RDF model objects.
SPARQLUpdateDataBlockParser(ValueFactory valueFactory)	Creates a new parser that will use the supplied ValueFactory to create RDF model objects.

Method Summary

Modifier and Type	Method	Description
protected int	getLineNumber()
RDFFormat	getRDFFormat()	Gets the RDF format that this parser can parse.
boolean	isAllowBlankNodes()
protected void	parseGraph()
protected Resource	parseImplicitBlank()	Parses an implicit blank node.
protected Resource	parseNodeID()	Parses a blank node ID, e.g.
void	setAllowBlankNodes(boolean allowBlankNodes)
void	setLineNumberOffset(int lineNumberOffset)

Methods inherited from class TriGStarParser

parseValue, setContext

Modifier and Type	Method	Description
protected Value	parseValue()	Parses an RDF value.
protected void	setContext(Resource context)

Methods inherited from class TriGParser

getContext, parseStatement, parseTriples, reportStatement

Modifier and Type	Method	Description
protected Resource	getContext()
protected void	parseStatement()
protected void	parseTriples()
protected void	reportStatement(Resource subj, IRI pred, Value obj)

Methods inherited from class TurtleParser

getSupportedSettings, parse, parse, parseAnnotation, parseBase, parseCollection, parseDirective, parseLongString, parseNumber, parseObject, parseObjectList, parsePredicate, parsePredicateObjectList, parsePrefixID, parseQNameOrBoolean, parseQuotedLiteral, parseQuotedString, parseString, parseSubject, parseTripleValue, parseURI, peekCodePoint, peekIsTripleValue, processComment, readCodePoint, reportError, reportFatalError, reportFatalError, reportLocation, reportWarning, skipWSC, throwEOFException, unread, unread, verifyCharacterOrFail

Modifier and Type	Method	Description
Collection<RioSetting<?>>	getSupportedSettings()
void	parse(InputStream in, String baseURI)	Parses the data from the supplied InputStream, using the supplied baseURI to resolve any relative URI references.
void	parse(Reader reader, String baseURI)	Parses the data from the supplied Reader, using the supplied baseURI to resolve any relative URI references.
protected void	parseAnnotation()
protected void	parseBase()
protected Resource	parseCollection()	Parses a collection, e.g.
protected void	parseDirective(String directive)
protected String	parseLongString(int closingCharacter)	Parses a """long string""".
protected Literal	parseNumber()
protected void	parseObject()	Parse an object
protected void	parseObjectList()
protected IRI	parsePredicate()
protected void	parsePredicateObjectList()
protected void	parsePrefixID()
protected Value	parseQNameOrBoolean()	Parses qnames and boolean values, which have equivalent starting characters.
protected Literal	parseQuotedLiteral()	Parses a quoted string, optionally followed by a language tag or datatype.
protected String	parseQuotedString()	Parses a quoted string, which is either a "normal string" or a """long string""".
protected String	parseString(int closingCharacter)	Parses a "normal string".
protected void	parseSubject()
protected Triple	parseTripleValue()	Parser an RDF-star triple value and returns it.
protected IRI	parseURI()
protected int	peekCodePoint()	Peeks at the next Unicode code point without advancing the reader, and returns its value.
protected boolean	peekIsTripleValue()	Peeks at the next two Unicode code points without advancing the reader and returns true if they indicate the start of an RDF-star triple value.
protected void	processComment()	Consumes characters from reader until the first EOL has been read.
protected int	readCodePoint()	Reads the next Unicode code point.
protected void	reportError(String msg, RioSetting<Boolean> setting)	Overrides AbstractRDFParser.reportError(String, RioSetting), adding line number information to the error.
protected void	reportFatalError(Exception e)	Overrides AbstractRDFParser.reportFatalError(Exception), adding line number information to the error.
protected void	reportFatalError(String msg)	Overrides AbstractRDFParser.reportFatalError(String), adding line number information to the error.
protected void	reportLocation()
protected void	reportWarning(String msg)	Overrides AbstractRDFParser.reportWarning(String), adding line number information to the error.
protected int	skipWSC()	Consumes any white space characters (space, tab, line feed, newline) and comments (#-style) from reader.
protected void	throwEOFException()
protected void	unread(int codePoint)	Pushes back a single code point by copying it to the front of the buffer.
protected void	unread(String string)	Pushes back the supplied string by copying it to the front of the buffer.
protected void	verifyCharacterOrFail(int codePoint, String expected)	Verifies that the supplied character code point codePoint is one of the expected characters specified in expected.

Methods inherited from class AbstractRDFParser

clear, clearBNodeIDMap, createBNode, createBNode, createLiteral, createLiteral, createLiteral, createNode, createNode, createStatement, createStatement, createURI, getNamespace, getParseErrorListener, getParseLocationListener, getParserConfig, getRDFHandler, initializeNamespaceTableFromConfiguration, preserveBNodeIDs, reportError, reportError, reportError, reportError, reportFatalError, reportFatalError, reportFatalError, reportLocation, reportWarning, resolveURI, set, setBaseURI, setBaseURI, setNamespace, setParseErrorListener, setParseLocationListener, setParserConfig, setPreserveBNodeIDs, setRDFHandler, setValueFactory

Modifier and Type	Method	Description
protected void	clear()	Clears any information that has been collected while parsing.
protected void	clearBNodeIDMap()	Deprecated. Map is no longer used, call AbstractRDFParser.clear() instead.
protected BNode	createBNode()	Deprecated.
protected BNode	createBNode(String nodeID)	Deprecated.
protected Literal	createLiteral(String label, String lang, CoreDatatype datatype, long lineNo, long columnNo)	Creates a Literal object with the supplied parameters, using the lineNo and columnNo to enhance error messages or exceptions that may be generated during the creation of the literal.
protected Literal	createLiteral(String label, String lang, IRI datatype)	Creates a Literal object with the supplied parameters.
protected Literal	createLiteral(String label, String lang, IRI datatype, long lineNo, long columnNo)	Creates a Literal object with the supplied parameters, using the lineNo and columnNo to enhance error messages or exceptions that may be generated during the creation of the literal.
protected Resource	createNode()	Creates a new BNode or Skolem IRI object.
protected Resource	createNode(String nodeID)	Creates a BNode or Skolem IRI object for the specified identifier.
protected Statement	createStatement(Resource subj, IRI pred, Value obj)	Creates a new Statement object with the supplied components.
protected Statement	createStatement(Resource subj, IRI pred, Value obj, Resource context)	Creates a new Statement object with the supplied components.
protected IRI	createURI(String uri)	Creates a IRI object for the specified URI-string.
protected String	getNamespace(String prefix)	Gets the namespace that is associated with the specified prefix or throws an RDFParseException.
ParseErrorListener	getParseErrorListener()
ParseLocationListener	getParseLocationListener()
ParserConfig	getParserConfig()	Retrieves the current parser configuration as a single object.
RDFHandler	getRDFHandler()
protected void	initializeNamespaceTableFromConfiguration()
boolean	preserveBNodeIDs()
protected void	reportError(Exception e, long lineNo, long columnNo, RioSetting<Boolean> relevantSetting)	Reports an error with associated line- and column number to the registered ParseErrorListener, if the given setting has been set to true.
protected void	reportError(Exception e, RioSetting<Boolean> relevantSetting)	Reports an error with associated line- and column number to the registered ParseErrorListener, if the given setting has been set to true.
protected void	reportError(String msg, long lineNo, long columnNo, RioSetting<Boolean> relevantSetting)	Reports an error with associated line- and column number to the registered ParseErrorListener, if the given setting has been set to true.
protected void	reportError(String msg, Exception e, long lineNo, long columnNo, RioSetting<Boolean> relevantSetting)	Reports an error with associated line- and column number to the registered ParseErrorListener, if the given setting has been set to true.
protected void	reportFatalError(Exception e, long lineNo, long columnNo)	Reports a fatal error with associated line- and column number to the registered ParseErrorListener, if any, and throws a ParseException wrapped the supplied exception afterwards.
protected void	reportFatalError(String msg, long lineNo, long columnNo)	Reports a fatal error with associated line- and column number to the registered ParseErrorListener, if any, and throws a ParseException afterwards.
protected void	reportFatalError(String message, Exception e, long lineNo, long columnNo)	Reports a fatal error with associated line- and column number to the registered ParseErrorListener, if any, and throws a ParseException wrapped the supplied exception afterwards.
protected void	reportLocation(long lineNo, long columnNo)	Reports the specified line- and column number to the registered ParseLocationListener, if any.
protected void	reportWarning(String msg, long lineNo, long columnNo)	Reports a warning with associated line- and column number to the registered ParseErrorListener, if any.
protected IRI	resolveURI(String uriSpec)	Resolves a URI-string against the base URI and creates a IRI object for it.
<T> RDFParser	set(RioSetting<T> setting, T value)	Set a setting on the parser, and return this parser object to allow chaining.
protected void	setBaseURI(String uriSpec)	Parses the supplied URI-string and sets it as the base URI for resolving relative URIs.
protected void	setBaseURI(ParsedIRI baseURI)	Sets the base URI for resolving relative URIs.
protected void	setNamespace(String prefix, String namespace)	Associates the specified prefix to the specified namespace.
RDFParser	setParseErrorListener(ParseErrorListener el)	Sets the ParseErrorListener that will be notified of any errors that this parser finds during parsing.
RDFParser	setParseLocationListener(ParseLocationListener el)	Sets the ParseLocationListener that will be notified of the parser's progress during the parse process.
RDFParser	setParserConfig(ParserConfig config)	Sets all supplied parser configuration options.
void	setPreserveBNodeIDs(boolean preserveBNodeIDs)	Set whether the parser should preserve bnode identifiers specified in the source (default is false).
RDFParser	setRDFHandler(RDFHandler handler)	Sets the RDFHandler that will handle the parsed RDF data.
RDFParser	setValueFactory(ValueFactory valueFactory)	Sets the ValueFactory that the parser will use to create Value objects for the parsed RDF data.

Methods inherited from class Object

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

Methods inherited from interface RDFParser

parse, parse

Modifier and Type	Method	Description
default void	parse(InputStream in)	Parses the data from the supplied InputStream.
default void	parse(Reader reader)	Parses the data from the supplied Reader.

Constructor Details

SPARQLUpdateDataBlockParser

public SPARQLUpdateDataBlockParser()

Creates a new parser that will use a SimpleValueFactory to create RDF model objects.

SPARQLUpdateDataBlockParser

public SPARQLUpdateDataBlockParser(ValueFactory valueFactory)

Creates a new parser that will use the supplied ValueFactory to create RDF model objects.

Parameters:

valueFactory - A ValueFactory.

Method Details

getRDFFormat

public RDFFormat getRDFFormat()

Description copied from interface: RDFParser

Gets the RDF format that this parser can parse.

Specified by:

getRDFFormat in interface RDFParser

Overrides:

getRDFFormat in class TriGStarParser

parseGraph

protected void parseGraph()
                   throws RDFParseException,
RDFHandlerException,
IOException

Overrides:

parseGraph in class TriGParser

Throws:

RDFParseException

RDFHandlerException

IOException

parseImplicitBlank

protected Resource parseImplicitBlank()
                               throws IOException,
RDFParseException,
RDFHandlerException

Description copied from class: TurtleParser

Parses an implicit blank node. This method parses the token [] and predicateObjectLists that are surrounded by square brackets.

Overrides:

parseImplicitBlank in class TurtleParser

Throws:

IOException

RDFParseException

RDFHandlerException

parseNodeID

protected Resource parseNodeID()
                        throws IOException,
RDFParseException

Description copied from class: TurtleParser

Parses a blank node ID, e.g. _:node1.

Overrides:

parseNodeID in class TurtleParser

Throws:

IOException

RDFParseException

isAllowBlankNodes

public boolean isAllowBlankNodes()

Returns:

Returns the allowBlankNodes.

setAllowBlankNodes

public void setAllowBlankNodes(boolean allowBlankNodes)

Parameters:

allowBlankNodes - The allowBlankNodes to set.

getLineNumber

protected int getLineNumber()

Overrides:

getLineNumber in class TurtleParser

setLineNumberOffset

public void setLineNumberOffset(int lineNumberOffset)

Parameters:

lineNumberOffset -