de.sekmi.histream.ontology.skos

Class Store

java.lang.Object

de.sekmi.histream.ontology.skos.Store

All Implemented Interfaces:

Ontology, Plugin, Closeable, AutoCloseable

public class Store
extends Object
implements Ontology, Plugin

Constructor Summary

Constructors

Constructor and Description
Store(File file)
Store(Iterable<File> files, String baseURI)
Store(Iterable<URL> urls)
Store(List<File> files, String baseURI, String scheme) Initialise the SKOS ontology with the specified files.
Store(Map<String,String> conf) Plugin constructor which accepts configuration parameters.

Method Summary

Modifier and Type	Method and Description
void	close()
protected void	forEachObject(org.openrdf.model.Resource subject, org.openrdf.model.URI predicate, Consumer<org.openrdf.model.Value> consumer)
void	forEachRDFListItem(org.openrdf.model.Resource rdfList, Consumer<org.openrdf.model.Value> consumer)
protected void	forEachStatement(org.openrdf.model.Resource subject, org.openrdf.model.URI predicate, Consumer<org.openrdf.model.Statement> consumer)
Concept	getConceptById(String id)
ConceptImpl	getConceptByNotation(String id)
ConceptImpl	getConceptByNotation(String notation, org.openrdf.model.URI conceptScheme) Find a concept by notation and concept scheme.
TransformationRules	getConceptTransformations(String notation, String schemaURI) Retrieve transformation rules for the concept identified by the given notation (restricted to a schema) TODO move method to ConceptImpl
org.openrdf.repository.RepositoryConnection	getConnection()
Concept[]	getTopConcepts()
Concept[]	getTopConcepts(String scheme)
protected int	inferInverseRelations(org.openrdf.model.URI predicate, org.openrdf.model.URI inversePredicate) Infer inverse relations.
long	lastModified()
void	printConceptHierarchy()
void	printTopConcepts()
void	setConceptScheme(String schemeURI)

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.sekmi.histream.Plugin

newInstance

Constructor Detail

Store

public Store(Map<String,String> conf)
      throws org.openrdf.repository.RepositoryException,
             IOException

Plugin constructor which accepts configuration parameters.

Configuration keys have the form rdf.baseURI, rdf.file.1, rdf.format.1. rdf.file is mandatory, other parameters are optional.

rdf.baseURI specifies a URI to resolve any relative URIs that are in the data against. See Store(Iterable, String).

rdf.skosScheme can specify the skos:ConceptScheme to find top concepts and unique notations

Parameters:

conf - configuration parameters

Throws:

FileNotFoundException - if one of the specified files can not be found

IOException - for i/o exceptions while reading the files

org.openrdf.repository.RepositoryException - for any other exceptions during ontology initialisation

Store

public Store(List<File> files,
             String baseURI,
             String scheme)
      throws org.openrdf.repository.RepositoryException,
             IOException

Initialise the SKOS ontology with the specified files.

Parameters:

files - TURTLE RDF files

baseURI - base URI to resolve relative URIs within the RDF files. can be null.

scheme - SKOS scheme URI to find top concepts and unique notations. Can be null.

Throws:

org.openrdf.repository.RepositoryException - repository errors

IOException - failure to read the specified files

Store

public Store(Iterable<File> files,
             String baseURI)
      throws org.openrdf.repository.RepositoryException,
             IOException

Throws:

org.openrdf.repository.RepositoryException

IOException

Store

public Store(Iterable<URL> urls)
      throws org.openrdf.repository.RepositoryException,
             IOException

Throws:

org.openrdf.repository.RepositoryException

IOException

Store

public Store(File file)
      throws org.openrdf.repository.RepositoryException,
             IOException

Throws:

org.openrdf.repository.RepositoryException

IOException

Method Detail

inferInverseRelations

protected int inferInverseRelations(org.openrdf.model.URI predicate,
                                    org.openrdf.model.URI inversePredicate)
                             throws org.openrdf.repository.RepositoryException

Infer inverse relations. The first predicate is searched. For each found statement the inverse predicate is added if it didn't exist previously.

Parameters:

predicate - predicate to search (use the less common one)

inversePredicate - inverse predicate to add

Returns:

number of inferred statements

Throws:

org.openrdf.repository.RepositoryException - error

setConceptScheme

public void setConceptScheme(String schemeURI)

getConnection

public org.openrdf.repository.RepositoryConnection getConnection()

getTopConcepts

public Concept[] getTopConcepts()
                         throws OntologyException

Specified by:

getTopConcepts in interface Ontology

Throws:

OntologyException

getTopConcepts

public Concept[] getTopConcepts(String scheme)
                         throws OntologyException

Specified by:

getTopConcepts in interface Ontology

Throws:

OntologyException

printTopConcepts

public void printTopConcepts()
                      throws OntologyException

Throws:

OntologyException

printConceptHierarchy

public void printConceptHierarchy()
                           throws OntologyException

Throws:

OntologyException

getConceptByNotation

public ConceptImpl getConceptByNotation(String id)
                                 throws OntologyException

Specified by:

getConceptByNotation in interface Ontology

Throws:

OntologyException

getConceptByNotation

public ConceptImpl getConceptByNotation(String notation,
                                        org.openrdf.model.URI conceptScheme)
                                 throws org.openrdf.repository.RepositoryException

Find a concept by notation and concept scheme.

If null is specified for the scheme, any concept with the specified notation is returned - regardless of scheme.

Parameters:

notation - notation to find

conceptScheme - scheme for the concept or null

Returns:

concept

Throws:

org.openrdf.repository.RepositoryException - for repository errors

close

public void close()
           throws IOException

Specified by:

close in interface Plugin

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

lastModified

public long lastModified()

Specified by:

lastModified in interface Ontology

forEachStatement

protected void forEachStatement(org.openrdf.model.Resource subject,
                                org.openrdf.model.URI predicate,
                                Consumer<org.openrdf.model.Statement> consumer)
                         throws org.openrdf.repository.RepositoryException

Throws:

org.openrdf.repository.RepositoryException

forEachObject

protected void forEachObject(org.openrdf.model.Resource subject,
                             org.openrdf.model.URI predicate,
                             Consumer<org.openrdf.model.Value> consumer)
                      throws org.openrdf.repository.RepositoryException

Throws:

org.openrdf.repository.RepositoryException

getConceptTransformations

public TransformationRules getConceptTransformations(String notation,
                                                     String schemaURI)
                                              throws OntologyException

Retrieve transformation rules for the concept identified by the given notation (restricted to a schema) TODO move method to ConceptImpl

Parameters:

notation - notation for the concept

schemaURI - schema in which to search for the notation. can be null

Returns:

transformation rules or null if there are no rules

Throws:

OntologyException - for ontology errors

forEachRDFListItem

public void forEachRDFListItem(org.openrdf.model.Resource rdfList,
                               Consumer<org.openrdf.model.Value> consumer)
                        throws org.openrdf.repository.RepositoryException

Throws:

org.openrdf.repository.RepositoryException

getConceptById

public Concept getConceptById(String id)
                       throws OntologyException

Specified by:

getConceptById in interface Ontology

Throws:

OntologyException