Go语言视频零基础入门到精通

admin

背景
CommonViewPager.png
ViewPager是Android开发者比较常用的一个控件了，由于它允许数据页从左到右或者从右到左翻页，因此这种交互也备受设计师的青睐。在APP中的很多场景都用得到，比如第一次安装APP时的用户引导页、图片浏览时左右翻页、广告Banner页等等都会用到ViewPager。ViewPager 的使用和RecyclerView的使用方式很相似，熟悉RecyclerView的朋友都知道，我们要使用RecyclerView，就得给RecyclerView提供一个Adapter来提供布局和装载数据。但是有一个比较麻烦的事情是，我们每次使用RecyclerView都要给他提供一个Adapter,并且这些Adapter中的一些方法和代码都是相同的，这使得我们写了很多重复的代码，降低了我们的开发效率，因此github有各种个样的对RecyclerView 的再度封装，目的就是减少这些重复的代码，尽量代码复用，使开发更简单。那么ViewPager的使用和RecyclerView 是非常相似的，我们同样也是给ViewPager提供一个Adapter来提供布局和装载数据。写Adapter的时候同样会写很多重复代码，那么我们是否能像

1. RecyclerView

复制代码

一样，也对Viewpager来做一个再次封装，达到复用和简单的效果呢？答案是肯定的，因此这篇文章就一起来封装一个通用的ViewPager。
现状
看过一些技术博客，对于普通的ViewPager使用封装的比较少，大多数的封装只是在用作Banner 的时候，也就是ViewPager 每页只显示一张图片。对外提供一个接口，传递一个imageUrl 数组就直接展示，不用再写其他的Adapter之类的。但是这样封装其实还是有一些局限性的。

  每个项目用的图片加载框架是不一样的，Picasso、Glide、ImageLoader等等各不相同，那么我们还需要在显示图片的时候换成自己用的图片加载框架才行。
  并不是所有的Banner 都只是显示一张图片,还有各种个样的文案展示等等，因此不能个性化定制，这是比较致命的。

  看看上面的局限性，是什么造成了这些局限性呢？答案是我们没有主动权，主动权在Adapter手中，他控制了布局，控制了数据绑定，所以它说怎样展示就怎样展示，它说展示什么就展示什么。那么现在问题的关键来了，我们又不想写Adapter,又想按照我们的指示展示布局和数据，怎么办呢？那就要从Adapter中夺回主动权，我们想ViewPager展示成什么样子我们自己说了算。Adapter只需要把我们提供给他的东西按照我们的指示展示就行了。具体的布局和数据绑定都我们自己控制。因此，有了主动权，展示什么布局我们能控制，用什么框架加载图片我们同样能控制。用什么方式来告诉Adapter 做页面展示呢？就用万能的接口啦。

封装通用的ViewPager
通过上面现状的分析，我们知道了，要封装一个比较通用的ViewPager,首先就是要从Adapter那里夺回主动权，因为它控制了布局和数据绑定。有了主动权之后，我们提供布局给Adapter，然后我们自己控制数据绑定。其中有2个关键的点：1，提供布局 。 2，数据绑定。 看到这两个点是不是觉得很熟悉？当然很熟悉，这不就是

1. RecyclerView

复制代码

的

1. ViewHolder

复制代码

干的事情嘛。既然是这样我们就借鉴一下

1. RecyclerView

复制代码

的

1. ViewHolder

复制代码

呗。
第一步：定义一个ViewHolder接口来提供布局和绑定数据：

1. ViewPagerHolder

复制代码

代码如下：

1. [code]/**
2. * Created by zhouwei on 17/5/28.
3. */
5. public interface ViewPagerHolder<T> {
6.     /**
7. * 创建View
8. * @param context
9. * @return
10. */
11.     View createView(Context context);
13.     /**
14. * 绑定数据
15. * @param context
16. * @param position
17. * @param data
18. */
19.     void onBind(Context context,int position,T data);
20. }

复制代码

[/code]

1. ViewPagerHolder

复制代码

接收一个泛型T,这是绑定数据要用的实体类。其中有2个方法，一个提供给Adapter布局，另一个则用于绑定数据。
第二步： 创建一个ViewHolder生成器，用来生成各种ViewHolder:

1. ViewPagerHolderCreator

复制代码

代码如下：

1. [code]/**
2. * Created by zhouwei on 17/5/28.
3. */
5. public interface ViewPagerHolderCreator<VH extends ViewPagerHolder> {
6.     /**
7. * 创建ViewHolder
8. * @return
9. */
10.     public VH createViewHolder();
11. }

复制代码

[/code]
该类接受一个 泛型，但是必须得是ViewPagerHolder 的子类，一个方法createViewHolder，返回ViewHolder实例。
第三步： 重写 ViewPager 的Adapter：

1. [code]/**
2. * Created by zhouwei on 17/5/28.
3. */
5. public class CommonViewPagerAdapter<T> extends PagerAdapter {
6.     private List<T> mDatas;
7.     private ViewPagerHolderCreator mCreator;//ViewHolder生成器
9.     public CommonViewPagerAdapter(List<T> datas, ViewPagerHolderCreator creator) {
10.         mDatas = datas;
11.         mCreator = creator;
12.     }
14.     @Override
15.     public int getCount() {
16.         return mDatas == null ? 0:mDatas.size();
17.     }
19.     @Override
20.     public boolean isViewFromObject(View view, Object object) {
21.         return view == object;
22.     }
24.     @Override
25.     public Object instantiateItem(ViewGroup container, int position) {
26.         //重点就在这儿了，不再是把布局写死，而是用接口提供的布局
27.         // 也不在这里绑定数据，数据绑定交给Api调用者。
28.         View view = getView(position,null,container);
29.         container.addView(view);
30.         return view;
31.     }
33.     @Override
34.     public void destroyItem(ViewGroup container, int position, Object object) {
35.         container.removeView((View) object);
36.     }
38.     /**
39. * 获取viewPager 页面展示View
40. * @param position
41. * @param view
42. * @param container
43. * @return
44. */
45.     private View getView(int position,View view ,ViewGroup container){
47.         ViewPagerHolder holder =null;
48.         if(view == null){
49.             //创建Holder
50.             holder = mCreator.createViewHolder();
51.             view = holder.createView(container.getContext());
52.             view.setTag(R.id.common_view_pager_item_tag,holder);
53.         }else{
54.             holder = (ViewPagerHolder) view.getTag(R.id.common_view_pager_item_tag);
55.         }
56.         if(holder!=null && mDatas!=null && mDatas.size()>0){
57.             // 数据绑定
58.             holder.onBind(container.getContext(),position,mDatas.get(position));
59.         }
61.         return view;
62.     }
63. }

复制代码

[/code]

  这个类比较重要，因为以前我们的布局提供和数据绑定都是在Adapter中的，因此现在我们就将这两项工作交给我们的ViewHolder。

1. CommonViewPagerAdapter

复制代码

的构造方法需要展示的数据集合和ViewPagerHolderCreator 生成器。其他代码都有注释一看便明白。

第四部：包装ViewPager
Adapter和ViewHolder都有了，现在我们只需要一个ViewPager 就大功告成了。我们采用自定义View 组合的方式来写这个ViewPager.
1 . 提供ViewPager 布局：

1. [code]<?xml version="1.0" encoding="utf-8"?>
2. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
3.                 xmlns:app="http://schemas.android.com/apk/res-auto"
4.                 android:orientation="vertical"
5.                 android:layout_width="match_parent"
6.                 android:layout_height="match_parent">
7.      <!-- ViewPager-->
9.      <android.support.v4.view.ViewPager
10.          android:id="@+id/common_view_pager"
11.          android:layout_width="match_parent"
12.          android:layout_height="match_parent"/>
14.      <!-- 指示器 indicatorView-->
15.      <com.zhouwei.indicatorview.CircleIndicatorView
16.          android:id="@+id/common_view_pager_indicator_view"
17.          android:layout_width="wrap_content"
18.          android:layout_height="wrap_content"
19.          android:layout_alignParentBottom="true"
20.          android:layout_marginBottom="10dp"
21.          app:indicatorSelectColor="@android:color/white"
22.          app:indicatorColor="@android:color/darker_gray"
23.          app:fill_mode="none"
24.          app:indicatorSpace="5dp"
25.          android:layout_centerHorizontal="true"
26.          />
27. </RelativeLayout>

复制代码

[/code]
布局中一个ViewPager 和一个指示器View, IndicatorView 用的是前面分享的CircleIndicatorView 。详情请看https://github.com/pinguo-zhouwei/CircleIndicatorView,博客地址：Android自定义View之 实现一个多功能的IndicatorView。
2 . CommonViewPager ，代码如下：

1. [code]/**
2. * Created by zhouwei on 17/5/28.
3. */
5. public class CommonViewPager<T> extends RelativeLayout {
6.     private ViewPager mViewPager;
7.     private CommonViewPagerAdapter mAdapter;
8.     private CircleIndicatorView mCircleIndicatorView;
9.     public CommonViewPager(@NonNull Context context) {
10.         super(context);
11.         init();
12.     }
14.     public CommonViewPager(@NonNull Context context, @Nullable AttributeSet attrs) {
15.         super(context, attrs);
16.         init();
17.     }
19.     public CommonViewPager(@NonNull Context context, @Nullable AttributeSet attrs, @AttrRes int defStyleAttr) {
20.         super(context, attrs, defStyleAttr);
21.         init();
22.     }
24.     @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
25.     public CommonViewPager(@NonNull Context context, @Nullable AttributeSet attrs, @AttrRes int defStyleAttr, @StyleRes int defStyleRes) {
26.         super(context, attrs, defStyleAttr, defStyleRes);
27.         init();
28.     }
30.     private void init(){
31.         View view = LayoutInflater.from(getContext()).inflate(R.layout.common_view_pager_layout,this,true);
32.         mViewPager = (ViewPager) view.findViewById(R.id.common_view_pager);
33.         mCircleIndicatorView = (CircleIndicatorView) view.findViewById(R.id.common_view_pager_indicator_view);
34.     }
36.     /**
37. * 设置数据
38. * @param data
39. * @param creator
40. */
41.     public void setPages(List<T> data, ViewPagerHolderCreator creator){
42.         mAdapter = new CommonViewPagerAdapter(data,creator);
43.         mViewPager.setAdapter(mAdapter);
44.         mAdapter.notifyDataSetChanged();
45.         mCircleIndicatorView.setUpWithViewPager(mViewPager);
46.     }
48.     public void setCurrentItem(int currentItem){
49.         mViewPager.setCurrentItem(currentItem);
50.     }
52.     public int getCurrentItem(){
53.         return mViewPager.getCurrentItem();
54.     }
56.     public void setOffscreenPageLimit(int limit){
57.         mViewPager.setOffscreenPageLimit(limit);
58.     }
60.     /**
61. * 设置切换动画，see {@link ViewPager#setPageTransformer(boolean, ViewPager.PageTransformer)}
62. * @param reverseDrawingOrder
63. * @param transformer
64. */
65.     public void setPageTransformer(boolean reverseDrawingOrder, ViewPager.PageTransformer transformer){
66.         mViewPager.setPageTransformer(reverseDrawingOrder,transformer);
67.     }
69.     /**
70. * see {@link ViewPager#setPageTransformer(boolean, ViewPager.PageTransformer)}
71. * @param reverseDrawingOrder
72. * @param transformer
73. * @param pageLayerType
74. */
75.     public void setPageTransformer(boolean reverseDrawingOrder, ViewPager.PageTransformer transformer,
76. int pageLayerType) {
77.         mViewPager.setPageTransformer(reverseDrawingOrder,transformer,pageLayerType);
78.     }
80.     /**
81. * see {@link ViewPager#addOnPageChangeListener(ViewPager.OnPageChangeListener)}
82. * @param listener
83. */
84.     public void addOnPageChangeListener(ViewPager.OnPageChangeListener listener){
85.         mViewPager.addOnPageChangeListener(listener);
86.     }
88.     /**
89. * 设置是否显示Indicator
90. * @param visible
91. */
92.     private void setIndicatorVisible(boolean visible){
93.         if(visible){
94.             mCircleIndicatorView.setVisibility(VISIBLE);
95.         }else{
96.             mCircleIndicatorView.setVisibility(GONE);
97.         }
99.     }
101.     public ViewPager getViewPager() {
102.         return mViewPager;
103.     }
104. }

复制代码

[/code]

1. CommonViewPager

复制代码

是对ViewPager的包装，提供了一些ViewPager的常用方法。 其中有一个非常重要的方法

1. public void setPages(List<T> data, ViewPagerHolderCreator creator)

复制代码

,提供数据和ViewHolder。其他的基本上都是ViewPager的方法。也可以通过getViewPager 获取到ViewPager 再调用ViewPager的方法。

到此封装也就全部完成了。
CommonViewPager 简便使用
啰嗦了这么久的封装，那么用起来方便不呢？看一下就知道。
1 , activity 布局文件：

1. [code]<?xml version="1.0" encoding="utf-8"?>
2. <RelativeLayout
3.     xmlns:android="http://schemas.android.com/apk/res/android"
4.     xmlns:app="http://schemas.android.com/apk/res-auto"
5.     xmlns:tools="http://schemas.android.com/tools"
6.     android:layout_width="match_parent"
7.     android:layout_height="match_parent"
8.     tools:context="com.zhouwei.commonviewpager.MainActivity">
10.     <com.zhouwei.viewpagerlib.CommonViewPager
11.         android:id="@+id/activity_common_view_pager"
12.         android:layout_width="match_parent"
13.         android:layout_height="200dp"
14.         />
16. </RelativeLayout>

复制代码

[/code]
ViewPager Item 的布局文件：

1. [code]<?xml version="1.0" encoding="utf-8"?>
2. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
3.               android:orientation="vertical"
4.               android:layout_width="match_parent"
5.               android:layout_height="match_parent">
6.    <ImageView
7.        android:id="@+id/viewPager_item_image"
8.        android:layout_width="match_parent"
9.        android:layout_height="match_parent"
10.        android:scaleType="centerCrop"
11.        />
12.    <TextView
13.        android:id="@+id/item_desc"
14.        android:layout_width="match_parent"
15.        android:layout_height="wrap_content"
16.        android:textSize="15sp"
17.        android:gravity="center"
18.        android:layout_centerInParent="true"
19.        android:textColor="@android:color/white"
20.        />
21. </RelativeLayout>

复制代码

[/code]
Activity 代码:

1. [code]  private void initView() {
2.         mCommonViewPager = (CommonViewPager) findViewById(R.id.activity_common_view_pager);
3.         // 设置数据
4.         mCommonViewPager.setPages(mockData(), new ViewPagerHolderCreator<ViewImageHolder>() {
5.             @Override
6.             public ViewImageHolder createViewHolder() {
7.                 // 返回ViewPagerHolder
8.                 return new ViewImageHolder();
9.             }
10.         });
11.     }
13.     /**
14. * 提供ViewPager展示的ViewHolder
15. * <P>用于提供布局和绑定数据</P>
16. */
17.     public static class ViewImageHolder implements ViewPagerHolder<DataEntry>{
18.         private ImageView mImageView;
19.         private TextView mTextView;
20.         @Override
21.         public View createView(Context context) {
22.             // 返回ViewPager 页面展示的布局
23.             View view = LayoutInflater.from(context).inflate(R.layout.view_pager_item,null);
24.             mImageView = (ImageView) view.findViewById(R.id.viewPager_item_image);
25.             mTextView = (TextView) view.findViewById(R.id.item_desc);
26.             return view;
27.         }
29.         @Override
30.         public void onBind(Context context, int position, DataEntry data) {
31.            // 数据绑定
32.            // 自己绑定数据，灵活度很大
33.            mImageView.setImageResource(data.imageResId);
34.            mTextView.setText(data.desc);
35.         }
36.     }

复制代码

[/code]
代码逻辑很清晰，也很简单，只需要提供一个ViewHolder,ViewHolder 自己实现，然后调用

1. setPages

复制代码

方法绑定数据就好了。最后上一张效果图：
ViewPager效果.gif
总结
本篇文章的这种封装思想不仅仅对于ViewPager,对于其他的展示集合数据的控件同样实用。其实整个封装还是蛮简单的，但是我觉得这种方法值得推广，以后像我们自己写一个扩展性比较强的控件时，就可以用这种方式。如果把这些一个个控件做成独立的通用的组件，那么我们开发的效率要提高很多。