Package com.atlassian.jira.entity

Class SelectQueryImpl.ExecutionContextImpl<E>

java.lang.Object

com.atlassian.jira.entity.SelectQueryImpl.ExecutionContextImpl<E>

All Implemented Interfaces:

SelectQuery.ExecutionContext<E>

Enclosing class:

SelectQueryImpl<E>

public final class SelectQueryImpl.ExecutionContextImpl<E>
extends Object
implements SelectQuery.ExecutionContext<E>

Constructor Summary

Constructors

Constructor	Description
ExecutionContextImpl(OfBizDelegator ofBizDelegator, EntityBuilder<E> entityBuilder)

Method Summary

Modifier and Type	Method	Description
List<E>	asList()	Returns the selected values in a list.
<R> List<R>	asList(Function<E,R> mappingFunction)	Returns the selected values in a list with the mapping function applied to each of them.
<K, V> Map<K,V>	asMap(Function<E,K> keyMapper, Function<E,V> valueMapper)	Returns the selected values in a map with the mapping functions applies to each of them.
<R> R	consumeWith(EntityListConsumer<E,R> consumer)	Apply an EntityListConsumer to the returned results.
long	count()	Returns a count of matching items.
void	forEach(Consumer<E> consumer)	Performs the given action for each entity returned by the query.
E	singleValue()	Returns the single Entity that is the result of this query.
String	toString()
void	visitWith(Visitor<E> visitor)	Visits each entity returned by the query.

Methods inherited from class java.lang.Object

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

Constructor Details

ExecutionContextImpl

public ExecutionContextImpl(OfBizDelegator ofBizDelegator,
 EntityBuilder<E> entityBuilder)

Method Details

asList

@Nonnull
public List<E> asList()

Description copied from interface: SelectQuery.ExecutionContext

Returns the selected values in a list.

Specified by:

asList in interface SelectQuery.ExecutionContext<E>

Returns:

the selected values in a list.

asList

@Nonnull
public <R> List<R> asList(@Nonnull
 Function<E,R> mappingFunction)

Description copied from interface: SelectQuery.ExecutionContext

Returns the selected values in a list with the mapping function applied to each of them. For example, if mappingFunction is a Function<GenericValue,String>, then each value is returned as the String produced by the function instead of the GenericValue itself.

Specified by:

asList in interface SelectQuery.ExecutionContext<E>

Type Parameters:

R - the type of value returned by the mapping function

Returns:

the selected values as a list of the yielded values.

asMap

@Nonnull
public <K,
V> Map<K,V> asMap(@Nonnull
 Function<E,K> keyMapper,
 @Nonnull
 Function<E,V> valueMapper)

Description copied from interface: SelectQuery.ExecutionContext

Returns the selected values in a map with the mapping functions applies to each of them. For example, if keyMapper is a Function<GenericValue,Long>, and valueMapper is a Function<GenericValue,String>, then the returned map is of type Map<Long,String>. If the same key is returned by the keyMapper more than once, the last value wins. The functions are permitted to return null.

Specified by:

asMap in interface SelectQuery.ExecutionContext<E>

Type Parameters:

K - the inferred key type for the returned map

V - the inferred value type for the returned map

Parameters:

keyMapper - the function that maps the queries values to the returned map's keys

valueMapper - the function that maps the queries values to the returned map's values

Returns:

the map produced by the query

visitWith

public void visitWith(@Nonnull
 Visitor<E> visitor)

Description copied from interface: SelectQuery.ExecutionContext

Visits each entity returned by the query.

Specified by:

visitWith in interface SelectQuery.ExecutionContext<E>

Parameters:

visitor - the visitor to call with each entity that the query returns

See Also:

• SelectQuery.ExecutionContext.forEach(Consumer)

singleValue

@Nullable
public E singleValue()
              throws IllegalStateException

Description copied from interface: SelectQuery.ExecutionContext

Returns the single Entity that is the result of this query.

Will return null if no rows were returned by the DB query.

Specified by:

singleValue in interface SelectQuery.ExecutionContext<E>

Returns:

the single matching value, or null if no match is found.

Throws:

IllegalStateException - if more than one row is found.

consumeWith

public <R> R consumeWith(@Nonnull
 EntityListConsumer<E,R> consumer)

Description copied from interface: SelectQuery.ExecutionContext

Apply an EntityListConsumer to the returned results.

This is equivalent to calling SelectQuery.ExecutionContext.visitWith(Visitor), except that the entity list consumer can return a value.

Specified by:

consumeWith in interface SelectQuery.ExecutionContext<E>

Type Parameters:

R - the return value of the consumer

Parameters:

consumer - the entity list consumer that will consume the query results

Returns:

the result returned by the consumer's EntityListConsumer.result() method.

forEach

public void forEach(@Nonnull
 Consumer<E> consumer)

Description copied from interface: SelectQuery.ExecutionContext

Performs the given action for each entity returned by the query. This is morally equivalent to SelectQuery.ExecutionContext.visitWith(Visitor), but is more consistent with the naming conventions of the Java 8 streaming interfaces.

Specified by:

forEach in interface SelectQuery.ExecutionContext<E>

Parameters:

consumer - the action to be performed

See Also:

• SelectQuery.ExecutionContext.visitWith(Visitor)

count

public long count()

Description copied from interface: SelectQuery.ExecutionContext

Returns a count of matching items. Note that this does not go through the the entityName + "Count" pseudo-view stuff in the entity model, but rather generates a count function directly in the query that it executes, so you should be able to use it with arbitrary entities.

Specified by:

count in interface SelectQuery.ExecutionContext<E>

Returns:

count of matching items

toString

public String toString()

Overrides:

toString in class Object