/** * See the file "LICENSE" for the full license governing this code. */ package com.todoroo.andlib.data; import java.util.WeakHashMap; import android.database.Cursor; import android.database.CursorWrapper; import com.todoroo.andlib.data.Property.PropertyVisitor; /** * AstridCursor wraps a cursor and allows users to query for individual * {@link Property} types or read an entire {@link AbstractModel} from * a database row. * * @author Tim Su * * @param a model type that is returned by this cursor */ public class TodorooCursor extends CursorWrapper { /** Properties read by this cursor */ private final Property[] properties; /** Weakly cache field name to column id references for this cursor. * Because it's a weak hash map, entire keys can be discarded by GC */ private final WeakHashMap columnIndexCache; /** Property reading visitor */ private static final CursorReadingVisitor reader = new CursorReadingVisitor(); /** * Create an AstridCursor from the supplied {@link Cursor} * object. * * @param cursor * @param properties properties read from this cursor */ public TodorooCursor(Cursor cursor, Property[] properties) { super(cursor); this.properties = properties; columnIndexCache = new WeakHashMap(); } /** * Get the value for the given property on the underlying {@link Cursor} * * @param type to return * @param property to retrieve * @return */ public PROPERTY_TYPE get(Property property) { return (PROPERTY_TYPE)property.accept(reader, this); } /** * Gets entire property list * @return */ public Property[] getProperties() { return properties; } /** * Use cache to get the column index for the given field name */ public synchronized int getColumnIndexFromCache(String field) { Integer index = columnIndexCache.get(field); if(index == null) { index = getColumnIndexOrThrow(field); columnIndexCache.put(field, index); } return index; } /** * Visitor that reads the given property from a cursor * * @author Tim Su * */ public static class CursorReadingVisitor implements PropertyVisitor> { public Object visitDouble(Property property, TodorooCursor cursor) { return cursor.getDouble(cursor.getColumnIndexFromCache(property.name)); } public Object visitInteger(Property property, TodorooCursor cursor) { return cursor.getInt(cursor.getColumnIndexFromCache(property.name)); } public Object visitLong(Property property, TodorooCursor cursor) { return cursor.getLong(cursor.getColumnIndexFromCache(property.name)); } public Object visitString(Property property, TodorooCursor cursor) { return cursor.getString(cursor.getColumnIndexFromCache(property.name)); } } }