[Android流水化开发]工序5：封装数据加载、上传接口，并显

原则：

1. 接口输入输出的数据 要么为json，要么为文件流。
2. json返回数据必须包含如下的字段，而且0表示成功

{"respCode":0,"respDesc":"成功"}

3. 同样的respCode，只能表达同一个含义。
4. 返回的json串中不允许使用数字作为key，不允许存在名字会变动的key，比如取近三年的数据，结果出现了2014、2015、2016这些key值。
5. 当你的方法超过一屏幕，请找Leader确定逻辑是否合理。
6. 需要提取到PandaAndroidLib的内容统一放置在java/lib这个文件夹下。
7. 整个App周期中需要配置的内容放在LaunchFragment里面进行，而不是Application的onCreate里面。

流程

1. 如需调用第三方服务，先完成第三方服务集成。常见第三方服务有：

• 统计。一般用友盟。PandaAndroidLib底层支持，设置好key即可。
• 分享。
• 登录。
• 支付。
• 地图。

1. 拿到服务端接口文档，新建RepositoryCollection类，所有的接口都放在此类里统一管理。

public class RepositoryCollection extends BaseRepositoryCollection {
}

2. 实现各种网络接口。数据Model可以用GsonFormat插件自动生成，且必须透过底层的BaseRepositoryCollection的方法来获取，总体有两类：

• executeJsonRequest：获取json类型的返回数据
• executeFileRequest：获取File类型的返回数据
• url和respCode统一放在Constant.java进行管理。

3. 上层调用接口。有两种情形：

• 配合NetFragment系列使用，在onDoInBackgroundSafely里面实现。主要使用场景参考：
  • 一个常规的Android页面模型：NetFragment
  • 列表展示页面模型：ListNetFragment
• 配合BaseAsyncTask系列使用，如点击登录等场景

4. 抛出相应的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里面

样例代码

1. 强大的Android异步框架库android-lite-async，里面有两个任务调度器TaskExecutor

• newOrderedExecutor() ：返回 有序异步任务执行器OrderedTaskExecutor 。

TaskExecutor.OrderedTaskExecutor cbe = BaseTaskExecutor.newOrderedExecutor();

• newCyclicBarrierExecutor()：返回 关卡异步任务执行器CyclicBarrierExecutor。

2. 缓存保存登录数据

/**
 * 用户信息
 */
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;
}

3. Fragment复用机制会导致在对象构造时候初始化的对象无法再次初始化，反而指向，比如下面的task

public class HomeFragment extends BaseFragment {
    TimerTask task = new TimerTask() {
      @Override
      public void run() {
      }
    };
}

因此此类变量的初始化，应该放在onCreate等方法中来进行，避免为null导致的崩溃问题。

第三方库问题排查路径

1. 如果是崩溃问题，先利用搜索引擎搜索相应的错误日志，确认是否有现成的解决方案
2. 如果没有解决方案，再确定问题数据把问题数据放入第三方库提供的demo，确认最新版本是否存在该问题。

• 如果存在，反馈给作者，寻找新的解决方案；
• 如果不存在，从引用的版本是否一致和使用的接口是否规范两方面入手解决问题。

Panda
2016-08-10