SearchSettings.java revision 94e8a2be78530170f50e7895a558bf8011bbf8e8 
1/*
2 * Copyright (C) 2009 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package com.android.quicksearchbox;
18
19import android.app.AlertDialog;
20import android.app.Dialog;
21import android.app.SearchManager;
22import android.content.DialogInterface;
23import android.content.Intent;
24import android.content.pm.PackageManager;
25import android.content.pm.ResolveInfo;
26import android.os.Bundle;
27import android.preference.CheckBoxPreference;
28import android.preference.Preference;
29import android.preference.PreferenceActivity;
30import android.preference.PreferenceGroup;
31import android.preference.PreferenceScreen;
32import android.preference.Preference.OnPreferenceChangeListener;
33import android.preference.Preference.OnPreferenceClickListener;
34import android.util.Log;
35
36import java.util.List;
37
38/**
39 * Activity for setting global search preferences. Changes to search preferences trigger a broadcast
40 * intent that causes all SuggestionSources objects to be updated.
41 */
42public class SearchSettings extends PreferenceActivity
43        implements OnPreferenceClickListener, OnPreferenceChangeListener {
44
45    private static final boolean DBG = false;
46    private static final String TAG = "SearchSettings";
47
48    // Only used to find the preferences after inflating
49    private static final String CLEAR_SHORTCUTS_PREF = "clear_shortcuts";
50    private static final String SEARCH_ENGINE_SETTINGS_PREF = "search_engine_settings";
51    private static final String SEARCH_SOURCES_PREF = "search_sources";
52
53    private SourceLookup mSources;
54    private ShortcutRepository mShortcuts;
55
56    // References to the top-level preference objects
57    private Preference mClearShortcutsPreference;
58    private PreferenceScreen mSearchEngineSettingsPreference;
59    private PreferenceGroup mSourcePreferences;
60
61    // Dialog ids
62    private static final int CLEAR_SHORTCUTS_CONFIRM_DIALOG = 0;
63
64    @Override
65    protected void onCreate(Bundle savedInstanceState) {
66        super.onCreate(savedInstanceState);
67
68        mSources = getSources();
69        mShortcuts = getQSBApplication().getShortcutRepository();
70        getPreferenceManager().setSharedPreferencesName(Sources.PREFERENCES_NAME);
71
72        addPreferencesFromResource(R.xml.preferences);
73
74        PreferenceScreen preferenceScreen = getPreferenceScreen();
75        mClearShortcutsPreference = preferenceScreen.findPreference(CLEAR_SHORTCUTS_PREF);
76        mSearchEngineSettingsPreference = (PreferenceScreen) preferenceScreen.findPreference(
77                SEARCH_ENGINE_SETTINGS_PREF);
78        mSourcePreferences = (PreferenceGroup) getPreferenceScreen().findPreference(
79                SEARCH_SOURCES_PREF);
80
81        mClearShortcutsPreference.setOnPreferenceClickListener(this);
82
83        updateClearShortcutsPreference();
84        populateSourcePreference();
85        populateSearchEnginePreference();
86    }
87
88    @Override
89    protected void onDestroy() {
90        mShortcuts.close();
91        super.onDestroy();
92    }
93
94    private QsbApplication getQSBApplication() {
95        return (QsbApplication) getApplication();
96    }
97
98    private Config getConfig() {
99        return getQSBApplication().getConfig();
100    }
101
102    private SourceLookup getSources() {
103        return getQSBApplication().getSources();
104    }
105
106    /**
107     * Enables/disables the "Clear search shortcuts" preference depending
108     * on whether there is any search history.
109     */
110    private void updateClearShortcutsPreference() {
111        boolean hasHistory = mShortcuts.hasHistory();
112        if (DBG) Log.d(TAG, "hasHistory()=" + hasHistory);
113        mClearShortcutsPreference.setEnabled(hasHistory);
114    }
115
116    /**
117     * Populates the preference item for the web search engine, which links to further
118     * search settings.
119     */
120    private void populateSearchEnginePreference() {
121        Intent intent = new Intent(SearchManager.INTENT_ACTION_WEB_SEARCH_SETTINGS);
122        intent.setPackage(getPackageName());
123
124        CharSequence webSearchSettingsLabel = getActivityLabel(intent);
125        mSearchEngineSettingsPreference.setTitle(webSearchSettingsLabel);
126        mSearchEngineSettingsPreference.setIntent(intent);
127    }
128
129    private CharSequence getActivityLabel(Intent intent) {
130        PackageManager pm = getPackageManager();
131        List<ResolveInfo> resolveInfos = pm.queryIntentActivities(intent, 0);
132        if (resolveInfos.size() == 0) {
133            Log.e(TAG, "No web search settings activity");
134            return null;
135        }
136        if (resolveInfos.size() > 1) {
137            Log.e(TAG, "More than one web search settings activity");
138            return null;
139        }
140        return resolveInfos.get(0).activityInfo.loadLabel(pm);
141    }
142
143    /**
144     * Fills the suggestion source list.
145     */
146    private void populateSourcePreference() {
147        for (Source source : mSources.getSources()) {
148            Preference pref = createSourcePreference(source);
149            if (pref != null) {
150                if (DBG) Log.d(TAG, "Adding search source: " + source);
151                mSourcePreferences.addPreference(pref);
152            }
153        }
154    }
155
156    /**
157     * Adds a suggestion source to the list of suggestion source checkbox preferences.
158     */
159    private Preference createSourcePreference(Source source) {
160        CheckBoxPreference sourcePref = new CheckBoxPreference(this);
161        sourcePref.setKey(Sources.getSourceEnabledPreference(source));
162        sourcePref.setDefaultValue(mSources.isTrustedSource(source));
163        sourcePref.setOnPreferenceChangeListener(this);
164        CharSequence label = source.getLabel();
165        sourcePref.setTitle(label);
166        sourcePref.setSummaryOn(source.getSettingsDescription());
167        sourcePref.setSummaryOff(source.getSettingsDescription());
168        return sourcePref;
169    }
170
171    /**
172     * Handles clicks on the "Clear search shortcuts" preference.
173     */
174    public synchronized boolean onPreferenceClick(Preference preference) {
175        if (preference == mClearShortcutsPreference) {
176            showDialog(CLEAR_SHORTCUTS_CONFIRM_DIALOG);
177            return true;
178        }
179        return false;
180    }
181
182    @Override
183    protected Dialog onCreateDialog(int id) {
184        switch (id) {
185            case CLEAR_SHORTCUTS_CONFIRM_DIALOG:
186                return new AlertDialog.Builder(this)
187                        .setTitle(R.string.clear_shortcuts)
188                        .setMessage(R.string.clear_shortcuts_prompt)
189                        .setPositiveButton(R.string.agree, new DialogInterface.OnClickListener() {
190                            public void onClick(DialogInterface dialog, int whichButton) {
191                                if (DBG) Log.d(TAG, "Clearing history...");
192                                mShortcuts.clearHistory();
193                                updateClearShortcutsPreference();
194                            }
195                        })
196                        .setNegativeButton(R.string.disagree, null).create();
197            default:
198                Log.e(TAG, "unknown dialog" + id);
199                return null;
200        }
201    }
202
203    /**
204     * Informs our listeners (SuggestionSources objects) about the updated settings data.
205     */
206    private void broadcastSettingsChanged() {
207        // We use a message broadcast since the listeners could be in multiple processes.
208        Intent intent = new Intent(SearchManager.INTENT_ACTION_SEARCH_SETTINGS_CHANGED);
209        Log.i(TAG, "Broadcasting: " + intent);
210        sendBroadcast(intent);
211    }
212
213    public synchronized boolean onPreferenceChange(Preference preference, Object newValue) {
214        broadcastSettingsChanged();
215        return true;
216    }
217
218}
219