org.semanticweb.owlapi.util

Class AutoIRIMapper

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.semanticweb.owlapi.util.AutoIRIMapper

All Implemented Interfaces:

Serializable, OWLOntologyIRIMapper, ContentHandler, DTDHandler, EntityResolver, ErrorHandler

@HasPriority(value=1.0)
public class AutoIRIMapper
extends DefaultHandler
implements OWLOntologyIRIMapper, Serializable

A mapper which given a root folder attempts to automatically discover and map files to ontologies. The mapper is only capable of mapping ontologies in RDF/XML and OWL/XML (other serialisations are not supported).

Since:

2.0.0

Author:

Matthew Horridge, The University Of Manchester, Bio-Health Informatics Group

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AutoIRIMapper(File rootDirectory, boolean recursive) Creates an auto-mapper which examines ontologies that reside in the specified root folder (and possibly sub-folders).

Method Summary

Modifier and Type	Method and Description
IRI	getDocumentIRI(IRI ontologyIRI) Given an ontology IRI, this method maps the ontology IRI to a document IRI.
Set<String>	getFileExtensions() The mapper only examines files that have specified file extensions.
Set<IRI>	getOntologyIRIs() Gets the set of ontology IRIs that this mapper has found.
void	setFileExtensions(Collection<String> extensions) Sets the extensions of files that are to be examined for ontological content.
void	startElement(String uri, String localName, String qName, Attributes attributes)
String	toString()
void	update() update the map.

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

characters, endDocument, endElement, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startDocument, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

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

Constructor Detail

AutoIRIMapper

public AutoIRIMapper(File rootDirectory,
                     boolean recursive)

Creates an auto-mapper which examines ontologies that reside in the specified root folder (and possibly sub-folders).

Parameters:

rootDirectory - The root directory which should be searched for ontologies.

recursive - Sub directories will be searched recursively if true.

Method Detail

getFileExtensions

public Set<String> getFileExtensions()

The mapper only examines files that have specified file extensions. This method returns the file extensions that cause a file to be examined.

Returns:

A Set of file extensions.

setFileExtensions

public void setFileExtensions(Collection<String> extensions)

Sets the extensions of files that are to be examined for ontological content. (By default the extensions are, owl, xml and rdf). Only files that have the specified extensions will be examined to see if they contain ontologies.

Parameters:

extensions - the set of extensions

getOntologyIRIs

public Set<IRI> getOntologyIRIs()

Gets the set of ontology IRIs that this mapper has found.

Returns:

A Set of ontology (logical) URIs

update

public void update()

update the map.

getDocumentIRI

@Nullable
public IRI getDocumentIRI(IRI ontologyIRI)

Description copied from interface: OWLOntologyIRIMapper

Given an ontology IRI, this method maps the ontology IRI to a document IRI.

Specified by:

getDocumentIRI in interface OWLOntologyIRIMapper

Parameters:

ontologyIRI - The ontology IRI to be mapped.

Returns:

The document IRI of the ontology, or null if the mapper doesn't have mapping for the specified ontology IRI.

startElement

public void startElement(@Nullable
                         String uri,
                         @Nullable
                         String localName,
                         @Nullable
                         String qName,
                         @Nullable
                         Attributes attributes)
                  throws SAXException

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class DefaultHandler

Throws:

SAXException

toString

public String toString()

Overrides:

toString in class Object