com.hp.hpl.jena.rdf.arp
Class JenaReader

java.lang.Object
  com.hp.hpl.jena.rdf.arp.JenaReader

All Implemented Interfaces:

ARPErrorNumbers, RDFReader

public class JenaReader

extends java.lang.Object

implements RDFReader, ARPErrorNumbers

Interface between Jena and ARP.

Author:

jjc

Field Summary

Fields inherited from interface com.hp.hpl.jena.rdf.arp.ARPErrorNumbers

EM_ERROR, EM_FATAL, EM_IGNORE, EM_WARNING, ERR_ABOUTEACH_NOT_TOPLEVEL, ERR_BAD_RDF_ATTRIBUTE, ERR_BAD_RDF_ELEMENT, ERR_ENCODING_MISMATCH, ERR_INTERNAL_ERROR, ERR_LI_AS_TYPE, ERR_NOT_WHITESPACE, ERR_RESOLVING_URI_AGAINST_NULL_BASE, ERR_SAX_ERROR, ERR_SAX_FATAL_ERROR, ERR_STRING_NOT_NORMAL_FORM_C, ERR_SYNTAX_ERROR, ERR_UNABLE_TO_RECOVER, ERR_URI_NOT_NORMAL_FORM_C, IGN_DAML_COLLECTION, IGN_NO_BASE_URI_SPECIFIED, IGN_PRIVATE_XMLLANG, IGN_XMLBASE_SIGNIFICANT, IGN_XMLBASE_USED, WARN_BAD_NAME, WARN_BAD_NAMESPACE_URI, WARN_BAD_RDF_NAMESPACE_URI, WARN_BAD_XML, WARN_BAD_XML_NAMESPACE_URI, WARN_BAD_XMLLANG, WARN_DEPRECATED_XMLLANG, WARN_ENCODING_MISMATCH, WARN_IN_STRICT_MODE, WARN_LEGAL_REUSE_OF_ID, WARN_MALFORMED_URI, WARN_MALFORMED_XMLLANG, WARN_MINOR_INTERNAL_ERROR, WARN_PROCESSING_INSTRUCTION_IN_RDF, WARN_QNAME_AS_ID, WARN_RDF_NN_AS_TYPE, WARN_REDEFINITION_OF_ID, WARN_RELATIVE_NAMESPACE_URI_DEPRECATED, WARN_RESOLVING_URI_AGAINST_EMPTY_BASE, WARN_SAX_WARNING, WARN_STRING_COMPOSING_CHAR, WARN_UNKNOWN_PARSETYPE, WARN_UNKNOWN_RDF_ATTRIBUTE, WARN_UNKNOWN_RDF_ELEMENT, WARN_UNKNOWN_XML_ATTRIBUTE, WARN_UNQUALIFIED_ATTRIBUTE, WARN_UNQUALIFIED_ELEMENT, WARN_UNQUALIFIED_RDF_ATTRIBUTE, WARN_URI_COMPOSING_CHAR, WARN_XMLBASE_MISSING

Constructor Summary

JenaReader()
Creates new JenaReader

Method Summary

static int	errorCode(java.lang.String upper)
static java.lang.String	errorCodeName(int errNo)
static Model	memModel() Deprecated. This Reader is now the default.
void	read(Model model, java.io.InputStream in, java.lang.String xmlBase) Reads from inputStream, using base URI xmlbase, adding triples to model.
void	read(Model model, java.io.Reader reader, java.lang.String xmlBase) Reads from reader, using base URI xmlbase, adding triples to model.
void	read(Model model, java.lang.String url) Read serialized RDF from a url and add the statements to a model.
RDFErrorHandler	setErrorHandler(RDFErrorHandler errHandler) Change the error handler.
java.lang.Object	setProperty(java.lang.String str, java.lang.Object value) Change a property of the RDF or XML parser.
static Literal	translate(ALiteral lit) Deprecated. Should never have been public.
static Resource	translate(AResource r) Deprecated. Should never have been public.
static Property	translatePred(AResource r) Deprecated. Should never have been public.
static void	useMe(Model m) Sets the reader for the languages RDF/XML and RDF/XML-ABBREV to be JenaReader.

Methods inherited from class java.lang.Object

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

Constructor Detail

JenaReader

public JenaReader()

Creates new JenaReader

Method Detail

useMe

public static void useMe(Model m)

Sets the reader for the languages RDF/XML and RDF/XML-ABBREV to be JenaReader.

Parameters:

m - The Model on which to set the reader properties.

read

public void read(Model model,
                 java.lang.String url)
          throws com.hp.hpl.jena.shared.JenaException

Description copied from interface: RDFReader

Read serialized RDF from a url and add the statements to a model.

Specified by:

read in interface RDFReader

Parameters:

model - the model to which statements should be added

url - the url, as a string, from which the serialized RDF should be read.

Throws:

com.hp.hpl.jena.shared.JenaException

translate

public static Literal translate(ALiteral lit)

Deprecated. Should never have been public.

Converts an ARP literal into a Jena Literal.

Parameters:

lit - The ARP literal.

Returns:

The Jena Literal.

translate

public static Resource translate(AResource r)

Deprecated. Should never have been public.

Converts an ARP resource into a Jena resource.

Parameters:

r - The ARP resource.

Returns:

The Jena resource.

translatePred

public static Property translatePred(AResource r)
                              throws com.hp.hpl.jena.shared.JenaException

Deprecated. Should never have been public.

Converts an ARP resource into a Jena property.

Parameters:

r - The ARP resource.

Returns:

The Jena property.

Throws:

com.hp.hpl.jena.shared.JenaException - If r is anonymous, or similarly ill-formed.

read

public void read(Model model,
                 java.io.Reader reader,
                 java.lang.String xmlBase)
          throws com.hp.hpl.jena.shared.JenaException

Reads from reader, using base URI xmlbase, adding triples to model. If xmlbase is "" then relative URIs may be added to model.

Specified by:

read in interface RDFReader

Parameters:

model - A model to add triples to.

reader - The RDF/XML document.

xmlBase - The base URI of the document or "".

Throws:

com.hp.hpl.jena.shared.JenaException

read

public void read(Model model,
                 java.io.InputStream in,
                 java.lang.String xmlBase)
          throws com.hp.hpl.jena.shared.JenaException

Reads from inputStream, using base URI xmlbase, adding triples to model. If xmlbase is "" then relative URIs may be added to model.

Specified by:

read in interface RDFReader

Parameters:

model - A model to add triples to.

in - The RDF/XML document stream.

xmlBase - The base URI of the document or "".

Throws:

com.hp.hpl.jena.shared.JenaException

setErrorHandler

public RDFErrorHandler setErrorHandler(RDFErrorHandler errHandler)

Change the error handler.

Note that errors of class ParseException can be promoted using the ParseException.promote() method. See ARP documentation for ErrorHandler for the details of error promotion.

Specified by:

setErrorHandler in interface RDFReader

Parameters:

errHandler - The new error handler.

Returns:

The old error handler.

setProperty

public java.lang.Object setProperty(java.lang.String str,
                                    java.lang.Object value)
                             throws com.hp.hpl.jena.shared.JenaException

Change a property of the RDF or XML parser.

This method is untested.

I do not believe that many of the XML features or properties are in fact useful for ARP users. The ARP properties allow fine-grained control over error reporting.

This interface can be used to set and get:

SAX2 features

See Xerces features. Value should be given as a String "true" or "false" or a Boolean.

SAX2 properties

See Xerces properties.

Xerces features

See Xerces features. Value should be given as a String "true" or "false" or a Boolean.

Xerces properties

See Xerces properties.

ARP properties

These are referred to either by their property name, (see below) or by an absolute URL of the form http://jena.hpl.hp.com/arp/properties/<PropertyName>. The value should be a String, an Integer or a Boolean depending on the property.
ARP property names and string values are case insensitive.

ARP Properties

Property Name	Description	Value class	Legal Values
error-mode	ARP.setDefaultErrorMode() ARP.setLaxErrorMode() ARP.setStrictErrorMode() ARP.setStrictErrorMode(int)	String	default lax strict strict-ignore strict-warning strict-error strict-fatal
embedding	ARP.setEmbedding(boolean)	String or Boolean	true or false
ERR_<XXX> WARN_<XXX> IGN_<XXX>	ARPErrorNumbers Any of the error condition numbers listed. ARP.setErrorMode(int, int)	String or Integer	EM_IGNORE EM_WARNING EM_ERROR EM_FATAL

Specified by:

setProperty in interface RDFReader

Parameters:

str - The property to set.

value - The new value; values of class String will be converted into appropriate classes. Values of class Boolean or Integer will be used for appropriate properties.

Returns:

The old value, or null if none, or old value is inaccesible.

Throws:

com.hp.hpl.jena.shared.JenaException - For bad values.

errorCode

public static int errorCode(java.lang.String upper)

errorCodeName

public static java.lang.String errorCodeName(int errNo)

memModel

public static Model memModel()

Deprecated. This Reader is now the default.

Create a instance of ModelMem() and set it to use JenaReader as its default reader.

Returns:

A new in-memory Jena model.