ai.grakn.graql.internal.reasoner.cache

Class LazyQueryCache<Q extends ReasonerQueryImpl>

java.lang.Object

ai.grakn.graql.internal.reasoner.cache.Cache<Q,LazyAnswerIterator>

ai.grakn.graql.internal.reasoner.cache.LazyQueryCache<Q>

Type Parameters:

Q - the type of query that is being cached

public class LazyQueryCache<Q extends ReasonerQueryImpl>
extends Cache<Q,LazyAnswerIterator>

Lazy container class for storing performed query resolutions. NB: In case the entry is not found, get methods perform a record operation.

Author:

Kasper Piskorski

Constructor Summary

Constructors

Constructor and Description
LazyQueryCache()

Method Summary

Modifier and Type	Method and Description
long	answerSize(Set<Q> queries)
void	consume()
LazyAnswerIterator	getAnswerIterator(Q query)
LazyAnswerIterator	getAnswers(Q query) retrieve cached answers for provided query
java.util.stream.Stream<Answer>	getAnswerStream(Q query)
Pair<java.util.stream.Stream<Answer>,MultiUnifier>	getAnswerStreamWithUnifier(Q query)
Pair<LazyAnswerIterator,MultiUnifier>	getAnswersWithUnifier(Q query)
LazyAnswerIterator	record(Q query, LazyAnswerIterator answers) record answer iterable for a specific query and retrieve the updated answers
java.util.stream.Stream<Answer>	record(Q query, java.util.stream.Stream<Answer> answers) record answer stream for a specific query and retrieve the updated stream
LazyAnswerIterator	recordRetrieveLazy(Q query, java.util.stream.Stream<Answer> answers) record answer stream for a specific query and retrieve the updated stream in a lazy iterator
void	reload() force stream consumption and reload cache
void	remove(Cache<Q,LazyAnswerIterator> c2, Set<Q> queries) cache subtraction of specified queries

Methods inherited from class ai.grakn.graql.internal.reasoner.cache.Cache

add, clear, contains, entries, get, getInverseAnswerMap, getInverseAnswerMap, getQueries, put, putAll, remove

Methods inherited from class java.lang.Object

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

Constructor Detail

LazyQueryCache

public LazyQueryCache()

Method Detail

record

public LazyAnswerIterator record(Q query,
                                 LazyAnswerIterator answers)

Description copied from class: Cache

record answer iterable for a specific query and retrieve the updated answers

Specified by:

record in class Cache<Q extends ReasonerQueryImpl,LazyAnswerIterator>

Parameters:

query - to be recorded

answers - to this query

Returns:

updated answer iterable

record

public java.util.stream.Stream<Answer> record(Q query,
                                              java.util.stream.Stream<Answer> answers)

Description copied from class: Cache

record answer stream for a specific query and retrieve the updated stream

Specified by:

record in class Cache<Q extends ReasonerQueryImpl,LazyAnswerIterator>

Parameters:

query - to be recorded

answers - answer stream of the query

Returns:

updated answer stream

recordRetrieveLazy

public LazyAnswerIterator recordRetrieveLazy(Q query,
                                             java.util.stream.Stream<Answer> answers)

Description copied from class: Cache

record answer stream for a specific query and retrieve the updated stream in a lazy iterator

Specified by:

recordRetrieveLazy in class Cache<Q extends ReasonerQueryImpl,LazyAnswerIterator>

Parameters:

query - to be recorded

answers - answer stream of the query

Returns:

lazy iterator of updated answers

getAnswers

public LazyAnswerIterator getAnswers(Q query)

Description copied from class: Cache

retrieve cached answers for provided query

Specified by:

getAnswers in class Cache<Q extends ReasonerQueryImpl,LazyAnswerIterator>

Parameters:

query - for which to retrieve answers

Returns:

unified cached answers

getAnswersWithUnifier

public Pair<LazyAnswerIterator,MultiUnifier> getAnswersWithUnifier(Q query)

Specified by:

getAnswersWithUnifier in class Cache<Q extends ReasonerQueryImpl,LazyAnswerIterator>

getAnswerStream

public java.util.stream.Stream<Answer> getAnswerStream(Q query)

Specified by:

getAnswerStream in class Cache<Q extends ReasonerQueryImpl,LazyAnswerIterator>

getAnswerStreamWithUnifier

public Pair<java.util.stream.Stream<Answer>,MultiUnifier> getAnswerStreamWithUnifier(Q query)

Specified by:

getAnswerStreamWithUnifier in class Cache<Q extends ReasonerQueryImpl,LazyAnswerIterator>

getAnswerIterator

public LazyAnswerIterator getAnswerIterator(Q query)

Specified by:

getAnswerIterator in class Cache<Q extends ReasonerQueryImpl,LazyAnswerIterator>

answerSize

public long answerSize(Set<Q> queries)

Specified by:

answerSize in class Cache<Q extends ReasonerQueryImpl,LazyAnswerIterator>

Parameters:

queries - to be checked

Returns:

number of answers for the specified query set

remove

public void remove(Cache<Q,LazyAnswerIterator> c2,
                   Set<Q> queries)

Description copied from class: Cache

cache subtraction of specified queries

Specified by:

remove in class Cache<Q extends ReasonerQueryImpl,LazyAnswerIterator>

Parameters:

c2 - subtraction right operand

queries - to which answers shall be subtracted

reload

public void reload()

force stream consumption and reload cache

consume

public void consume()