org.apache.jena.iri
Interface IRIFactoryI

All Known Implementing Classes:

AbsIRIFactoryImpl, AbsIRIImpl, IRI, IRIFactory, IRIFactoryImpl, IRIImpl, ResolvedRelativeIRI

public interface IRIFactoryI

This interface is used for making new IRI objects. It is used for making IRIs in two ways:

1. Without resolving against a base (by the class IRIFactory).
2. By resolving against a base (by the interface IRI).

Which properties of the IRIs result in errors or warnings is determined by the current settings of the underlying IRIFactory, which is the factory object being used in the first case, or the factory object used to create the base IRI in the second case.

Author:

Jeremy J. Carroll

Method Summary

IRI	construct(IRI i) Make a new IRI object (possibly including IRI resolution), and check it for violations of the standards being enforced by the factory.
IRI	construct(String s) Make a new IRI object (possibly including IRI resolution), and check it for violations of the standards being enforced by the factory.
IRI	create(IRI i) Make a new IRI object (possibly including IRI resolution), and check it for violations of the standards being enforced by the factory.
IRI	create(String s) Make a new IRI object (possibly including IRI resolution), and check it for violations of the standards being enforced by the factory.

Method Detail

construct

IRI construct(IRI i)
              throws IRIException

Make a new IRI object (possibly including IRI resolution), and check it for violations of the standards being enforced by the factory. This method both allows IRI resolution against a base, and for creating a new IRI using a different factory, with different conformance settings, implementing a different URI or IRI standard, or variant thereof.

Parameters:

i - The IRI to use.

Returns:

A new IRI object.

Throws:

IRIException - If a violation of the standards being enforced by the factory has been detected, and this violation is classified by the factory as an error.

construct

IRI construct(String s)
              throws IRIException

Make a new IRI object (possibly including IRI resolution), and check it for violations of the standards being enforced by the factory.

Parameters:

s - The IRI to use.

Returns:

A new IRI object.

Throws:

IRIException - If a violation of the standards being enforced by the factory has been detected, and this violation is classified by the factory as an error.

create

IRI create(IRI i)

Make a new IRI object (possibly including IRI resolution), and check it for violations of the standards being enforced by the factory. This method both allows IRI resolution against a base, and for creating a new IRI using a different factory, with different conformance settings, implementing a different URI or IRI standard, or variant thereof. This method does not throw exceptions, but records all errors and warnings found to be queried later using IRI.hasViolation(boolean) and IRI.violations(boolean).

Parameters:

i - The IRI to use.

Returns:

A new IRI object.

create

IRI create(String s)

Make a new IRI object (possibly including IRI resolution), and check it for violations of the standards being enforced by the factory. This method does not throw exceptions, but records all errors and warnings found to be queried later using IRI.hasViolation(boolean) and IRI.violations(boolean).

Parameters:

s - The IRI to use.

Returns:

A new IRI object.