org.openrdf.rio

Interface RDFParser

All Known Implementing Classes:

RDFParserBase

public interface RDFParser

An interface for RDF parsers. All implementing classes should define a public zero-argument constructor to allow them to be created through reflection.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	RDFParser.DatatypeHandling Deprecated. These settings are not recognised and will be removed in a future version. Use BasicParserSettings.FAIL_ON_UNKNOWN_DATATYPES BasicParserSettings.NORMALIZE_DATATYPE_VALUES and BasicParserSettings.VERIFY_DATATYPE_VALUES instead.

Method Summary

Methods

Modifier and Type	Method and Description
ParserConfig	getParserConfig() Retrieves the current parser configuration as a single object.
RDFFormat	getRDFFormat() Gets the RDF format that this parser can parse.
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.
void	setDatatypeHandling(RDFParser.DatatypeHandling datatypeHandling) Deprecated. Since 2.7.0. Use getParserConfig() with BasicParserSettings.FAIL_ON_UNKNOWN_DATATYPES, BasicParserSettings.VERIFY_DATATYPE_VALUES, and/or BasicParserSettings.NORMALIZE_DATATYPE_VALUES instead.
void	setParseErrorListener(ParseErrorListener el) Sets the ParseErrorListener that will be notified of any errors that this parser finds during parsing.
void	setParseLocationListener(ParseLocationListener ll) 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. Since 2.7.0. Use getParserConfig() with ParserConfig.addNonFatalError(RioSetting) to select which errors will not always fail the parse prematurely.
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) Deprecated. Since 2.7.0. Use getParserConfig() with BasicParserSettings.FAIL_ON_UNKNOWN_DATATYPES, BasicParserSettings.VERIFY_DATATYPE_VALUES, and/or BasicParserSettings.NORMALIZE_DATATYPE_VALUES instead.

Method Detail

getRDFFormat

RDFFormat getRDFFormat()

Gets the RDF format that this parser can parse.

setValueFactory

void setValueFactory(ValueFactory valueFactory)

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

Parameters:

valueFactory - The value factory that the parser should use.

setRDFHandler

void setRDFHandler(RDFHandler handler)

Sets the RDFHandler that will handle the parsed RDF data.

setParseErrorListener

void setParseErrorListener(ParseErrorListener el)

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

setParseLocationListener

void setParseLocationListener(ParseLocationListener ll)

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

setParserConfig

void setParserConfig(ParserConfig config)

Sets all supplied parser configuration options.

Parameters:

config - a parser configuration object.

getParserConfig

ParserConfig getParserConfig()

Retrieves the current parser configuration as a single object.

Returns:

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

getSupportedSettings

Collection<RioSetting<?>> getSupportedSettings()

Returns:

A collection of RioSettings that are supported by this RDFParser.

Since:

2.7.0

setVerifyData

@Deprecated
void setVerifyData(boolean verifyData)

Deprecated. Since 2.7.0. Use getParserConfig() with BasicParserSettings.FAIL_ON_UNKNOWN_DATATYPES, BasicParserSettings.VERIFY_DATATYPE_VALUES, and/or BasicParserSettings.NORMALIZE_DATATYPE_VALUES instead.

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

setPreserveBNodeIDs

void setPreserveBNodeIDs(boolean preserveBNodeIDs)

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

setStopAtFirstError

@Deprecated
void setStopAtFirstError(boolean stopAtFirstError)

Deprecated. Since 2.7.0. Use getParserConfig() with ParserConfig.addNonFatalError(RioSetting) to select which errors will not always fail the parse prematurely.

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

setDatatypeHandling

@Deprecated
void setDatatypeHandling(RDFParser.DatatypeHandling datatypeHandling)

Deprecated. Since 2.7.0. Use getParserConfig() with BasicParserSettings.FAIL_ON_UNKNOWN_DATATYPES, BasicParserSettings.VERIFY_DATATYPE_VALUES, and/or BasicParserSettings.NORMALIZE_DATATYPE_VALUES instead.

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.

Parameters:

datatypeHandling - A datatype handling option.

parse

void parse(InputStream in,
         String baseURI)
           throws IOException,
                  RDFParseException,
                  RDFHandlerException

Parses 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.

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

void parse(Reader reader,
         String baseURI)
           throws IOException,
                  RDFParseException,
                  RDFHandlerException

Parses 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.

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.