org.aksw.sparqlify.database

Class RdfViewSystem2

java.lang.Object

org.aksw.sparqlify.database.RdfViewSystem2

All Implemented Interfaces:

RdfViewSystem

public class RdfViewSystem2
extends Object
implements RdfViewSystem

Constructor Summary

Constructors

Constructor and Description
RdfViewSystem2()

Method Summary

Methods

Modifier and Type	Method and Description
com.hp.hpl.jena.sparql.algebra.Op	_getApplicableViews(com.hp.hpl.jena.sparql.algebra.Op op) Given a sparql query in quad form, this method replaces (sub sets of) quad patterns with view instances (view patterns) The method also passes the filter conditions that an op must satisfy.
com.hp.hpl.jena.sparql.algebra.Op	_getApplicableViews(com.hp.hpl.jena.sparql.algebra.Op op, RestrictionManagerImpl restrictions)
void	addView(RdfView view)
static StartsWithConstraint	deriveConstraint(com.hp.hpl.jena.sparql.expr.E_StrConcat expr)
static StartsWithConstraint	deriveConstraint(E_StrConcatPermissive expr)
static Constraint	deriveConstraint(com.hp.hpl.jena.sparql.expr.Expr expr)
static StartsWithConstraint	deriveConstraintConcat(com.hp.hpl.jena.sparql.expr.ExprFunction concat)
static VariableConstraint	deriveIsPrefixOfConstraint(com.hp.hpl.jena.sparql.expr.Expr a, com.hp.hpl.jena.sparql.expr.Expr b) If a variable equals a (uri or string) constant, it means that the view must provide a prefix for that value.
void	deriveRestrictions(RdfView view) Derive prefix constraints for variables based on variable definitions: concat('constant', var, rest) -> prefix = 'constant' TODO: Actually we should not add these constraints to the view, but just return them
Map<com.hp.hpl.jena.sparql.core.Var,RdfTermType>	deriveTypeConstraints(RdfView view)
static VariableConstraint	deriveViewLookupConstraint(com.hp.hpl.jena.sparql.expr.Expr expr) Returns IsPrefixOf Constraints for equality expressions between variables and constants.
static RestrictionManagerImpl	filterRestrictionsBound(RestrictionManagerImpl restrictions) Create a new retrictions manager, where "bound" retrictions are removed
Set<org.aksw.sparqlify.database.ViewQuad>	findCandidates(com.hp.hpl.jena.sparql.core.Quad quad, RestrictionManagerImpl restrictions)
org.aksw.commons.util.Pair<NavigableMap<Integer,Set<com.hp.hpl.jena.sparql.core.Quad>>,Map<com.hp.hpl.jena.sparql.core.Quad,Set<org.aksw.sparqlify.database.ViewQuad>>>	findQuadWithFewestViewCandidates(com.hp.hpl.jena.sparql.core.QuadPattern queryQuads, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpDistinct op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpExtend op, RestrictionManagerImpl _restrictions) We treat OpExtend as a filter for now TODO This breaks for instance Count(*) as Jena also does renaming with extend: Jena generates Project(?c, Extend(?c, ?x, Group(Count(*) As ?x))) So in this case, extend creates a new alias for a variable
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpFilter op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpGroup op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpJoin op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpLeftJoin op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpOrder op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpProject op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpQuadPattern op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpSlice op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpUnion op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.query.Query query)
List<RdfViewConjunction>	getApplicableViewsBase(com.hp.hpl.jena.sparql.algebra.op.OpQuadPattern op, RestrictionManagerImpl restrictions) Order the quads of the quadPattern by selectivity.
void	getApplicableViewsRec2(int index, List<com.hp.hpl.jena.sparql.core.Quad> quadOrder, Set<org.aksw.sparqlify.database.ViewQuad> viewQuads, Map<com.hp.hpl.jena.sparql.core.Quad,Set<org.aksw.sparqlify.database.ViewQuad>> candidates, RestrictionManagerImpl restrictions, org.aksw.sparqlify.database.NestedStack<RdfViewInstance> instances, List<RdfViewConjunction> result)
static List<String>	getCandidateNames(org.aksw.sparqlify.database.NestedStack<RdfViewInstance> instances)
static List<RestrictionManagerImpl>	getRestrictions(com.hp.hpl.jena.sparql.algebra.Op op)
static void	getRestrictions(com.hp.hpl.jena.sparql.algebra.Op op, Collection<RestrictionManagerImpl> result) Returns a disjunction (list) of restrictions that apply for a given node
static RestrictionManagerImpl	getRestrictions2(com.hp.hpl.jena.sparql.algebra.Op op)
static RdfTermType	getType(com.hp.hpl.jena.graph.Node node, RestrictionManagerImpl restrictions)
Collection<RdfView>	getViews()
static boolean	isSatisfiable(List<RdfViewInstance> list)

Methods inherited from class java.lang.Object

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

Constructor Detail

RdfViewSystem2

public RdfViewSystem2()

Method Detail

addView

public void addView(RdfView view)

Specified by:

addView in interface RdfViewSystem

deriveConstraint

public static Constraint deriveConstraint(com.hp.hpl.jena.sparql.expr.Expr expr)

deriveConstraint

public static StartsWithConstraint deriveConstraint(com.hp.hpl.jena.sparql.expr.E_StrConcat expr)

deriveConstraint

public static StartsWithConstraint deriveConstraint(E_StrConcatPermissive expr)

deriveConstraintConcat

public static StartsWithConstraint deriveConstraintConcat(com.hp.hpl.jena.sparql.expr.ExprFunction concat)

deriveTypeConstraints

public Map<com.hp.hpl.jena.sparql.core.Var,RdfTermType> deriveTypeConstraints(RdfView view)

deriveRestrictions

public void deriveRestrictions(RdfView view)

Derive prefix constraints for variables based on variable definitions: concat('constant', var, rest) -> prefix = 'constant' TODO: Actually we should not add these constraints to the view, but just return them

getType

public static RdfTermType getType(com.hp.hpl.jena.graph.Node node,
                  RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.query.Query query)

Specified by:

getApplicableViews in interface RdfViewSystem

deriveIsPrefixOfConstraint

public static VariableConstraint deriveIsPrefixOfConstraint(com.hp.hpl.jena.sparql.expr.Expr a,
                                            com.hp.hpl.jena.sparql.expr.Expr b)

If a variable equals a (uri or string) constant, it means that the view must provide a prefix for that value.

Parameters:

a -

b -

Returns:

deriveViewLookupConstraint

public static VariableConstraint deriveViewLookupConstraint(com.hp.hpl.jena.sparql.expr.Expr expr)

Returns IsPrefixOf Constraints for equality expressions between variables and constants. Used for looking up view candidates. Not used for satisfiability checks.

Parameters:

expr -

Returns:

getApplicableViewsBase

public List<RdfViewConjunction> getApplicableViewsBase(com.hp.hpl.jena.sparql.algebra.op.OpQuadPattern op,
                                              RestrictionManagerImpl restrictions)

Order the quads of the quadPattern by selectivity. Iterate the quads in order, and for each quad, do a lookup of the views that may yield answers to it. So for each quad we get a set of candidate bindings to the views. Binding is a mapping from query-var to a set of view variables/constant The view varibale may have constraints on it, which carry over to the query variable. So given Create View x ... {?x a Class . } With ?x.value prefix "foo" a query Select {?s ?p ?o } and a binding(?s = ?x), then we can infer the constraint on ?x.value prefix "foo" So if there is a second pattern { ?x a Class. ?x label ?z } Then we can use this constraint on the lookup at the second pattern. Note that the selectivity of query quad pattern change with the bindings, so we should be able to quickly update the selectivity of the quads in the presence of bindings. Another note: Maybe we could treat constants as specially delimited prefixes, such as 'aaaa' = prefix 'aaaaa$' = constant

findCandidates

public Set<org.aksw.sparqlify.database.ViewQuad> findCandidates(com.hp.hpl.jena.sparql.core.Quad quad,
                                                       RestrictionManagerImpl restrictions)

findQuadWithFewestViewCandidates

public org.aksw.commons.util.Pair<NavigableMap<Integer,Set<com.hp.hpl.jena.sparql.core.Quad>>,Map<com.hp.hpl.jena.sparql.core.Quad,Set<org.aksw.sparqlify.database.ViewQuad>>> findQuadWithFewestViewCandidates(com.hp.hpl.jena.sparql.core.QuadPattern queryQuads,
                                                                                                                                                                                                       RestrictionManagerImpl restrictions)

getCandidateNames

public static List<String> getCandidateNames(org.aksw.sparqlify.database.NestedStack<RdfViewInstance> instances)

getApplicableViewsRec2

public void getApplicableViewsRec2(int index,
                          List<com.hp.hpl.jena.sparql.core.Quad> quadOrder,
                          Set<org.aksw.sparqlify.database.ViewQuad> viewQuads,
                          Map<com.hp.hpl.jena.sparql.core.Quad,Set<org.aksw.sparqlify.database.ViewQuad>> candidates,
                          RestrictionManagerImpl restrictions,
                          org.aksw.sparqlify.database.NestedStack<RdfViewInstance> instances,
                          List<RdfViewConjunction> result)

Parameters:

index -

quadOrder -

viewQuads - The viewQuads provided by the parent invocation - with any restrictions encountered during the rewrite taken into account

candidates - The viewQuads here are the ones from only analyzing the query filter In some cases (small candidate sets) it might be faster filtering this set of view candidates, rather than doing a new lookup.

restrictions -

result -

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpQuadPattern op,
                                                   RestrictionManagerImpl restrictions)

isSatisfiable

public static boolean isSatisfiable(List<RdfViewInstance> list)

_getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op _getApplicableViews(com.hp.hpl.jena.sparql.algebra.Op op)

Given a sparql query in quad form, this method replaces (sub sets of) quad patterns with view instances (view patterns) The method also passes the filter conditions that an op must satisfy.

Parameters:

op -

Returns:

_getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op _getApplicableViews(com.hp.hpl.jena.sparql.algebra.Op op,
                                                    RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpProject op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpOrder op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpGroup op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpExtend op,
                                                   RestrictionManagerImpl _restrictions)

We treat OpExtend as a filter for now TODO This breaks for instance Count(*) as Jena also does renaming with extend: Jena generates Project(?c, Extend(?c, ?x, Group(Count(*) As ?x))) So in this case, extend creates a new alias for a variable

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpFilter op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpUnion op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpJoin op,
                                                   RestrictionManagerImpl restrictions)

filterRestrictionsBound

public static RestrictionManagerImpl filterRestrictionsBound(RestrictionManagerImpl restrictions)

Create a new retrictions manager, where "bound" retrictions are removed

Parameters:

restrictions -

Returns:

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpLeftJoin op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpSlice op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpDistinct op,
                                                   RestrictionManagerImpl restrictions)

getRestrictions2

public static RestrictionManagerImpl getRestrictions2(com.hp.hpl.jena.sparql.algebra.Op op)

getRestrictions

public static List<RestrictionManagerImpl> getRestrictions(com.hp.hpl.jena.sparql.algebra.Op op)

getRestrictions

public static void getRestrictions(com.hp.hpl.jena.sparql.algebra.Op op,
                   Collection<RestrictionManagerImpl> result)

Returns a disjunction (list) of restrictions that apply for a given node

getViews

public Collection<RdfView> getViews()

Specified by:

getViews in interface RdfViewSystem