RdfXmlParser (Java RDF API Framework 0.5.3)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.jrdf.parser.rdfxml
Class RdfXmlParser

java.lang.Object
  org.jrdf.parser.rdfxml.RdfXmlParser

All Implemented Interfaces:: ConfigurableParser, Parser, ParserConfiguration, StatementHandlerConfiguration

public final class RdfXmlParser
extends Object
implements ConfigurableParser
extends Object
implements ConfigurableParser

A parser for XML-serialized RDF. This parser operates directly on the SAX events generated by a SAX-enabled XML parser. The XML parser should be compliant with SAX2. You should specify which SAX parser should be used by setting the org.xml.sax.driver property. This parser is not thread-safe, therefore it's public methods are synchronized.

To parse a document using this parser:

Create an instance of RdfXmlParser, optionally supplying it with your own ValueFactory.
Set the StatementHandler.
Optionally, set the ParseErrorListener, ParseLocationListener and/or NamespaceListener.
Optionally, specify whether the parser should verify the data it parses and whether it should stop immediately when it finds an error in the data (both default to true).
Call the parse method.

Example code:

 Graph jrdfGraph = new GraphImpl();
 Parser parser = new RdfXmlParser(jrdfGraph.getElementFactory());
 parser.setStatementHandler(myStatementHandler);
 parser.setParseErrorListener(myParseErrorListener);
 parser.setVerifyData(true);
 parser.setStopAtFirstError(false);
 
 // Parse the data from inputStream, resolving any relative URIs against http://foo/bar:
 parser.parse(inputStream, "http://foo/bar");

Field Summary

Fields inherited from interface org.jrdf.parser.ParserConfiguration
`DT_IGNORE, DT_NORMALIZE, DT_VERIFY`

Constructor Summary
`RdfXmlParser(GraphElementFactory graphElementFactory)` Creates a new RdfXmlParser that will use the supplied GraphElementFactory to create objects for resources, bNodes and literals.
`RdfXmlParser(GraphElementFactory graphElementFactory, MapFactory creator)` Creates a new RdfXmlParser that will use the supplied BlankNodeFactoryCreator and create a new map to be used by the generic ParserBlankNodeFactoryImpl.
`RdfXmlParser(GraphElementFactory valueFactory, ParserBlankNodeFactory parserBlankNodeFactory)` Creates a new RdfXmlParser that will use the supplied GraphElementFactory to create objects for resources, bNodes and literals.

Method Summary
`boolean`	`getParseStandAloneDocuments()` Returns whether the parser is currently in a mode to parse stand-alone RDF documents.
`void`	`parse(InputStream in, String baseURI)` Parses the data from the supplied InputStream, using the supplied BASE_URI to resolve any relative URI references.
`void`	`parse(Reader reader, String baseURI)` Parses the data from the supplied Reader, using the supplied BASE_URI to resolve any relative URI references.
`void`	`setDatatypeHandling(int datatypeHandling)` Sets the datatype handling mode.
`void`	`setNamespaceListener(NamespaceListener nl)` Sets the NamespaceListener that will be notified of any namespace declarations that the parser finds during parsing.
`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`	`setParseStandAloneDocuments(boolean standAloneDocs)` Sets the parser in a mode to parse stand-alone RDF documents.
`void`	`setPreserveBNodeIds(boolean preserveBNodeIds)` Set whether the parser should preserve bnode identifiers specified in the source (default is `false`).
`void`	`setStatementHandler(StatementHandler sh)` Sets the StatementHandler that will be notified of statements that are parsed by this parser.
`void`	`setStopAtFirstError(boolean stopAtFirstError)` Sets whether the parser should stop immediately if it finds an error in the data (default value is `true`).
`void`	`setVerifyData(boolean verifyData)` Sets whether the parser should verify the data it parses (default value is `true`).

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

RdfXmlParser

public RdfXmlParser(GraphElementFactory graphElementFactory)
             throws GraphException

Creates a new RdfXmlParser that will use the supplied GraphElementFactory to create objects for resources, bNodes and literals. This create an in memory blank node factory which may exhaust available memory.

Parameters:: graphElementFactory - A GraphElementFactory.
Throws:: GraphException

RdfXmlParser

public RdfXmlParser(GraphElementFactory graphElementFactory,
                    MapFactory creator)
             throws GraphException

Creates a new RdfXmlParser that will use the supplied BlankNodeFactoryCreator and create a new map to be used by the generic ParserBlankNodeFactoryImpl.

Parameters:: graphElementFactory - A GraphElementFactory.; creator - A BlankNodeFactoryCreator.
Throws:: GraphException

RdfXmlParser

public RdfXmlParser(GraphElementFactory valueFactory,
                    ParserBlankNodeFactory parserBlankNodeFactory)
             throws GraphException

Creates a new RdfXmlParser that will use the supplied GraphElementFactory to create objects for resources, bNodes and literals.

Parameters:: valueFactory - A GraphElementFactory.; parserBlankNodeFactory - A ParserBlankNodeFactory.
Throws:: GraphException

Method Detail

setStatementHandler

public void setStatementHandler(StatementHandler sh)

Description copied from interface: StatementHandlerConfiguration

Sets the StatementHandler that will be notified of statements that are parsed by this parser.

Specified by:: setStatementHandler in interface StatementHandlerConfiguration

Parameters:: sh - the StatementHandler.