Package org.eclipse.rdf4j.rio.ntriples
Class NTriplesParser
- java.lang.Object
-
- org.eclipse.rdf4j.rio.helpers.AbstractRDFParser
-
- org.eclipse.rdf4j.rio.ntriples.NTriplesParser
-
- All Implemented Interfaces:
RDFParser
- Direct Known Subclasses:
NQuadsParser
public class NTriplesParser extends AbstractRDFParser
RDF parser for N-Triples files. A specification of NTriples can be found in this section of the RDF Test Cases document. This parser is not thread-safe, therefore its public methods are synchronized.- Author:
- Arjohn Kampman
-
-
Field Summary
Fields Modifier and Type Field Description protected intcurrentIndexprotected char[]lineCharsprotected longlineNoprotected Valueobjectprotected IRIpredicateprotected BufferedReaderreaderprotected Resourcesubject-
Fields inherited from class org.eclipse.rdf4j.rio.helpers.AbstractRDFParser
rdfHandler, valueFactory
-
-
Constructor Summary
Constructors Constructor Description NTriplesParser()Creates a new NTriplesParser that will use aSimpleValueFactoryto create object for resources, bNodes and literals.NTriplesParser(ValueFactory valueFactory)Creates a new NTriplesParser that will use the supplied ValueFactory to create RDF model objects.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected voidassertLineTerminates()Verifies that there is only whitespace or comments until the end of the line.protected voidclear()Clears any information that has been collected while parsing.protected IRIcreateURI(String uri)Creates aIRIobject for the specified URI-string.RDFFormatgetRDFFormat()Gets the RDF format that this parser can parse.Collection<RioSetting<?>>getSupportedSettings()protected voidhandleStatement(boolean ignoredAnError)voidparse(InputStream in, String baseURI)Parses the data from the supplied InputStream, using the supplied baseURI to resolve any relative URI references.voidparse(Reader reader, String baseURI)Parses the data from the supplied Reader, using the supplied baseURI to resolve any relative URI references.protected IRIparseIRI()protected ResourceparseNode()protected voidparseObject()protected voidparsePredicate()protected voidparseStatement()protected voidparseSubject()protected voidreportError(Exception e, RioSetting<Boolean> setting)Reports an error with associated line- and column number to the registered ParseErrorListener, if the given setting has been set to true.protected voidreportError(String msg, RioSetting<Boolean> setting)OverridesAbstractRDFParser.reportError(String, RioSetting), adding line number information to the error.protected voidreportFatalError(Exception e)OverridesAbstractRDFParser.reportFatalError(Exception), adding line number information to the error.protected voidreportFatalError(String msg)OverridesAbstractRDFParser.reportFatalError(String), adding line number information to the error.protected voidreportWarning(String msg)OverridesAbstractRDFParser.reportWarning(String), adding line number information to the error.protected booleanshouldParseLine()protected voidskipWhitespace(boolean throwEOF)protected voidthrowEOFException()-
Methods inherited from class org.eclipse.rdf4j.rio.helpers.AbstractRDFParser
clearBNodeIDMap, createBNode, createBNode, createLiteral, createLiteral, createLiteral, createNode, createNode, createStatement, createStatement, getNamespace, getParseErrorListener, getParseLocationListener, getParserConfig, getRDFHandler, initializeNamespaceTableFromConfiguration, preserveBNodeIDs, reportError, reportError, reportError, reportFatalError, reportFatalError, reportFatalError, reportLocation, reportWarning, resolveURI, set, setBaseURI, setBaseURI, setNamespace, setParseErrorListener, setParseLocationListener, setParserConfig, setPreserveBNodeIDs, setRDFHandler, setValueFactory
-
-
-
-
Field Detail
-
reader
protected BufferedReader reader
-
lineChars
protected char[] lineChars
-
currentIndex
protected int currentIndex
-
lineNo
protected long lineNo
-
subject
protected Resource subject
-
predicate
protected IRI predicate
-
object
protected Value object
-
-
Constructor Detail
-
NTriplesParser
public NTriplesParser()
Creates a new NTriplesParser that will use aSimpleValueFactoryto create object for resources, bNodes and literals.
-
NTriplesParser
public NTriplesParser(ValueFactory valueFactory)
Creates a new NTriplesParser that will use the supplied ValueFactory to create RDF model objects.- Parameters:
valueFactory- A ValueFactory.
-
-
Method Detail
-
getRDFFormat
public RDFFormat getRDFFormat()
Description copied from interface:RDFParserGets the RDF format that this parser can parse.
-
parse
public void parse(InputStream in, String baseURI) throws IOException, RDFParseException, RDFHandlerException
Description copied from interface:RDFParserParses the data from the supplied InputStream, using the supplied baseURI to resolve any relative URI references.- Parameters:
in- The InputStream from which to read the data.baseURI- The URI associated with the data in the InputStream. May benull. Parsers for syntax formats that do not support relative URIs will ignore this argument.Note that if the data contains an embedded base URI, that embedded base URI will overrule the value supplied here (see RFC 3986 section 5.1 for details).
- Throws:
IOException- If an I/O error occurred while data was read from the InputStream.RDFParseException- If the parser has found an unrecoverable parse error.RDFHandlerException- If the configured statement handler has encountered an unrecoverable error.
-
parse
public void parse(Reader reader, String baseURI) throws IOException, RDFParseException, RDFHandlerException
Description copied from interface:RDFParserParses the data from the supplied Reader, using the supplied baseURI to resolve any relative URI references.- Parameters:
reader- The Reader from which to read the data.baseURI- The URI associated with the data in the InputStream. May benull. Parsers for syntax formats that do not support relative URIs will ignore this argument.Note that if the data contains an embedded base URI, that embedded base URI will overrule the value supplied here (see RFC 3986 section 5.1 for details).
- Throws:
IOException- If an I/O error occurred while data was read from the InputStream.RDFParseException- If the parser has found an unrecoverable parse error.RDFHandlerException- If the configured statement handler has encountered an unrecoverable error.
-
parseStatement
protected void parseStatement() throws RDFParseException, RDFHandlerException- Throws:
RDFParseExceptionRDFHandlerException
-
skipWhitespace
protected void skipWhitespace(boolean throwEOF)
-
shouldParseLine
protected boolean shouldParseLine()
-
parseSubject
protected void parseSubject()
-
parsePredicate
protected void parsePredicate()
-
parseObject
protected void parseObject()
-
assertLineTerminates
protected void assertLineTerminates() throws RDFParseExceptionVerifies that there is only whitespace or comments until the end of the line.- Throws:
RDFParseException
-
handleStatement
protected void handleStatement(boolean ignoredAnError)
-
parseIRI
protected IRI parseIRI()
-
parseNode
protected Resource parseNode()
-
createURI
protected IRI createURI(String uri) throws RDFParseException
Description copied from class:AbstractRDFParserCreates aIRIobject for the specified URI-string.- Overrides:
createURIin classAbstractRDFParser- Throws:
RDFParseException
-
reportWarning
protected void reportWarning(String msg)
OverridesAbstractRDFParser.reportWarning(String), adding line number information to the error.- Overrides:
reportWarningin classAbstractRDFParser
-
reportError
protected void reportError(String msg, RioSetting<Boolean> setting) throws RDFParseException
OverridesAbstractRDFParser.reportError(String, RioSetting), adding line number information to the error.- Overrides:
reportErrorin classAbstractRDFParser- Parameters:
msg- The message to use forParseErrorListener.error(String, long, long)and forRDFParseException(String, long, long).setting- 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(Exception e, RioSetting<Boolean> setting) throws RDFParseException
Description copied from class:AbstractRDFParserReports 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
RDFParseExceptionwhen the given setting has been set to true and it is not a nonFatalError.- Overrides:
reportErrorin classAbstractRDFParser- Parameters:
e- The exception whose message will be used forParseErrorListener.error(String, long, long)and forRDFParseException(String, long, long).setting- 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(String msg) throws RDFParseException
OverridesAbstractRDFParser.reportFatalError(String), adding line number information to the error.- Overrides:
reportFatalErrorin classAbstractRDFParser- Throws:
RDFParseException
-
reportFatalError
protected void reportFatalError(Exception e) throws RDFParseException
OverridesAbstractRDFParser.reportFatalError(Exception), adding line number information to the error.- Overrides:
reportFatalErrorin classAbstractRDFParser- Throws:
RDFParseException
-
throwEOFException
protected void throwEOFException() throws RDFParseException- Throws:
RDFParseException
-
clear
protected void clear()
Description copied from class:AbstractRDFParserClears any information that has been collected while parsing. This method must be called by subclasses when finishing the parse process.- Overrides:
clearin classAbstractRDFParser
-
getSupportedSettings
public Collection<RioSetting<?>> getSupportedSettings()
- Specified by:
getSupportedSettingsin interfaceRDFParser- Overrides:
getSupportedSettingsin classAbstractRDFParser- Returns:
- A collection of
RioSettings that are supported by this RDFParser.
-
-