org.da.sparqlhelper.sparql.model

Class SparqlRequestGroup

java.lang.Object

org.da.sparqlhelper.sparql.model.AbstractSparqlRequest

org.da.sparqlhelper.sparql.model.SparqlRequestGroup

All Implemented Interfaces:

java.io.Serializable, DistanceUnits, ExpressionTypes, ISparqlRequestGroup

public class SparqlRequestGroup
extends AbstractSparqlRequest
implements java.io.Serializable

Since:

0.1

See Also:

Serialized Form

Field Summary

Fields inherited from class org.da.sparqlhelper.sparql.model.AbstractSparqlRequest

binds, coalesces, deleteForms, filters, insertForms, selectForm, whereForm

Fields inherited from interface org.da.sparqlhelper.sparql.model.ExpressionTypes

LABEL, SUBCLASS_OF, SUBCLASS_OF_STAR, TYPE, TYPE_SUBCLASS_OF

Fields inherited from interface org.da.sparqlhelper.sparql.model.DistanceUnits

DISTANCE_FT, DISTANCE_KM, DISTANCE_M, DISTANCE_NM

Constructor Summary

Constructors

Constructor and Description
SparqlRequestGroup(SparqlRequest parent)

Method Summary

Modifier and Type	Method and Description
java.lang.String	addAutoVariable() Add an additional variable in the query with a name chosen automatically.
Bind	addBind() Add a bind.
Bind	addBind(java.lang.String var) Add a bind.
Coalesce	addCoalesce() Add a coalesce.
boolean	addDistance(java.lang.String var, java.lang.String fromVar, java.lang.String varDist, short unit, boolean isExact) Add a distance property reference declaration in the WHERE part of the request.
Filter	addFilter() Add a filter.
boolean	addGeometry(java.lang.String var, java.lang.String varLat, java.lang.String varLon, boolean isExact) Add a geometry declaration in the WHERE part of the request.
boolean	addLabel(java.lang.String var, TripleElement type) Add a rdfs:label matching declaration in the WHERE part of the request.
boolean	addPropertyIndividualRef(java.lang.String var, TripleElement type, java.lang.String individual, boolean optional) Add an object property individual declaration in the WHERE part of the request.
boolean	addPropertyRef(java.lang.String var, TripleElement type, java.lang.String varRef, boolean optional) Add an object property reference declaration in the WHERE part of the request.
boolean	addPropertyValue(java.lang.String var, TripleElement type, java.lang.Object propertyValue, boolean optional) Add a property value declaration in the WHERE part of the request.
boolean	addPropertyValues(java.lang.String var, TripleElement type, java.util.List<? extends java.lang.Object> propValues, boolean optional) Add a property value declaration in the WHERE part of the request, for several values.
boolean	addSubClassOf(java.lang.String var, TripleElement type) Add a rdf:subClassOf matching declaration in the WHERE part of the request.
boolean	addSubClassOfStar(java.lang.String var, TripleElement type) Add a rdfs:subClassOf* matching declaration in the WHERE part of the request.
boolean	addTime(java.lang.String var, java.lang.String varTime, boolean isDateTime) Add a time declaration in the WHERE part of the request.
boolean	addType(java.lang.String var, short exprKind, TripleElement type) Add a matching declaration in the WHERE part of the request.
boolean	addType(java.lang.String var, TripleElement type) Add a rdf:type matching declaration in the WHERE part of the request.
boolean	addTypeSubClassOf(java.lang.String var, TripleElement type) Add a rdf:type/rdfs:subClassOf matching declaration in the WHERE part of the request.
boolean	addVariableSubClassOf(java.lang.String var, TripleElement type) Add a rdf:subClassOf matching declaration in the WHERE part of the request.
boolean	addVariableSubClassOfStar(java.lang.String var, TripleElement type) Add a rdfs:subClassOf* matching declaration in the WHERE part of the request.
boolean	addVariableType(java.lang.String var, short exprKind, TripleElement type) Add a matching declaration in the WHERE part of the request.
boolean	addVariableType(java.lang.String var, TripleElement type) Add a rdf:type matching declaration in the WHERE part of the request.
boolean	addVariableTypeSubClassOf(java.lang.String var, TripleElement type) Add a rdf:type/rdfs:subClassOf matching declaration in the WHERE part of the request.
boolean	checkValidity() Check the validity of the SPARQL expression for the group expression.
java.util.Map<java.lang.String,Variable>	getAdditionalVars() Return the additional variables.
java.lang.String	getDefaultSchema() Return the schema.
int	getOffset() Return the OFFSET of the number of results.
java.util.List<SparqlRequestGroup>	getOptionals()
SparqlRequest	getRootRequest()
java.util.Map<java.lang.String,SelectItem>	getSelectMap() Return the map opf SELECT items.
java.util.List<Union>	getUnions()
java.util.Set<WhereType>	getWhereTypes()
boolean	hasAdditionalVariable(java.lang.String var)
boolean	isCheckingVariablesExistence() Return true if the variables existence if checked during the creation of the request.
boolean	isLoggingErrors() Return true if errors should be logged by the framework.
void	resetSPARQLResult()
void	writeSPARQLImpl(java.lang.StringBuilder buf)
void	writeSPARQLImpl(java.lang.StringBuilder buf, boolean inUnion)

Methods inherited from class org.da.sparqlhelper.sparql.model.AbstractSparqlRequest

addDelete, addInsert, addInsertData, addProperty, appendTypeExpression, checkVariableExistence, getBinds, getCoalesces, getDeleteForms, getDistances, getFilters, getGeometries, getGraphPatterns, getInsertForms, getLastInsertForm, getOwlTimes, getPrefix, getPrefix, getPropertyIndRefs, getPropertyRefs, getPropertyValues, getSelectForm, getWhereForm, hasSelectVariable, isSelectAll

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.da.sparqlhelper.sparql.model.ISparqlRequestGroup

addLabel, addProperty, addPropertyIndividualRef, addPropertyIndividualRef, addPropertyRef, addPropertyRef, addPropertyRef, addPropertyValue, addPropertyValue, addPropertyValue, addPropertyValues, addPropertyValues, addPropertyValues, addSubClassOf, addSubClassOfStar, addType, addType, addTypeSubClassOf, addVariableSubClassOf, addVariableSubClassOfStar, addVariableType, addVariableType, addVariableTypeSubClassOf

Constructor Detail

SparqlRequestGroup

public SparqlRequestGroup(SparqlRequest parent)

Method Detail

getRootRequest

public SparqlRequest getRootRequest()

Specified by:

getRootRequest in interface ISparqlRequestGroup

getUnions

public java.util.List<Union> getUnions()

Specified by:

getUnions in interface ISparqlRequestGroup

addAutoVariable

public java.lang.String addAutoVariable()

Add an additional variable in the query with a name chosen automatically.

Specified by:

addAutoVariable in interface ISparqlRequestGroup

Returns:

the variable name

getDefaultSchema

public java.lang.String getDefaultSchema()

Return the schema.

Specified by:

getDefaultSchema in interface ISparqlRequestGroup

Returns:

the schema

getWhereTypes

public java.util.Set<WhereType> getWhereTypes()

getOffset

public int getOffset()

Return the OFFSET of the number of results.

Specified by:

getOffset in interface ISparqlRequestGroup

Returns:

the OFFSET declaration

isCheckingVariablesExistence

public boolean isCheckingVariablesExistence()

Return true if the variables existence if checked during the creation of the request. If false, no existence check will be performed but you will still be able to use the checkValidity() before the generation.

Specified by:

isCheckingVariablesExistence in interface ISparqlRequestGroup

Returns:

true if the variables existence if checked during the creation of the request

isLoggingErrors

public boolean isLoggingErrors()

Return true if errors should be logged by the framework.

Specified by:

isLoggingErrors in interface ISparqlRequestGroup

Returns:

true if errors should be logged by the framework

getOptionals

public java.util.List<SparqlRequestGroup> getOptionals()

Specified by:

getOptionals in interface ISparqlRequestGroup

getSelectMap

public java.util.Map<java.lang.String,SelectItem> getSelectMap()

Description copied from interface: ISparqlRequestGroup

Return the map opf SELECT items.

Specified by:

getSelectMap in interface ISparqlRequestGroup

Returns:

the map opf SELECT items

getAdditionalVars

public java.util.Map<java.lang.String,Variable> getAdditionalVars()

Return the additional variables.

Specified by:

getAdditionalVars in interface ISparqlRequestGroup

Returns:

the additional variables

hasAdditionalVariable

public boolean hasAdditionalVariable(java.lang.String var)

Specified by:

hasAdditionalVariable in interface ISparqlRequestGroup

addDistance

public boolean addDistance(java.lang.String var,
                           java.lang.String fromVar,
                           java.lang.String varDist,
                           short unit,
                           boolean isExact)

Add a distance property reference declaration in the WHERE part of the request.

Specified by:

addDistance in interface ISparqlRequestGroup

Parameters:

var - the variable name

fromVar - the other elment variable name

varDist - the distance variable name

unit - the unit

isExact - the name for an exact geometry

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addFilter

public Filter addFilter()

Add a filter.

Specified by:

addFilter in interface ISparqlRequestGroup

Returns:

the filter

addBind

public Bind addBind()

Add a bind.

Specified by:

addBind in interface ISparqlRequestGroup

Returns:

the bind

addBind

public Bind addBind(java.lang.String var)

Add a bind.

Specified by:

addBind in interface ISparqlRequestGroup

Parameters:

var - the variable

Returns:

the bind

addCoalesce

public Coalesce addCoalesce()

Add a coalesce.

Specified by:

addCoalesce in interface ISparqlRequestGroup

Returns:

the coalesce

addTime

public boolean addTime(java.lang.String var,
                       java.lang.String varTime,
                       boolean isDateTime)

Add a time declaration in the WHERE part of the request.

Specified by:

addTime in interface ISparqlRequestGroup

Parameters:

var - the variable name

varTime - the time variable name

isDateTime - true for a dateTime property

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addGeometry

public boolean addGeometry(java.lang.String var,
                           java.lang.String varLat,
                           java.lang.String varLon,
                           boolean isExact)

Add a geometry declaration in the WHERE part of the request.

Specified by:

addGeometry in interface ISparqlRequestGroup

Parameters:

var - the variable name

varLat - the latitude variable name

varLon - the longitude variable name

isExact - the name for an exact geometry

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addPropertyValue

public boolean addPropertyValue(java.lang.String var,
                                TripleElement type,
                                java.lang.Object propertyValue,
                                boolean optional)

Add a property value declaration in the WHERE part of the request.

Specified by:

addPropertyValue in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

propertyValue - the property value

optional - true for an optional pattern

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addPropertyValues

public boolean addPropertyValues(java.lang.String var,
                                 TripleElement type,
                                 java.util.List<? extends java.lang.Object> propValues,
                                 boolean optional)

Add a property value declaration in the WHERE part of the request, for several values.

Specified by:

addPropertyValues in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

propValues - the property values

optional - true for an optional pattern

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addPropertyRef

public boolean addPropertyRef(java.lang.String var,
                              TripleElement type,
                              java.lang.String varRef,
                              boolean optional)

Add an object property reference declaration in the WHERE part of the request.

Specified by:

addPropertyRef in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

varRef - the variable to use for the reference

optional - true for an optional pattern

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addPropertyIndividualRef

public boolean addPropertyIndividualRef(java.lang.String var,
                                        TripleElement type,
                                        java.lang.String individual,
                                        boolean optional)

Add an object property individual declaration in the WHERE part of the request.

Specified by:

addPropertyIndividualRef in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

individual - the individual name

optional - true for an optional pattern

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addSubClassOf

public boolean addSubClassOf(java.lang.String var,
                             TripleElement type)

Add a rdf:subClassOf matching declaration in the WHERE part of the request.

Specified by:

addSubClassOf in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addLabel

public boolean addLabel(java.lang.String var,
                        TripleElement type)

Add a rdfs:label matching declaration in the WHERE part of the request.

Specified by:

addLabel in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addSubClassOfStar

public boolean addSubClassOfStar(java.lang.String var,
                                 TripleElement type)

Add a rdfs:subClassOf* matching declaration in the WHERE part of the request.

Specified by:

addSubClassOfStar in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addType

public boolean addType(java.lang.String var,
                       short exprKind,
                       TripleElement type)

Add a matching declaration in the WHERE part of the request. This can be:

• ExpressionTypes.TYPE: a rdf:type expression
• ExpressionTypes.SUBCLASS_OF: a rdfs:subClassOf expression
• ExpressionTypes.SUBCLASS_OF_STAR: a rdfs:subClassOf* expression
• ExpressionTypes.TYPE_SUBCLASS_OF: a rdf:type/rdfs:subClassOf expression

Specified by:

addType in interface ISparqlRequestGroup

Parameters:

var - the variable name

exprKind - the expression kind

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addTypeSubClassOf

public boolean addTypeSubClassOf(java.lang.String var,
                                 TripleElement type)

Add a rdf:type/rdfs:subClassOf matching declaration in the WHERE part of the request.

Specified by:

addTypeSubClassOf in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addType

public boolean addType(java.lang.String var,
                       TripleElement type)

Add a rdf:type matching declaration in the WHERE part of the request.

Specified by:

addType in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addVariableSubClassOf

public boolean addVariableSubClassOf(java.lang.String var,
                                     TripleElement type)

Add a rdf:subClassOf matching declaration in the WHERE part of the request.

Specified by:

addVariableSubClassOf in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addVariableSubClassOfStar

public boolean addVariableSubClassOfStar(java.lang.String var,
                                         TripleElement type)

Add a rdfs:subClassOf* matching declaration in the WHERE part of the request.

Specified by:

addVariableSubClassOfStar in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addVariableType

public boolean addVariableType(java.lang.String var,
                               short exprKind,
                               TripleElement type)

Add a matching declaration in the WHERE part of the request. This can be:

• ExpressionTypes.TYPE: a rdf:type expression
• ExpressionTypes.SUBCLASS_OF: a rdfs:subClassOf expression
• ExpressionTypes.SUBCLASS_OF_STAR: a rdfs:subClassOf* expression
• ExpressionTypes.TYPE_SUBCLASS_OF: a rdf:type/rdfs:subClassOf expression

Specified by:

addVariableType in interface ISparqlRequestGroup

Parameters:

var - the variable name

exprKind - the expression kind

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addVariableTypeSubClassOf

public boolean addVariableTypeSubClassOf(java.lang.String var,
                                         TripleElement type)

Add a rdf:type/rdfs:subClassOf matching declaration in the WHERE part of the request.

Specified by:

addVariableTypeSubClassOf in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

addVariableType

public boolean addVariableType(java.lang.String var,
                               TripleElement type)

Add a rdf:type matching declaration in the WHERE part of the request.

Specified by:

addVariableType in interface ISparqlRequestGroup

Parameters:

var - the variable name

type - the type

Returns:

true if the variable exists (it is specified in the SELECT part or as an additional variable)

checkValidity

public boolean checkValidity()

Check the validity of the SPARQL expression for the group expression.

Returns:

true if the Sparql request is valid

resetSPARQLResult

public void resetSPARQLResult()

Specified by:

resetSPARQLResult in interface ISparqlRequestGroup

writeSPARQLImpl

public void writeSPARQLImpl(java.lang.StringBuilder buf)

writeSPARQLImpl

public void writeSPARQLImpl(java.lang.StringBuilder buf,
                            boolean inUnion)