com.complexible.common.rdf.rio.parser

Class TurtleParser

java.lang.Object

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

com.complexible.common.rdf.rio.parser.TurtleParser

All Implemented Interfaces:

org.openrdf.rio.RDFParser

Direct Known Subclasses:

TriGParser

public class TurtleParser
extends AbstractRDFParser

RDF parser for Turtle files. This parser is not thread-safe, therefore its public methods are synchronized.

This implementation is based on the 2006/01/02 version of the Turtle specification, with slight deviations:

• Normalization of integer, floating point and boolean values is dependent on the specified datatype handling. According to the specification, integers and booleans should be normalized, but floats don't.
• Comments can be used anywhere in the document, and extend to the end of the line. The Turtle grammar doesn't allow comments to be used inside triple constructs that extend over multiple lines, but the author's own parser deviates from this too.
• The localname part of a prefixed named is allowed to start with a number (cf. the W3C Turtle Working Draft).

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 int	lineNumber
protected org.openrdf.model.Value	object
protected org.openrdf.model.IRI	predicate
protected PushbackReader	reader
protected org.openrdf.model.Resource	subject

Fields inherited from class com.complexible.common.rdf.rio.parser.AbstractRDFParser

baseURI, namespaceTable, rdfHandler, valueFactory

Constructor Summary

Constructors

Constructor and Description
TurtleParser() Creates a new TurtleParser.

Method Summary

Modifier and Type	Method and Description
protected org.openrdf.model.Resource	getContext()
org.openrdf.rio.RDFFormat	getRDFFormat()
Collection<org.openrdf.rio.RioSetting<?>>	getSupportedSettings()
protected void	initConfigParams()
void	parse(InputStream in, String baseURI) Implementation of the parse(InputStream, String) method defined in the RDFParser interface.
void	parse(Reader reader, String baseURI) Implementation of the parse(Reader, String) method defined in the RDFParser interface.
protected void	parseBase()
protected void	parseBlock(String blockName)
protected org.openrdf.model.Resource	parseCollection() Parses a collection, e.g.
protected boolean	parseDirective()
protected org.openrdf.model.Resource	parseImplicitBlank(boolean verify) Parses an implicit blank node.
protected void	parseKeyword(String expected)
protected String	parseLongString(int closingCharacter) Parses a """long string""".
protected org.openrdf.model.BNode	parseNodeID() Parses a blank node ID, e.g.
protected org.openrdf.model.Literal	parseNumber()
protected void	parseObject()
protected void	parseObjectList()
protected org.openrdf.model.IRI	parsePredicate()
protected void	parsePredicateObjectList()
protected void	parsePrefixID()
protected org.openrdf.model.Value	parseQNameOrBoolean() Parses qnames and boolean values, which have equivalent starting characters.
protected org.openrdf.model.Literal	parseQuotedLiteral() Parses a quoted string, optionally followed by a language tag or datatype.
protected String	parseQuotedString() Parses a quoted string, which is either a "normal string" or a """long string""".
protected void	parseRule(org.openrdf.model.Resource ruleID)
protected org.openrdf.model.Resource	parseRuleID()
protected void	parseStatement()
protected String	parseString(int closingCharacter) Parses a "normal string".
protected void	parseSubject()
protected void	parseTriples()
protected org.openrdf.model.IRI	parseURI()
org.openrdf.model.Value	parseValue() Parses an RDF value.
protected int	peekCodePoint() Peeks at the next Unicode code point without advancing the reader, and returns its value.
protected void	processComment() Consumes characters from reader until the first EOL has been read.
protected void	processComment(StringBuilder comment)
protected int	readCodePoint() Reads the next Unicode code point.
protected void	reportError(String msg, org.openrdf.rio.RioSetting<Boolean> setting) Overrides AbstractRDFParser.reportError(String, RioSetting), adding line number information to the error.
protected void	reportFatalError(Exception e) Overrides AbstractRDFParser.reportFatalError(Exception), adding line number information to the error.
protected void	reportFatalError(String msg) Overrides AbstractRDFParser.reportFatalError(String), adding line number information to the error.
protected void	reportLocation()
protected void	reportStatement(org.openrdf.model.Resource subj, org.openrdf.model.IRI pred, org.openrdf.model.Value obj)
protected void	reportWarning(String msg) Overrides AbstractRDFParser.reportWarning(String), adding line number information to the error.
protected int	skipWSC() Consumes any white space characters (space, tab, line feed, newline) and comments (#-style) from reader.
protected void	throwEOFException()
protected void	unread(int codePoint) Pushes back a single code point by copying it to the front of the buffer.
protected void	unread(String string) Pushes back the supplied string by copying it to the front of the buffer.
protected void	verifyCharacterOrFail(int codePoint, String expected) Verifies that the supplied character code point codePoint is one of the expected characters specified in expected.

Methods inherited from class com.complexible.common.rdf.rio.parser.AbstractRDFParser

clear, clearBNodeIDMap, createBNode, createBNode, createLiteral, createStatement, createStatement, createURI, createURI, datatypeHandling, getNamespace, getParseErrorListener, getParseLocationListener, getParserConfig, getRDFHandler, initializeNamespaceTableFromConfiguration, preserveBNodeIDs, reportError, reportError, reportFatalError, reportFatalError, reportLocation, reportWarning, resolveURI, set, setBaseURI, setBaseURI, setDatatypeHandling, setNamespace, setParseErrorListener, setParseLocationListener, setParserConfig, setPreserveBNodeIDs, setRDFHandler, setStopAtFirstError, setValueFactory, setVerifyData, stopAtFirstError, verifyData

Methods inherited from class java.lang.Object

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

Field Detail

reader

protected PushbackReader reader

subject

protected org.openrdf.model.Resource subject

predicate

protected org.openrdf.model.IRI predicate

object

protected org.openrdf.model.Value object

lineNumber

protected int lineNumber

Constructor Detail

TurtleParser

public TurtleParser()

Creates a new TurtleParser.

Method Detail

getRDFFormat

public org.openrdf.rio.RDFFormat getRDFFormat()

getSupportedSettings

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

Specified by:

getSupportedSettings in interface org.openrdf.rio.RDFParser

Overrides:

getSupportedSettings in class AbstractRDFParser

parse

public void parse(InputStream in,
                  String baseURI)
           throws IOException,
                  org.openrdf.rio.RDFParseException,
                  org.openrdf.rio.RDFHandlerException

Implementation of the parse(InputStream, String) method defined in the RDFParser interface.

Parameters:

in - The InputStream from which to read the data, must not be null. The InputStream is supposed to contain UTF-8 encoded Unicode characters, as per the Turtle specification.

baseURI - The IRI associated with the data in the InputStream, must not be null.

Throws:

IOException - If an I/O error occurred while data was read from the InputStream.

org.openrdf.rio.RDFParseException - If the parser has found an unrecoverable parse error.

org.openrdf.rio.RDFHandlerException - If the configured statement handler encountered an unrecoverable error.

IllegalArgumentException - If the supplied input stream or base IRI is null.

initConfigParams

protected void initConfigParams()

Overrides:

initConfigParams in class AbstractRDFParser

parse

public void parse(Reader reader,
                  String baseURI)
           throws IOException,
                  org.openrdf.rio.RDFParseException,
                  org.openrdf.rio.RDFHandlerException

Implementation of the parse(Reader, String) method defined in the RDFParser interface.

Parameters:

reader - The Reader from which to read the data, must not be null.

baseURI - The URI associated with the data in the Reader, must not be null.

Throws:

IOException - If an I/O error occurred while data was read from the InputStream.

org.openrdf.rio.RDFParseException - If the parser has found an unrecoverable parse error.

org.openrdf.rio.RDFHandlerException - If the configured statement handler encountered an unrecoverable error.

IllegalArgumentException - If the supplied reader or base URI is null.

parseStatement

protected void parseStatement()
                       throws IOException,
                              org.openrdf.rio.RDFParseException,
                              org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseDirective

protected boolean parseDirective()
                          throws IOException

Throws:

IOException

parsePrefixID

protected void parsePrefixID()
                      throws IOException,
                             org.openrdf.rio.RDFParseException,
                             org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseBase

protected void parseBase()
                  throws IOException,
                         org.openrdf.rio.RDFParseException,
                         org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseKeyword

protected void parseKeyword(String expected)
                     throws IOException,
                            org.openrdf.rio.RDFParseException,
                            org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseRuleID

protected org.openrdf.model.Resource parseRuleID()
                                          throws IOException,
                                                 org.openrdf.rio.RDFParseException,
                                                 org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseRule

protected void parseRule(org.openrdf.model.Resource ruleID)
                  throws IOException,
                         org.openrdf.rio.RDFParseException,
                         org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseBlock

protected void parseBlock(String blockName)
                   throws IOException,
                          org.openrdf.rio.RDFParseException

Throws:

IOException

org.openrdf.rio.RDFParseException

parseTriples

protected void parseTriples()
                     throws IOException,
                            org.openrdf.rio.RDFParseException,
                            org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parsePredicateObjectList

protected void parsePredicateObjectList()
                                 throws IOException,
                                        org.openrdf.rio.RDFParseException,
                                        org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseObjectList

protected void parseObjectList()
                        throws IOException,
                               org.openrdf.rio.RDFParseException,
                               org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseSubject

protected void parseSubject()
                     throws IOException,
                            org.openrdf.rio.RDFParseException,
                            org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parsePredicate

protected org.openrdf.model.IRI parsePredicate()
                                        throws IOException,
                                               org.openrdf.rio.RDFParseException

Throws:

IOException

org.openrdf.rio.RDFParseException

parseObject

protected void parseObject()
                    throws IOException,
                           org.openrdf.rio.RDFParseException,
                           org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseCollection

protected org.openrdf.model.Resource parseCollection()
                                              throws IOException,
                                                     org.openrdf.rio.RDFParseException,
                                                     org.openrdf.rio.RDFHandlerException

Parses a collection, e.g. ( item1 item2 item3 ).

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseImplicitBlank

protected org.openrdf.model.Resource parseImplicitBlank(boolean verify)
                                                 throws IOException,
                                                        org.openrdf.rio.RDFParseException,
                                                        org.openrdf.rio.RDFHandlerException

Parses an implicit blank node. This method parses the token [] and predicateObjectLists that are surrounded by square brackets.

Throws:

IOException

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

parseValue

public org.openrdf.model.Value parseValue()
                                   throws IOException,
                                          org.openrdf.rio.RDFParseException

Parses an RDF value. This method parses uriref, qname, node ID, quoted literal, integer, double and boolean.

Throws:

IOException

org.openrdf.rio.RDFParseException

parseQuotedLiteral

protected org.openrdf.model.Literal parseQuotedLiteral()
                                                throws IOException,
                                                       org.openrdf.rio.RDFParseException

Parses a quoted string, optionally followed by a language tag or datatype.

Throws:

IOException

org.openrdf.rio.RDFParseException

parseQuotedString

protected String parseQuotedString()
                            throws IOException,
                                   org.openrdf.rio.RDFParseException

Parses a quoted string, which is either a "normal string" or a """long string""".

Throws:

IOException

org.openrdf.rio.RDFParseException

parseString

protected String parseString(int closingCharacter)
                      throws IOException,
                             org.openrdf.rio.RDFParseException

Parses a "normal string". This method requires that the opening character has already been parsed.

Throws:

IOException

org.openrdf.rio.RDFParseException

parseLongString

protected String parseLongString(int closingCharacter)
                          throws IOException,
                                 org.openrdf.rio.RDFParseException

Parses a """long string""". This method requires that the first three characters have already been parsed.

Throws:

IOException

org.openrdf.rio.RDFParseException

parseNumber

protected org.openrdf.model.Literal parseNumber()
                                         throws IOException,
                                                org.openrdf.rio.RDFParseException

Throws:

IOException

org.openrdf.rio.RDFParseException

parseURI

protected org.openrdf.model.IRI parseURI()
                                  throws IOException,
                                         org.openrdf.rio.RDFParseException

Throws:

IOException

org.openrdf.rio.RDFParseException

parseQNameOrBoolean

protected org.openrdf.model.Value parseQNameOrBoolean()
                                               throws IOException,
                                                      org.openrdf.rio.RDFParseException

Parses qnames and boolean values, which have equivalent starting characters.

Throws:

IOException

org.openrdf.rio.RDFParseException

parseNodeID

protected org.openrdf.model.BNode parseNodeID()
                                       throws IOException,
                                              org.openrdf.rio.RDFParseException

Parses a blank node ID, e.g. _:node1.

Throws:

IOException

org.openrdf.rio.RDFParseException

reportStatement

protected void reportStatement(org.openrdf.model.Resource subj,
                               org.openrdf.model.IRI pred,
                               org.openrdf.model.Value obj)
                        throws org.openrdf.rio.RDFParseException,
                               org.openrdf.rio.RDFHandlerException

Throws:

org.openrdf.rio.RDFParseException

org.openrdf.rio.RDFHandlerException

verifyCharacterOrFail

protected void verifyCharacterOrFail(int codePoint,
                                     String expected)
                              throws org.openrdf.rio.RDFParseException

Verifies that the supplied character code point codePoint is one of the expected characters specified in expected. This method will throw a ParseException if this is not the case.

Throws:

org.openrdf.rio.RDFParseException

skipWSC

protected int skipWSC()
               throws IOException,
                      org.openrdf.rio.RDFHandlerException

Consumes any white space characters (space, tab, line feed, newline) and comments (#-style) from reader. After this method has been called, the first character that is returned by reader is either a non-ignorable character, or EOF. For convenience, this character is also returned by this method.

Returns:

The next character code point that will be returned by reader.

Throws:

IOException

org.openrdf.rio.RDFHandlerException

processComment

protected void processComment()
                       throws IOException,
                              org.openrdf.rio.RDFHandlerException

Consumes characters from reader until the first EOL has been read. This line of text is then passed to the AbstractRDFParser.rdfHandler as a comment.

Throws:

IOException

org.openrdf.rio.RDFHandlerException

processComment

protected void processComment(StringBuilder comment)
                       throws IOException,
                              org.openrdf.rio.RDFHandlerException

Throws:

IOException

org.openrdf.rio.RDFHandlerException

readCodePoint

protected int readCodePoint()
                     throws IOException

Reads the next Unicode code point.

Returns:

the next Unicode code point, or -1 if the end of the stream has been reached.

Throws:

IOException

unread

protected void unread(int codePoint)
               throws IOException

Pushes back a single code point by copying it to the front of the buffer. After this method returns, a call to readCodePoint() will return the same code point c again.

Parameters:

codePoint - a single Unicode code point.

Throws:

IOException

unread

protected void unread(String string)
               throws IOException

Pushes back the supplied string by copying it to the front of the buffer. After this method returns, successive calls to readCodePoint() will return the code points in the supplied string again, starting at the first in the String..

Parameters:

string - the string to un-read.

Throws:

IOException

peekCodePoint

protected int peekCodePoint()
                     throws IOException

Peeks at the next Unicode code point without advancing the reader, and returns its value.

Returns:

the next Unicode code point, or -1 if the end of the stream has been reached.

Throws:

IOException

reportLocation

protected void reportLocation()

reportWarning

protected void reportWarning(String msg)

Overrides AbstractRDFParser.reportWarning(String), adding line number information to the error.

Overrides:

reportWarning in class AbstractRDFParser

reportError

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

Overrides AbstractRDFParser.reportError(String, RioSetting), adding line number information to the error.

Overrides:

reportError in class AbstractRDFParser

Parameters:

msg - The message to use for ParseErrorListener.error(String, long, long) and for RDFParseException.RDFParseException(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 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

Overrides AbstractRDFParser.reportFatalError(String), adding line number information to the error.

Overrides:

reportFatalError in class AbstractRDFParser

Throws:

org.openrdf.rio.RDFParseException

reportFatalError

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

Overrides AbstractRDFParser.reportFatalError(Exception), adding line number information to the error.

Overrides:

reportFatalError in class AbstractRDFParser

Throws:

org.openrdf.rio.RDFParseException

throwEOFException

protected void throwEOFException()
                          throws org.openrdf.rio.RDFParseException

Throws:

org.openrdf.rio.RDFParseException

getContext

protected org.openrdf.model.Resource getContext()