|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.xml.sax.helpers.DefaultHandler
com.hp.hpl.jena.rdf.arp.SAX2RDFImpl
com.hp.hpl.jena.rdf.arp.SAX2RDF
public class SAX2RDF
Allows connecting an arbitrary source of SAX events with ARP.
For use with a DOM tree, see The Java Developer's Almanac for a discussion of how to transform a DOM into a source of SAX events.
The use pattern is to create and initialize one of these,
then set it as the content, lexical and error handler
for some source of SAX events (e.g. from a parser).
It must be configured to use namespaces, and namespace
prefixes. This initializing can be done for XMLReaders
using installHandlers(org.xml.sax.XMLReader, com.hp.hpl.jena.rdf.arp.XMLHandler)
.
Triples and errors are reported on a different thread. Do not expect synchronous behaviour between the SAX events and the triples or errors being generated.
This class does not support multithreaded SAX sources, nor IO interruption.
There is further documentation: here and here.
Field Summary |
---|
Fields inherited from interface com.hp.hpl.jena.rdf.arp.RDFParserConstants |
---|
A_ABOUT, A_DATATYPE, A_ID, A_NODEID, A_OTHER, A_PARSETYPE, A_RDF_N, A_RESOURCE, A_TYPE, A_XMLBASE, A_XMLLANG, A_XMLNS, A_XMLSPACE, AV_COLLECTION, AV_DAMLCOLLECTION, AV_LITERAL, AV_RESOURCE, AV_STRING, CD_STRING, COMMENT, E_DESCRIPTION, E_END, E_LI, E_OTHER, E_RDF, E_RDF_N, EOF, PROCESSING_INSTRUCTION, tokenImage, X_SAX_EX, X_WARNING |
Method Summary | |
---|---|
ARPHandlers |
getHandlers()
This is used when configuring a parser that is not loading into a Jena Model, but is processing the triples etc. in some other way. |
ARPOptions |
getOptions()
The options used during parsing. |
static void |
installHandlers(XMLReader rdr,
com.hp.hpl.jena.rdf.arp.XMLHandler sax2rdf)
Initializes an XMLReader to use the SAX2RDF object as its handler for all events, and to use namespaces and namespace prefixes. |
static SAX2RDF |
newInstance(String base)
Factory method to create a new SAX2RDF. |
static SAX2RDF |
newInstance(String base,
String lang)
Factory method to create a new SAX2RDF. |
void |
setDocumentLocator(Locator locator)
|
void |
setHandlersWith(ARPHandlers handlers)
This is used when configuring a parser that is not loading into a Jena Model, but is processing the triples etc. in some other way. |
void |
setOptionsWith(ARPOptions opts)
Copies the options from the argument to be used by this instance. |
void |
startPrefixMapping(String prefix,
String uri)
Begin the scope of a prefix-URI Namespace mapping. |
Methods inherited from class com.hp.hpl.jena.rdf.arp.SAX2RDFImpl |
---|
characters, comment, endCDATA, endDocument, endDTD, endElement, endEntity, endPrefixMapping, error, fatalError, ignorableWhitespace, processingInstruction, skippedEntity, startCDATA, startDocument, startDTD, startElement, startEntity, warning |
Methods inherited from class org.xml.sax.helpers.DefaultHandler |
---|
notationDecl, resolveEntity, unparsedEntityDecl |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface org.xml.sax.ContentHandler |
---|
setDocumentLocator |
Method Detail |
---|
public static SAX2RDF newInstance(String base) throws MalformedURIException
getHandlers()
or setHandlersWith(com.hp.hpl.jena.rdf.arp.ARPHandlers)
to provide
a StatementHandler
, and usually an ErrorHandler
base
- The retrieval URL, or the base URI to be
used while parsing.
MalformedURIException
public static SAX2RDF newInstance(String base, String lang) throws MalformedURIException
startPrefixMapping(java.lang.String, java.lang.String)
.
base
- The retrieval URL, or the base URI to be
used while parsing. Use
getHandlers()
or setHandlersWith(com.hp.hpl.jena.rdf.arp.ARPHandlers)
to provide
a StatementHandler
, and usually an ErrorHandler
lang
- The current value of xml:lang when parsing starts, usually "".
MalformedURIException
- If base is bad.public void startPrefixMapping(String prefix, String uri)
This is passed to any NamespaceHandler
associated
with this parser.
It can be called before the initial
SAX2RDFImpl.startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)
event, or other events associated
with the elements being processed.
When building a Jena Model, it is not required to match this
with corresponding SAX2RDFImpl.endPrefixMapping(java.lang.String)
events.
Other NamespaceHandler
s may be fussier.
When building a Jena Model, the prefix bindings are
remembered with the Model, and may be used in some
output routines. It is permitted to not call this method
for prefixes declared in the outer context, in which case,
any output routine will need to use a gensym for such
namespaces.
startPrefixMapping
in interface ContentHandler
startPrefixMapping
in class SAX2RDFImpl
prefix
- The Namespace prefix being declared.uri
- The Namespace URI the prefix is mapped to.public ARPHandlers getHandlers()
getHandlers
in interface ARPConfig
ARPConfig.getHandlers()
public void setHandlersWith(ARPHandlers handlers)
setHandlersWith
in interface ARPConfig
handlers
- The new values to use.ARPConfig.setHandlersWith(com.hp.hpl.jena.rdf.arp.ARPHandlers)
public ARPOptions getOptions()
ARPConfig
set..
methods
in ARPOptions
.
The options can be copied onto another ARP instance
using the ARPConfig.setOptionsWith(com.hp.hpl.jena.rdf.arp.ARPOptions)
method.
getOptions
in interface ARPConfig
ARPOptions.setDefaultErrorMode()
,
ARPOptions.setLaxErrorMode()
,
ARPOptions.setStrictErrorMode()
,
ARPOptions.setStrictErrorMode(int)
,
ARPOptions.setEmbedding(boolean)
,
ARPOptions.setErrorMode(int, int)
,
ARPConfig.setOptionsWith(com.hp.hpl.jena.rdf.arp.ARPOptions)
public void setOptionsWith(ARPOptions opts)
ARPConfig
ARPConfig.getOptions()
to retrieve this
instance's copy of the options.
setOptionsWith
in interface ARPConfig
opts
- The new values to use.public static void installHandlers(XMLReader rdr, com.hp.hpl.jena.rdf.arp.XMLHandler sax2rdf) throws SAXException
rdr
- The XMLReader to initialize.sax2rdf
- The SAX2RDF instance to use.
SAXException
public void setDocumentLocator(Locator locator)
setDocumentLocator
in interface ContentHandler
setDocumentLocator
in class DefaultHandler
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |