org.aksw.jena_sparql_api.shape

Class ResourceShape

java.lang.Object

org.aksw.jena_sparql_api.shape.ResourceShape

public class ResourceShape
extends Object

A graph expression is a SPARQL expression which only makes use of the variables ?s ?p and ?o The evaluation of a graph expression te over an RDF dataset D yields a graph (a set of triples) [[te]]_D Maybe we should take a set of triples, derive a set of related resources, and then for this related set of resources specify which triples we are interested in again. In this case, the model is Map i.e. the expression evaluates to a resource for each triple, and these resources are used for further lookups. However, how would we navigate in inverse direction? Each resource r is associated with a set of ingoing and outgoing triples: outgoing: { t | t in G and t.s = r} ingoing: { t | t in G and t.o = r} Navigating to the set of related triples: Let G be the set of all triples and G1 and G2 subsetof G be two graphs. { t2 | t1 in G1 and expr(t1, t2)} We could use expressions over the additional variables ?x ?y ?z to perform joins: (?s ?p ?o ?x ?y ?z) ?s = ?x G1 x G2

Author:

raven

Constructor Summary

Constructors

Constructor and Description
ResourceShape()

Method Summary

Modifier and Type	Method and Description
static Relation	asRelation(org.apache.jena.sparql.expr.Expr expr)
static void	collectConcepts(Collection<Concept> result, Concept baseConcept, Map<Relation,ResourceShape> map, boolean isInverse, org.aksw.jena_sparql_api.utils.Generator<org.apache.jena.sparql.core.Var> vargen)
static void	collectConcepts(Collection<Concept> result, Concept baseConcept, ResourceShape source, org.aksw.jena_sparql_api.utils.Generator<org.apache.jena.sparql.core.Var> vargen)
static void	collectConcepts(Collection<Concept> result, ResourceShape source)
static void	collectConcepts(Collection<Concept> result, ResourceShape source, org.aksw.jena_sparql_api.utils.Generator<org.apache.jena.sparql.core.Var> vargen)
static List<Concept>	collectConcepts(ResourceShape source)
static boolean	contains(Collection<org.apache.jena.sparql.expr.Expr> exprs, org.apache.jena.graph.Triple triple, org.apache.jena.sparql.function.FunctionEnv functionEnv) Whether a triple matches any of the ingoing or outgoing filter expression of this node
static Concept	createConcept(Concept baseConcept, org.aksw.jena_sparql_api.utils.Generator<org.apache.jena.sparql.core.Var> vargen, Relation predicateRelation, boolean isInverse) Creates elements for this node and then descends into its children
static MappedConcept<org.apache.jena.graph.Graph>	createMappedConcept(org.apache.jena.query.Query query)
static MappedConcept<org.apache.jena.graph.Graph>	createMappedConcept(ResourceShape resourceShape, Concept filter)
static MappedConcept<org.apache.jena.sparql.core.DatasetGraph>	createMappedConcept2(org.apache.jena.query.Query query)
static MappedConcept<org.apache.jena.sparql.core.DatasetGraph>	createMappedConcept2(ResourceShape resourceShape, Concept filter)
static org.apache.jena.query.Query	createQuery(List<Concept> concepts, Concept filter)
static org.apache.jena.query.Query	createQuery(ResourceShape resourceShape, Concept filter)
static org.apache.jena.query.Query	createQueryConstruct(List<Concept> concepts, Concept filter) Deprecated.
boolean	equals(Object obj)
void	extend(ResourceShape that)
Map<Relation,ResourceShape>	getIngoing()
Map<Relation,ResourceShape>	getOutgoing()
static List<Relation>	group(Collection<Relation> relations)
int	hashCode() Get all triples about the titles of books, together with the books' male buyers' names and age.
static org.apache.jena.sparql.syntax.Element	remapVars(org.apache.jena.sparql.syntax.Element element, Map<org.apache.jena.sparql.core.Var,org.apache.jena.sparql.core.Var> varMap)
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ResourceShape

public ResourceShape()

Method Detail

getOutgoing

public Map<Relation,ResourceShape> getOutgoing()

getIngoing

public Map<Relation,ResourceShape> getIngoing()

extend

public void extend(ResourceShape that)

collectConcepts

public static List<Concept> collectConcepts(ResourceShape source)

collectConcepts

public static void collectConcepts(Collection<Concept> result,
                                   ResourceShape source)

collectConcepts

public static void collectConcepts(Collection<Concept> result,
                                   ResourceShape source,
                                   org.aksw.jena_sparql_api.utils.Generator<org.apache.jena.sparql.core.Var> vargen)

collectConcepts

public static void collectConcepts(Collection<Concept> result,
                                   Concept baseConcept,
                                   ResourceShape source,
                                   org.aksw.jena_sparql_api.utils.Generator<org.apache.jena.sparql.core.Var> vargen)

collectConcepts

public static void collectConcepts(Collection<Concept> result,
                                   Concept baseConcept,
                                   Map<Relation,ResourceShape> map,
                                   boolean isInverse,
                                   org.aksw.jena_sparql_api.utils.Generator<org.apache.jena.sparql.core.Var> vargen)

group

public static List<Relation> group(Collection<Relation> relations)

asRelation

public static Relation asRelation(org.apache.jena.sparql.expr.Expr expr)

remapVars

public static org.apache.jena.sparql.syntax.Element remapVars(org.apache.jena.sparql.syntax.Element element,
                                                              Map<org.apache.jena.sparql.core.Var,org.apache.jena.sparql.core.Var> varMap)

createQuery

public static org.apache.jena.query.Query createQuery(ResourceShape resourceShape,
                                                      Concept filter)

createQueryConstruct

@Deprecated
public static org.apache.jena.query.Query createQueryConstruct(List<Concept> concepts,
                                                                           Concept filter)

Deprecated.

Deprecated, because with the construct approach we cannot get a tripe's context resource

Parameters:

concepts -

filter -

Returns:

createMappedConcept2

public static MappedConcept<org.apache.jena.sparql.core.DatasetGraph> createMappedConcept2(ResourceShape resourceShape,
                                                                                           Concept filter)

createMappedConcept

public static MappedConcept<org.apache.jena.graph.Graph> createMappedConcept(ResourceShape resourceShape,
                                                                             Concept filter)

createMappedConcept2

public static MappedConcept<org.apache.jena.sparql.core.DatasetGraph> createMappedConcept2(org.apache.jena.query.Query query)

createMappedConcept

public static MappedConcept<org.apache.jena.graph.Graph> createMappedConcept(org.apache.jena.query.Query query)

createQuery

public static org.apache.jena.query.Query createQuery(List<Concept> concepts,
                                                      Concept filter)

createConcept

public static Concept createConcept(Concept baseConcept,
                                    org.aksw.jena_sparql_api.utils.Generator<org.apache.jena.sparql.core.Var> vargen,
                                    Relation predicateRelation,
                                    boolean isInverse)

Creates elements for this node and then descends into its children

Parameters:

predicateConcept -

target -

isInverse -

Returns:

contains

public static boolean contains(Collection<org.apache.jena.sparql.expr.Expr> exprs,
                               org.apache.jena.graph.Triple triple,
                               org.apache.jena.sparql.function.FunctionEnv functionEnv)

Whether a triple matches any of the ingoing or outgoing filter expression of this node

Parameters:

triple -

functionEnv -

Returns:

hashCode

public int hashCode()

Get all triples about the titles of books, together with the books' male buyers' names and age. The generated query has the structure Construct { ?s ?p ?o } { { ?x a Book . Bind(?x as ?s)} # Root concept { # get the 'buyer' triples ?s ?p ?o . Filter(?p = boughtBy) // outgoing { ?o gender male }} // restricting the resources of the relation #Optional { # ?x ?y ?z . Filter(?y = rdfs:label) #} } Union { { # get the buyers names - requires repetition of above's pattern ?x ?y ?s . Filter(?y = boughtBy) { ?s gender male }} // restricting the resources of the relation ?s ?p ?o . Filter(?p = rdfs:label) } Union { ?s ?p ?o . Filter(?p = dc:title && langMatches(lang(?o), 'en')) # outgoing } }

Overrides:

hashCode in class Object

Parameters:

root -

Returns:

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object