Merge pull request #13 from AlanCheen/develop

release 0.9.0 feature

Author: AlanCheen

README.md

@@ -1,14 +1,12 @@
 # Flap
 
-[![Download](https://api.bintray.com/packages/alancheen/maven/flap/images/download.svg?version=0.6.0)](https://bintray.com/alancheen/maven/flap/0.6.0/link) [![Build Status](https://travis-ci.org/AlanCheen/Flap.svg?branch=master)](https://travis-ci.org/AlanCheen/Flap) ![RecyclerView](https://img.shields.io/badge/RecyclerView-28.0.0-brightgreen.svg) ![API](https://img.shields.io/badge/API-14%2B-brightgreen.svg?style=flat) [![license](https://img.shields.io/github/license/AlanCheen/Flap.svg)](./LICENSE)
+[![Download](https://api.bintray.com/packages/alancheen/maven/flap/images/download.svg?version=0.9.0)](https://bintray.com/alancheen/maven/flap/0.9.0/link) [![Build Status](https://travis-ci.org/AlanCheen/Flap.svg?branch=master)](https://travis-ci.org/AlanCheen/Flap) ![RecyclerView](https://img.shields.io/badge/RecyclerView-28.0.0-brightgreen.svg) ![API](https://img.shields.io/badge/API-14%2B-brightgreen.svg?style=flat) [![license](https://img.shields.io/github/license/AlanCheen/Flap.svg)](./LICENSE)
 
 **[WIP]WARNING: Flap is still under development.**
 
-`Flap` is a library that makes `RecyclerView.Adapter` more easier to use , especially when you have to support lots of different type ViewHolders.
+`Flap` is a library that makes `RecyclerView.Adapter` much more easier to use , by keeping you from writing boilerplate codes and providing lots advance features , especially when you have to support lots of different type items.
 
-Flap can save your day by keeping you from writing boilerplate codes.
-
-Have a try , thanks !
+Have a try !
 
 ## Integrate Flap
 

app/src/main/java/me/yifeiyuan/flapdev/FlapApplication.java

@@ -28,5 +28,7 @@ public void onCreate() {
 
         Log.e("Flap", "Init Flap time cost :" + (t2 - t1));
 
+        Flap.getDefault().getFlapItemPool().setMaxRecycledViews(new SimpleImageItem.Factory().getItemViewType(null), 8);
+
     }
 }

app/src/main/java/me/yifeiyuan/flapdev/MainActivity.java

@@ -20,6 +20,12 @@ protected void onCreate(Bundle savedInstanceState) {
 
         RecyclerView recyclerView = findViewById(R.id.rv_items);
 
+        createSimpleTestCase(recyclerView);
+
+        createAdvanceTestCase(recyclerView);
+    }
+
+    private void createSimpleTestCase(final RecyclerView recyclerView) {
         FlapAdapter adapter = new FlapAdapter();
 
         List<Object> models = new ArrayList<>();
@@ -36,8 +42,19 @@ protected void onCreate(Bundle savedInstanceState) {
         adapter.setModels(models);
 
         recyclerView.setAdapter(adapter);
+    }
+
+    private void createAdvanceTestCase(final RecyclerView recyclerView) {
 
-//        List<Object> models = mockModels();
+        List<Object> models = mockModels();
+
+        FlapAdapter adapter = new FlapAdapter();
+        adapter.setUseGlobalPool(true)
+                .setLifecycleEnable(true)
+                .setLifecycleOwner(this)
+                .setModels(models);
+
+        recyclerView.setAdapter(adapter);
     }
 
     private List<Object> mockModels() {

flap/build.gradle

@@ -33,7 +33,7 @@ dependencies {
 
 apply plugin: "guru.stefma.bintrayrelease"
 
-version = "0.7.0"
+version = "0.9.0"
 group = "me.yifeiyuan.flap"
 androidArtifact {
     artifactId = "flap"

flap/src/main/java/me/yifeiyuan/flap/Flap.java

@@ -24,6 +24,8 @@ public final class Flap implements IFlap {
     private final Map<Class<?>, FlapItemFactory> itemFactories;
     private final SparseArray<FlapItemFactory> factoryMapping;
 
+    private final FlapItemPool GLOBAL_POOL = new FlapItemPool();
+
     private static volatile Flap sInstance;
 
     public static Flap getDefault() {
@@ -115,6 +117,21 @@ public void onBindViewHolder(@NonNull final FlapItem holder, final Object model,
         holder.bind(model, flapAdapter, payloads);
     }
 
+    @Override
+    public void onViewAttachedToWindow(@NonNull final FlapItem holder, @NonNull final FlapAdapter flapAdapter) {
+        holder.onViewAttachedToWindow(flapAdapter);
+    }
+
+    @Override
+    public void onViewDetachedFromWindow(@NonNull final FlapItem holder, @NonNull final FlapAdapter flapAdapter) {
+        holder.onViewDetachedFromWindow(flapAdapter);
+    }
+
+    @Override
+    public void onViewRecycled(@NonNull final FlapItem holder, @NonNull final FlapAdapter flapAdapter) {
+        holder.onViewRecycled(flapAdapter);
+    }
+
     @NonNull
     @Override
     public FlapItem onCreateDefaultViewHolder(@NonNull final LayoutInflater inflater, @NonNull final ViewGroup parent, final int viewType) {
@@ -124,4 +141,8 @@ public FlapItem onCreateDefaultViewHolder(@NonNull final LayoutInflater inflater
     public static void setDebug(final boolean isDebugging) {
         FlapDebug.setDebug(isDebugging);
     }
+
+    public FlapItemPool getFlapItemPool() {
+        return GLOBAL_POOL;
+    }
 }

flap/src/main/java/me/yifeiyuan/flap/FlapAdapter.java

@@ -20,13 +20,15 @@ public class FlapAdapter extends RecyclerView.Adapter<FlapItem> {
     @NonNull
     private final Flap flap = Flap.getDefault();
 
-    private LifecycleOwner lifecycleOwner;
-
     @NonNull
     private List<?> models = new ArrayList<>();
 
+    private LifecycleOwner lifecycleOwner;
+
     private boolean lifecycleEnable = true;
 
+    private boolean useGlobalPool = true;
+
     @NonNull
     @Override
     public FlapItem onCreateViewHolder(@NonNull final ViewGroup parent, final int viewType) {
@@ -72,24 +74,27 @@ public void onAttachedToRecyclerView(@NonNull final RecyclerView recyclerView) {
         if (recyclerView.getContext() instanceof LifecycleOwner && lifecycleOwner == null) {
             setLifecycleOwner((LifecycleOwner) recyclerView.getContext());
         }
+        if (useGlobalPool) {
+            recyclerView.setRecycledViewPool(flap.getFlapItemPool());
+        }
     }
 
     @Override
     public void onViewAttachedToWindow(@NonNull FlapItem holder) {
         super.onViewAttachedToWindow(holder);
-        holder.onViewAttachedToWindow(this);
+        flap.onViewAttachedToWindow(holder, this);
     }
 
     @Override
     public void onViewDetachedFromWindow(@NonNull FlapItem holder) {
         super.onViewDetachedFromWindow(holder);
-        holder.onViewDetachedFromWindow(this);
+        flap.onViewDetachedFromWindow(holder, this);
     }
 
     @Override
     public void onViewRecycled(@NonNull final FlapItem holder) {
         super.onViewRecycled(holder);
-        holder.onViewRecycled(this);
+        flap.onViewRecycled(holder, this);
     }
 
     @Override
@@ -115,13 +120,29 @@ private Object getModel(final int position) {
         return getModels().get(position);
     }
 
-    public void setModels(@NonNull List<?> models) {
+    public FlapAdapter setModels(@NonNull List<?> models) {
         checkNotNull(models, "models can't be null here");
         this.models = models;
+        return this;
     }
 
     @NonNull
     public List<?> getModels() {
         return models;
     }
+
+    /**
+     * Set whether use the global RecycledViewPool or not.
+     *
+     * NOTE : Call this before you call RecyclerView.setAdapter.
+     *
+     * @param enable true by default
+     *
+     * @return this
+     */
+    public FlapAdapter setUseGlobalPool(final boolean enable) {
+        this.useGlobalPool = enable;
+        return this;
+    }
+
 }

flap/src/main/java/me/yifeiyuan/flap/FlapAdapterDelegate.java

@@ -8,6 +8,8 @@
 
 /**
  * Created by 程序亦非猿 on 2019/1/2.
+ *
+ * A delegate of FlapAdapter.
  */
 interface FlapAdapterDelegate {
 
@@ -17,4 +19,10 @@ interface FlapAdapterDelegate {
     FlapItem onCreateViewHolder(@NonNull LayoutInflater inflater, @NonNull ViewGroup parent, int viewType);
 
     void onBindViewHolder(@NonNull final FlapItem holder, Object model, @NonNull FlapAdapter flapAdapter, @NonNull List<Object> payloads);
+
+    void onViewAttachedToWindow(@NonNull FlapItem holder,@NonNull  FlapAdapter flapAdapter);
+
+    void onViewDetachedFromWindow(@NonNull FlapItem holder,@NonNull  FlapAdapter flapAdapter);
+
+    void onViewRecycled(@NonNull FlapItem holder,@NonNull  FlapAdapter flapAdapter);
 }

flap/src/main/java/me/yifeiyuan/flap/FlapItemPool.java

@@ -0,0 +1,14 @@
+package me.yifeiyuan.flap;
+
+import android.support.v7.widget.RecyclerView;
+
+/**
+ * Created by 程序亦非猿 on 2019/1/2.
+ *
+ * A global RecycledViewPool that can be shared among RecyclerViews , which is enabled by default.
+ *
+ * @see FlapAdapter#setUseGlobalPool(boolean)
+ */
+public class FlapItemPool extends RecyclerView.RecycledViewPool {
+
+}