/*
 * ASTRID: Android's Simple Task Recording Dashboard
 *
 * Copyright (c) 2009 Tim Su
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
 * for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 */
package com.timsu.astrid.data;

import java.util.Date;

import android.content.ContentValues;
import android.database.Cursor;

/** A data object backed by a database */
public abstract class AbstractModel {

    /* Data Source Ordering:
     *
     * In order to return the best data, we want to check first what the user
     * has explicitly set (setValues), then the values we have read out of
     * the database (values), the database itself (cursor), then defaults
     * (getDefaultValues)
     */

    /** User set values */
    protected ContentValues setValues     = new ContentValues();

    /** Cached values from database */
    private ContentValues   values        = new ContentValues();

    /** Cursor into the database */
    private Cursor          cursor        = null;

    // --- constructors

    /** Construct a model from scratch */
    public AbstractModel() {
        // ...
    }

    /** Construct a model from a database object */
    public AbstractModel(Cursor cursor) {
        this.cursor = cursor;
    }

    // --- data source getters

    /** Get the user-set values for this object */
    public ContentValues getSetValues() {
        return setValues;
    }

    /** Get the default values for this object */
    abstract public ContentValues getDefaultValues();

    /** Get a list of all field/value pairs merged across data sources */
    public ContentValues getMergedValues() {
        ContentValues mergedValues = new ContentValues();

        mergedValues.putAll(getDefaultValues());
        mergedValues.putAll(values);
        mergedValues.putAll(setValues);

        return mergedValues;
    }

    /** Return the database cursor */
    public Cursor getCursor() {
        return cursor;
    }

    // --- data retrieval for the different object types

    protected String retrieveString(String field) {
        if(setValues.containsKey(field))
            return setValues.getAsString(field);

        if(values.containsKey(field))
            return values.getAsString(field);

        // if we have a database to hit, do that now
        if(cursor != null) {
            String value = cursor.getString(cursor.getColumnIndexOrThrow(field));
            values.put(field, value);
            return value;
        }

        // do we have defaults?
        ContentValues defaults = getDefaultValues();
        if(defaults != null && defaults.containsKey(field))
            return defaults.getAsString(field);

        throw new UnsupportedOperationException("Could not read field " + field);
    }

    protected Integer retrieveInteger(String field) {
        if(setValues.containsKey(field))
            return setValues.getAsInteger(field);

        if(values.containsKey(field))
            return values.getAsInteger(field);

        // if we have a database to hit, do that now
        if(cursor != null) {
            Integer value = cursor.getInt(cursor.getColumnIndexOrThrow(field));
            values.put(field, value);
            return value;
        }

        // do we have defaults?
        ContentValues defaults = getDefaultValues();
        if(defaults != null && defaults.containsKey(field))
            return defaults.getAsInteger(field);

        throw new UnsupportedOperationException("Could not read field " + field);
    }

    protected Long retrieveLong(String field) {
        if(setValues.containsKey(field))
            return setValues.getAsLong(field);

        if(values.containsKey(field))
            return values.getAsLong(field);

        // if we have a database to hit, do that now
        if(cursor != null) {
            Long value = cursor.getLong(cursor.getColumnIndexOrThrow(field));
            values.put(field, value);
            return value;
        }

        // do we have defaults?
        ContentValues defaults = getDefaultValues();
        if(defaults != null && defaults.containsKey(field))
            return defaults.getAsLong(field);

        throw new UnsupportedOperationException("Could not read field " + field);
    }

    protected Double retrieveDouble(String field) {
        if(setValues.containsKey(field))
            return setValues.getAsDouble(field);

        if(values.containsKey(field))
            return values.getAsDouble(field);

        // if we have a database to hit, do that now
        if(cursor != null) {
            Double value = cursor.getDouble(cursor.getColumnIndexOrThrow(field));
            values.put(field, value);
            return value;
        }

        // do we have defaults?
        ContentValues defaults = getDefaultValues();
        if(defaults != null && defaults.containsKey(field))
            return defaults.getAsDouble(field);

        throw new UnsupportedOperationException("Could not read field " + field);
    }

    // --- retrieving composite objects

    protected Date retrieveDate(String field) {
        Long time = retrieveLong(field);
        if(time == null || time == 0)
            return null;

        return new Date(time);
    }
}