/** * Copyright (c) 2012 Todoroo Inc * * See the file "LICENSE" for the full license governing this code. */ package com.todoroo.andlib.data; import android.database.Cursor; import android.database.CursorWrapper; import com.todoroo.andlib.data.Property.PropertyVisitor; import java.util.WeakHashMap; /** * 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 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 */ public PROPERTY_TYPE get(Property property) { return (PROPERTY_TYPE)property.accept(reader, this); } /** * Gets entire property list */ 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> { @Override public Object visitInteger(Property property, TodorooCursor cursor) { int column = columnIndex(property, cursor); if(property.checkFlag(Property.PROP_FLAG_NULLABLE) && cursor.isNull(column)) { return null; } return cursor.getInt(column); } @Override public Object visitLong(Property property, TodorooCursor cursor) { int column = columnIndex(property, cursor); if(property.checkFlag(Property.PROP_FLAG_NULLABLE) && cursor.isNull(column)) { return null; } return cursor.getLong(column); } @Override public Object visitString(Property property, TodorooCursor cursor) { int column = columnIndex(property, cursor); if(property.checkFlag(Property.PROP_FLAG_NULLABLE) && cursor.isNull(column)) { return null; } return cursor.getString(column); } private int columnIndex(Property property, TodorooCursor cursor) { return cursor.getColumnIndexFromCache(property.getColumnName()); } } }