deprecate the Content Loader abstract classes

We should be using ViewModels, LiveData, & Coroutines to load data for UIs

Author: frett

gto-support-core/src/main/java/org/ccci/gto/android/common/support/v4/app/SimpleLoaderCallbacks.java

@@ -6,6 +6,10 @@
 import androidx.loader.app.LoaderManager;
 import androidx.loader.content.Loader;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public abstract class SimpleLoaderCallbacks<D> implements LoaderManager.LoaderCallbacks<D> {
     @Override
     public void onLoaderReset(@NonNull final Loader<D> loader) {

gto-support-core/src/main/java/org/ccci/gto/android/common/support/v4/content/AsyncTaskBroadcastReceiverLoader.java

@@ -6,6 +6,10 @@
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public abstract class AsyncTaskBroadcastReceiverLoader<D> extends CachingAsyncTaskLoader<D>
         implements BroadcastReceiverLoaderHelper.Interface {
     private final BroadcastReceiverLoaderHelper mHelper;

gto-support-core/src/main/java/org/ccci/gto/android/common/support/v4/content/AsyncTaskSharedPreferencesChangeLoader.java

@@ -5,6 +5,10 @@
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public abstract class AsyncTaskSharedPreferencesChangeLoader<D> extends CachingAsyncTaskLoader<D>
         implements SharedPreferencesChangeLoaderHelper.Interface {
     private final SharedPreferencesChangeLoaderHelper mHelper;

gto-support-core/src/main/java/org/ccci/gto/android/common/support/v4/content/BroadcastReceiverLoaderHelper.java

@@ -9,6 +9,10 @@
 
 import java.util.ArrayList;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public final class BroadcastReceiverLoaderHelper {
     public interface Interface {
         void addIntentFilter(@NonNull IntentFilter filter);

gto-support-core/src/main/java/org/ccci/gto/android/common/support/v4/content/CachingAsyncTaskLoader.java

@@ -6,6 +6,10 @@
 import androidx.annotation.Nullable;
 import androidx.loader.content.AsyncTaskLoader;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public abstract class CachingAsyncTaskLoader<D> extends AsyncTaskLoader<D> {
     @Nullable
     private D mData;

gto-support-core/src/main/java/org/ccci/gto/android/common/support/v4/content/CursorBroadcastReceiverLoader.java

@@ -6,6 +6,10 @@
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public abstract class CursorBroadcastReceiverLoader extends SimpleCursorLoader
         implements BroadcastReceiverLoaderHelper.Interface {
     @NonNull

gto-support-core/src/main/java/org/ccci/gto/android/common/support/v4/content/LoaderBroadcastReceiver.java

@@ -6,6 +6,10 @@
 import androidx.annotation.NonNull;
 import androidx.loader.content.Loader;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public class LoaderBroadcastReceiver extends BroadcastReceiver {
     @NonNull
     private final Loader mLoader;

gto-support-core/src/main/java/org/ccci/gto/android/common/support/v4/content/SharedPreferencesChangeLoaderHelper.java

@@ -8,6 +8,10 @@
 import java.util.HashSet;
 import java.util.Set;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public final class SharedPreferencesChangeLoaderHelper {
     public interface Interface {
         void addPreferenceKey(@Nullable String key);

gto-support-core/src/main/java/org/ccci/gto/android/common/support/v4/content/SimpleCursorLoader.java

@@ -7,6 +7,10 @@
 import androidx.annotation.WorkerThread;
 import androidx.loader.content.CursorLoader;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public abstract class SimpleCursorLoader extends CursorLoader {
     public SimpleCursorLoader(@NonNull final Context context) {
         super(context);

gto-support-core/src/main/java/org/ccci/gto/android/common/support/v4/content/SwipeRefreshLayoutBroadcastReceiverHelper.java

@@ -11,6 +11,10 @@
 import java.util.Arrays;
 import java.util.List;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public class SwipeRefreshLayoutBroadcastReceiverHelper {
     SwipeRefreshLayout mRefreshLayout = null;
 

gto-support-db/src/main/java/org/ccci/gto/android/common/db/support/v4/content/DaoCursorBroadcastReceiverLoader.java

@@ -1,19 +1,23 @@
 package org.ccci.gto.android.common.db.support.v4.content;
 
+import static org.ccci.gto.android.common.db.AbstractDao.ARG_WHERE;
+
 import android.content.BroadcastReceiver;
 import android.content.Context;
 import android.content.IntentFilter;
 import android.os.Bundle;
 
-import org.ccci.gto.android.common.db.AbstractDao;
-import org.ccci.gto.android.common.db.Table;
-import org.ccci.gto.android.common.support.v4.content.BroadcastReceiverLoaderHelper;
-
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
-import static org.ccci.gto.android.common.db.AbstractDao.ARG_WHERE;
+import org.ccci.gto.android.common.db.AbstractDao;
+import org.ccci.gto.android.common.db.Table;
+import org.ccci.gto.android.common.support.v4.content.BroadcastReceiverLoaderHelper;
 
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public class DaoCursorBroadcastReceiverLoader<T> extends DaoCursorLoader<T>
         implements BroadcastReceiverLoaderHelper.Interface {
     @NonNull

gto-support-db/src/main/java/org/ccci/gto/android/common/db/support/v4/content/DaoCursorLoader.java

@@ -1,9 +1,19 @@
 package org.ccci.gto.android.common.db.support.v4.content;
 
+import static org.ccci.gto.android.common.db.AbstractDao.ARG_DISTINCT;
+import static org.ccci.gto.android.common.db.AbstractDao.ARG_JOINS;
+import static org.ccci.gto.android.common.db.AbstractDao.ARG_ORDER_BY;
+import static org.ccci.gto.android.common.db.AbstractDao.ARG_PROJECTION;
+import static org.ccci.gto.android.common.db.AbstractDao.ARG_WHERE;
+
 import android.content.Context;
 import android.database.Cursor;
 import android.os.Bundle;
 
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.annotation.WorkerThread;
+
 import org.ccci.gto.android.common.db.AbstractDao;
 import org.ccci.gto.android.common.db.Expression;
 import org.ccci.gto.android.common.db.Expression.Field;
@@ -13,16 +23,10 @@
 import org.ccci.gto.android.common.support.v4.content.SimpleCursorLoader;
 import org.ccci.gto.android.common.util.os.BundleUtils;
 
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-import androidx.annotation.WorkerThread;
-
-import static org.ccci.gto.android.common.db.AbstractDao.ARG_DISTINCT;
-import static org.ccci.gto.android.common.db.AbstractDao.ARG_JOINS;
-import static org.ccci.gto.android.common.db.AbstractDao.ARG_ORDER_BY;
-import static org.ccci.gto.android.common.db.AbstractDao.ARG_PROJECTION;
-import static org.ccci.gto.android.common.db.AbstractDao.ARG_WHERE;
-
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public class DaoCursorLoader<T> extends SimpleCursorLoader {
     @NonNull
     protected final AbstractDao mDao;

gto-support-eventbus/src/main/java/org/ccci/gto/android/common/eventbus/content/CachingAsyncTaskEventBusLoader.java

@@ -2,13 +2,17 @@
 
 import android.content.Context;
 
-import org.ccci.gto.android.common.support.v4.content.CachingAsyncTaskLoader;
-import org.greenrobot.eventbus.EventBus;
-
 import androidx.annotation.MainThread;
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
+import org.ccci.gto.android.common.support.v4.content.CachingAsyncTaskLoader;
+import org.greenrobot.eventbus.EventBus;
+
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public abstract class CachingAsyncTaskEventBusLoader<D> extends CachingAsyncTaskLoader<D>
         implements EventBusLoaderHelper.Interface {
     @NonNull

gto-support-eventbus/src/main/java/org/ccci/gto/android/common/eventbus/content/CursorEventBusLoader.java

@@ -2,13 +2,17 @@
 
 import android.content.Context;
 
-import org.ccci.gto.android.common.support.v4.content.SimpleCursorLoader;
-import org.greenrobot.eventbus.EventBus;
-
 import androidx.annotation.MainThread;
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
+import org.ccci.gto.android.common.support.v4.content.SimpleCursorLoader;
+import org.greenrobot.eventbus.EventBus;
+
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public abstract class CursorEventBusLoader extends SimpleCursorLoader implements EventBusLoaderHelper.Interface {
     @NonNull
     private final EventBusLoaderHelper mHelper;

gto-support-eventbus/src/main/java/org/ccci/gto/android/common/eventbus/content/DaoCursorEventBusLoader.java

@@ -3,14 +3,18 @@
 import android.content.Context;
 import android.os.Bundle;
 
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
 import org.ccci.gto.android.common.db.AbstractDao;
 import org.ccci.gto.android.common.db.Table;
 import org.ccci.gto.android.common.db.support.v4.content.DaoCursorLoader;
 import org.greenrobot.eventbus.EventBus;
 
-import androidx.annotation.NonNull;
-import androidx.annotation.Nullable;
-
+/**
+ * @deprecated Since v3.9.0, use LiveData & coroutines to asynchronously load data for a UI.
+ */
+@Deprecated
 public class DaoCursorEventBusLoader<T> extends DaoCursorLoader<T> implements EventBusLoaderHelper.Interface {
     private final EventBusLoaderHelper mHelper;