原则：
- 接口输入输出的数据 要么为json，要么为文件流。
- json返回数据必须包含如下的字段，而且0表示成功
{"respCode":0,"respDesc":"成功"}
- 同样的respCode，只能表达同一个含义。
- 返回的json串中不允许使用数字作为key，不允许存在名字会变动的key，比如取近三年的数据，结果出现了2014、2015、2016这些key值。
- 当你的方法超过一屏幕，请找Leader确定逻辑是否合理。
- 需要提取到PandaAndroidLib的内容统一放置在
java/lib这个文件夹下。 - 整个App周期中需要配置的内容放在LaunchFragment里面进行，而不是Application的onCreate里面。
流程
- 如需调用第三方服务，先完成第三方服务集成。常见第三方服务有：
- 统计。一般用友盟。PandaAndroidLib底层支持，设置好key即可。
- 分享。
- 登录。
- 支付。
- 地图。
- 拿到服务端接口文档，新建RepositoryCollection类，所有的接口都放在此类里统一管理。
public class RepositoryCollection extends BaseRepositoryCollection {
}
- 实现各种网络接口。数据Model可以用GsonFormat插件自动生成，且必须透过底层的
BaseRepositoryCollection的方法来获取，总体有两类：
- executeJsonRequest：获取json类型的返回数据
- executeFileRequest：获取File类型的返回数据
- url和respCode统一放在Constant.java进行管理。
- 上层调用接口。有两种情形：
- 配合NetFragment系列使用，在
onDoInBackgroundSafely里面实现。主要使用场景参考： - 配合BaseAsyncTask系列使用，如点击登录等场景
- 抛出相应的EventBus事件，新建监听器接口。如果是基于底层数据模型增删改的事件，统一命名为 <数据模型名>Event，继承ModelEvent
样例如下：
//-------1. 新建事件类-------
public class ModelEvent extends BaseEvent {
public interface listener {
void onEventMainThread(LoginSuccessEvent event);
}
}
//-------2. 产生事件-------
EventBus.getDefault().post(new ModelEvent());
//-------3. 消耗事件（implements ModelEvent.listener）-------
// 登陆成功时
public void onEventMainThread(ModelEvent event) {
Log.d(TAG, "ModelEvent: "+ event.toString());
}
EventBus.getDefault().register(this);//一般放在onCreateView里面
EventBus.getDefault().unregister(this);//一般放在onDestroyView里面
样例代码
- 强大的Android异步框架库android-lite-async，里面有两个任务调度器TaskExecutor
- newOrderedExecutor() ：返回 有序异步任务执行器OrderedTaskExecutor 。
TaskExecutor.OrderedTaskExecutor cbe = BaseTaskExecutor.newOrderedExecutor();
- newCyclicBarrierExecutor()：返回 关卡异步任务执行器CyclicBarrierExecutor。
- 缓存保存登录数据
/**
* 用户信息
*/
private static final String KEY_USER_INFO = "user_info";
private static UserInfoModel mUserInfoModel = null;
public static UserInfoModel getUserInfoModel() {
if (mUserInfoModel == null) {
try {
String acacheAsString = DataCacheManager.getJsonACache().getAsString(KEY_USER_INFO);
Log.d(TAG, "acacheAsString = " + acacheAsString);
mUserInfoModel = BaseModel.getGson().fromJson(acacheAsString, UserInfoModel.class);
} catch (Exception e) {
e.printStackTrace();
}
}
return mUserInfoModel;
}
public static void saveUserInfoModel(UserInfoModel UserInfoModel) {
DataManager.mUserInfoModel = UserInfoModel;
DataCacheManager.getJsonACache().put(KEY_USER_INFO, UserInfoModel.toString());
}
public static boolean isLogined() {
boolean isLogined = (DataManager.getUserInfoModel() != null);
Log.d(TAG+"getusertInfo", "getusertInfo = " + isLogined);
return isLogined;
}
public static void logout() {
DataCacheManager.getJsonACache().remove(KEY_USER_INFO);
mUserInfoModel = null;
}
- Fragment复用机制会导致在对象构造时候初始化的对象无法再次初始化，反而指向，比如下面的
task
public class HomeFragment extends BaseFragment {
TimerTask task = new TimerTask() {
@Override
public void run() {
}
};
}
因此此类变量的初始化，应该放在onCreate等方法中来进行，避免为null导致的崩溃问题。
第三方库问题排查路径
- 如果是崩溃问题，先利用搜索引擎搜索相应的错误日志，确认是否有现成的解决方案
- 如果没有解决方案，再确定问题数据把问题数据放入第三方库提供的demo，确认最新版本是否存在该问题。
- 如果存在，反馈给作者，寻找新的解决方案；
- 如果不存在，从
引用的版本是否一致和使用的接口是否规范两方面入手解决问题。
Panda
2016-08-10
