org.openrdf.rio.helpers

Class RDFParserBase

java.lang.Object

org.openrdf.rio.helpers.RDFParserBase

All Implemented Interfaces:

RDFParser

public abstract class RDFParserBase
extends Object
implements 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

RDFParser.DatatypeHandling

Field Summary

Fields

Modifier and Type	Field and 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 and Description
RDFParserBase() Creates a new RDFParserBase that will use a ValueFactoryImpl to create RDF model objects.
RDFParserBase(ValueFactory valueFactory) Creates a new RDFParserBase that will use the supplied ValueFactory to create RDF model objects.

Method Summary

Methods

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 BNode	createBNode() Creates a new BNode object.
protected BNode	createBNode(String nodeID) Creates a BNode object for the specified identifier.
protected Literal	createLiteral(String label, String lang, URI datatype) Creates a Literal object with the supplied parameters.
protected Literal	createLiteral(String label, String lang, URI 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 Statement	createStatement(Resource subj, URI pred, Value obj) Creates a new Statement object with the supplied components.
protected Statement	createStatement(Resource subj, URI pred, Value obj, Resource context) Creates a new Statement object with the supplied components.
protected URI	createURI(String uri) Creates a URI object for the specified URI-string.
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.
ParseErrorListener	getParseErrorListener()
ParseLocationListener	getParseLocationListener()
ParserConfig	getParserConfig() Retrieves the current parser configuration as a single object.
RDFHandler	getRDFHandler()
Collection<RioSetting<?>>	getSupportedSettings()
boolean	preserveBNodeIDs()
protected void	reportError(Exception e, int lineNo, int 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, int lineNo, int 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, 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 URI	resolveURI(String uriSpec) Resolves a URI-string against the base URI and creates a URI object for it.
protected void	setBaseURI(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(RDFParser.DatatypeHandling datatypeHandling) Sets the datatype handling mode.
protected void	setNamespace(String prefix, String namespace) Associates the specified prefix to the specified namespace.
void	setParseErrorListener(ParseErrorListener el) Sets the ParseErrorListener that will be notified of any errors that this parser finds during parsing.
void	setParseLocationListener(ParseLocationListener el) Sets the ParseLocationListener that will be notified of the parser's progress during the parse process.
void	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).
void	setRDFHandler(RDFHandler handler) Sets the RDFHandler that will handle the parsed RDF data.
void	setStopAtFirstError(boolean stopAtFirstError) Deprecated.
void	setValueFactory(ValueFactory valueFactory) Sets the ValueFactory that the parser will use to create Value objects for the parsed RDF data.
void	setVerifyData(boolean verifyData) Sets whether the parser should verify the data it parses (default value is true).
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 RDFHandler rdfHandler

The RDFHandler that will handle the parsed RDF.

valueFactory

protected ValueFactory valueFactory

The ValueFactory to use for creating RDF model objects.

Constructor Detail

RDFParserBase

public RDFParserBase()

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

RDFParserBase

public RDFParserBase(ValueFactory valueFactory)

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

Parameters:

valueFactory - A ValueFactory.

Method Detail

setValueFactory

public void setValueFactory(ValueFactory valueFactory)

Description copied from interface: RDFParser

Sets the ValueFactory that the parser will use to create Value objects for the parsed RDF data.

Specified by:

setValueFactory in interface RDFParser

Parameters:

valueFactory - The value factory that the parser should use.

setRDFHandler

public void setRDFHandler(RDFHandler handler)

Description copied from interface: RDFParser

Sets the RDFHandler that will handle the parsed RDF data.

Specified by:

setRDFHandler in interface RDFParser

getRDFHandler

public RDFHandler getRDFHandler()

setParseErrorListener

public void setParseErrorListener(ParseErrorListener el)

Description copied from interface: RDFParser

Sets the ParseErrorListener that will be notified of any errors that this parser finds during parsing.

Specified by:

setParseErrorListener in interface RDFParser

getParseErrorListener

public ParseErrorListener getParseErrorListener()

setParseLocationListener

public void setParseLocationListener(ParseLocationListener el)

Description copied from interface: RDFParser

Sets the ParseLocationListener that will be notified of the parser's progress during the parse process.

Specified by:

setParseLocationListener in interface RDFParser

getParseLocationListener

public ParseLocationListener getParseLocationListener()

setParserConfig

public void setParserConfig(ParserConfig config)

Description copied from interface: RDFParser

Sets all supplied parser configuration options.

Specified by:

setParserConfig in interface RDFParser

Parameters:

config - a parser configuration object.

getParserConfig

public ParserConfig getParserConfig()

Description copied from interface: RDFParser

Retrieves the current parser configuration as a single object.

Specified by:

getParserConfig in interface RDFParser

Returns:

a parser configuration object representing the current configuration of the parser.

getSupportedSettings

public Collection<RioSetting<?>> getSupportedSettings()

Specified by:

getSupportedSettings in interface RDFParser

Returns:

A collection of RioSettings that are supported by this RDFParser.

setVerifyData

public void setVerifyData(boolean verifyData)

Description copied from interface: RDFParser

Sets whether the parser should verify the data it parses (default value is true).

Specified by:

setVerifyData in interface RDFParser

verifyData

@Deprecated
public boolean verifyData()

Deprecated. Use specific settings instead.

setPreserveBNodeIDs

public void setPreserveBNodeIDs(boolean preserveBNodeIDs)

Description copied from interface: RDFParser

Set whether the parser should preserve bnode identifiers specified in the source (default is false).

Specified by:

setPreserveBNodeIDs in interface RDFParser

preserveBNodeIDs

public boolean preserveBNodeIDs()

setStopAtFirstError

@Deprecated
public void setStopAtFirstError(boolean stopAtFirstError)

Deprecated.

Description copied from interface: RDFParser

Sets whether the parser should stop immediately if it finds an error in the data (default value is true).

Specified by:

setStopAtFirstError in interface RDFParser

stopAtFirstError

@Deprecated
public boolean stopAtFirstError()

Deprecated. Check specific settings instead.

setDatatypeHandling

public void setDatatypeHandling(RDFParser.DatatypeHandling datatypeHandling)

Description copied from interface: RDFParser

Sets the datatype handling mode. There are three modes for handling datatyped literals: ignore, verifyand normalize . If set to ignore, no special action will be taken to handle datatyped literals. If set to verify, any literals with known (XML Schema built-in) datatypes are checked to see if their values are valid. If set to normalize, the literal values are not only checked, but also normalized to their canonical representation. The default value is verify.

Specified by:

setDatatypeHandling in interface RDFParser

Parameters:

datatypeHandling - A datatype handling option.

datatypeHandling

@Deprecated
public 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(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 RDFParseException

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

Throws:

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.

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 URI resolveURI(String uriSpec)
                  throws RDFParseException

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

Throws:

RDFParseException

createURI

protected URI createURI(String uri)
                 throws RDFParseException

Creates a URI object for the specified URI-string.

Throws:

RDFParseException

createBNode

protected BNode createBNode()
                     throws RDFParseException

Creates a new BNode object.

Throws:

RDFParseException

createBNode

protected BNode createBNode(String nodeID)
                     throws RDFParseException

Creates a BNode object for the specified identifier.

Throws:

RDFParseException

createLiteral

protected Literal createLiteral(String label,
                    String lang,
                    URI datatype)
                         throws RDFParseException

Creates a Literal object with the supplied parameters.

Throws:

RDFParseException

createLiteral

protected Literal createLiteral(String label,
                    String lang,
                    URI datatype,
                    int lineNo,
                    int columnNo)
                         throws 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:

RDFParseException

Since:

2.7.4

See Also:

RDFParserHelper.createLiteral(String, String, URI, ParserConfig, ParseErrorListener, ValueFactory, int, int)

createStatement

protected Statement createStatement(Resource subj,
                        URI pred,
                        Value obj)
                             throws RDFParseException

Creates a new Statement object with the supplied components.

Throws:

RDFParseException

createStatement

protected Statement createStatement(Resource subj,
                        URI pred,
                        Value obj,
                        Resource context)
                             throws RDFParseException

Creates a new Statement object with the supplied components.

Throws:

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,
               RioSetting<Boolean> relevantSetting)
                    throws 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, int, int) and for RDFParseException.RDFParseException(String, int, int).

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:

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,
               RioSetting<Boolean> relevantSetting)
                    throws 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, int, int) and for RDFParseException.RDFParseException(String, int, int).

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

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

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:

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,
               RioSetting<Boolean> relevantSetting)
                    throws 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, int, int) and for RDFParseException.RDFParseException(String, int, int).

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

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

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:

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

reportFatalError

protected void reportFatalError(String msg)
                         throws 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:

RDFParseException

reportFatalError

protected void reportFatalError(String msg,
                    int lineNo,
                    int columnNo)
                         throws RDFParseException

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

Throws:

RDFParseException

reportFatalError

protected void reportFatalError(Exception e)
                         throws 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:

RDFParseException

reportFatalError

protected void reportFatalError(Exception e,
                    int lineNo,
                    int columnNo)
                         throws 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:

RDFParseException