前言
我们知道，地址选择器是一个通用组件，网上的开源项目也有很多。那么为什么还会有这篇文章呢？因为我在调研过程中发现，虽然都是地址选择器，但是实现的方式却各不相同。以下是调研地址选择器的一些总结和思考实践。希望对大家有帮助，大家有什么更好的想法，也要告知我哦～
地址选择器实现方式介绍
-
本地存放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都是唯一的。缓存机制比较简单，可以看下如下的流程图。
- 建立三个缓存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<>();
- 选择省、市、区某一级时，先查看是否有缓存数据，若有则使用缓存数据；若没有，则向服务端发送网络请求。
// 有缓存则直接使用缓存,否则去重新请求
if(province2city.containsKey(province.id)){
setCities(province2city.get(province.id));
} else {
progressBar.setVisibility(View.VISIBLE);
listener.onProvinceSelected(province);
}
3、每次获取的历史数据，存储在相应的缓存map中。
province2city.put(provinceId, cities);
控件使用
- gradle导入控件
compile 'com.zr.addressselector:library:1.0.1'
- Activity实现
OnAddressSelectedListener接口
public class MainActivity extends AppCompatActivity implements OnAddressSelectedListener
- 展现地址选择器
dialog = new BottomSelectorDialog(MainActivity.this);
dialog.setOnAddressSelectedListener(MainActivity.this);
dialog.show();
- 根据网络返回，设置数据
dialog.getSelector().setProvinces(Collections.singletonList(province));
- 控件提供的几个设置方法
/**
* 设置回调接口
* @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，本组件设计也是受此开源项目启发，非常感谢作者开源～
