replicant-packages_apps_Email/src/com/android/email/activity/AccountShortcutPicker.java

/*
 * Copyright (C) 2008 The Android Open Source Project
 *
 * 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.email.activity;

import com.android.email.R;
import com.android.emailcommon.provider.EmailContent;
import com.android.emailcommon.provider.EmailContent.Account;
import com.android.emailcommon.utility.Utility;

import android.app.ListActivity;
import android.content.Intent;
import android.database.Cursor;
import android.os.AsyncTask;
import android.os.Bundle;
import android.os.Parcelable;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.ListView;
import android.widget.SimpleCursorAdapter;

/**
 * This class implements a launcher shortcut for directly accessing a single account.
 *
 * TODO Handle upgraded shortcuts for the phone UI release.  Shortcuts used to launch MessageList
 * directly.  We need to detect this and redirect to Welcome.
 */
public class AccountShortcutPicker extends ListActivity
        implements OnClickListener, OnItemClickListener {

    private AccountTask mAccountTask;

    /**
     * Support for list adapter
     */
    private final static String[] FROM_COLUMNS = new String[] {
            EmailContent.AccountColumns.DISPLAY_NAME,
            EmailContent.AccountColumns.EMAIL_ADDRESS,
    };
    private final static int[] TO_IDS = new int[] {
            R.id.description,
            R.id.email,
    };

    @Override
    public void onCreate(Bundle icicle) {
        super.onCreate(icicle);

        // finish() immediately if we aren't supposed to be here
        if (!Intent.ACTION_CREATE_SHORTCUT.equals(getIntent().getAction())) {
            finish();
            return;
        }

        setContentView(R.layout.account_shortcut_picker);
        findViewById(R.id.cancel).setOnClickListener(this);

        ListView listView = getListView();
        listView.setOnItemClickListener(this);
        listView.setItemsCanFocus(false);

        mAccountTask = new AccountTask();
        mAccountTask.execute();
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        // Cleanup running async task (if any)
        Utility.cancelTaskInterrupt(mAccountTask);
        mAccountTask = null;
        // Cleanup accounts cursor (if any)
        SimpleCursorAdapter adapter = (SimpleCursorAdapter) getListAdapter();
        if (adapter != null) {
            adapter.changeCursor(null);
        }
    }

    /**
     * Implements View.OnClickListener
     */
    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.cancel:
                finish();
                break;
        }
    }

    public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
        Cursor cursor = (Cursor)parent.getItemAtPosition(position);
        Account account = new Account();
        account.restore(cursor);
        setupShortcut(account);
        finish();
    }

    /**
     * Load the accounts and create the adapter.
     */
    private class AccountTask extends AsyncTask<Void, Void, Cursor> {

        @Override
        protected Cursor doInBackground(Void... params) {
            Cursor cursor = AccountShortcutPicker.this.getContentResolver().query(
                    EmailContent.Account.CONTENT_URI,
                    EmailContent.Account.CONTENT_PROJECTION,
                    null, null, null);
            if (isCancelled()) {
                cursor.close();
                cursor = null;
            }
            return cursor;
        }

        @Override
        protected void onPostExecute(Cursor cursor) {
            // If canceled, get out immediately
            if (cursor == null || cursor.isClosed()) {
                return;
            }
            // If there are no accounts, we should never have been here - exit the activity
            if (cursor.getCount() == 0) {
                finish();
                return;
            }
            // Create an adapter and connect to the ListView
            AccountShortcutPicker activity = AccountShortcutPicker.this;
            SimpleCursorAdapter adapter = new SimpleCursorAdapter(activity,
                    R.layout.account_shortcut_picker_item, cursor, FROM_COLUMNS, TO_IDS);
            activity.getListView().setAdapter(adapter);
        }
    }

    /**
     * This function creates a shortcut and returns it to the caller.  There are actually two
     * intents that you will send back.
     *
     * The first intent serves as a container for the shortcut and is returned to the launcher by
     * setResult().  This intent must contain three fields:
     *
     * <ul>
     * <li>{@link android.content.Intent#EXTRA_SHORTCUT_INTENT} The shortcut intent.</li>
     * <li>{@link android.content.Intent#EXTRA_SHORTCUT_NAME} The text that will be displayed with
     * the shortcut.</li>
     * <li>{@link android.content.Intent#EXTRA_SHORTCUT_ICON} The shortcut's icon, if provided as a
     * bitmap, <i>or</i> {@link android.content.Intent#EXTRA_SHORTCUT_ICON_RESOURCE} if provided as
     * a drawable resource.</li>
     * </ul>
     *
     * If you use a simple drawable resource, note that you must wrapper it using
     * {@link android.content.Intent.ShortcutIconResource}, as shown below.  This is required so
     * that the launcher can access resources that are stored in your application's .apk file.  If
     * you return a bitmap, such as a thumbnail, you can simply put the bitmap into the extras
     * bundle using {@link android.content.Intent#EXTRA_SHORTCUT_ICON}.
     *
     * The shortcut intent can be any intent that you wish the launcher to send, when the user
     * clicks on the shortcut.  Typically this will be {@link android.content.Intent#ACTION_VIEW}
     * with an appropriate Uri for your content, but any Intent will work here as long as it
     * triggers the desired action within your Activity.
     */
    private void setupShortcut(Account account) {
        // First, set up the shortcut intent.
        Intent shortcutIntent = Welcome.createOpenAccountInboxIntent(this, account.mId);

        // Then, set up the container intent (the response to the caller)
        Intent intent = new Intent();
        intent.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent);
        intent.putExtra(Intent.EXTRA_SHORTCUT_NAME, account.getDisplayName());
        Parcelable iconResource = Intent.ShortcutIconResource.fromContext(this, R.mipmap.ic_launcher_email);
        intent.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, iconResource);

        // Now, return the result to the launcher

        setResult(RESULT_OK, intent);
    }
}