开发一款商业级Banner控件

本文已授权微信公众号:鸿洋(hongyangAndroid)原创首发。

商业级控件最重要的特性:高内聚、低耦合!

1、分析需求

我们想要实现什么功能、达到什么效果?
站在用户在这里就是我们的程序员的角度上来看,我们在使用的时候是希望以最少的代码实现更多的功能,且能有足够地自由去自定义该功能。功能需求如下:

用户需求用例图

我们想要实现的效果 :


2、理清技术点

在开发之前,大致评估一下技术可行性,结合技术点的特性才能更好的去划分层次和搭建框架,首先梳理几个功能点 以及它们相对应的技术点;

  1. ViewPeger作为view的载体(为什么不用recyclerView,懒,使用recyclerVIew会多出很多代码,比如自己写滑动监听,换页换页监听,换页动画等等比较麻烦的代码,以及各种计算)
  2. 如何无限循环,如图所示; 首尾各增加一项item; 且当滑动至 第0项 时无缝切换至 倒数第二项(真实数据最后一项下标),当滑动到最后一项时无缝切换至第二项(真实数据第一项);
   2.0.0 版本采用的思路是:
        getCount()  6百倍实际长度;
        将开始下标置为300倍;  做一个假的无限循环;
        在下标不在 200~400倍时; 重新定位在300倍位置;
  1. 翻页动画,有一个ViewPager有个接口PageTransformer;贼好用,在滑动过程中 会计算各个itemVIew的左坐标与滑动距离差 与 总宽度的比例;
    protected void onPageScrolled(int position, float offset, int offsetPixels) {
        ...    
           if (mPageTransformer != null) {
            final int scrollX = getScrollX();
            final int childCount = getChildCount();
            for (int i = 0; i < childCount; i++) {
                final View child = getChildAt(i);
               ....
                final float transformPos = (float) (child.getLeft() - scrollX) / getClientWidth();
                mPageTransformer.transformPage(child, transformPos);
            }
        ...
  1. 默认指示器,一个自定义View, 动态添加指示点。根据状态切换指示点图标。
  2. 如何一页显示多屏(如下效果),其中用到了 clipChildren属性
    ,在ViewGroup中该属性是这样注释的
    // When set, ViewGroup invalidates only the child's rectangle
    // Set by default
    static final int FLAG_CLIP_CHILDREN = 0x1;
    /**
     * By default, children are clipped to their bounds before drawing. This
     * allows view groups to override this behavior for animations, etc.
     *
     * @param clipChildren true to clip children to their bounds,
     *        false otherwise
     * @attr ref android.R.styleable#ViewGroup_clipChildren
     */
    public void setClipChildren(boolean clipChildren) {
    ...

通过设置根布局 android:clipChildren="false" 这样我们就能实现一屏显示多view的效果了。

多屏

3、面向对象设计

我们需要根据业务的细分对象,每个对象要实现什么功能;各个对象之间如何关联起来贯穿整个业务流程; 设计框架与高层抽象;

3.1、 细分对象

我们都知道面向对象设计思想呢 有一种原则叫 单一职责原则! 所以我们第一步就是划分这个对象。每个对象该做什么事情。 且遵循单一职责原则的优点在于:我的任一单一的对象都可以拿出来单独使用,这样就能极大程度保证我们的代码的可扩展性。

ok,那我们一个一个来分析:

  1. wenldBanner
    也是我们最外层一个对象,它包含了viewPager 对象与我们的指示器对象;负责协调我们VIewPager与指示器之间的关联关系与位置摆放,同时能够对各个对象的属性进行相对应的设置。
  2. AutoTurnViewPager :
    负责自动翻页相关功能;
  3. LoopViewPager
    负责自动翻页设置; 重写滑动监听事件(addOnPageChangeListener,removeOnPageChangeListener);重写真实选中事件(setCurrentItem,getCurrentItem)等等;
  4. WenldPagerAdapter :
    展示真实的View;提供适配器下标与真实数据下标相互转换算法; 并实现对View的复用;
  5. Holder:
    适配器View,Holder
  6. DefaultPageIndicator
    默认指示器
  7. PageIndicatorListener
    指示器监听接口。

3.2 简单UML

大概事件有这么多,如下图:


根据以上搭建类图:

4 拆分代码编程

根据uml流程用例图以及类图 搭建好框架后 定义出接口并写出伪代码;依次实现细节代码。
具体可以进入源码 WenldBanner查看。

5 总结

5.1 遇到的坑

5.1.1、 notifyDataSetChanged "不刷新问题"

这个坑还算是比较轻松就能填充的: 首先是数据源改变后 调用notifyDataSetChanged 界面不刷新
例如:数据从{"一","二","三" }变为{"四","五","六" } 时的效果展现失败,如下图所示

数据变换前

数据变换后

slove:

1、进入notifyDataSetChanged 源码查看 ,通过几步找到了ViewPager的 dataSetChanged() 方法

   void dataSetChanged() {
        ...
        for (int i = 0; i < mItems.size(); i++) {
            final ItemInfo ii = mItems.get(i);
          //调用adapter的 getItemPosition方法  ,然而 该方法返回值 一直为:POSITION_UNCHANGED
            final int newPos = mAdapter.getItemPosition(ii.object);

            if (newPos == PagerAdapter.POSITION_UNCHANGED) {
                continue;
            }
          //如果返回的是 PagerAdapter.POSITION_NONE 那么移除所有view 重新填充
            if (newPos == PagerAdapter.POSITION_NONE) {
            //移除
                mItems.remove(i);
                ...
          //移除
                mAdapter.destroyItem(this, ii.position, ii.object);
          ...
           //在该方法内  如果 mItems 为空 该方法内最终会调用 到 adapter.instantiateItem 方法 填充新的view
            setCurrentItemInternal(newCurrItem, false, true);
            requestLayout();
        }
    }

可以看到 如果 mAdapter.getItemPosition()方法 返回的是 PagerAdapter.POSITION_NONE,那么我们就会将旧items清除掉;经过方法判断items为空, 最终会重新填充新的view;

2、所以我们就可以在 adapter的 getItemPosition方法内下手:
在调用notifyDataSetChanged时保证 getItemPosition返回的是POSITION_NONE

WenldPagerAdapter.class 

    @Override
    public void notifyDataSetChanged() {
        myNotify=true;
        super.notifyDataSetChanged();
        myNotify=false;
    }

    @Override
    public int getItemPosition(Object object) {
        if (!myNotify) {
            return super.getItemPosition(object);
        } else {
            return POSITION_NONE;
        }
    }

5.1.2、 设置切换动画后 notifyDataSetChanged 错乱

1、这个坑算是比较大的:如果我们设置了切换动画,调用notifyDataSetChanged 以后效果会错乱, 如下图所示


2、还是进入源码来分析解决问题,不过分析比较多,请查看ViewPager源码解析PageAdapter刷新问题

5.2 收获

一款商业级Banner控件

既然敢说商业级,那么就支持足够的自定义与扩展性! 实现思路请看这 开发一款商业级Banner控件

效果图:


可以做到以下效果

  • 设置自定义指示器效果
  • 设置指示器位置
  • 设置是否循环
  • 是否可以跳转
  • 页面切换间隔
  • 页面切换持续时间
  • 是否支持手动滑动
  • 是否反向切换页面(切换方向)

use

1、引用:

版本号:[图片上传失败...(image-e7ddb3-1511330475991)]

// root build.gradle
repositories {
    jcenter()
    maven { url "https://www.jitpack.io" }
}
// yout project build.gradle
dependencies {
        compile 'com.github.LidongWen:WenldBanner:2.0.0'
}

具体查看代码:Github地址


希望我的文章不会误导在观看的你,如果有异议的地方欢迎讨论和指正。
如果能给观看的你带来收获,那就是最好不过了。

人生得意须尽欢, 桃花坞里桃花庵
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,132评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,802评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,566评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,858评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,867评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,695评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,064评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,705评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,915评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,677评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,796评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,432评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,041评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,992评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,223评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,185评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,535评论 2 343

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,468评论 25 707
  • 内容抽屉菜单ListViewWebViewSwitchButton按钮点赞按钮进度条TabLayout图标下拉刷新...
    皇小弟阅读 46,708评论 22 664
  • (一) 不知不觉中秋季已经悄然到来,正如她曾经悄然的走时一样。行走在飘满落叶的行道上,行走在略显凉意的秋风中,总会...
    寒扬阅读 402评论 0 37