阅读 725

一次地址选择器的实践

前言

我们知道,地址选择器是一个通用组件,网上的开源项目也有很多。那么为什么还会有这篇文章呢?因为我在调研过程中发现,虽然都是地址选择器,但是实现的方式却各不相同。以下是调研地址选择器的一些总结和思考实践。希望对大家有帮助,大家有什么更好的想法,也要告知我哦~

地址选择器实现方式介绍

  • 本地存放area.db文件
    大多数App都是此种实现

    • 优点:启动快,不受网络影响
    • 缺点:
      • 不能实时更新,数据更新依赖发布新版本。(或则自己实现一套更新机制,文件从后端下载,实现较为复杂)
      • 各端(服务器、前端、移动端)需要维护一份相同的地址信息表,维护成本高。
      • 地址信息表本地保存,增大安装包体积
  • 一次性从服务端拉取所有地址信息
    在App启动时候,一次性拉取所有地址信息。

    • 优点:数据可配置、请求少
    • 缺点:
      • 每次启动都请求服务器,大部分是无用请求,浪费了服务器资源。
      • 请求数据量大
    • 优化方案:更换请求时机,点击选择地址的时候才去一次性请求所有数据。但是还是不能避免请求数据量过大问题。
  • 实时获取省、市、区信息,选中上一级才去获取对应的下一级数据
    如:京东

    • 优点:数据可配置,请求数据量小
    • 缺点:请求较多,需要处理的异常case较多
    • 思考优化方案:每次唤起地址选择器时,缓存获取的地址信息历史数据。显示地址信息的时候,只有本地缓存没有当前数据,才向服务端发送请求。(其实这种场景很少出现,但是再小的苍蝇也是肉,能优化就优化了吧……)

因为用户基本是在有网络的情况下才会使用,所以选择联网获取地址信息也是合理的。又考虑到网络请求的大小,服务端性能影响,安装包大小以及地址信息可配置性等因素,实时获取地址信息是一个不错的方式。下面介绍地址选择器实现一些关键点。

实时获取信息的地址选择器设计

先来看效果,如下图所示。唤起地址选择器会有一次省份的网络请求,之后每一级数据都是实时去获取。在当前地址选择器唤起状态,获取之后就将历史数据保存在本地,下一次就不再发送网络请求了。

地址选择器效果图

整体的框架设计类图如下所示:

框架类图

数据结构设计

当前的地址信息按照省、市、区/县、街道四级划分,后一级总是和前一级相关联。

  • Province
public class Province {
    public long id;
    public String name;
}
复制代码
  • City
public class City  {
    public long id;
    public long province_id;
    public String name;
}
复制代码
  • County
public class County {
    public long id;
    public long city_id;
    public String name;
}
复制代码
  • Street
public class Street {
    public long id;
    public long county_id;
    public String name;
}
复制代码

回调接口设计

主要提供了4个回调方法:

public interface OnAddressSelectedListener {
    // 获取地址完成回调
    void onAddressSelected(Province province, City city, County county, Street street);
    // 选取省份完成回调
    void onProvinceSelected(Province province);
    // 选取城市完成回调
    void onCitySelected(City city);
    // 选取区/县完成回调
    void onCountySelected(County county);
}
复制代码

这里着重说一下onAddressSelected回调方法,其是在地址选择完成的时候调用。那么是如何判断地址选择已经完成呢。这个在AddressSelector中有如下一个机制。
每次一个级别选择完成后,会获取下一个级别的数据(网络请求或者缓存获取)进行显示。显示的时候有这么一个逻辑,当前级别有数据,则正常显示;若没有,则说明地址选择已经完成,此时调用onAddressSelected方法。

缓存设计

我们这里默认服务端每个地址的id都是唯一的。一次点击选择地址的缓存操作,可以看下如下的流程图。

缓存机制流程图

  1. 建立三个缓存map,分别缓存省-市市-区区-街道
/** 缓存数据:省-市 */
private ArrayMap<Long, List<City>> province2city = new ArrayMap<>();
/** 缓存数据:市-区 */
private ArrayMap<Long, List<County>> city2county = new ArrayMap<>();
/** 缓存数据:区-街道 */
private ArrayMap<Long, List<Street>> county2street = new ArrayMap<>();
复制代码
  1. 选择省、市、区某一级时,先查看是否有缓存数据,若有则使用缓存数据;若没有,则向服务端发送网络请求。
// 有缓存则直接使用缓存,否则去重新请求
if(province2city.containsKey(province.id)){
    setCities(province2city.get(province.id));
} else {
    progressBar.setVisibility(View.VISIBLE); 
    listener.onProvinceSelected(province);
}
复制代码

3、每次获取的历史数据,存储在相应的缓存map中。

province2city.put(provinceId, cities);
复制代码

Tab切换动画实现

不知道大家有没有发现,当我们选择地址时,顶部tab下有一个小横条,它会跟着我们选择进行平滑切换的。横条的动画主要包含两个部分:

  • 平滑移动到所选tab的文字下面
  • 根据选择tab内容的长度,在横条移动过程中,动态变化横条长度。当移动结束时,刚好变化为与tab内容长度一致。

具体思路是通过ObjectAnimator来设置横条移动的动画效果,ValueAnimator实现横条长度的动态变化,最后通过AnimatorSet来设置两个动画一起运行。控件中,封装了一个方法实现此动画效果。

private AnimatorSet buildIndicatorAnimatorTowards(TextView tab) {
    ObjectAnimator xAnimator = ObjectAnimator.ofFloat(indicator, "X", indicator.getX(), tab.getX() + tab.getPaddingLeft() * 2);

    final ViewGroup.LayoutParams params = indicator.getLayoutParams();
    ValueAnimator widthAnimator = ValueAnimator.ofInt(params.width, tab.getMeasuredWidth() - tab.getPaddingLeft() * 2);
    widthAnimator.addUpdateListener(new ValueAnimator.AnimatorUpdateListener() {
        @Override
        public void onAnimationUpdate(ValueAnimator animation) {
            params.width = (int) animation.getAnimatedValue();
            indicator.setLayoutParams(params);
        }
    });

    AnimatorSet set = new AnimatorSet();
    set.setInterpolator(new FastOutSlowInInterpolator());
    set.playTogether(xAnimator, widthAnimator);

    return set;
}
复制代码

控件使用

  1. gradle导入控件
compile 'com.zr.addressselector:library:1.0.1'
复制代码
  1. Activity实现OnAddressSelectedListener接口
public class MainActivity extends AppCompatActivity implements OnAddressSelectedListener
复制代码
  1. 展现地址选择器
dialog = new BottomSelectorDialog(MainActivity.this);
dialog.setOnAddressSelectedListener(MainActivity.this);
dialog.show();
复制代码
  1. 根据网络返回,设置数据
dialog.getSelector().setProvinces(Collections.singletonList(province));
复制代码
  1. 控件提供的几个设置方法
/**
     * 设置回调接口
     * @param listener
     */
    public void setOnAddressSelectedListener(OnAddressSelectedListener listener) {
        this.listener = listener;
    }

    /**
     * 设置省列表
     * @param provinces 省份列表
     */
    public void setProvinces(List<Province> provinces){
        handler.sendMessage(Message.obtain(handler, WHAT_PROVINCES_PROVIDED, provinces));
    }

    /**
     * 设置市列表
     * @param cities 城市列表
     */
    public void setCities(List<City> cities){
        handler.sendMessage(Message.obtain(handler, WHAT_CITIES_PROVIDED, cities));
    }

    /**
     * 设置区列表
     * @param countries 区/县列表
     */
    public void setCountries(List<County> countries){
        handler.sendMessage(Message.obtain(handler, WHAT_COUNTIES_PROVIDED, countries));
    }

    /**
     * 设置街道列表
     * @param streets 街道列表
     */
    public void setStreets(List<Street> streets){
        handler.sendMessage(Message.obtain(handler, WHAT_STREETS_PROVIDED, streets));
    }
复制代码

写在最后

虽然提供了gradle compile导入的方式,但是整个控件的源码其实是很简单的。如果有定制需求,可以到这里下载源码。

项目源码下载:ZRAddressSelector

特别感谢

JDAddressSelector,本组件设计也是受此开源项目启发,非常感谢作者开源~

关注下面的标签,发现更多相似文章
评论