com.github.anno4j.querying

Class QueryService<T extends Annotation>

java.lang.Object

com.github.anno4j.querying.QueryService<T>

Type Parameters:

T -

public class QueryService<T extends Annotation>
extends Object

The QueryService allows to query the MICO triple stores by using criteria. Furthermore this is provided by simple classes. This is why the user does not need to write SPARQL queries by himself.

Author:

Andreas Eisenkolb

Constructor Summary

Constructors

Constructor and Description
QueryService(Class<T> type, org.openrdf.repository.object.ObjectRepository objectRepository)

Method Summary

Modifier and Type	Method and Description
QueryService	addPrefix(String label, String url) Setting shortcut names for URI prefixes.
QueryService	addPrefixes(HashMap<String,String> prefixes) Setting multiple names for URI prefixes.
<T> List<T>	execute() Creates and executes the SPARQL query according to the criteria specified by the user.
QueryService	limit(Integer limit) Setting the limit value.
QueryService	offset(Integer offset) Setting the offset value.
QueryService	orderBy(Order order) Defines the ordering of the result set.
QueryService	setAnnotationCriteria(String ldpath) Setting a criteria for filtering eu.mico.platform.persistence.impl.AnnotationImpl objects.
QueryService	setAnnotationCriteria(String ldpath, Number value) Setting a criteria for filtering eu.mico.platform.persistence.impl.AnnotationImpl objects.
QueryService	setAnnotationCriteria(String ldpath, Number value, Comparison comparison) Setting a criteria for filtering eu.mico.platform.persistence.impl.AnnotationImpl objects.
QueryService	setAnnotationCriteria(String ldpath, String value) Setting a criteria for filtering eu.mico.platform.persistence.impl.AnnotationImpl objects.
QueryService	setAnnotationCriteria(String ldpath, String value, Comparison comparison) Setting a criteria for filtering eu.mico.platform.persistence.impl.AnnotationImpl objects.
QueryService	setBodyCriteria(String ldpath) Setting a criteria for filtering eu.mico.platform.persistence.impl.BodyImpl.* objects.
QueryService	setBodyCriteria(String ldpath, Number value) Setting a criteria for filtering eu.mico.platform.persistence.impl.BodyImpl.* objects.
QueryService	setBodyCriteria(String ldpath, Number value, Comparison comparison) Setting a criteria for filtering eu.mico.platform.persistence.impl.BodyImpl.* objects.
QueryService	setBodyCriteria(String ldpath, String value) Setting a criteria for filtering eu.mico.platform.persistence.impl.BodyImpl.* objects.
QueryService	setBodyCriteria(String ldpath, String value, Comparison comparison) Setting a criteria for filtering eu.mico.platform.persistence.impl.BodyImpl.* objects.
QueryService	setSelectorCriteria(String ldpath) Setting a criteria for filtering eu.mico.platform.persistence.impl.SelectorImpl.* objects.
QueryService	setSelectorCriteria(String ldpath, Number value) Setting a criteria for filtering eu.mico.platform.persistence.impl.SelectorImpl.* objects.
QueryService	setSelectorCriteria(String ldpath, Number value, Comparison comparison) Setting a criteria for filtering eu.mico.platform.persistence.impl.SelectorImpl.* objects.
QueryService	setSelectorCriteria(String ldpath, String value) Setting a criteria for filtering eu.mico.platform.persistence.impl.SelectorImpl.* objects.
QueryService	setSelectorCriteria(String ldpath, String value, Comparison comparison) Setting a criteria for filtering eu.mico.platform.persistence.impl.SelectorImpl.* objects.
QueryService	setSourceCriteria(String ldpath)
QueryService	setSourceCriteria(String ldpath, Number value)
QueryService	setSourceCriteria(String ldpath, Number value, Comparison comparison)
QueryService	setSourceCriteria(String ldpath, String value)
QueryService	setSourceCriteria(String ldpath, String value, Comparison comparison)

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryService

public QueryService(Class<T> type,
                    org.openrdf.repository.object.ObjectRepository objectRepository)

Method Detail

setBodyCriteria

public QueryService setBodyCriteria(String ldpath,
                                    String value,
                                    Comparison comparison)

Setting a criteria for filtering eu.mico.platform.persistence.impl.BodyImpl.* objects.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Body object

comparison - The comparison mode, e.g. Comparison.EQ (=)

value - The constraint value

Returns:

itself to allow chaining.

setBodyCriteria

public QueryService setBodyCriteria(String ldpath,
                                    Number value,
                                    Comparison comparison)

Setting a criteria for filtering eu.mico.platform.persistence.impl.BodyImpl.* objects.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Body object

comparison - The comparison mode, e.g. Comparison.EQ (=)

value - The constraint value

Returns:

itself to allow chaining.

setBodyCriteria

public QueryService setBodyCriteria(String ldpath,
                                    String value)

Setting a criteria for filtering eu.mico.platform.persistence.impl.BodyImpl.* objects. Compared to the other setBodyCriteria function, this function does not need a Comparison statement. Hence, the Comparison.EQ statement ("=") will be used automatically.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Body object

value - The constraint value

Returns:

itself to allow chaining.

setBodyCriteria

public QueryService setBodyCriteria(String ldpath,
                                    Number value)

Setting a criteria for filtering eu.mico.platform.persistence.impl.BodyImpl.* objects. Compared to the other setBodyCriteria function, this function does not need a Comparison statement. Hence, the Comparison.EQ statement ("=") will be used automatically.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Body object

value - The constraint value

Returns:

itself to allow chaining.

setBodyCriteria

public QueryService setBodyCriteria(String ldpath)

Setting a criteria for filtering eu.mico.platform.persistence.impl.BodyImpl.* objects.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Body object

Returns:

itself to allow chaining.

setAnnotationCriteria

public QueryService setAnnotationCriteria(String ldpath,
                                          String value,
                                          Comparison comparison)

Setting a criteria for filtering eu.mico.platform.persistence.impl.AnnotationImpl objects.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Annotation object

comparison - The comparison mode, e.g. Comparison.EQ (=)

value - The constraint value

Returns:

itself to allow chaining.

setAnnotationCriteria

public QueryService setAnnotationCriteria(String ldpath,
                                          Number value,
                                          Comparison comparison)

Setting a criteria for filtering eu.mico.platform.persistence.impl.AnnotationImpl objects.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Annotation object

comparison - The comparison mode, e.g. Comparison.EQ (=)

value - The constraint value

Returns:

itself to allow chaining.

setAnnotationCriteria

public QueryService setAnnotationCriteria(String ldpath,
                                          String value)

Setting a criteria for filtering eu.mico.platform.persistence.impl.AnnotationImpl objects. Compared to the other setAnnotationCriteria function, this function does not need a Comparison statement. Hence, the Comparison.EQ statement ("=") will be used automatically.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Annotation object

value - The constraint value

Returns:

itself to allow chaining.

setAnnotationCriteria

public QueryService setAnnotationCriteria(String ldpath,
                                          Number value)

Setting a criteria for filtering eu.mico.platform.persistence.impl.AnnotationImpl objects. Compared to the other setAnnotationCriteria function, this function does not need a Comparison statement. Hence, the Comparison.EQ statement ("=") will be used automatically.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Annotation object

value - The constraint value

Returns:

itself to allow chaining.

setAnnotationCriteria

public QueryService setAnnotationCriteria(String ldpath)

Setting a criteria for filtering eu.mico.platform.persistence.impl.AnnotationImpl objects.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Annotation object

Returns:

itself to allow chaining.

setSelectorCriteria

public QueryService setSelectorCriteria(String ldpath,
                                        String value,
                                        Comparison comparison)

Setting a criteria for filtering eu.mico.platform.persistence.impl.SelectorImpl.* objects.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Selector object

comparison - The comparison mode, e.g. Comparison.EQ (=)

value - The constraint value

Returns:

itself to allow chaining.

setSelectorCriteria

public QueryService setSelectorCriteria(String ldpath,
                                        Number value,
                                        Comparison comparison)

Setting a criteria for filtering eu.mico.platform.persistence.impl.SelectorImpl.* objects.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Selector object

comparison - The comparison mode, e.g. Comparison.EQ (=)

value - The constraint value

Returns:

itself to allow chaining.

setSelectorCriteria

public QueryService setSelectorCriteria(String ldpath,
                                        String value)

Setting a criteria for filtering eu.mico.platform.persistence.impl.SelectorImpl.* objects. Compared to the other setSelectorCriteria function, this function does not need a Comparison statement. Hence, the Comparison.EQ statement ("=") will be used automatically.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Selector object

value - The constraint value

Returns:

itself to allow chaining.

setSelectorCriteria

public QueryService setSelectorCriteria(String ldpath,
                                        Number value)

Setting a criteria for filtering eu.mico.platform.persistence.impl.SelectorImpl.* objects. Compared to the other setSelectorCriteria function, this function does not need a Comparison statement. Hence, the Comparison.EQ statement ("=") will be used automatically.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Selector object

value - The constraint value

Returns:

itself to allow chaining.

setSelectorCriteria

public QueryService setSelectorCriteria(String ldpath)

Setting a criteria for filtering eu.mico.platform.persistence.impl.SelectorImpl.* objects.

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Selector object

Returns:

itself to allow chaining.

setSourceCriteria

public QueryService setSourceCriteria(String ldpath,
                                      String value,
                                      Comparison comparison)

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Source object

value - The constraint value

comparison - The comparison mode, e.g. Comparison.EQ (=)

Returns:

itself to allow chaining.

setSourceCriteria

public QueryService setSourceCriteria(String ldpath,
                                      Number value,
                                      Comparison comparison)

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Source object

value - The constraint value

comparison - The comparison mode, e.g. Comparison.EQ (=)

Returns:

itself to allow chaining.

setSourceCriteria

public QueryService setSourceCriteria(String ldpath,
                                      String value)

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Source object

value - The constraint value

Returns:

itself to allow chaining.

setSourceCriteria

public QueryService setSourceCriteria(String ldpath,
                                      Number value)

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Source object

value - The constraint value

Returns:

itself to allow chaining.

setSourceCriteria

public QueryService setSourceCriteria(String ldpath)

Parameters:

ldpath - Syntax similar to XPath. Beginning from the Source object

Returns:

itself to allow chaining.

addPrefix

public QueryService addPrefix(String label,
                              String url)

Setting shortcut names for URI prefixes.

Parameters:

label - The label of the namespace, e.g. foaf

url - The URL

Returns:

itself to allow chaining.

addPrefixes

public QueryService addPrefixes(HashMap<String,String> prefixes)

Setting multiple names for URI prefixes.

Parameters:

prefixes - HashMap with multiple namespaces.

Returns:

itself to allow chaining.

orderBy

public QueryService orderBy(Order order)

Defines the ordering of the result set.

Parameters:

order - Defines the order of the result set.

Returns:

itself to allow chaining.

limit

public QueryService limit(Integer limit)

Setting the limit value.

Parameters:

limit - The limit value.

Returns:

itself to allow chaining.

offset

public QueryService offset(Integer offset)

Setting the offset value.

Parameters:

offset - The offset value.

Returns:

itself to allow chaining.

execute

public <T> List<T> execute()
                    throws org.apache.marmotta.ldpath.parser.ParseException,
                           org.openrdf.repository.RepositoryException,
                           org.openrdf.query.MalformedQueryException,
                           org.openrdf.query.QueryEvaluationException

Creates and executes the SPARQL query according to the criteria specified by the user.

Type Parameters:

T -

Returns:

the result set

Throws:

org.apache.marmotta.ldpath.parser.ParseException

org.openrdf.repository.RepositoryException

org.openrdf.query.MalformedQueryException

org.openrdf.query.QueryEvaluationException