diff options
Diffstat (limited to 'java/com/android/dialer/calllog/datasources')
3 files changed, 240 insertions, 0 deletions
diff --git a/java/com/android/dialer/calllog/datasources/CallLogDataSource.java b/java/com/android/dialer/calllog/datasources/CallLogDataSource.java new file mode 100644 index 000000000..13d0b842d --- /dev/null +++ b/java/com/android/dialer/calllog/datasources/CallLogDataSource.java @@ -0,0 +1,68 @@ +/* + * Copyright (C) 2017 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.dialer.calllog.datasources; + +import android.content.Context; +import android.database.sqlite.SQLiteDatabase; +import android.support.annotation.MainThread; +import android.support.annotation.WorkerThread; +import com.android.dialer.calllog.database.CallLogMutations; + +/** A source of data for one or more columns in the annotated call log. */ +public interface CallLogDataSource { + + /** + * A lightweight check which runs frequently to detect if the annotated call log is out of date + * with respect to this data source. + * + * <p>This is typically used to detect external changes to the underlying data source which have + * been made in such a way that the dialer application was not notified. + * + * <p>Most implementations of this method will rely on some sort of last modified timestamp. If it + * is impossible for a data source to be modified without the dialer application being notified, + * this method may immediately return false. + */ + @WorkerThread + boolean isDirty(Context appContext); + + /** + * Computes the set of mutations necessary to update the annotated call log with respect to this + * data source. + * + * @param mutations the set of mutations which this method should contribute to. Note that it may + * contain inserts from the system call log, and these inserts should be modified by each data + * source. + */ + @WorkerThread + void fill( + Context appContext, + SQLiteDatabase readableDatabase, + long lastRebuildTimeMillis, + CallLogMutations mutations); + + @MainThread + void registerContentObservers( + Context appContext, ContentObserverCallbacks contentObserverCallbacks); + + /** + * Methods which may optionally be called as a result of a data source's content observer firing. + */ + interface ContentObserverCallbacks { + @MainThread + void markDirtyAndNotify(Context appContext); + } +} diff --git a/java/com/android/dialer/calllog/datasources/contacts/ContactsDataSource.java b/java/com/android/dialer/calllog/datasources/contacts/ContactsDataSource.java new file mode 100644 index 000000000..241be5d71 --- /dev/null +++ b/java/com/android/dialer/calllog/datasources/contacts/ContactsDataSource.java @@ -0,0 +1,58 @@ +/* + * Copyright (C) 2017 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.dialer.calllog.datasources.contacts; + +import android.content.Context; +import android.database.sqlite.SQLiteDatabase; +import android.support.annotation.MainThread; +import android.support.annotation.WorkerThread; +import com.android.dialer.calllog.database.CallLogMutations; +import com.android.dialer.calllog.datasources.CallLogDataSource; +import com.android.dialer.common.Assert; +import javax.inject.Inject; + +/** Responsible for maintaining the contacts related columns in the annotated call log. */ +public final class ContactsDataSource implements CallLogDataSource { + + @Inject + public ContactsDataSource() {} + + @WorkerThread + @Override + public boolean isDirty(Context appContext) { + Assert.isWorkerThread(); + + // TODO: Implementation. + return false; + } + + @WorkerThread + @Override + public void fill( + Context appContext, + SQLiteDatabase readableDatabase, + long lastRebuildTimeMillis, + CallLogMutations mutations) { + Assert.isWorkerThread(); + // TODO: Implementation. + } + + @MainThread + @Override + public void registerContentObservers( + Context appContext, ContentObserverCallbacks contentObserverCallbacks) {} +} diff --git a/java/com/android/dialer/calllog/datasources/systemcalllog/SystemCallLogDataSource.java b/java/com/android/dialer/calllog/datasources/systemcalllog/SystemCallLogDataSource.java new file mode 100644 index 000000000..1cc51ee99 --- /dev/null +++ b/java/com/android/dialer/calllog/datasources/systemcalllog/SystemCallLogDataSource.java @@ -0,0 +1,114 @@ +/* + * Copyright (C) 2017 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.dialer.calllog.datasources.systemcalllog; + +import android.content.Context; +import android.database.ContentObserver; +import android.database.sqlite.SQLiteDatabase; +import android.net.Uri; +import android.os.Handler; +import android.provider.CallLog; +import android.support.annotation.MainThread; +import android.support.annotation.WorkerThread; +import com.android.dialer.calllog.database.CallLogMutations; +import com.android.dialer.calllog.datasources.CallLogDataSource; +import com.android.dialer.common.Assert; +import com.android.dialer.common.LogUtil; +import com.android.dialer.common.concurrent.ThreadUtil; +import javax.inject.Inject; + +/** + * Responsible for defining the rows in the annotated call log and maintaining the columns in it + * which are derived from the system call log. + */ +public class SystemCallLogDataSource implements CallLogDataSource { + + @Inject + public SystemCallLogDataSource() {} + + @MainThread + @Override + public void registerContentObservers( + Context appContext, ContentObserverCallbacks contentObserverCallbacks) { + Assert.isMainThread(); + + appContext + .getContentResolver() + .registerContentObserver( + CallLog.Calls.CONTENT_URI, + true, + new CallLogObserver( + ThreadUtil.getUiThreadHandler(), appContext, contentObserverCallbacks)); + } + + @WorkerThread + @Override + public boolean isDirty(Context appContext) { + Assert.isWorkerThread(); + + /* + * The system call log has a last updated timestamp, but deletes are physical (the "deleted" + * column is unused). This means that we can't detect deletes without scanning the entire table, + * which would be too slow. So, we just rely on content observers to trigger rebuilds when any + * change is made to the system call log. + */ + return false; + } + + @WorkerThread + @Override + public void fill( + Context appContext, + SQLiteDatabase readableDatabase, + long lastRebuildTimeMillis, + CallLogMutations mutations) { + Assert.isWorkerThread(); + + // This data source should always run first so the mutations should always be empty. + Assert.checkState(mutations.isEmpty()); + + // TODO: Implementation. + } + + private static class CallLogObserver extends ContentObserver { + private final Context appContext; + private final ContentObserverCallbacks contentObserverCallbacks; + + CallLogObserver( + Handler handler, Context appContext, ContentObserverCallbacks contentObserverCallbacks) { + super(handler); + this.appContext = appContext; + this.contentObserverCallbacks = contentObserverCallbacks; + } + + @MainThread + @Override + public void onChange(boolean selfChange, Uri uri) { + Assert.isMainThread(); + LogUtil.enterBlock("SystemCallLogDataSource.CallLogObserver.onChange"); + super.onChange(selfChange, uri); + + /* + * The system call log has a last updated timestamp, but deletes are physical (the "deleted" + * column is unused). This means that we can't detect deletes without scanning the entire + * table, which would be too slow. So, we just rely on content observers to trigger rebuilds + * when any change is made to the system call log. + */ + contentObserverCallbacks.markDirtyAndNotify(appContext); + } + } +} |