Rename a bunch of stuff.

For homepage cards, rename Homepage* to ContextualCard*.

Change-Id: I95740f15a1789683fa6c61f03ecf9bc47c367146
Fixes: 113966426
Test: robotests

src/com/android/settings/homepage/ContextualCardManager.java

@@ -0,0 +1,140 @@
+/*
+ * Copyright (C) 2018 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.settings.homepage;
+
+import android.content.Context;
+import android.widget.BaseAdapter;
+
+import com.android.settingslib.core.lifecycle.Lifecycle;
+import com.android.settingslib.core.lifecycle.LifecycleObserver;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * This is a centralized manager of multiple {@link ContextualCardController}.
+ *
+ * {@link ContextualCardManager} first loads data from {@link CardContentLoader} and gets back a list of
+ * {@link ContextualCard}. All subclasses of {@link ContextualCardController} are loaded here, which
+ * will then trigger the {@link ContextualCardController} to load its data and listen to
+ * corresponding changes. When every single {@link ContextualCardController} updates its data, the
+ * data will be passed here, then going through some sorting mechanisms. The
+ * {@link ContextualCardController} will end up building a list of {@link ContextualCard} for {@link
+ * ContextualCardsAdapter} and {@link BaseAdapter#notifyDataSetChanged()} will be called to get the page
+ * refreshed.
+ */
+public class ContextualCardManager implements CardContentLoader.CardContentLoaderListener,
+        ContextualCardUpdateListener {
+
+    private static final String TAG = "ContextualCardManager";
+    //The list for Settings Custom Card
+    @ContextualCard.CardType
+    private static final int[] SETTINGS_CARDS = {ContextualCard.CardType.CONDITIONAL};
+
+    private final Context mContext;
+    private final ControllerRendererPool mControllerRendererPool;
+    private final Lifecycle mLifecycle;
+
+    private List<ContextualCard> mContextualCards;
+    private ContextualCardUpdateListener mListener;
+
+
+    public ContextualCardManager(Context context, Lifecycle lifecycle) {
+        mContext = context;
+        mLifecycle = lifecycle;
+        mContextualCards = new ArrayList<>();
+        mControllerRendererPool = new ControllerRendererPool();
+    }
+
+    void startCardContentLoading() {
+        final CardContentLoader cardContentLoader = new CardContentLoader();
+        cardContentLoader.setListener(this);
+    }
+
+    private void loadCardControllers() {
+        if (mContextualCards != null) {
+            for (ContextualCard card : mContextualCards) {
+                setupController(card.getCardType());
+            }
+        }
+
+        //for data provided by Settings
+        for (int cardType : SETTINGS_CARDS) {
+            setupController(cardType);
+        }
+    }
+
+    private void setupController(int cardType) {
+        final ContextualCardController controller = mControllerRendererPool.getController(mContext,
+                cardType);
+        if (controller != null) {
+            controller.setCardUpdateListener(this);
+            if (controller instanceof LifecycleObserver) {
+                if (mLifecycle != null) {
+                    mLifecycle.addObserver((LifecycleObserver) controller);
+                }
+            }
+        }
+    }
+
+    //TODO(b/111822376): implement sorting mechanism.
+    private void sortCards() {
+        //take mContextualCards as the source and do the ranking based on the rule.
+    }
+
+    @Override
+    public void onHomepageCardUpdated(int cardType, List<ContextualCard> updateList) {
+        //TODO(b/112245748): Should implement a DiffCallback.
+        //Keep the old list for comparison.
+        final List<ContextualCard> prevCards = mContextualCards;
+
+        //Remove the existing data that matches the certain cardType so as to insert the new data.
+        for (int i = mContextualCards.size() - 1; i >= 0; i--) {
+            if (mContextualCards.get(i).getCardType() == cardType) {
+                mContextualCards.remove(i);
+            }
+        }
+
+        //Append the new data
+        mContextualCards.addAll(updateList);
+
+        sortCards();
+
+        if (mListener != null) {
+            mListener.onHomepageCardUpdated(ContextualCard.CardType.INVALID, mContextualCards);
+        }
+    }
+
+    @Override
+    public void onFinishCardLoading(List<ContextualCard> contextualCards) {
+        mContextualCards = contextualCards;
+
+        //Force card sorting here in case CardControllers of custom view have nothing to update
+        // for the first launch.
+        sortCards();
+
+        loadCardControllers();
+    }
+
+    void setListener(ContextualCardUpdateListener listener) {
+        mListener = listener;
+    }
+
+    public ControllerRendererPool getControllerRendererPool() {
+        return mControllerRendererPool;
+    }
+}