com.apicatalog.rdf.nquads

Class NQuadsReader

java.lang.Object

com.apicatalog.rdf.nquads.NQuadsReader

public class NQuadsReader
extends Object

A simple and efficient streaming N-Quads reader.

Use the provide(RdfQuadConsumer) method to parse input and process N-Quads statements.

See Also:

RDF 1.1 N-Quads Specification

Field Summary

Fields

Modifier and Type	Field and Description
protected String	ltDatatype
protected String	ltDirection
protected String	ltLangTag
protected String	ltObject
protected Predicate<String>	testAbsoluteIRI
protected NQuadsTokenizer	tokenizer

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	NQuadsReader(NQuadsTokenizer tokenizer, Predicate<String> testAbsoluteIRI)
	NQuadsReader(Reader reader) Creates a new NQuadsReader instance with the specified character stream.
	NQuadsReader(Reader reader, int bufferSize) Creates a new NQuadsReader instance with the specified character stream and buffer size for optimized reading.
	NQuadsReader(Reader reader, int bufferSize, Predicate<String> testAbsoluteIRI) Creates a new NQuadsReader instance with the specified character stream and buffer size for optimized reading.
	NQuadsReader(Reader reader, Predicate<String> testAbsoluteIRI) Creates a new NQuadsReader instance with the specified character stream.

Method Summary

Modifier and Type	Method and Description
protected void	assertAbsoluteIri(String uri, String what)
protected static void	datatype(String datatype, BiConsumer<String,String[]> result)
protected void	object()
void	provide(com.apicatalog.rdf.api.RdfQuadConsumer consumer) Reads and processes N-Quads, invoking the provided consumer immediately after each N-Quad statement is deserialized.
protected String	resource(String name)
protected void	skipWhitespace(int min)
protected static boolean	startsWithScheme(String uri)
protected void	statement(com.apicatalog.rdf.api.RdfQuadConsumer consumer)
protected static <T> T	unexpected(NQuadsTokenizer.Token token, NQuadsTokenizer.TokenType... types)

Methods inherited from class java.lang.Object

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

Field Detail

tokenizer

protected final NQuadsTokenizer tokenizer

testAbsoluteIRI

protected final Predicate<String> testAbsoluteIRI

ltObject

protected String ltObject

ltDatatype

protected String ltDatatype

ltLangTag

protected String ltLangTag

ltDirection

protected String ltDirection

Constructor Detail

NQuadsReader

public NQuadsReader(Reader reader)

Creates a new NQuadsReader instance with the specified character stream.

Parameters:

reader - the Reader to read N-Quads data from

NQuadsReader

public NQuadsReader(Reader reader,
                    Predicate<String> testAbsoluteIRI)

Creates a new NQuadsReader instance with the specified character stream.

Parameters:

reader - the Reader to read N-Quads data from

testAbsoluteIRI - a function to test if an IRI is absolute or not

NQuadsReader

public NQuadsReader(Reader reader,
                    int bufferSize)

Creates a new NQuadsReader instance with the specified character stream and buffer size for optimized reading.

Parameters:

reader - the Reader to read N-Quads data from

bufferSize - the size of the buffer used for reading > 0 (bytes)

Throws:

IllegalArgumentException - if bufferSize is non-positive number

NQuadsReader

public NQuadsReader(Reader reader,
                    int bufferSize,
                    Predicate<String> testAbsoluteIRI)

Creates a new NQuadsReader instance with the specified character stream and buffer size for optimized reading.

Parameters:

reader - the Reader to read N-Quads data from

bufferSize - the size of the buffer used for reading > 0 (bytes)

testAbsoluteIRI - a function to test if an IRI is absolute or not

Throws:

IllegalArgumentException - if bufferSize is non-positive number

NQuadsReader

protected NQuadsReader(NQuadsTokenizer tokenizer,
                       Predicate<String> testAbsoluteIRI)

Method Detail

provide

public void provide(com.apicatalog.rdf.api.RdfQuadConsumer consumer)
             throws NQuadsReaderException,
                    com.apicatalog.rdf.api.RdfConsumerException

Reads and processes N-Quads, invoking the provided consumer immediately after each N-Quad statement is deserialized.

Parameters:

consumer - the RdfQuadConsumer that processes each deserialized N-Quad statement

Throws:

NQuadsReaderException - if an error occurs while reading the N-Quads

com.apicatalog.rdf.api.RdfConsumerException - if an error occurs while processing the N-Quad statement

statement

protected void statement(com.apicatalog.rdf.api.RdfQuadConsumer consumer)
                  throws NQuadsReaderException,
                         com.apicatalog.rdf.api.RdfConsumerException

Throws:

NQuadsReaderException

com.apicatalog.rdf.api.RdfConsumerException

resource

protected String resource(String name)
                   throws NQuadsReaderException

Throws:

NQuadsReaderException

object

protected void object()
               throws NQuadsReaderException

Throws:

NQuadsReaderException

unexpected

protected static final <T> T unexpected(NQuadsTokenizer.Token token,
                                        NQuadsTokenizer.TokenType... types)
                                 throws NQuadsReaderException

Throws:

NQuadsReaderException

skipWhitespace

protected void skipWhitespace(int min)
                       throws NQuadsReaderException

Throws:

NQuadsReaderException

assertAbsoluteIri

protected final void assertAbsoluteIri(String uri,
                                       String what)
                                throws NQuadsReaderException

Throws:

NQuadsReaderException

datatype

protected static final void datatype(String datatype,
                                     BiConsumer<String,String[]> result)

startsWithScheme

protected static final boolean startsWithScheme(String uri)