org.semanticweb.owlapi.rdf.syntax

Class RDFParser

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.semanticweb.owlapi.rdf.syntax.RDFParser

All Implemented Interfaces:

RDFConstants, ContentHandler, DTDHandler, EntityResolver, ErrorHandler

public class RDFParser
extends org.xml.sax.helpers.DefaultHandler
implements RDFConstants

This class parses the RDF according to the syntax specified in http://www.w3.org/TR/rdf-syntax-grammar/.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	RDFParser.EmptyPropertyElement Parses emptyPropertyElt production.
protected class	RDFParser.NodeElement Parses the nodeElement production.
protected class	RDFParser.NodeElementList Parses the nodeElementList production.
protected class	RDFParser.ParseTypeCollectionPropertyElement Parses parseTypeCollectionPropertyElt production.
protected class	RDFParser.ParseTypeLiteralPropertyElement Parses parseTypeLiteralPropertyElt production.
protected class	RDFParser.ParseTypeResourcePropertyElement Parses parseTypeResourcePropertyElt production.
protected class	RDFParser.PropertyElementList Parses the propertyEltList production.
protected static class	RDFParser.ReificationManager
protected class	RDFParser.ReifiedStatementBag
protected class	RDFParser.ResourceOrLiteralPropertyElement Parses resourcePropertyElt or literalPropertyElt productions.
protected class	RDFParser.StartRDF State expecting start of RDF text.
protected static class	RDFParser.State Base class for all parser states.

Field Summary

Fields

Modifier and Type	Field and Description
protected IRI	m_baseIRI IRI of the document being parsed.
protected LinkedList<IRI>	m_baseIRIs Stack of base IRIs.
protected RDFConsumer	m_consumer Consumer receiving notifications about parsing events.
protected Locator	m_documentLocator Document locator.
protected ErrorHandler	m_errorHandler Registered error handler.
protected String	m_language The current language.
protected LinkedList<String>	m_languages The stack of languages.
protected RDFParser.State	m_state Current parser's state.
protected List<RDFParser.State>	m_states Stack of parser states.
protected static Locator	s_nullDocumentLocator
protected static SAXParserFactory	s_parserFactory
protected Map<String,IRI>	uriCache

Fields inherited from interface org.semanticweb.owlapi.rdf.util.RDFConstants

ATTR_ABOUT, ATTR_ABOUT_EACH, ATTR_ABOUT_EACH_PREFIX, ATTR_BAG_ID, ATTR_DATATYPE, ATTR_ID, ATTR_NODE_ID, ATTR_PARSE_TYPE, ATTR_RESOURCE, ELT_ALT, ELT_BAG, ELT_DESCRIPTION, ELT_LI, ELT_RDF, ELT_SEQ, ELT_TYPE, KAONNS, PARSE_TYPE_COLLECTION, PARSE_TYPE_LITERAL, PARSE_TYPE_RESOURCE, RDF_ABOUT, RDF_BAG, RDF_DATATYPE, RDF_DESCRIPTION, RDF_FIRST, RDF_ID, RDF_LI, RDF_LIST, RDF_NIL, RDF_NODE_ID, RDF_OBJECT, RDF_PARSE_TYPE, RDF_PREDICATE, RDF_PROPERTY, RDF_RDF, RDF_RESOURCE, RDF_REST, RDF_STATEMENT, RDF_SUBJECT, RDF_TYPE, RDF_XMLLITERAL, RDFNS, RDFS_CLASS, RDFS_COMMENT, RDFS_DOMAIN, RDFS_LABEL, RDFS_RANGE, RDFS_SUBCLASSOF, RDFS_SUBPROPERTYOF, RDFSNS, XMLLANG, XMLNS

Constructor Summary

Constructors

Constructor and Description
RDFParser() Creates a RDF parser.

Method Summary

Methods

Modifier and Type	Method and Description
void	characters(char[] data, int start, int length) Called when character content is parsed.
protected void	checkUnsupportedAttributes(Attributes atts) Checks if attribute list contains some of the unsupported attributes.
void	endDocument() Called when document parsing is ended.
void	endElement(String namespaceIRI, String localName, String qName) Called when element parsing is ended.
void	error(SAXParseException e) Called when error is encountered.
void	fatalError(SAXParseException e) Called when a fatal error is encountered.
protected String	getIDNodeIDAboutResourceIRI(Attributes atts) Extracts the IRI of the resource from rdf:ID, rdf:nodeID or rdf:about attribute.
IRI	getIRI(String s)
protected String	getIRIFromAbout(String about) Returns an absolute IRI from an about attribute.
protected String	getIRIFromID(String id) Returns an absolute IRI from an ID.
protected String	getIRIFromNodeID(String nodeID) Returns an abolute IRI from a nodeID attribute.
protected String	getIRIFromResource(String resource) Returns an absolute IRI from a resource attribute.
protected String	getNodeIDResourceResourceIRI(Attributes atts) Extracts the IRI of the resource from rdf:resource or rdf:nodeID attribute.
protected RDFParser.ReificationManager	getReificationManager(Attributes atts) Returns the reification manager for given attributes.
boolean	isAnonymousNodeID(String iri)
boolean	isAnonymousNodeIRI(String uri) Tests whether supplied IRI was generated by this parser in order to label an anonymous node.
protected boolean	isWhitespaceOnly(char[] data, int start, int length) Checks whether given characters contain only whitespace.
protected boolean	isWhitespaceOnly(StringBuilder buffer) Checks whether given characters contain only whitespace.
protected String	nextAnonymousIRI() Generates next anonymous IRI.
void	parse(InputSource source, RDFConsumer consumer) Parses RDF from given input source.
protected Map<String,String>	parseStringArguments(String string) Parses the string into a map of name-value pairs.
protected void	popState() Pops a state from the stack.
void	processingInstruction(String target, String data) Called when processing instruction is parsed.
protected void	processXMLBase(Attributes atts) Processes xml:base reference if there is one.
protected void	processXMLLanguage(Attributes atts) Processes xml:language reference is there is one.
protected void	propertyAttributes(String subjectIRI, Attributes atts, RDFParser.ReificationManager reificationManager) Parses the propertyAttributes production.
protected void	pushState(RDFParser.State state) Pushes a new state on the state stack.
protected String	resolveIRI(String uri) Resolves an IRI with the current base.
void	setDocumentLocator(Locator locator) Called to receive a document locator.
void	setErrorHandler(ErrorHandler errorHandler) Sets the error handler.
void	startDocument() Called when document parsing is started.
void	startElement(String namespaceIRI, String localName, String qName, Attributes atts) Called when an element is started.
protected void	statementWithLiteralValue(String subject, String predicate, String object, String dataType, String reificationID) Called when a statement with literal value is added to the model.
protected void	statementWithResourceValue(String subject, String predicate, String object, String reificationID) Called when a statement with resource value is added to the model.
void	warning(SAXParseException e) Called when warning is encountered.

Methods inherited from class org.xml.sax.helpers.DefaultHandler

endPrefixMapping, ignorableWhitespace, notationDecl, resolveEntity, skippedEntity, startPrefixMapping, unparsedEntityDecl

Methods inherited from class java.lang.Object

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

Field Detail

s_nullDocumentLocator

protected static final Locator s_nullDocumentLocator

s_parserFactory

protected static final SAXParserFactory s_parserFactory

uriCache

protected Map<String,IRI> uriCache

m_errorHandler

protected ErrorHandler m_errorHandler

Registered error handler.

m_baseIRIs

protected LinkedList<IRI> m_baseIRIs

Stack of base IRIs.

m_baseIRI

protected IRI m_baseIRI

IRI of the document being parsed.

m_languages

protected LinkedList<String> m_languages

The stack of languages.

m_language

protected String m_language

The current language.

m_consumer

protected RDFConsumer m_consumer

Consumer receiving notifications about parsing events.

m_state

protected RDFParser.State m_state

Current parser's state.

m_states

protected List<RDFParser.State> m_states

Stack of parser states.

m_documentLocator

protected Locator m_documentLocator

Document locator.

Constructor Detail

RDFParser

public RDFParser()

Creates a RDF parser.

Method Detail

parse

public void parse(InputSource source,
         RDFConsumer consumer)
           throws SAXException,
                  IOException

Parses RDF from given input source.

Parameters:

source - specifies where RDF comes from

consumer - receives notifications about RDF parsing events

Throws:

SAXException

IOException

setDocumentLocator

public void setDocumentLocator(Locator locator)

Called to receive a document locator.

Specified by:

setDocumentLocator in interface ContentHandler

Overrides:

setDocumentLocator in class org.xml.sax.helpers.DefaultHandler

Parameters:

locator - the document locator

setErrorHandler

public void setErrorHandler(ErrorHandler errorHandler)

Sets the error handler.

Parameters:

errorHandler - the error handler

warning

public void warning(SAXParseException e)
             throws SAXException

Called when warning is encountered.

Specified by:

warning in interface ErrorHandler

Overrides:

warning in class org.xml.sax.helpers.DefaultHandler

Parameters:

e - the exception

Throws:

SAXException

error

public void error(SAXParseException e)
           throws SAXException

Called when error is encountered.

Specified by:

error in interface ErrorHandler

Overrides:

error in class org.xml.sax.helpers.DefaultHandler

Parameters:

e - the exception

Throws:

SAXException

fatalError

public void fatalError(SAXParseException e)
                throws SAXException

Called when a fatal error is encountered.

Specified by:

fatalError in interface ErrorHandler

Overrides:

fatalError in class org.xml.sax.helpers.DefaultHandler

Parameters:

e - the exception

Throws:

SAXException

startDocument

public void startDocument()

Called when document parsing is started.

Specified by:

startDocument in interface ContentHandler

Overrides:

startDocument in class org.xml.sax.helpers.DefaultHandler

endDocument

public void endDocument()
                 throws SAXException

Called when document parsing is ended.

Specified by:

endDocument in interface ContentHandler

Overrides:

endDocument in class org.xml.sax.helpers.DefaultHandler

Throws:

SAXException

startElement

public void startElement(String namespaceIRI,
                String localName,
                String qName,
                Attributes atts)
                  throws SAXException

Called when an element is started.

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class org.xml.sax.helpers.DefaultHandler

Parameters:

namespaceIRI - the IRI of the namespace

localName - the local name of the element

qName - the Q-name of the element

atts - the attributes

Throws:

SAXException

endElement

public void endElement(String namespaceIRI,
              String localName,
              String qName)
                throws SAXException

Called when element parsing is ended.

Specified by:

endElement in interface ContentHandler

Overrides:

endElement in class org.xml.sax.helpers.DefaultHandler

Parameters:

namespaceIRI - the IRI of the namespace

localName - the local name of the element

qName - the Q-name of the element

Throws:

SAXException

characters

public void characters(char[] data,
              int start,
              int length)
                throws SAXException

Called when character content is parsed.

Specified by:

characters in interface ContentHandler

Overrides:

characters in class org.xml.sax.helpers.DefaultHandler

Parameters:

data - the data buffer containing the characters

start - the start index of character text

length - the length of the character text

Throws:

SAXException

processingInstruction

public void processingInstruction(String target,
                         String data)
                           throws SAXException

Called when processing instruction is parsed.

Specified by:

processingInstruction in interface ContentHandler

Overrides:

processingInstruction in class org.xml.sax.helpers.DefaultHandler

Parameters:

target - the name of the processing instruction

data - the argument to the processing instruction

Throws:

SAXException

pushState

protected void pushState(RDFParser.State state)

Pushes a new state on the state stack.

Parameters:

state - new state

popState

protected void popState()
                 throws SAXException

Pops a state from the stack.

Throws:

SAXException

checkUnsupportedAttributes

protected void checkUnsupportedAttributes(Attributes atts)
                                   throws SAXException

Checks if attribute list contains some of the unsupported attributes.

Parameters:

atts - the attributes

Throws:

SAXException

processXMLBase

protected void processXMLBase(Attributes atts)
                       throws SAXException

Processes xml:base reference if there is one.

Parameters:

atts - the attributes potentially containing xml:base declaration

Throws:

SAXException

processXMLLanguage

protected void processXMLLanguage(Attributes atts)

Processes xml:language reference is there is one.

Parameters:

atts - the attributes potentially containing xml:language declaration

resolveIRI

protected String resolveIRI(String uri)
                     throws SAXException

Resolves an IRI with the current base.

Parameters:

uri - the IRI being resolved

Returns:

the resolved IRI

Throws:

SAXException

getIRIFromID

protected String getIRIFromID(String id)
                       throws SAXException

Returns an absolute IRI from an ID.

Throws:

SAXException

getIRIFromAbout

protected String getIRIFromAbout(String about)
                          throws SAXException

Returns an absolute IRI from an about attribute.

Throws:

SAXException

getIRIFromNodeID

protected String getIRIFromNodeID(String nodeID)
                           throws SAXException

Returns an abolute IRI from a nodeID attribute.

Throws:

SAXException

getIRIFromResource

protected String getIRIFromResource(String resource)
                             throws SAXException

Returns an absolute IRI from a resource attribute.

Throws:

SAXException

nextAnonymousIRI

protected String nextAnonymousIRI()
                           throws SAXException

Generates next anonymous IRI.

Throws:

SAXException

getIDNodeIDAboutResourceIRI

protected String getIDNodeIDAboutResourceIRI(Attributes atts)
                                      throws SAXException

Extracts the IRI of the resource from rdf:ID, rdf:nodeID or rdf:about attribute. If no attribute is found, an IRI is generated.

Throws:

SAXException

getNodeIDResourceResourceIRI

protected String getNodeIDResourceResourceIRI(Attributes atts)
                                       throws SAXException

Extracts the IRI of the resource from rdf:resource or rdf:nodeID attribute. If no attribute is found, null is returned.

Parameters:

atts - the attributes

Returns:

the IRI of the resource or null

Throws:

SAXException

statementWithResourceValue

protected void statementWithResourceValue(String subject,
                              String predicate,
                              String object,
                              String reificationID)
                                   throws SAXException

Called when a statement with resource value is added to the model.

Parameters:

subject - IRI of the subject resource

predicate - IRI of the predicate resource

object - IRI of the object resource

reificationID - if not null, contains IRI of the resource that will wold the reified statement

Throws:

SAXException

statementWithLiteralValue

protected void statementWithLiteralValue(String subject,
                             String predicate,
                             String object,
                             String dataType,
                             String reificationID)
                                  throws SAXException

Called when a statement with literal value is added to the model.

Parameters:

subject - IRI of the subject resource

predicate - IRI of the predicate resource

object - literal object value

dataType - the IRI of the literal's datatype (may be null)

reificationID - if not null, contains IRI of the resource that will wold the reified statement

Throws:

SAXException

propertyAttributes

protected void propertyAttributes(String subjectIRI,
                      Attributes atts,
                      RDFParser.ReificationManager reificationManager)
                           throws SAXException

Parses the propertyAttributes production.

Parameters:

subjectIRI - IRI of the resource whose properties are being parsed

atts - attributes

reificationManager - the reification manager

Throws:

SAXException

isWhitespaceOnly

protected boolean isWhitespaceOnly(char[] data,
                       int start,
                       int length)

Checks whether given characters contain only whitespace.

Parameters:

data - the data being checked

start - the start index (inclusive)

length - the end index (non-inclusive)

Returns:

true if characters contain whitespace

isWhitespaceOnly

protected boolean isWhitespaceOnly(StringBuilder buffer)

Checks whether given characters contain only whitespace.

Parameters:

buffer - the data being checked

Returns:

true if characters contain whitespace

getReificationManager

protected RDFParser.ReificationManager getReificationManager(Attributes atts)
                                                      throws SAXException

Returns the reification manager for given attributes.

Parameters:

atts - the attributes

Returns:

the reification manager

Throws:

SAXException

parseStringArguments

protected Map<String,String> parseStringArguments(String string)
                                           throws SAXException

Parses the string into a map of name-value pairs.

Parameters:

string - string to be parsed

Returns:

map of name-value pairs

Throws:

SAXException - if there was an IOException this will be wrapped in a parse exception

isAnonymousNodeIRI

public boolean isAnonymousNodeIRI(String uri)

Tests whether supplied IRI was generated by this parser in order to label an anonymous node.

Parameters:

uri - the IRI

Returns:

true if the IRI was generated by this parser to label an anonymous node

isAnonymousNodeID

public boolean isAnonymousNodeID(String iri)

getIRI

public IRI getIRI(String s)