io.requery.android

Class QueryAdapter<E>

java.lang.Object

android.widget.BaseAdapter

io.requery.android.QueryAdapter<E>

Type Parameters:

E - entity element type

All Implemented Interfaces:

android.widget.Adapter, android.widget.ListAdapter, android.widget.SpinnerAdapter, java.io.Closeable, java.lang.AutoCloseable

public abstract class QueryAdapter<E>
extends android.widget.BaseAdapter
implements java.io.Closeable

An implementation of BaseAdapter specifically for displaying items from a EntityDataStore query. To use extend this class and implement performQuery() and getView(Object, View, ViewGroup).

Field Summary

Fields inherited from interface android.widget.Adapter

IGNORE_ITEM_VIEW_TYPE, NO_SELECTION

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	QueryAdapter() Creates a new adapter instance without any type mapping.
protected	QueryAdapter(io.requery.meta.EntityModel model, java.lang.Class<E> type) Creates a new adapter instance.
protected	QueryAdapter(io.requery.meta.Type<E> type) Creates a new adapter instance mapped to the given type.

Method Summary

Modifier and Type	Method and Description
void	close() Call this to clean up the underlying result.
int	getCount()
E	getItem(int position)
long	getItemId(int position)
abstract android.view.View	getView(E item, android.view.View convertView, android.view.ViewGroup parent) Called to display the data at the specified position for the given item.
android.view.View	getView(int position, android.view.View convertView, android.view.ViewGroup parent)
abstract io.requery.query.Result<E>	performQuery() Implement this method with your query operation.
void	queryAsync() Schedules the query to be run in the background.
void	setExecutor(java.util.concurrent.ExecutorService executor) Sets the Executor used for running the query off the main thread.
void	setResult(io.requery.sql.ResultSetIterator<E> iterator) Sets the results the adapter should display.

Methods inherited from class android.widget.BaseAdapter

areAllItemsEnabled, getDropDownView, getItemViewType, getViewTypeCount, hasStableIds, isEmpty, isEnabled, notifyDataSetChanged, notifyDataSetInvalidated, registerDataSetObserver, unregisterDataSetObserver

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryAdapter

protected QueryAdapter(io.requery.meta.EntityModel model,
                       java.lang.Class<E> type)

Creates a new adapter instance.

Parameters:

model - database entity model

type - entity class type

QueryAdapter

protected QueryAdapter()

Creates a new adapter instance without any type mapping.

QueryAdapter

protected QueryAdapter(io.requery.meta.Type<E> type)

Creates a new adapter instance mapped to the given type.

Parameters:

type - entity type

Method Detail

close

public void close()

Call this to clean up the underlying result.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

setExecutor

public void setExecutor(java.util.concurrent.ExecutorService executor)

Sets the Executor used for running the query off the main thread.

Parameters:

executor - ExecutorService to use for the background query.

setResult

public void setResult(io.requery.sql.ResultSetIterator<E> iterator)

Sets the results the adapter should display.

Parameters:

iterator - result set iterator

queryAsync

public void queryAsync()

Schedules the query to be run in the background. After completion setResult(ResultSetIterator) will be called to update the contents of the adapter. Note if an Executor was not specified one will be created automatically to run the query.

performQuery

public abstract io.requery.query.Result<E> performQuery()

Implement this method with your query operation. Note this method is executed on a background thread not the main thread.

Returns:

query result set

See Also:

setExecutor(ExecutorService)

getItem

public E getItem(int position)

Specified by:

getItem in interface android.widget.Adapter

getView

public android.view.View getView(int position,
                                 android.view.View convertView,
                                 android.view.ViewGroup parent)

Specified by:

getView in interface android.widget.Adapter

getView

public abstract android.view.View getView(E item,
                                          android.view.View convertView,
                                          android.view.ViewGroup parent)

Called to display the data at the specified position for the given item. The item is retrieved from the result iterator.

Parameters:

item - entity element to bind to the view

convertView - view being recycled

parent - parent view

getItemId

public long getItemId(int position)

Specified by:

getItemId in interface android.widget.Adapter

getCount

public int getCount()

Specified by:

getCount in interface android.widget.Adapter