Package org.eclipse.rdf4j.rio.helpers
Class AbstractRDFParser
- java.lang.Object
-
- org.eclipse.rdf4j.rio.helpers.AbstractRDFParser
-
- All Implemented Interfaces:
RDFParser
- Direct Known Subclasses:
BinaryRDFParser
,HDTParser
,JSONLDParser
,NTriplesParser
,RDFJSONParser
,TurtleParser
,XMLReaderBasedParser
public abstract class AbstractRDFParser extends java.lang.Object implements RDFParser
Base class forRDFParser
s offering common functionality for RDF parsers.
-
-
Field Summary
Fields Modifier and Type Field Description private ParsedIRI
baseURI
The base URI for resolving relative URIs.private ParseErrorListener
errListener
An optional ParseErrorListener to report parse errors to.private ParseLocationListener
locationListener
An optional ParseLocationListener to report parse progress in the form of line- and column numbers to.private java.security.MessageDigest
md5
private java.util.Map<java.lang.String,java.lang.String>
namespaceTable
Mapping from namespace prefixes to namespace names.private java.lang.String
nextBNodePrefix
Enables a consistent global mapping of blank node identifiers without using a map, but concatenating this as a prefix for the blank node identifiers supplied by the parser.private ValueFactory
originalValueFactory
private ParsedIRI
parsedSkolemOrigin
private ParserConfig
parserConfig
A collection of configuration options for this parser.protected RDFHandler
rdfHandler
The RDFHandler that will handle the parsed RDF.private java.lang.String
skolemOrigin
The base URI for skolemizing IRIs.private static java.lang.String
uniqueIdPrefix
private static java.util.concurrent.atomic.AtomicLong
uniqueIdSuffix
protected ValueFactory
valueFactory
The ValueFactory to use for creating RDF model objects.
-
Constructor Summary
Constructors Modifier Constructor Description protected
AbstractRDFParser()
Creates a new RDFParserBase that will use aSimpleValueFactory
to create RDF model objects.protected
AbstractRDFParser(ValueFactory valueFactory)
Creates a new RDFParserBase that will use the supplied ValueFactory to create RDF model objects.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods 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, callclear()
instead.protected BNode
createBNode()
Deprecated.protected BNode
createBNode(java.lang.String nodeID)
Deprecated.protected Literal
createLiteral(java.lang.String label, java.lang.String lang, IRI datatype)
Creates aLiteral
object with the supplied parameters.protected Literal
createLiteral(java.lang.String label, java.lang.String lang, IRI datatype, long lineNo, long columnNo)
Creates aLiteral
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()
protected Resource
createNode(java.lang.String nodeID)
protected Statement
createStatement(Resource subj, IRI pred, Value obj)
Creates a newStatement
object with the supplied components.protected Statement
createStatement(Resource subj, IRI pred, Value obj, Resource context)
Creates a newStatement
object with the supplied components.private java.lang.String
createUniqueBNodePrefix()
protected IRI
createURI(java.lang.String uri)
Creates aIRI
object for the specified URI-string.private ParsedIRI
getCachedSkolemOrigin()
Parse skolem origin, if setprotected java.lang.String
getNamespace(java.lang.String prefix)
Gets the namespace that is associated with the specified prefix or throws anRDFParseException
.ParseErrorListener
getParseErrorListener()
ParseLocationListener
getParseLocationListener()
ParserConfig
getParserConfig()
Retrieves the current parser configuration as a single object.RDFHandler
getRDFHandler()
java.util.Collection<RioSetting<?>>
getSupportedSettings()
protected void
initializeNamespaceTableFromConfiguration()
boolean
preserveBNodeIDs()
protected void
reportError(java.lang.Exception e, long lineNo, long columnNo, RioSetting<java.lang.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(java.lang.Exception e, RioSetting<java.lang.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(java.lang.String msg, long lineNo, long columnNo, RioSetting<java.lang.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(java.lang.String msg, java.lang.Exception e, long lineNo, long columnNo, RioSetting<java.lang.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(java.lang.String msg, RioSetting<java.lang.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(java.lang.Exception e)
Reports a fatal error to the registered ParseErrorListener, if any, and throws a ParseException afterwards.protected void
reportFatalError(java.lang.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(java.lang.String msg)
Reports a fatal error to the registered ParseErrorListener, if any, and throws a ParseException afterwards.protected void
reportFatalError(java.lang.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(java.lang.String message, java.lang.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 registeredParseLocationListener
, if any.protected void
reportWarning(java.lang.String msg)
Reports a warning to the registered ParseErrorListener, if any.protected void
reportWarning(java.lang.String msg, long lineNo, long columnNo)
Reports a warning with associated line- and column number to the registered ParseErrorListener, if any.protected IRI
resolveURI(java.lang.String uriSpec)
Resolves a URI-string against the base URI and creates aIRI
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(java.lang.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(java.lang.String prefix, java.lang.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.
-
-
-
Field Detail
-
uniqueIdPrefix
private static final java.lang.String uniqueIdPrefix
-
uniqueIdSuffix
private static final java.util.concurrent.atomic.AtomicLong uniqueIdSuffix
-
md5
private final java.security.MessageDigest md5
-
rdfHandler
protected RDFHandler rdfHandler
The RDFHandler that will handle the parsed RDF.
-
errListener
private ParseErrorListener errListener
An optional ParseErrorListener to report parse errors to.
-
locationListener
private ParseLocationListener locationListener
An optional ParseLocationListener to report parse progress in the form of line- and column numbers to.
-
valueFactory
protected ValueFactory valueFactory
The ValueFactory to use for creating RDF model objects.
-
originalValueFactory
private ValueFactory originalValueFactory
-
baseURI
private ParsedIRI baseURI
The base URI for resolving relative URIs.
-
skolemOrigin
private java.lang.String skolemOrigin
The base URI for skolemizing IRIs.
-
parsedSkolemOrigin
private ParsedIRI parsedSkolemOrigin
-
nextBNodePrefix
private java.lang.String nextBNodePrefix
Enables a consistent global mapping of blank node identifiers without using a map, but concatenating this as a prefix for the blank node identifiers supplied by the parser.
-
namespaceTable
private final java.util.Map<java.lang.String,java.lang.String> namespaceTable
Mapping from namespace prefixes to namespace names.
-
parserConfig
private ParserConfig parserConfig
A collection of configuration options for this parser.
-
-
Constructor Detail
-
AbstractRDFParser
protected AbstractRDFParser()
Creates a new RDFParserBase that will use aSimpleValueFactory
to create RDF model objects.
-
AbstractRDFParser
protected AbstractRDFParser(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 RDFParser 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 interfaceRDFParser
- Parameters:
valueFactory
- The value factory that the parser should use.- Returns:
- Either a copy of this parser, if it is immutable, or this object, to allow chaining of method calls.
-
setRDFHandler
public RDFParser setRDFHandler(RDFHandler handler)
Description copied from interface:RDFParser
Sets the RDFHandler that will handle the parsed RDF data.- Specified by:
setRDFHandler
in interfaceRDFParser
- Parameters:
handler
- The RDFHandler to handle the parsed data.- Returns:
- Either a copy of this parser, if it is immutable, or this object, to allow chaining of method calls.
-
getRDFHandler
public RDFHandler getRDFHandler()
-
setParseErrorListener
public RDFParser 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 interfaceRDFParser
- Parameters:
el
- The ParseErrorListener that will be notified of errors or warnings.- Returns:
- Either a copy of this parser, if it is immutable, or this object, to allow chaining of method calls.
-
getParseErrorListener
public ParseErrorListener getParseErrorListener()
-
setParseLocationListener
public RDFParser 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 interfaceRDFParser
- Parameters:
el
- The ParseLocationListener that will be notified of the parser's progress.- Returns:
- Either a copy of this parser, if it is immutable, or this object, to allow chaining of method calls.
-
getParseLocationListener
public ParseLocationListener getParseLocationListener()
-
setParserConfig
public RDFParser setParserConfig(ParserConfig config)
Description copied from interface:RDFParser
Sets all supplied parser configuration options.- Specified by:
setParserConfig
in interfaceRDFParser
- Parameters:
config
- a parser configuration object.- Returns:
- Either a copy of this parser, if it is immutable, or this object, to allow chaining of method calls.
-
getParserConfig
public ParserConfig getParserConfig()
Description copied from interface:RDFParser
Retrieves the current parser configuration as a single object.- Specified by:
getParserConfig
in interfaceRDFParser
- Returns:
- a parser configuration object representing the current configuration of the parser.
-
getSupportedSettings
public java.util.Collection<RioSetting<?>> getSupportedSettings()
- Specified by:
getSupportedSettings
in interfaceRDFParser
- Returns:
- A collection of
RioSetting
s that are supported by this RDFParser.
-
set
public <T> RDFParser set(RioSetting<T> setting, T value)
Description copied from interface:RDFParser
Set a setting on the parser, and return this parser object to allow chaining.
-
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 interfaceRDFParser
-
preserveBNodeIDs
public boolean preserveBNodeIDs()
-
setBaseURI
protected void setBaseURI(java.lang.String uriSpec)
Parses the supplied URI-string and sets it as the base URI for resolving relative URIs.
-
setBaseURI
protected void setBaseURI(ParsedIRI baseURI)
Sets the base URI for resolving relative URIs.
-
setNamespace
protected void setNamespace(java.lang.String prefix, java.lang.String namespace)
Associates the specified prefix to the specified namespace.
-
getNamespace
protected java.lang.String getNamespace(java.lang.String prefix) throws RDFParseException
Gets the namespace that is associated with the specified prefix or throws anRDFParseException
.- 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.
-
initializeNamespaceTableFromConfiguration
protected void initializeNamespaceTableFromConfiguration()
-
clearBNodeIDMap
@Deprecated protected void clearBNodeIDMap()
Deprecated.Map is no longer used, callclear()
instead.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 IRI resolveURI(java.lang.String uriSpec) throws RDFParseException
Resolves a URI-string against the base URI and creates aIRI
object for it.- Throws:
RDFParseException
-
createURI
protected IRI createURI(java.lang.String uri) throws RDFParseException
Creates aIRI
object for the specified URI-string.- Throws:
RDFParseException
-
createNode
protected Resource createNode() throws RDFParseException
- Returns:
- blank node or skolem IRI
- Throws:
RDFParseException
-
createNode
protected Resource createNode(java.lang.String nodeID) throws RDFParseException
- Parameters:
nodeID
- node identifier- Returns:
- blank node or skolem IRI
- Throws:
RDFParseException
-
createBNode
@Deprecated protected BNode createBNode() throws RDFParseException
Deprecated.Creates a newBNode
object.- Throws:
RDFParseException
-
createBNode
@Deprecated protected BNode createBNode(java.lang.String nodeID) throws RDFParseException
Deprecated.Creates aBNode
object for the specified identifier.- Throws:
RDFParseException
-
createLiteral
protected Literal createLiteral(java.lang.String label, java.lang.String lang, IRI datatype) throws RDFParseException
Creates aLiteral
object with the supplied parameters.- Throws:
RDFParseException
-
createLiteral
protected Literal createLiteral(java.lang.String label, java.lang.String lang, IRI datatype, long lineNo, long columnNo) throws RDFParseException
Creates aLiteral
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.
-
createStatement
protected Statement createStatement(Resource subj, IRI pred, Value obj) throws RDFParseException
Creates a newStatement
object with the supplied components.- Throws:
RDFParseException
-
createStatement
protected Statement createStatement(Resource subj, IRI pred, Value obj, Resource context) throws RDFParseException
Creates a newStatement
object with the supplied components.- Throws:
RDFParseException
-
reportLocation
protected void reportLocation(long lineNo, long columnNo)
Reports the specified line- and column number to the registeredParseLocationListener
, if any.
-
reportWarning
protected void reportWarning(java.lang.String msg)
Reports a warning to the registered ParseErrorListener, if any. This method simply callsreportWarning(String, long, long)
supplying -1 for the line- and column number.
-
reportWarning
protected void reportWarning(java.lang.String msg, long lineNo, long columnNo)
Reports a warning with associated line- and column number to the registered ParseErrorListener, if any.
-
reportError
protected void reportError(java.lang.String msg, RioSetting<java.lang.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 forParseErrorListener.error(String, long, long)
and forRDFParseException(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 ifParserConfig.isNonFatalError(RioSetting)
returns true an exception will be thrown.- Throws:
RDFParseException
- IfRioConfig.get(RioSetting)
returns true, andParserConfig.isNonFatalError(RioSetting)
returns true for the given setting.
-
reportError
protected void reportError(java.lang.String msg, long lineNo, long columnNo, RioSetting<java.lang.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 forParseErrorListener.error(String, long, long)
and forRDFParseException(String, long, long)
.lineNo
- Optional line number, should default to setting this as -1 if not known. Used forParseErrorListener.error(String, long, long)
and forRDFParseException(String, long, long)
.columnNo
- Optional column number, should default to setting this as -1 if not known. Used forParseErrorListener.error(String, long, long)
and forRDFParseException(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 ifParserConfig.isNonFatalError(RioSetting)
returns true an exception will be thrown.- Throws:
RDFParseException
- IfRioConfig.get(RioSetting)
returns true, andParserConfig.isNonFatalError(RioSetting)
returns true for the given setting.
-
reportError
protected void reportError(java.lang.Exception e, RioSetting<java.lang.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:
e
- The exception whose message will be used forParseErrorListener.error(String, long, long)
and forRDFParseException(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 ifParserConfig.isNonFatalError(RioSetting)
returns true an exception will be thrown.- Throws:
RDFParseException
- IfRioConfig.get(RioSetting)
returns true, andParserConfig.isNonFatalError(RioSetting)
returns true for the given setting.
-
reportError
protected void reportError(java.lang.Exception e, long lineNo, long columnNo, RioSetting<java.lang.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:
e
- The exception whose message will be used forParseErrorListener.error(String, long, long)
and forRDFParseException(String, long, long)
.lineNo
- Optional line number, should default to setting this as -1 if not known. Used forParseErrorListener.error(String, long, long)
and forRDFParseException(String, long, long)
.columnNo
- Optional column number, should default to setting this as -1 if not known. Used forParseErrorListener.error(String, long, long)
and forRDFParseException(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 ifParserConfig.isNonFatalError(RioSetting)
returns true an exception will be thrown.- Throws:
RDFParseException
- IfRioConfig.get(RioSetting)
returns true, andParserConfig.isNonFatalError(RioSetting)
returns true for the given setting.
-
reportError
protected void reportError(java.lang.String msg, java.lang.Exception e, long lineNo, long columnNo, RioSetting<java.lang.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 forParseErrorListener.error(String, long, long)
and forRDFParseException(String, long, long)
.e
- The exception whose message will be used forParseErrorListener.error(String, long, long)
and forRDFParseException(String, long, long)
.lineNo
- Optional line number, should default to setting this as -1 if not known. Used forParseErrorListener.error(String, long, long)
and forRDFParseException(String, long, long)
.columnNo
- Optional column number, should default to setting this as -1 if not known. Used forParseErrorListener.error(String, long, long)
and forRDFParseException(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 ifParserConfig.isNonFatalError(RioSetting)
returns true an exception will be thrown.- Throws:
RDFParseException
- IfRioConfig.get(RioSetting)
returns true, andParserConfig.isNonFatalError(RioSetting)
returns true for the given setting.
-
reportFatalError
protected void reportFatalError(java.lang.String msg) throws RDFParseException
Reports a fatal error to the registered ParseErrorListener, if any, and throws a ParseException afterwards. This method simply callsreportFatalError(String, long, long)
supplying -1 for the line- and column number.- Throws:
RDFParseException
-
reportFatalError
protected void reportFatalError(java.lang.String msg, long lineNo, long 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(java.lang.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 aRDFParseException
; 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, long, long)
supplying -1 for the line- and column number.- Throws:
RDFParseException
-
reportFatalError
protected void reportFatalError(java.lang.Exception e, long lineNo, long 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 aRDFParseException
; 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
-
reportFatalError
protected void reportFatalError(java.lang.String message, java.lang.Exception e, long lineNo, long 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 aRDFParseException
; 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
-
createUniqueBNodePrefix
private java.lang.String createUniqueBNodePrefix()
-
getCachedSkolemOrigin
private ParsedIRI getCachedSkolemOrigin()
Parse skolem origin, if set- Returns:
- skolem origin or null
-
-