com.complexible.common.rdf.rio.parser

Class AbstractRDFParser

java.lang.Object

com.complexible.common.rdf.rio.parser.AbstractRDFParser

All Implemented Interfaces:

org.openrdf.rio.RDFParser

Direct Known Subclasses:

TurtleParser

public abstract class AbstractRDFParser
extends Object
implements org.openrdf.rio.RDFParser

Base class for RDFParsers offering common functionality for RDF parsers.

Author:

Arjohn Kampman

Nested Class Summary

Nested classes/interfaces inherited from interface org.openrdf.rio.RDFParser

org.openrdf.rio.RDFParser.DatatypeHandling

Field Summary

Fields

Modifier and Type	Field and Description
protected info.aduna.net.ParsedURI	baseURI The base URI for resolving relative URIs.
protected Map<String,String>	namespaceTable Mapping from namespace prefixes to namespace names.
protected org.openrdf.rio.RDFHandler	rdfHandler The RDFHandler that will handle the parsed RDF.
protected StardogValueFactory	valueFactory The ValueFactory to use for creating RDF model objects.

Constructor Summary

Constructors

Constructor and Description
AbstractRDFParser() Creates a new RDFParserBase that will use a SimpleValueFactory to create RDF model objects.

Method Summary

Modifier and Type	Method and Description
protected void	clear() Clears any information that has been collected while parsing.
protected void	clearBNodeIDMap() Deprecated. Map is no longer used.
protected org.openrdf.model.BNode	createBNode() Creates a new BNode object.
protected org.openrdf.model.BNode	createBNode(String nodeID) Creates a BNode object for the specified identifier.
protected org.openrdf.model.Literal	createLiteral(String label, String lang, org.openrdf.model.IRI datatype, int lineNo, int 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 org.openrdf.model.Statement	createStatement(org.openrdf.model.Resource subj, org.openrdf.model.IRI pred, org.openrdf.model.Value obj) Creates a new Statement object with the supplied components.
protected org.openrdf.model.Statement	createStatement(org.openrdf.model.Resource subj, org.openrdf.model.IRI pred, org.openrdf.model.Value obj, org.openrdf.model.Resource context) Creates a new Statement object with the supplied components.
protected org.openrdf.model.IRI	createURI(String uri) Creates a IRI object for the specified URI-string.
protected org.openrdf.model.IRI	createURI(String namespace, String localName) Creates a IRI object for the specified namespace and localname.
org.openrdf.rio.RDFParser.DatatypeHandling	datatypeHandling() Deprecated. Use BasicParserSettings.VERIFY_DATATYPE_VALUES and BasicParserSettings.FAIL_ON_UNKNOWN_DATATYPES and BasicParserSettings.NORMALIZE_DATATYPE_VALUES instead.
protected String	getNamespace(String prefix) Gets the namespace that is associated with the specified prefix or throws an RDFParseException.
org.openrdf.rio.ParseErrorListener	getParseErrorListener()
org.openrdf.rio.ParseLocationListener	getParseLocationListener()
org.openrdf.rio.ParserConfig	getParserConfig()
org.openrdf.rio.RDFHandler	getRDFHandler()
Collection<org.openrdf.rio.RioSetting<?>>	getSupportedSettings()
protected void	initConfigParams()
protected void	initializeNamespaceTableFromConfiguration()
boolean	preserveBNodeIDs()
protected void	reportError(Exception e, int lineNo, int columnNo, org.openrdf.rio.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, int lineNo, int columnNo, org.openrdf.rio.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, org.openrdf.rio.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) Reports a fatal error to the registered ParseErrorListener, if any, and throws a ParseException afterwards.
protected void	reportFatalError(Exception e, int lineNo, int 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) Reports a fatal error to the registered ParseErrorListener, if any, and throws a ParseException afterwards.
protected void	reportFatalError(String msg, int lineNo, int columnNo) Reports a fatal error with associated line- and column number to the registered ParseErrorListener, if any, and throws a ParseException afterwards.
protected void	reportLocation(int lineNo, int columnNo) Reports the specified line- and column number to the registered ParseLocationListener, if any.
protected void	reportWarning(String msg) Reports a warning to the registered ParseErrorListener, if any.
protected void	reportWarning(String msg, int lineNo, int columnNo) Reports a warning with associated line- and column number to the registered ParseErrorListener, if any.
protected org.openrdf.model.IRI	resolveURI(String uriSpec) Resolves a URI-string against the base URI and creates a IRI object for it.
<T> org.openrdf.rio.RDFParser	set(org.openrdf.rio.RioSetting<T> setting, T value)
protected void	setBaseURI(info.aduna.net.ParsedURI baseURI) Sets the base URI for resolving relative URIs.
protected void	setBaseURI(String uriSpec) Parses and normalizes the supplied URI-string and sets it as the base URI for resolving relative URIs.
void	setDatatypeHandling(org.openrdf.rio.RDFParser.DatatypeHandling datatypeHandling)
protected void	setNamespace(String prefix, String namespace) Associates the specified prefix to the specified namespace.
AbstractRDFParser	setParseErrorListener(org.openrdf.rio.ParseErrorListener el)
AbstractRDFParser	setParseLocationListener(org.openrdf.rio.ParseLocationListener el)
org.openrdf.rio.RDFParser	setParserConfig(org.openrdf.rio.ParserConfig config)
void	setPreserveBNodeIDs(boolean preserveBNodeIDs)
AbstractRDFParser	setRDFHandler(org.openrdf.rio.RDFHandler handler)
void	setStopAtFirstError(boolean stopAtFirstError) Deprecated.
org.openrdf.rio.RDFParser	setValueFactory(org.openrdf.model.ValueFactory valueFactory)
void	setVerifyData(boolean verifyData)
boolean	stopAtFirstError() Deprecated. Check specific settings instead.
boolean	verifyData() Deprecated. Use specific settings instead.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openrdf.rio.RDFParser

getRDFFormat, parse, parse

Field Detail

rdfHandler

protected org.openrdf.rio.RDFHandler rdfHandler

The RDFHandler that will handle the parsed RDF.

valueFactory

protected final StardogValueFactory valueFactory

The ValueFactory to use for creating RDF model objects.

baseURI

protected info.aduna.net.ParsedURI baseURI

The base URI for resolving relative URIs.

namespaceTable

protected Map<String,String> namespaceTable

Mapping from namespace prefixes to namespace names.

Constructor Detail

AbstractRDFParser

public AbstractRDFParser()

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

Method Detail

setValueFactory

public org.openrdf.rio.RDFParser setValueFactory(org.openrdf.model.ValueFactory valueFactory)

Specified by:

setValueFactory in interface org.openrdf.rio.RDFParser

setRDFHandler

public AbstractRDFParser setRDFHandler(org.openrdf.rio.RDFHandler handler)

Specified by:

setRDFHandler in interface org.openrdf.rio.RDFParser

getRDFHandler

public org.openrdf.rio.RDFHandler getRDFHandler()

setParseErrorListener

public AbstractRDFParser setParseErrorListener(org.openrdf.rio.ParseErrorListener el)

Specified by:

setParseErrorListener in interface org.openrdf.rio.RDFParser

getParseErrorListener

public org.openrdf.rio.ParseErrorListener getParseErrorListener()

setParseLocationListener

public AbstractRDFParser setParseLocationListener(org.openrdf.rio.ParseLocationListener el)

Specified by:

setParseLocationListener in interface org.openrdf.rio.RDFParser

getParseLocationListener

public org.openrdf.rio.ParseLocationListener getParseLocationListener()

setParserConfig

public org.openrdf.rio.RDFParser setParserConfig(org.openrdf.rio.ParserConfig config)

Specified by:

setParserConfig in interface org.openrdf.rio.RDFParser

getParserConfig

public org.openrdf.rio.ParserConfig getParserConfig()

Specified by:

getParserConfig in interface org.openrdf.rio.RDFParser

getSupportedSettings

public Collection<org.openrdf.rio.RioSetting<?>> getSupportedSettings()

Specified by:

getSupportedSettings in interface org.openrdf.rio.RDFParser

set

public <T> org.openrdf.rio.RDFParser set(org.openrdf.rio.RioSetting<T> setting,
                                         T value)

Specified by:

set in interface org.openrdf.rio.RDFParser

setVerifyData

public void setVerifyData(boolean verifyData)

Specified by:

setVerifyData in interface org.openrdf.rio.RDFParser

verifyData

@Deprecated
public boolean verifyData()

Deprecated. Use specific settings instead.

setPreserveBNodeIDs

public void setPreserveBNodeIDs(boolean preserveBNodeIDs)

Specified by:

setPreserveBNodeIDs in interface org.openrdf.rio.RDFParser

preserveBNodeIDs

public boolean preserveBNodeIDs()

setStopAtFirstError

@Deprecated
public void setStopAtFirstError(boolean stopAtFirstError)

Deprecated.

Specified by:

setStopAtFirstError in interface org.openrdf.rio.RDFParser

stopAtFirstError

@Deprecated
public boolean stopAtFirstError()

Deprecated. Check specific settings instead.

setDatatypeHandling

public void setDatatypeHandling(org.openrdf.rio.RDFParser.DatatypeHandling datatypeHandling)

Specified by:

setDatatypeHandling in interface org.openrdf.rio.RDFParser

datatypeHandling

@Deprecated
public org.openrdf.rio.RDFParser.DatatypeHandling datatypeHandling()

Deprecated. Use BasicParserSettings.VERIFY_DATATYPE_VALUES and BasicParserSettings.FAIL_ON_UNKNOWN_DATATYPES and BasicParserSettings.NORMALIZE_DATATYPE_VALUES instead.

setBaseURI

protected void setBaseURI(String uriSpec)

Parses and normalizes the supplied URI-string and sets it as the base URI for resolving relative URIs.

setBaseURI

protected void setBaseURI(info.aduna.net.ParsedURI baseURI)

Sets the base URI for resolving relative URIs.

setNamespace

protected void setNamespace(String prefix,
                            String namespace)

Associates the specified prefix to the specified namespace.

getNamespace

protected String getNamespace(String prefix)
                       throws org.openrdf.rio.RDFParseException

Gets the namespace that is associated with the specified prefix or throws an RDFParseException.

Throws:

org.openrdf.rio.RDFParseException - if no namespace is associated with this prefix

clear

protected void clear()

Clears any information that has been collected while parsing. This method must be called by subclasses when finishing the parse process.

initializeNamespaceTableFromConfiguration

protected void initializeNamespaceTableFromConfiguration()

initConfigParams

protected void initConfigParams()

clearBNodeIDMap

@Deprecated
protected void clearBNodeIDMap()

Deprecated. Map is no longer used.

Clears the map that keeps track of blank nodes that have been parsed. Normally, this map is clear when the document has been parsed completely, but subclasses can clear the map at other moments too, for example when a bnode scope ends.

resolveURI

protected org.openrdf.model.IRI resolveURI(String uriSpec)
                                    throws org.openrdf.rio.RDFParseException

Resolves a URI-string against the base URI and creates a IRI object for it.

Throws:

org.openrdf.rio.RDFParseException

createURI

protected org.openrdf.model.IRI createURI(String uri)
                                   throws org.openrdf.rio.RDFParseException

Creates a IRI object for the specified URI-string.

Throws:

org.openrdf.rio.RDFParseException

createURI

protected org.openrdf.model.IRI createURI(String namespace,
                                          String localName)
                                   throws org.openrdf.rio.RDFParseException

Creates a IRI object for the specified namespace and localname.

Throws:

org.openrdf.rio.RDFParseException

createBNode

protected org.openrdf.model.BNode createBNode()
                                       throws org.openrdf.rio.RDFParseException

Creates a new BNode object.

Throws:

org.openrdf.rio.RDFParseException

createBNode

protected org.openrdf.model.BNode createBNode(String nodeID)
                                       throws org.openrdf.rio.RDFParseException

Creates a BNode object for the specified identifier.

Throws:

org.openrdf.rio.RDFParseException

createLiteral

protected org.openrdf.model.Literal createLiteral(String label,
                                                  String lang,
                                                  org.openrdf.model.IRI datatype,
                                                  int lineNo,
                                                  int columnNo)
                                           throws org.openrdf.rio.RDFParseException

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.

Throws:

org.openrdf.rio.RDFParseException

Since:

2.7.4

See Also:

RDFParserHelper.createLiteral(String, String, IRI, ParserConfig, ParseErrorListener, ValueFactory, long, long)

createStatement

protected org.openrdf.model.Statement createStatement(org.openrdf.model.Resource subj,
                                                      org.openrdf.model.IRI pred,
                                                      org.openrdf.model.Value obj)
                                               throws org.openrdf.rio.RDFParseException

Creates a new Statement object with the supplied components.

Throws:

org.openrdf.rio.RDFParseException

createStatement

protected org.openrdf.model.Statement createStatement(org.openrdf.model.Resource subj,
                                                      org.openrdf.model.IRI pred,
                                                      org.openrdf.model.Value obj,
                                                      org.openrdf.model.Resource context)
                                               throws org.openrdf.rio.RDFParseException

Creates a new Statement object with the supplied components.

Throws:

org.openrdf.rio.RDFParseException

reportLocation

protected void reportLocation(int lineNo,
                              int columnNo)

Reports the specified line- and column number to the registered ParseLocationListener, if any.

reportWarning

protected void reportWarning(String msg)

Reports a warning to the registered ParseErrorListener, if any. This method simply calls reportWarning(String,int,int) supplying -1 for the line- and column number.

reportWarning

protected void reportWarning(String msg,
                             int lineNo,
                             int columnNo)

Reports a warning with associated line- and column number to the registered ParseErrorListener, if any.

reportError

protected void reportError(String msg,
                           org.openrdf.rio.RioSetting<Boolean> relevantSetting)
                    throws org.openrdf.rio.RDFParseException

Reports an error with associated line- and column number to the registered ParseErrorListener, if the given setting has been set to true.

This method also throws an RDFParseException when the given setting has been set to true and it is not a nonFatalError.

Parameters:

msg - The message to use for ParseErrorListener.error(String, long, long) and for RDFParseException.RDFParseException(String, long, long).

relevantSetting - The boolean setting that will be checked to determine if this is an issue that we need to look at at all. If this setting is true, then the error listener will receive the error, and if ParserConfig.isNonFatalError(RioSetting) returns true an exception will be thrown.

Throws:

org.openrdf.rio.RDFParseException - If RioConfig.get(RioSetting) returns true, and ParserConfig.isNonFatalError(RioSetting) returns true for the given setting.

reportError

protected void reportError(String msg,
                           int lineNo,
                           int columnNo,
                           org.openrdf.rio.RioSetting<Boolean> relevantSetting)
                    throws org.openrdf.rio.RDFParseException

Reports an error with associated line- and column number to the registered ParseErrorListener, if the given setting has been set to true.

This method also throws an RDFParseException when the given setting has been set to true and it is not a nonFatalError.

Parameters:

msg - The message to use for ParseErrorListener.error(String, long, long) and for RDFParseException.RDFParseException(String, long, long).

lineNo - Optional line number, should default to setting this as -1 if not known. Used for ParseErrorListener.error(String, long, long) and for RDFParseException.RDFParseException(String, long, long).

columnNo - Optional column number, should default to setting this as -1 if not known. Used for ParseErrorListener.error(String, long, long) and for RDFParseException.RDFParseException(String, long, long).

relevantSetting - The boolean setting that will be checked to determine if this is an issue that we need to look at at all. If this setting is true, then the error listener will receive the error, and if ParserConfig.isNonFatalError(RioSetting) returns true an exception will be thrown.

Throws:

org.openrdf.rio.RDFParseException - If RioConfig.get(RioSetting) returns true, and ParserConfig.isNonFatalError(RioSetting) returns true for the given setting.

reportError

protected void reportError(Exception e,
                           int lineNo,
                           int columnNo,
                           org.openrdf.rio.RioSetting<Boolean> relevantSetting)
                    throws org.openrdf.rio.RDFParseException

Reports an error with associated line- and column number to the registered ParseErrorListener, if the given setting has been set to true.

This method also throws an RDFParseException when the given setting has been set to true and it is not a nonFatalError.

Parameters:

e - The exception whose message will be used for ParseErrorListener.error(String, long, long) and for RDFParseException.RDFParseException(String, long, long).

lineNo - Optional line number, should default to setting this as -1 if not known. Used for ParseErrorListener.error(String, long, long) and for RDFParseException.RDFParseException(String, long, long).

columnNo - Optional column number, should default to setting this as -1 if not known. Used for ParseErrorListener.error(String, long, long) and for RDFParseException.RDFParseException(String, long, long).

relevantSetting - The boolean setting that will be checked to determine if this is an issue that we need to look at at all. If this setting is true, then the error listener will receive the error, and if ParserConfig.isNonFatalError(RioSetting) returns true an exception will be thrown.

Throws:

org.openrdf.rio.RDFParseException - If RioConfig.get(RioSetting) returns true, and ParserConfig.isNonFatalError(RioSetting) returns true for the given setting.

reportFatalError

protected void reportFatalError(String msg)
                         throws org.openrdf.rio.RDFParseException

Reports a fatal error to the registered ParseErrorListener, if any, and throws a ParseException afterwards. This method simply calls reportFatalError(String,int,int) supplying -1 for the line- and column number.

Throws:

org.openrdf.rio.RDFParseException

reportFatalError

protected void reportFatalError(String msg,
                                int lineNo,
                                int columnNo)
                         throws org.openrdf.rio.RDFParseException

Reports a fatal error with associated line- and column number to the registered ParseErrorListener, if any, and throws a ParseException afterwards.

Throws:

org.openrdf.rio.RDFParseException

reportFatalError

protected void reportFatalError(Exception e)
                         throws org.openrdf.rio.RDFParseException

Reports a fatal error to the registered ParseErrorListener, if any, and throws a ParseException afterwards. An exception is made for the case where the supplied exception is a RDFParseException; in that case the supplied exception is not wrapped in another ParseException and the error message is not reported to the ParseErrorListener, assuming that it has already been reported when the original ParseException was thrown.

This method simply calls reportFatalError(Exception,int,int) supplying -1 for the line- and column number.

Throws:

org.openrdf.rio.RDFParseException

reportFatalError

protected void reportFatalError(Exception e,
                                int lineNo,
                                int columnNo)
                         throws org.openrdf.rio.RDFParseException

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. An exception is made for the case where the supplied exception is a RDFParseException; in that case the supplied exception is not wrapped in another ParseException and the error message is not reported to the ParseErrorListener, assuming that it has already been reported when the original ParseException was thrown.

Throws:

org.openrdf.rio.RDFParseException