Package com.github.owlcs.ontapi

Class OWLFactoryWrapper

java.lang.Object

com.github.owlcs.ontapi.OWLFactoryWrapper

All Implemented Interfaces:

OntologyFactory.Loader, OntologyLoader, Serializable

@ParametersAreNonnullByDefault
public class OWLFactoryWrapper
extends Object
implements OntologyFactory.Loader

An implementation of OntologyLoader which is actually OWLOntologyFactory decorator. Used to load ontology through pure OWL-API mechanisms (i.e. owl-api parsers). Some formats (such as ManchesterSyntaxDocumentFormat or FunctionalSyntaxDocumentFormat) are not supported by Jena, so this is the only way to handle them by ONT-API.

See Also:

• OntologyLoaderImpl
• LoadSettings.isUseOWLParsersToLoad()
• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OWLFactoryWrapper.AcceptHeaderBuilder	A copy-pasted OWL-API-impl utility class.
static class	OWLFactoryWrapper.FactoryImpl	This is a copy-paste the original OWL-API OWLOntologyFactory implementation, which is used if syntax format of source can not be handled by Apache Jena.

Field Summary

Fields

Modifier and Type	Field	Description
protected final Set<org.semanticweb.owlapi.model.IRI>	sources

Constructor Summary

Constructors

Constructor	Description
OWLFactoryWrapper()

Method Summary

Modifier and Type	Method	Description
OntologyFactory	asOntologyFactory(OntologyCreator builder)	Represents this loader as an ontology factory.
void	clear()	Release the state parameters that can appear during the load.
static OntologyBuilderImpl	createLoadingBuilder(OntologyCreator base)	Creates a builder that is optimized for load operations occurring through native (OWL-API) parsers.
OWLAdapter	getAdapter()
Ontology	loadOntology(OntologyCreator builder, OntologyManager manager, org.semanticweb.owlapi.io.OWLOntologyDocumentSource source, OntLoaderConfiguration conf)	This method loads an ontology model from the given document source into the manarer according to the configuration settings.
OntLoaderConfiguration	optimize(OntLoaderConfiguration config)	Optimizes the given configuration to interact with native OWL-API parsers.
OntologyCreator	optimize(OntologyCreator builder)	Optimizes the given builder to interact with native OWL-API parsers.

Methods inherited from class java.lang.Object

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

Field Details

sources

protected final Set<org.semanticweb.owlapi.model.IRI> sources

Constructor Details

OWLFactoryWrapper

public OWLFactoryWrapper()

Method Details

getAdapter

public OWLAdapter getAdapter()

asOntologyFactory

public OntologyFactory asOntologyFactory(OntologyCreator builder)

Represents this loader as an ontology factory.

Specified by:

asOntologyFactory in interface OntologyFactory.Loader

Parameters:

builder - OntologyCreator

Returns:

OntologyFactory

clear

public void clear()

Release the state parameters that can appear during the load.

See Also:

• OntologyLoaderImpl.clear()

optimize

public OntologyCreator optimize(OntologyCreator builder)

Optimizes the given builder to interact with native OWL-API parsers.

Parameters:

builder - OntologyCreator, not null

Returns:

OntologyCreator

Since:

1.4.2

optimize

public OntLoaderConfiguration optimize(OntLoaderConfiguration config)

Optimizes the given configuration to interact with native OWL-API parsers.

Impl notes: Here, the nodes cache (i.e. SearchModel) is disabled, since:

• 1) read operations (list axioms, annotations) are not expected during assembly model
• 2) if these operations do occur, they may lead to exception, if incomplete information has been cached (for example, cache entity when there is still no declaration axiom)

Iterator cache is also disabled (just in case): no repeating axioms listing operations are expected.

Parameters:

config - OntLoaderConfiguration, not null

Returns:

OntLoaderConfiguration

Since:

1.4.2

loadOntology

public Ontology loadOntology(OntologyCreator builder,
 OntologyManager manager,
 org.semanticweb.owlapi.io.OWLOntologyDocumentSource source,
 OntLoaderConfiguration conf)
                      throws org.semanticweb.owlapi.model.OWLOntologyCreationException

This method loads an ontology model from the given document source into the manarer according to the configuration settings. If the document source corresponds an ontology that has imports, these all imports are also treated as sources, and subsequently populated in the manager as ontologies. To handle correctly an IRI document sources, the manager's IRI Mapper and Graph Mapper are used. In case of any error the manager state should not be change.

Specified by:

loadOntology in interface OntologyLoader

Parameters:

builder - OntologyCreator to construct a fresh Ontology instance

manager - OntologyManager

source - OWLOntologyDocumentSource

conf - OntLoaderConfiguration

Returns:

an ontology inside manager

Throws:

OntologyFactoryImpl.BadRecursionException - if recursion occurs (the situation looks like cohesion/coupling issue in OWL-API: a manager uses a factory which uses the manager in its turn)

org.semanticweb.owlapi.model.OWLOntologyCreationException - if any other problem occurs

See Also:

• OWLOntologyIRIMapper
• OntologyManager.DocumentSourceMapping

createLoadingBuilder

public static OntologyBuilderImpl createLoadingBuilder(OntologyCreator base)

Creates a builder that is optimized for load operations occurring through native (OWL-API) parsers.

Parameters:

base - OntologyCreator, the builder to inherit behaviour, not null

Returns:

OntologyBuilderImpl

Since:

1.4.2