com.yek.keyboard.dictionaries.content.ContactsDictionary.java Source code

Java tutorial

Introduction

Here is the source code for com.yek.keyboard.dictionaries.content.ContactsDictionary.java

Source

/*
 * Copyright (c) 2013 Menny Even-Danan
 *
 * 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.yek.keyboard.dictionaries.content;

import android.Manifest;
import android.annotation.TargetApi;
import android.app.PendingIntent;
import android.content.ContentResolver;
import android.content.Context;
import android.content.Intent;
import android.database.ContentObserver;
import android.database.Cursor;
import android.provider.ContactsContract.Contacts;
import android.support.v4.app.NotificationCompat;
import android.support.v4.app.NotificationManagerCompat;
import android.support.v4.util.ArrayMap;

import com.yek.keyboard.anysoftkeyboard.PermissionsRequestCodes;
import com.yek.keyboard.dictionaries.BTreeDictionary;
import com.anysoftkeyboard.nextword.NextWord;
import com.anysoftkeyboard.nextword.NextWordGetter;
import com.yek.keyboard.ui.settings.MainSettingsActivity;
import com.yek.keyboard.R;

import net.evendanan.chauffeur.lib.permissions.PermissionsFragmentChauffeurActivity;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;
import java.util.Map;

@TargetApi(7)
public class ContactsDictionary extends BTreeDictionary implements NextWordGetter {

    protected static final String TAG = "ASK CDict";
    /**
     * A contact is a valid word in a language, and it usually very frequent.
     */
    private static final int MINIMUM_CONTACT_WORD_FREQUENCY = 64;
    private static final String[] PROJECTION = { Contacts._ID, Contacts.DISPLAY_NAME, Contacts.STARRED,
            Contacts.TIMES_CONTACTED };
    private static final int INDEX_NAME = 1;
    private static final int INDEX_STARRED = 2;
    private static final int INDEX_TIMES = 3;
    private final Map<CharSequence, String[]> mNextNameParts = new ArrayMap<>();
    private final Map<CharSequence, Map<CharSequence, NextWord>> mLoadingPhaseNextNames = new ArrayMap<>();

    public ContactsDictionary(Context context) {
        super("ContactsDictionary", context);
    }

    @Override
    protected void registerObserver(ContentObserver dictionaryContentObserver, ContentResolver contentResolver) {
        contentResolver.registerContentObserver(Contacts.CONTENT_URI, true, dictionaryContentObserver);
    }

    @Override
    protected void loadAllResources() {
        super.loadAllResources();
        mNextNameParts.clear();
        //converting the loaded NextWord into a simple, static array
        for (Map.Entry<CharSequence, Map<CharSequence, NextWord>> entry : mLoadingPhaseNextNames.entrySet()) {
            final CharSequence firstWord = entry.getKey();
            List<NextWord> nextWordList = new ArrayList<>(entry.getValue().values());
            Collections.sort(nextWordList, new NextWord.NextWordComparator());
            String[] nextParts = new String[nextWordList.size()];
            for (int index = 0; index < nextParts.length; index++)
                nextParts[index] = nextWordList.get(index).nextWord;
            mNextNameParts.put(firstWord, nextParts);
        }
        mLoadingPhaseNextNames.clear();
    }

    @Override
    protected void readWordsFromActualStorage(WordReadListener listener) {
        //we required Contacts permission
        if (true)
            return;
        Intent contactsRequired = PermissionsFragmentChauffeurActivity.createIntentToPermissionsRequest(mContext,
                MainSettingsActivity.class, PermissionsRequestCodes.CONTACTS.getRequestCode(),
                Manifest.permission.READ_CONTACTS);
        if (contactsRequired != null) {
            //we are running OUTSIDE an Activity
            contactsRequired.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            //showing a notification, so the user's flow will not be interrupted.
            showNotificationWithIntent(contactsRequired);
            //and failing. So it will try to read contacts again
            throw new RuntimeException("We do not have permission to read contacts!");
        } else {
            Cursor cursor = mContext.getContentResolver().query(Contacts.CONTENT_URI, PROJECTION,
                    Contacts.IN_VISIBLE_GROUP + "=?", new String[] { "1" }, null);
            if (cursor != null && cursor.moveToFirst()) {
                while (!cursor.isAfterLast()) {
                    final String fullname = cursor.getString(INDEX_NAME);
                    final int freq;
                    //in contacts, the frequency is a bit tricky:
                    //stared contacts are really high
                    final boolean isStarred = cursor.getInt(INDEX_STARRED) > 0;
                    if (isStarred) {
                        freq = MAX_WORD_FREQUENCY;// WOW! important!
                    } else {
                        //times contacted will be our frequency
                        final int frequencyContacted = cursor.getInt(INDEX_TIMES);
                        //A contact is a valid word in a language, and it usually very frequent.
                        final int minimumAdjustedFrequencyContacted = Math.max(MINIMUM_CONTACT_WORD_FREQUENCY,
                                frequencyContacted);
                        //but no more than the max allowed
                        freq = Math.min(minimumAdjustedFrequencyContacted, MAX_WORD_FREQUENCY);
                    }
                    if (!listener.onWordRead(fullname, freq))
                        break;
                    cursor.moveToNext();
                }
            }
            if (cursor != null)
                cursor.close();
        }
    }

    private void showNotificationWithIntent(Intent contactsRequired) {
        final int requestId = PermissionsRequestCodes.CONTACTS.getRequestCode();
        PendingIntent pendingIntent = PendingIntent.getActivity(mContext, requestId, contactsRequired, 0);
        NotificationCompat.Builder builder = new NotificationCompat.Builder(mContext);
        builder.setTicker(mContext.getString(R.string.notification_read_contacts_ticker));
        builder.setSmallIcon(R.drawable.ic_notification_contacts_permission_required);
        builder.setContentIntent(pendingIntent);
        builder.setContentTitle(mContext.getString(R.string.notification_read_contacts_title));
        builder.setContentText(mContext.getString(R.string.notification_read_contacts_text));
        builder.setAutoCancel(true);
        NotificationManagerCompat.from(mContext).notify(requestId, builder.build());
    }

    @Override
    protected void addWordFromStorageToMemory(String name, int frequency) {
        //the word in Contacts is actually the full name,
        //so, let's break it to individual words.
        int len = name.length();

        // TODO: Better tokenization for non-Latin writing systems
        String previousNamePart = null;
        for (int i = 0; i < len; i++) {
            if (Character.isLetter(name.charAt(i))) {
                int j;
                for (j = i + 1; j < len; j++) {
                    char c = name.charAt(j);

                    if (c != '-' && c != '\'' && !Character.isLetter(c)) {
                        break;
                    }
                }

                String namePart = name.substring(i, j);
                i = j - 1;

                // Safeguard against adding really long
                // words. Stack
                // may overflow due to recursion
                // Also don't add single letter words,
                // possibly confuses
                // capitalization of i.
                final int namePartLength = namePart.length();
                if (namePartLength < MAX_WORD_LENGTH && namePartLength > 1) {
                    //adding to next-namePart dictionary
                    if (previousNamePart != null) {
                        Map<CharSequence, NextWord> nextWords;
                        if (mLoadingPhaseNextNames.containsKey(previousNamePart)) {
                            nextWords = mLoadingPhaseNextNames.get(previousNamePart);
                        } else {
                            nextWords = new ArrayMap<>();
                            mLoadingPhaseNextNames.put(previousNamePart, nextWords);
                        }

                        if (nextWords.containsKey(namePart))
                            nextWords.get(namePart).markAsUsed();
                        else
                            nextWords.put(namePart, new NextWord(namePart));
                    }

                    int oldFrequency = getWordFrequency(namePart);
                    //ensuring that frequencies do not go lower
                    if (oldFrequency < frequency) {
                        super.addWordFromStorageToMemory(namePart, frequency);
                    }
                }
                //remembering this for the next loop
                previousNamePart = namePart;
            }
        }
    }

    @Override
    protected void deleteWordFromStorage(String word) {
        //not going to support deletion of contacts!
    }

    @Override
    protected void addWordToStorage(String word, int frequency) {
        //not going to support addition of contacts!
    }

    @Override
    protected void closeStorage() {
        /*nothing to close here*/
    }

    @Override
    public Iterable<String> getNextWords(CharSequence currentWord, int maxResults, int minWordUsage) {
        if (mNextNameParts.containsKey(currentWord)) {
            return Arrays.asList(mNextNameParts.get(currentWord));
        } else {
            return Collections.emptyList();
        }
    }
}