org.apache.clerezza.rdf.enrichment

Class Enricher

java.lang.Object

org.apache.clerezza.rdf.enrichment.Enricher

public abstract class Enricher
extends Object

use cases: - resources with a common eg:parent should be eg:sibling - for every foaf:Person there shall be a foaf:PersonalProfileDocument - every non literal resource shall be subject of rdf:type rdfs:Resource statemet - every eg:City shall have a eg:currentWeather property pointing to a bnode with temperature and humidity features: - pre-filter (filter filter): only filter matching resource-matcher are forwarded - on invocation with matching resource the Enricher knows which criteria matched

Author:

reto

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Enricher.ResourceFilter Filters resources of a TripleCollcetion

Field Summary

Fields

Modifier and Type	Field and Description
Enricher.ResourceFilter	acceptAll A filter accepting all resources

Constructor Summary

Constructors

Constructor and Description
Enricher()

Method Summary

Methods

Modifier and Type	Method and Description
protected BNode	createLocalBNode()
abstract Iterator<Triple>	filter(NonLiteral subject, UriRef predicate, Resource object, TripleCollection base) returns the additional triples to a specified base graph.
protected Iterator<Triple>	filterIterator(NonLiteral subject, UriRef predicate, Resource object, Iterator<Triple> baseIter) utility method to filter an iterator
protected static Enricher.ResourceFilter	getDataTypeFilter(UriRef dataType)
protected static Enricher.ResourceFilter	getExtensionalFilter(Resource... resources) creates a resource filters that matches only the specified resource
protected static Enricher.ResourceFilter	getFilterForSubjectsWith(UriRef predicate, Resource object)
protected static Enricher.ResourceFilter	getFilterForSubjectsWithProperty(UriRef predicate)
protected Enricher.ResourceFilter	getLocalBNodeFilter()
Enricher.ResourceFilter	getObjectFilter() The filter method of this enricher shall only be invoked with objects matching the Filter returned by this method
Enricher.ResourceFilter	getPredicateFilter() The filter method of this enricher shall only be invoked with predicates matching the Filter returned by this method
Enricher.ResourceFilter	getSubjectFilter() The filter method of this enricher shall only be invoked with subjects matching the Filter returned by this method
abstract int	providedTriplesCount(TripleCollection base) returns the number of enrichment triples for base

Methods inherited from class java.lang.Object

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

Field Detail

acceptAll

public Enricher.ResourceFilter acceptAll

A filter accepting all resources

Constructor Detail

Enricher

public Enricher()

Method Detail

filter

public abstract Iterator<Triple> filter(NonLiteral subject,
                      UriRef predicate,
                      Resource object,
                      TripleCollection base)

returns the additional triples to a specified base graph. This method is only invoked with resources matching the respective Filter.

Parameters:

subject -

predicate -

object -

base -

Returns:

providedTriplesCount

public abstract int providedTriplesCount(TripleCollection base)

returns the number of enrichment triples for base

Parameters:

base - the triplecollection for which enrichment triples are generated

Returns:

the number of triples

getSubjectFilter

public Enricher.ResourceFilter getSubjectFilter()

The filter method of this enricher shall only be invoked with subjects matching the Filter returned by this method

Returns:

getPredicateFilter

public Enricher.ResourceFilter getPredicateFilter()

The filter method of this enricher shall only be invoked with predicates matching the Filter returned by this method

Returns:

getObjectFilter

public Enricher.ResourceFilter getObjectFilter()

The filter method of this enricher shall only be invoked with objects matching the Filter returned by this method

Returns:

getFilterForSubjectsWithProperty

protected static Enricher.ResourceFilter getFilterForSubjectsWithProperty(UriRef predicate)

Parameters:

predicate -

Returns:

a filter accepting all resources that are the subject of a statement with the specified predicate

getFilterForSubjectsWith

protected static Enricher.ResourceFilter getFilterForSubjectsWith(UriRef predicate,
                                               Resource object)

Returns:

a filter accepting all resources that are the subject of a statement with the specified predicate and object

getExtensionalFilter

protected static Enricher.ResourceFilter getExtensionalFilter(Resource... resources)

creates a resource filters that matches only the specified resource

Parameters:

resources -

Returns:

getDataTypeFilter

protected static Enricher.ResourceFilter getDataTypeFilter(UriRef dataType)

Parameters:

dataType -

Returns:

a filter accepting only typed literals of dataType

createLocalBNode

protected BNode createLocalBNode()

Returns:

a Bnode that will be accepted by localBNodeFilter

getLocalBNodeFilter

protected Enricher.ResourceFilter getLocalBNodeFilter()

Returns:

localBNodeFilter a filter matching exclusively BNodes created by the createLocalBNode method of the same instance

filterIterator

protected Iterator<Triple> filterIterator(NonLiteral subject,
                              UriRef predicate,
                              Resource object,
                              Iterator<Triple> baseIter)

utility method to filter an iterator

Returns:

an iterator with the triples baseIter matching the specified subject, predicate and object where this are not null