org.dllearner.utilities

Class QueryUtils

java.lang.Object

org.apache.jena.sparql.syntax.ElementVisitorBase

org.dllearner.utilities.QueryUtils

All Implemented Interfaces:

org.apache.jena.sparql.syntax.ElementVisitor

public class QueryUtils
extends org.apache.jena.sparql.syntax.ElementVisitorBase

Utilities for SPARQL queries.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	QueryUtils.LabeledEdge

Constructor Summary

Constructors

Constructor and Description
QueryUtils()

Method Summary

Modifier and Type	Method and Description
static String	addPrefix(String queryString, Map<String,String> prefix2Namespace)
static String	addPrefixes(String queryString, String prefix, String namespace)
static org.jgrapht.graph.DefaultDirectedGraph<org.apache.jena.graph.Node,QueryUtils.LabeledEdge>	asJGraphT(org.apache.jena.query.Query query)
static void	exportAsGraph(org.apache.jena.query.Query query, File file)
Set<org.apache.jena.graph.Triple>	extractIncomingTriplePatterns(org.apache.jena.query.Query query, org.apache.jena.graph.Node node) Returns all triple patterns in given SPARQL query that have the given node in object position, i.e.
Map<org.apache.jena.sparql.core.Var,Set<org.apache.jena.graph.Triple>>	extractIncomingTriplePatternsForProjectionVars(org.apache.jena.query.Query query) Returns triple patterns for each projection variable v such that v is in subject position.
Set<org.apache.jena.graph.Triple>	extractIncomingTriplePatternsTrans(org.apache.jena.query.Query query, org.apache.jena.graph.Node node)
Map<org.apache.jena.sparql.core.Var,Set<org.apache.jena.graph.Triple>>	extractIngoingTriplePatternsForProjectionVars(org.apache.jena.query.Query query) Returns triple patterns for each projection variable v such that v is in object position.
Set<org.apache.jena.graph.Triple>	extractNonOptionalTriplePatterns(org.apache.jena.query.Query query, org.apache.jena.graph.Node node) Returns all triple patterns in given SPARQL query that have the given node either in subject or in object position, i.e.
Set<org.apache.jena.graph.Triple>	extractOutgoingTriplePatterns(org.apache.jena.query.Query query, org.apache.jena.graph.Node node) Returns all triple patterns in given SPARQL query that have the given node in subject position, i.e.
Map<org.apache.jena.sparql.core.Var,Set<org.apache.jena.graph.Triple>>	extractOutgoingTriplePatternsForProjectionVars(org.apache.jena.query.Query query) Returns triple patterns for each projection variable v such that v is in subject position.
Set<org.apache.jena.graph.Triple>	extractOutgoingTriplePatternsTrans(org.apache.jena.query.Query query, org.apache.jena.graph.Node node)
Set<org.apache.jena.graph.Triple>	extractTriplePattern(org.apache.jena.sparql.syntax.ElementGroup group)
Set<org.apache.jena.graph.Triple>	extractTriplePattern(org.apache.jena.sparql.syntax.ElementGroup group, boolean ignoreOptionals)
Set<org.apache.jena.graph.Triple>	extractTriplePattern(org.apache.jena.query.Query query)
Set<org.apache.jena.graph.Triple>	extractTriplePattern(org.apache.jena.query.Query query, boolean ignoreOptionals)
Set<org.apache.jena.graph.Triple>	extractTriplePatterns(org.apache.jena.query.Query query, org.apache.jena.graph.Node node) Returns all triple patterns in given SPARQL query that have the given node either in subject or in object position, i.e.
Map<org.apache.jena.sparql.core.Var,Set<org.apache.jena.graph.Triple>>	extractTriplePatternsForProjectionVars(org.apache.jena.query.Query query) Returns triple patterns for each projection variable v such that v is either in subject or object position.
Set<org.apache.jena.graph.Triple>	extractTriplePatternsWithPredicate(org.apache.jena.query.Query query, org.apache.jena.graph.Node predicate) Returns all triple patterns in given SPARQL query that contain the given predicate.
void	filterOutGeneralTypes(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef, org.apache.jena.query.Query query) Removes triple patterns of form (s rdf:type A) if there exists a triple pattern (s rdf:type B) such that the underlying knowledge base entails (B rdfs:subClassOf A).
org.apache.jena.sparql.syntax.ElementGroup	getElementGroup(org.apache.jena.graph.Triple triple) Returns the ElementGroup object containing the triple pattern.
int	getFilterCount()
static Set<org.apache.jena.graph.Node>	getNodes(org.apache.jena.query.Query query)
static Set<org.apache.jena.graph.Node>	getNodes(org.apache.jena.graph.Triple t) Convert triple pattern to a set of nodes {s, p, o}
Set<org.apache.jena.sparql.core.Var>	getObjectVariables(org.apache.jena.query.Query query) Returns all variables that occur as subject in a triple pattern of the SPARQL query.
static Set<org.apache.jena.sparql.core.Var>	getObjectVars(org.apache.jena.query.Query query) Returns all variables that occur as object in a triple pattern of the SPARQL query.
static CBDStructureTree	getOptimalCBDStructure(org.apache.jena.query.Query query)
int	getOptionalCount()
Set<org.apache.jena.graph.Triple>	getOptionalTriplePatterns()
static Set<org.apache.jena.graph.Triple>	getOutgoingTriplePatterns(org.apache.jena.query.Query query, org.apache.jena.graph.Node source) Given a SPARQL query and a start node, return the outgoing triple patterns.
static int	getSubjectObjectJoinDepth(org.apache.jena.query.Query query, org.apache.jena.graph.Node source) Given a SPARQL query and a start node, return the maximum subject-object join depth.
Set<org.apache.jena.sparql.core.Var>	getSubjectVariables(org.apache.jena.query.Query query) Returns all variables that occur as subject in a triple pattern of the SPARQL query.
static Set<org.apache.jena.sparql.core.Var>	getSubjectVars(org.apache.jena.query.Query query) Returns all variables that occur as subject in a triple pattern of the SPARQL query.
static Set<org.apache.jena.graph.Triple>	getTriplePatterns(org.apache.jena.query.Query query)
int	getUnionCount()
Set<org.apache.jena.sparql.core.Var>	getVariables(org.apache.jena.query.Query query) Returns all variables that occur in a triple pattern of the SPARQL query.
boolean	isOptional(org.apache.jena.graph.Triple triple)
static void	main(String[] args)
static void	prunePrefixes(org.apache.jena.query.Query query) Remove unused prefix declarations from preamble.
org.apache.jena.query.Query	removeUnboundObjectVarTriples(org.apache.jena.query.Query query)
void	visit(org.apache.jena.sparql.syntax.ElementFilter el)
void	visit(org.apache.jena.sparql.syntax.ElementGroup el)
void	visit(org.apache.jena.sparql.syntax.ElementOptional el)
void	visit(org.apache.jena.sparql.syntax.ElementPathBlock el)
void	visit(org.apache.jena.sparql.syntax.ElementTriplesBlock el)
void	visit(org.apache.jena.sparql.syntax.ElementUnion el)

Methods inherited from class org.apache.jena.sparql.syntax.ElementVisitorBase

visit, visit, visit, visit, visit, visit, visit, visit, visit, visit

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryUtils

public QueryUtils()

Method Detail

addPrefix

public static String addPrefix(String queryString,
                               Map<String,String> prefix2Namespace)

addPrefixes

public static String addPrefixes(String queryString,
                                 String prefix,
                                 String namespace)

prunePrefixes

public static void prunePrefixes(org.apache.jena.query.Query query)

Remove unused prefix declarations from preamble.

Parameters:

query - the query

getNodes

public static Set<org.apache.jena.graph.Node> getNodes(org.apache.jena.query.Query query)

Parameters:

query - the query

Returns:

all nodes that occur in triple patterns of the query

getNodes

public static Set<org.apache.jena.graph.Node> getNodes(org.apache.jena.graph.Triple t)

Convert triple pattern to a set of nodes {s, p, o}

Parameters:

t - the triple pattern

Returns:

set of nodes {s, p, o}

getVariables

public Set<org.apache.jena.sparql.core.Var> getVariables(org.apache.jena.query.Query query)

Returns all variables that occur in a triple pattern of the SPARQL query.

Parameters:

query - the query

Returns:

getSubjectVariables

public Set<org.apache.jena.sparql.core.Var> getSubjectVariables(org.apache.jena.query.Query query)

Returns all variables that occur as subject in a triple pattern of the SPARQL query.

Parameters:

query - the query

Returns:

getSubjectVars

public static Set<org.apache.jena.sparql.core.Var> getSubjectVars(org.apache.jena.query.Query query)

Returns all variables that occur as subject in a triple pattern of the SPARQL query.

Parameters:

query - the query

Returns:

getTriplePatterns

public static Set<org.apache.jena.graph.Triple> getTriplePatterns(org.apache.jena.query.Query query)

getOutgoingTriplePatterns

public static Set<org.apache.jena.graph.Triple> getOutgoingTriplePatterns(org.apache.jena.query.Query query,
                                                                          org.apache.jena.graph.Node source)

Given a SPARQL query and a start node, return the outgoing triple patterns.

Parameters:

query - the query

source - the start node

Returns:

getSubjectObjectJoinDepth

public static int getSubjectObjectJoinDepth(org.apache.jena.query.Query query,
                                            org.apache.jena.graph.Node source)

Given a SPARQL query and a start node, return the maximum subject-object join depth.

Parameters:

query - the query

source - the start node

Returns:

getOptimalCBDStructure

public static CBDStructureTree getOptimalCBDStructure(org.apache.jena.query.Query query)

getObjectVars

public static Set<org.apache.jena.sparql.core.Var> getObjectVars(org.apache.jena.query.Query query)

Returns all variables that occur as object in a triple pattern of the SPARQL query.

Parameters:

query - the query

Returns:

getObjectVariables

public Set<org.apache.jena.sparql.core.Var> getObjectVariables(org.apache.jena.query.Query query)

Returns all variables that occur as subject in a triple pattern of the SPARQL query.

Parameters:

query - the query

Returns:

extractOutgoingTriplePatterns

public Set<org.apache.jena.graph.Triple> extractOutgoingTriplePatterns(org.apache.jena.query.Query query,
                                                                       org.apache.jena.graph.Node node)

Returns all triple patterns in given SPARQL query that have the given node in subject position, i.e. the outgoing triple patterns.

Parameters:

query - The SPARQL query.

node - the node

Returns:

extractOutgoingTriplePatternsTrans

public Set<org.apache.jena.graph.Triple> extractOutgoingTriplePatternsTrans(org.apache.jena.query.Query query,
                                                                            org.apache.jena.graph.Node node)

extractIncomingTriplePatterns

public Set<org.apache.jena.graph.Triple> extractIncomingTriplePatterns(org.apache.jena.query.Query query,
                                                                       org.apache.jena.graph.Node node)

Returns all triple patterns in given SPARQL query that have the given node in object position, i.e. the incoming triple patterns.

Parameters:

query - The SPARQL query.

node - the node

Returns:

extractIncomingTriplePatternsTrans

public Set<org.apache.jena.graph.Triple> extractIncomingTriplePatternsTrans(org.apache.jena.query.Query query,
                                                                            org.apache.jena.graph.Node node)

extractTriplePatterns

public Set<org.apache.jena.graph.Triple> extractTriplePatterns(org.apache.jena.query.Query query,
                                                               org.apache.jena.graph.Node node)

Returns all triple patterns in given SPARQL query that have the given node either in subject or in object position, i.e. the ingoing and outgoing triple patterns.

Parameters:

query - The SPARQL query.

node - the node

Returns:

extractTriplePatternsWithPredicate

public Set<org.apache.jena.graph.Triple> extractTriplePatternsWithPredicate(org.apache.jena.query.Query query,
                                                                            org.apache.jena.graph.Node predicate)

Returns all triple patterns in given SPARQL query that contain the given predicate.

Parameters:

query - the SPARQL query.

predicate - the predicate

Returns:

extractNonOptionalTriplePatterns

public Set<org.apache.jena.graph.Triple> extractNonOptionalTriplePatterns(org.apache.jena.query.Query query,
                                                                          org.apache.jena.graph.Node node)

Returns all triple patterns in given SPARQL query that have the given node either in subject or in object position, i.e. the incoming and outgoing triple patterns.

Parameters:

query - The SPARQL query.

node - the node

Returns:

extractTriplePatternsForProjectionVars

public Map<org.apache.jena.sparql.core.Var,Set<org.apache.jena.graph.Triple>> extractTriplePatternsForProjectionVars(org.apache.jena.query.Query query)

Returns triple patterns for each projection variable v such that v is either in subject or object position.

Parameters:

query - The SPARQL query.

Returns:

extractOutgoingTriplePatternsForProjectionVars

public Map<org.apache.jena.sparql.core.Var,Set<org.apache.jena.graph.Triple>> extractOutgoingTriplePatternsForProjectionVars(org.apache.jena.query.Query query)

Returns triple patterns for each projection variable v such that v is in subject position.

Parameters:

query - The SPARQL query.

Returns:

getOptionalTriplePatterns

public Set<org.apache.jena.graph.Triple> getOptionalTriplePatterns()

Returns:

the optionalTriplePattern

extractIncomingTriplePatternsForProjectionVars

public Map<org.apache.jena.sparql.core.Var,Set<org.apache.jena.graph.Triple>> extractIncomingTriplePatternsForProjectionVars(org.apache.jena.query.Query query)

Returns triple patterns for each projection variable v such that v is in subject position.

Parameters:

query - The SPARQL query.

Returns:

extractIngoingTriplePatternsForProjectionVars

public Map<org.apache.jena.sparql.core.Var,Set<org.apache.jena.graph.Triple>> extractIngoingTriplePatternsForProjectionVars(org.apache.jena.query.Query query)

Returns triple patterns for each projection variable v such that v is in object position.

Parameters:

query - The SPARQL query.

Returns:

extractTriplePattern

public Set<org.apache.jena.graph.Triple> extractTriplePattern(org.apache.jena.query.Query query)

extractTriplePattern

public Set<org.apache.jena.graph.Triple> extractTriplePattern(org.apache.jena.query.Query query,
                                                              boolean ignoreOptionals)

isOptional

public boolean isOptional(org.apache.jena.graph.Triple triple)

extractTriplePattern

public Set<org.apache.jena.graph.Triple> extractTriplePattern(org.apache.jena.sparql.syntax.ElementGroup group)

extractTriplePattern

public Set<org.apache.jena.graph.Triple> extractTriplePattern(org.apache.jena.sparql.syntax.ElementGroup group,
                                                              boolean ignoreOptionals)

removeUnboundObjectVarTriples

public org.apache.jena.query.Query removeUnboundObjectVarTriples(org.apache.jena.query.Query query)

filterOutGeneralTypes

public void filterOutGeneralTypes(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef,
                                  org.apache.jena.query.Query query)

Removes triple patterns of form (s rdf:type A) if there exists a triple pattern (s rdf:type B) such that the underlying knowledge base entails (B rdfs:subClassOf A).

Parameters:

qef - the query execution factory

query - the query

asJGraphT

public static org.jgrapht.graph.DefaultDirectedGraph<org.apache.jena.graph.Node,QueryUtils.LabeledEdge> asJGraphT(org.apache.jena.query.Query query)

exportAsGraph

public static void exportAsGraph(org.apache.jena.query.Query query,
                                 File file)

visit

public void visit(org.apache.jena.sparql.syntax.ElementGroup el)

Specified by:

visit in interface org.apache.jena.sparql.syntax.ElementVisitor

Overrides:

visit in class org.apache.jena.sparql.syntax.ElementVisitorBase

visit

public void visit(org.apache.jena.sparql.syntax.ElementOptional el)

Specified by:

visit in interface org.apache.jena.sparql.syntax.ElementVisitor

Overrides:

visit in class org.apache.jena.sparql.syntax.ElementVisitorBase

visit

public void visit(org.apache.jena.sparql.syntax.ElementTriplesBlock el)

Specified by:

visit in interface org.apache.jena.sparql.syntax.ElementVisitor

Overrides:

visit in class org.apache.jena.sparql.syntax.ElementVisitorBase

visit

public void visit(org.apache.jena.sparql.syntax.ElementPathBlock el)

Specified by:

visit in interface org.apache.jena.sparql.syntax.ElementVisitor

Overrides:

visit in class org.apache.jena.sparql.syntax.ElementVisitorBase

visit

public void visit(org.apache.jena.sparql.syntax.ElementUnion el)

Specified by:

visit in interface org.apache.jena.sparql.syntax.ElementVisitor

Overrides:

visit in class org.apache.jena.sparql.syntax.ElementVisitorBase

visit

public void visit(org.apache.jena.sparql.syntax.ElementFilter el)

Specified by:

visit in interface org.apache.jena.sparql.syntax.ElementVisitor

Overrides:

visit in class org.apache.jena.sparql.syntax.ElementVisitorBase

getUnionCount

public int getUnionCount()

getOptionalCount

public int getOptionalCount()

getFilterCount

public int getFilterCount()

getElementGroup

public org.apache.jena.sparql.syntax.ElementGroup getElementGroup(org.apache.jena.graph.Triple triple)

Returns the ElementGroup object containing the triple pattern.

Parameters:

triple - the triple patterm

Returns:

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception