mail/ui/RecentFolderList.java

/**
 * Copyright (c) 2011, Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.android.mail.ui;

import android.content.ContentResolver;
import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.text.TextUtils;
import android.os.AsyncTask;

import com.android.mail.providers.Account;
import com.android.mail.providers.Folder;
import com.android.mail.providers.UIProvider;
import com.android.mail.utils.LogUtils;
import com.android.mail.utils.LruCache;

import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.List;

/**
 * A self-updating list of folder canonical names for the N most recently touched folders, ordered
 * from least-recently-touched to most-recently-touched. N is a fixed size determined upon
 * creation.
 *
 * RecentFoldersCache returns lists of this type, and will keep them updated when observers are
 * registered on them.
 *
 */
public final class RecentFolderList {
    private static final String LOG_TAG = new LogUtils().getLogTag();
    /** The application context */
    private final Context mContext;
    /** The current account */
    private Account mAccount = null;
    /**
     * Compare based on alphanumeric name of the folder, ignoring case.
     */
    private static final Comparator<Folder> ALPHABET_IGNORECASE = new Comparator<Folder>() {
        @Override
        public int compare(Folder lhs, Folder rhs) {
            return lhs.name.compareToIgnoreCase(rhs.name);
        }
    };
    private final LruCache<String, Folder> mFolderCache;
    /**
     *  We want to show five recent folders, and one space for the current folder (not displayed
     *  to the user).
     */
    private final static int NUM_FOLDERS = 5 + 1;
    /**
     * Class to store the recent folder list asynchronously.
     */
    private class StoreRecent extends AsyncTask<ContentValues, Void, Void> {
        final ContentResolver mResolver;
        final Account mAccount;

        public StoreRecent(Context context, Account account) {
            mResolver = context.getContentResolver();
            mAccount = account;
        }

        @Override
        protected Void doInBackground(ContentValues... valuesArray) {
            mResolver.update(mAccount.recentFolderListUri, valuesArray[0], null, null);
            return null;
        }
    }

    /**
     * Create a Recent Folder List from the given account. This will query the UIProvider to
     * retrieve the RecentFolderList from persistent storage (if any).
     * @param account
     */
    public RecentFolderList(Context context) {
        mFolderCache = new LruCache<String, Folder>(NUM_FOLDERS);
        mContext = context;
    }

    /**
     * Change the current account. This causes the recent label list to be written out to the
     * provider. When a cursor over the recent folders for this account is available, the client
     * <b>must</b> call {@link #loadFromUiProvider(Cursor)} with the updated cursor. Till then,
     * the recent account list will be empty.
     * @param account
     */
    public void setCurrentAccount(Account account) {
        saveToUiProvider();
        mAccount = account;
        // At some point in the future, the load method will return and populate our cache with
        // useful entries. But for now, the cache is invalid.
        mFolderCache.clear();
    }

    /**
     * Load the account information from the UI provider given the cursor over the recent folders.
     * @param data a cursor over the recent folders.
     */
    public void loadFromUiProvider(Cursor data) {
        if (mAccount == null || mAccount.recentFolderListUri == null || data == null
                || data.getCount() <= 0)
            return;
        int i = 0;
        while (data.moveToNext()) {
            assert (data.getColumnCount() == UIProvider.FOLDERS_PROJECTION.length);
            Folder folder = new Folder(data);
            mFolderCache.putElement(folder.id, folder);
            i++;
            if (i >= NUM_FOLDERS)
                break;
        }
    }

    /**
     * Marks the given folder as 'accessed' by the user interface, and its entry is updated in the
     * recent folder list.
     * @param folder the folder we have changed to.
     */
    public void touchFolder(Folder folder) {
        mFolderCache.putElement(folder.id, folder);
        // Update the UiProvider with the current recent folder list.
        // TODO(viki): Perhaps not do this on every touch. This is excessive.
        saveToUiProvider();
    }

    /**
     * Requests the UIProvider to save this RecentFolderList to persistent storage.
     */
    private void saveToUiProvider() {
        if (mAccount == null || mFolderCache.isEmpty() || mAccount.recentFolderListUri == null)
            return;
        // TODO: Remove this test
        if (TextUtils.equals("null", mAccount.recentFolderListUri.toString())) {
            LogUtils.d(LOG_TAG, "recent folder list uri was null for account " + mAccount.name);
            return;
        }
        // Write the current recent folder list into the account.
        // Store the ID of the folder and the last touched timestamp.
        ContentValues values = new ContentValues();
        // TODO(viki): Fix the timestamps here, and put real timestamps rather than garbage.
        final long now = System.currentTimeMillis();
        for (String id : mFolderCache.keySet()) {
            values.put(id, now);
        }
        // Store the values in the background.
        new StoreRecent(mContext, mAccount).execute(values);
    }

    /**
     * Generate a sorted array of recent folders, excluding the specified folders.
     * @param exclude the folders to be excluded.
     */
    public Folder[] getSortedArray(Folder exclude) {
        final int spaceForCurrentFolder =
                (exclude != null && mFolderCache.getElement(exclude.id) != null)
                        ? 1 : 0;
        final int numRecents = mFolderCache.size() - spaceForCurrentFolder;
        final Folder[] folders = new Folder[numRecents];
        int i = 0;
        final List<Folder> recent = new ArrayList<Folder>(mFolderCache.values());
        Collections.sort(recent, ALPHABET_IGNORECASE);
        for (Folder f : recent) {
            if (exclude == null || !TextUtils.equals(f.id, exclude.id)) {
                folders[i++] = f;
            }
        }
        return folders;
    }
}