org.apache.jena.riot.system

Class IRIResolver

java.lang.Object

org.apache.jena.riot.system.IRIResolver

public abstract class IRIResolver
extends Object

IRI handling

Method Summary

Modifier and Type	Method and Description
static boolean	checkIRI(String iriStr) Check an IRI string (does not resolve it)
static org.apache.jena.iri.IRI	chooseBaseURI() Choose a base URI based on the current directory
static IRIResolver	create()
static IRIResolver	create(org.apache.jena.iri.IRI baseIRI)
static IRIResolver	create(String baseStr)
static IRIResolver	createNoResolve() A resolver that does not resolv against a base IRI.
String	getBaseIRIasString()
static org.apache.jena.iri.IRIFactory	iriFactory() The IRI checker setup, focused on parsing and languages.
static org.apache.jena.iri.IRI	parseIRI(String iriStr) Parse an IRI (does not resolve it)
static org.apache.jena.iri.IRI	parseIRIex(String iriStr) Parse an IRI (does not resolve it) - throws exception on a bad IRI
org.apache.jena.iri.IRI	resolve(String uriStr) Resolve a relative URI against the base of this IRIResolver or normalize an absolute URI.
static org.apache.jena.iri.IRI	resolve(String relStr, String baseStr) Resolve a URI against a base.
static String	resolveFileURL(String filename) Turn a filename into a well-formed file: URL relative to the working directory.
static org.apache.jena.iri.IRI	resolveIRI(String uriStr) Resolve an IRI against whatever is the base for this process (likely to be based on the current working directory of this process at the time of initialization of this class).
abstract org.apache.jena.iri.IRI	resolveSilent(String uriStr) Create a URI, resolving relative IRIs, normalize an absolute URI, but do not throw exception on a bad IRI.
static String	resolveString(String uriStr) Resolve a URI against the base for this process.
static String	resolveString(String relStr, String baseStr) Resolve a URI against a base.
static String	resolveStringSilent(String uriStr) Resolve a URI against a base.
String	resolveToString(String uriStr) Resolving relative IRIs, return a string
String	resolveToStringSilent(String uriStr) Resolving relative IRIs, return a string, but do not throw exception on bad a IRI
static void	suppressExceptions() To allow Eyeball to bypass IRI checking (because it's doing its own)
static void	validateIRI(String iriStr) Check an IRI string (does not resolve it) - throw exception if not good

Methods inherited from class java.lang.Object

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

Method Detail

iriFactory

public static org.apache.jena.iri.IRIFactory iriFactory()

The IRI checker setup, focused on parsing and languages. This is a clean version of jena-iri IRIFactory.iriImplementation() modified to allow unregistered schemes and allow <file:relative> IRIs.

See Also:

IRIFactory

checkIRI

public static boolean checkIRI(String iriStr)

Check an IRI string (does not resolve it)

validateIRI

public static void validateIRI(String iriStr)
                        throws org.apache.jena.iri.IRIException

Check an IRI string (does not resolve it) - throw exception if not good

Throws:

org.apache.jena.iri.IRIException

parseIRI

public static org.apache.jena.iri.IRI parseIRI(String iriStr)

Parse an IRI (does not resolve it)

parseIRIex

public static org.apache.jena.iri.IRI parseIRIex(String iriStr)
                                          throws org.apache.jena.iri.IRIException

Parse an IRI (does not resolve it) - throws exception on a bad IRI

Throws:

org.apache.jena.iri.IRIException

resolveFileURL

public static String resolveFileURL(String filename)
                             throws org.apache.jena.iri.IRIException

Turn a filename into a well-formed file: URL relative to the working directory.

Parameters:

filename -

Returns:

String The filename as an absolute URL

Throws:

org.apache.jena.iri.IRIException

resolve

public static org.apache.jena.iri.IRI resolve(String relStr,
                                              String baseStr)
                                       throws RiotException

Resolve a URI against a base. If baseStr is a relative file IRI then it is first resolved against the current working directory.

Parameters:

relStr -

baseStr - Can be null if relStr is absolute

Returns:

An absolute URI

Throws:

RiotException - If result would not be legal, absolute IRI

resolveString

public static String resolveString(String relStr,
                                   String baseStr)
                            throws RiotException

Resolve a URI against a base.

Parameters:

relStr -

baseStr - Can be null if relStr is absolute

Returns:

String An absolute URI

Throws:

RiotException - If result would not be legal, absolute IRI

resolveString

public static String resolveString(String uriStr)
                            throws RiotException

Resolve a URI against the base for this process. If baseStr is a relative file IRI then it is first resolved against the current working directory. If it is an absolute URI, it is normalized.

Parameters:

uriStr -

Returns:

String An absolute URI

Throws:

RiotException - If result would not be legal, absolute IRI

resolveStringSilent

public static String resolveStringSilent(String uriStr)
                                  throws RiotException

Resolve a URI against a base. If baseStr is a relative file IRI then it is first resolved against the current working directory. If it is an absolute URI, it is normalized.

Parameters:

uriStr -

Returns:

String An absolute URI

Throws:

RiotException

resolveIRI

public static org.apache.jena.iri.IRI resolveIRI(String uriStr)

Resolve an IRI against whatever is the base for this process (likely to be based on the current working directory of this process at the time of initialization of this class).

create

public static IRIResolver create()

create

public static IRIResolver create(String baseStr)

create

public static IRIResolver create(org.apache.jena.iri.IRI baseIRI)

createNoResolve

public static IRIResolver createNoResolve()

A resolver that does not resolv against a base IRI.

suppressExceptions

public static void suppressExceptions()

To allow Eyeball to bypass IRI checking (because it's doing its own)

chooseBaseURI

public static org.apache.jena.iri.IRI chooseBaseURI()

Choose a base URI based on the current directory

Returns:

String Absolute URI

getBaseIRIasString

public String getBaseIRIasString()

resolve

public org.apache.jena.iri.IRI resolve(String uriStr)

Resolve a relative URI against the base of this IRIResolver or normalize an absolute URI.

Parameters:

uriStr -

Returns:

the resolved IRI

Throws:

RiotException - If resulting URI would not be legal, absolute IRI

resolveSilent

public abstract org.apache.jena.iri.IRI resolveSilent(String uriStr)

Create a URI, resolving relative IRIs, normalize an absolute URI, but do not throw exception on a bad IRI.

Parameters:

uriStr -

Returns:

the resolved IRI

Throws:

RiotException - If resulting URI would not be legal, absolute IRI

resolveToString

public String resolveToString(String uriStr)

Resolving relative IRIs, return a string

resolveToStringSilent

public String resolveToStringSilent(String uriStr)

Resolving relative IRIs, return a string, but do not throw exception on bad a IRI