×

Android谈谈封装那些事--BaseActivity和BaseFragment(一)

96
Hankkinn
2016.12.25 20:41* 字数 1756

绪论

圣诞节怎么过?我不过圣诞节,被票圈的晒幸福虐惨了,还是在家里面总结总结自己吧。上篇文章
Android自定义View--自己撸一个柱状图也没那么难
我说过会封装一套属于自己的库,争取在元旦之前发出来,作为新年礼物给自己,给大家。好了,今天我们先来聊聊自己在项目中以及参考大神们的代码怎么来封装自己的BaseActivity和BaseFragment。

怎么封装?

说到封装我们首先想到的就是面向对象,以前脑子里对于面向对象的认识就是封装、继承、多态,随着自己真正进入开发工作之后,慢慢的才有了更深的认识;其实最深的一次是在和朋友交流的过程中他给了我很大的启发,所以技术交流其实还是很重要的。那么什么是封装呢?那就不得不提到面向对象了,下面谈谈我自己的理解,不一定对,所以还请大家多多包涵指正:

首先:面向对象的根本本质是什么?简单的一句话,其实就是把属性和方法绑定到了一起,这句话该怎么理解呢?举一个最简单的例子:我们在写一个activity的时候,我们可以把属性宏观理解为各种组件以及一些我们用的参数,然后把我们的处理业务逻辑的代码写到自己的方法中,基本上所有的类都是这样,属性-方法搞到一起,同时封还装隐藏了类的内部实现机制,从而可以在不影响使用者的前提下改变类的内部结构,同时保护了数据。。

紧接着:封装的概念就出来了,当我们觉得一个activity过于臃肿,代码过于冗余的时候,我们就会考虑到封装了,将某个复杂的业务逻辑封装成一个工具类,单独提出来供其他使用,再举个例子:下载文件。。。想必大家都会封装一个下载文件的工具类吧。具体不做过多介绍了啊。

当我们的这个类不能满足我们某些特定的需求时,我们还有继承,通俗的说:继承就是儿子遗传了老子的基因,同时也派生出了新的基因;继承是从已有的类中派生出新的类,新的类能吸收已有类的数据属性和行为,并能扩展新的能力。(可以从下面我的BaseEventActivity和BaseParentActivity中看)

当然继承是为了重用父类代码,同时为实现多态性作准备。多态这个多态我一直都觉得它的出现其实就是为了将接口和实现分离开,改善代码的组织结构,增强代码的可读性。在某些很简单的情况下,或许我们不使用多态也能开发出满足我们需要的程序,但大多数情况,如果没有多态,就会觉得代码极其难以维护。同时也补缺了Java中单继承的不足。当然这里不得不提到的还有抽象抽象就是把现实世界中的某一类东西,提取出来,用程序代码表示,抽象出来一般叫做类或者接口。

好了,这个面向对象我可能理解的还是比较浅,也有不对的地方,勿喷啊,多多指正。本着这个原则所以才有了下面的BaseActivity和BaseFragment。

BaseActivity封装

  • BaseEventActivity 事件总线基类
  • BaseParentActivity 注解绑定基类
  • BaseStatusBarActivity 通知栏沉浸基类

1. BaseEventActivity

我之前的项目中都用到了EventBus订阅/发布事件总线,代替了Intent,Handler,BroadCast在Fragment,Activity,Service,线程之间传递消息。但是用着用着发现每个activity里面都要注册、解注册事件.在OnCreate()里面注册:
EventBus.getDefault().register(this);
在OnDestroy()里面解注册:
EventBus.getDefault().unregister(this);
感觉有些麻烦,所以就封装了BaseEventActivity作为根Activity,同时将所有的Event放到BaseEventMap中,需要讨论的问题是就是这样的话就导致了所有的activity都订阅了事件总线,一个post发布之后,所有activity都会监听到,然后通过Event的类型进行判断,不知道这样的话有没有什么不妥当的地方。

先看一下BaseEventMap

所有的event都继承于BaseEvent,里面有两个参数:

public static class BaseEvent{
        public String code;        //错误码

        public String message;     //错误信息
    }

还有异常错误Event,我们可以将一些错误信息方法里面,通过错误码获取错误信息进行提示,当然类型可以自己定义。

package com.hankkin.hlibrary.event;

import android.text.TextUtils;
import java.util.HashMap;

/**
 * Created by Hankkin on 16/12/23.
 * 注释:时间总线类
 */

public class EventMap {

    //事件总线基类
    public static class BaseEvent{
        public String code;        //错误码

        public String message;     //错误信息
    }

    //错误类存储器
    public static HashMap<String,String> ERROR_MAPS = new HashMap<>();
    //本地存储各种错误信息
    static {
        ERROR_MAPS.put("-1", "上传失败");
        ERROR_MAPS.put("0", "连接超时,请检查网络后重试");
        ERROR_MAPS.put("1", "服务器内部错误,请重试");
        ERROR_MAPS.put("119", "客户端没有权限执行该项操作");
        ERROR_MAPS.put("127", "手机号无效,尚未发送验证码");
        ERROR_MAPS.put("206", "操作失败");
        ERROR_MAPS.put("210", "密码不正确,请重新输入");
        ERROR_MAPS.put("211", "用户不存在,请重新输入");
        ERROR_MAPS.put("213", "该手机号尚未注册");
        ERROR_MAPS.put("214", "该手机号已经被注册,请更换手机号重新注册");
        ERROR_MAPS.put("215", "该手机号尚未验证,无法修改密码");
        ERROR_MAPS.put("601", "发送短信验证码过快,请稍后重试");
    }

    /**
     * 根据错误码返回错误信息
     * @param code  错误码
     * @return
     */
    public static String pickMessage(String code){
        if (TextUtils.isEmpty(code)){
            return null;
        }
        if (ERROR_MAPS.containsKey(code))
            return ERROR_MAPS.get(code);
        return null;
    }

    /**
     * 错误异常事件
     */
    public static class HExceptionEvent extends BaseEvent{
        public boolean isPickedMessage = false;

        public HExceptionEvent(String message){
            this.message = message;
            this.isPickedMessage = true;
        }

        public HExceptionEvent(int code,String message){
            this.code = String.valueOf(code);
            this.isPickedMessage = ERROR_MAPS.containsKey(this.code);
            String pick = pickMessage(this.code);
            this.message = TextUtils.isEmpty(pick) ? message : pick;
        }
    }


    /**-----------华丽的分割线,你可以在下面定义你的事件继承BaseEvent----------------*/
}

然后我们在BaseEventActivity里面定义时间观察者,统一处理异常Event进行Toast提示:

 /**
     * 事件观察者
     * @param event
     */
    @Subscribe(threadMode = ThreadMode.MAIN)
    public void onEventMainThread(EventMap.BaseEvent event){
        if (event != null && event instanceof EventMap.HExceptionEvent){
            if (!TextUtils.isEmpty(event.message)){
                ToastUtils.showToast(mActivity,event.message);
            }
        }
    }

2. BaseParentActivity

同样的道理,我们在BaseParentActivity里面主要做了一下操作:

  • 统一进行注解绑定 initBind()
  • 布局加载 setContentView(getContentId());
  • 统一Titlebar初始化 initToolBar()
  • 组件初始化等方法 initViews()
  • Activity跳转 gotoActivity

其中布局加载initBind()组件初始化initViews()我觉得是每个activity都会写到的方法,所以这里实现了一个接口BaseViewInterface,里面有两个方法:

package com.hankkin.hlibrary.base;

/**
 * 
 * @author Hankkin
 *
 */
public interface BaseViewInterface {

    public int getLayoutId();

    public void initView();

}

所有的activity都重写这两个方法,看一下具体代码(里面还有activity跳转、拍照相册等方法):

package com.hankkin.hlibrary.base;

import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.provider.MediaStore;
import android.support.v7.widget.Toolbar;
import android.view.LayoutInflater;
import android.view.View;
import android.widget.ImageView;
import android.widget.TextView;
import butterknife.ButterKnife;
import com.hankkin.hlibrary.AppManager;
import com.hankkin.hlibrary.R;
import java.io.File;

/**
 * Created by Hankkin on 16/8/7.
 */
public abstract class BaseParentActivity extends BaseEventActivity implements BaseViewInterface {

    public static final int REQUEST_CAMERA = 100;
    public static final int REQUEST_GALLERY = 101;
    public static final int PHOTO_REQUEST_CUT = 102;

    protected LayoutInflater mInflater;
    protected String TAG;
    protected Activity activity;

    public interface OnRightClickListener {
        void rightClick();
    }

    @Override
    public void onCreate(Bundle savedInstanceState) {
        TAG = this.getClass().getSimpleName();
        AppManager.getAppManager().addActivity(this);
        if (getContentId() != 0) {
            setContentView(getContentId());
        }
        super.onCreate(savedInstanceState);
        mInflater = getLayoutInflater();
        activity = this;
        initBind();
        initView(savedInstanceState);
    }

    /**
     * 打开一个Activity 默认 不关闭当前activity
     */
    public void gotoActivity(Class<?> clz) {
        gotoActivity(clz, false, null);
    }

    public void gotoActivity(Class<?> clz, boolean isCloseCurrentActivity) {
        gotoActivity(clz, isCloseCurrentActivity, null);
    }

    public void gotoActivity(Class<?> clz, boolean isCloseCurrentActivity, Bundle ex) {
        Intent intent = new Intent(this, clz);
        if (ex != null) intent.putExtras(ex);
        startActivity(intent);
        if (isCloseCurrentActivity) {
            finish();
        }
    }

    /**
     * 统一初始化titlebar
     */
    protected Toolbar initToolBar(String title) {
        ImageView ivBack = (ImageView) findViewById(R.id.tool_bar_back);
        TextView tvTitle = (TextView) findViewById(R.id.tv_toolbar_title);
        tvTitle.setText(title);
        Toolbar toolbar = (Toolbar) findViewById(R.id.tool_bar);
        toolbar.setTitle("");
        setSupportActionBar(toolbar);
        toolbar.setContentInsetsRelative(10, 0);
        ivBack.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                back();
            }
        });
        return toolbar;
    }

    /**
     * 统一初始化titlebar右侧图片
     */
    protected Toolbar initToolBarRightImg(String title, int rightId, final OnRightClickListener listener) {
        ImageView ivBack = (ImageView) findViewById(R.id.tool_bar_back);
        TextView tvTitle = (TextView) findViewById(R.id.tv_toolbar_title);
        tvTitle.setText(title);
        Toolbar toolbar = (Toolbar) findViewById(R.id.tool_bar);
        toolbar.setTitle("");
        setSupportActionBar(toolbar);
        toolbar.setContentInsetsRelative(10, 0);
        ivBack.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                back();
            }
        });
        ImageView ivRight = (ImageView) findViewById(R.id.iv_tool_bar_right);
        ivRight.setImageResource(rightId);
        ivRight.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                listener.rightClick();
            }
        });
        return toolbar;
    }


    /**
     * 统一初始化titlebar右侧文字
     */
    protected Toolbar initToolBarRightTxt(String title, String right, final OnRightClickListener listener) {
        ImageView ivBack = (ImageView) findViewById(R.id.tool_bar_back);
        TextView tvTitle = (TextView) findViewById(R.id.tv_toolbar_title);
        tvTitle.setText(title);
        Toolbar toolbar = (Toolbar) findViewById(R.id.tool_bar);
        toolbar.setTitle("");
        setSupportActionBar(toolbar);
        toolbar.setContentInsetsRelative(10, 0);
        ivBack.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                back();
            }
        });
        TextView tvRight = (TextView) findViewById(R.id.tv_tool_bar_right);
        tvRight.setText(right);
        tvRight.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                listener.rightClick();
            }
        });
        return toolbar;
    }

    protected void back() {
        if (activity != null) {
            activity.finish();
        }
    }

 

    @Override
    protected void onDestroy() {
        super.onDestroy();
    }

    protected int getContentId() {
        return getLayoutId();
    }

    protected void initBind() {
        ButterKnife.bind(activity);
    }
}


3. BaseStatusActivity

随着Android系统版本的提高,绝大多数的APP都已经适配了沉浸式状态栏,不然觉得黑乎乎的状态栏太别扭,沉浸通知栏的文章也有很多,但是我觉得最好的一篇还是猴哥的那篇,封装的很好,基本适配了所有情况,连Fragment里面图片、透明通知栏都已经适配好了,我的库里面也有,这里面就不多说了,还没太完善:

package com.hankkin.hlibrary.base;

import android.app.Activity;
import android.os.Bundle;
import butterknife.ButterKnife;
import com.hankkin.hlibrary.R;
import com.hankkin.hlibrary.utils.statusbar.StatusBarUtil;

/**
 * Created by Hankkin on 16/12/23.
 * 注释:设置状态栏base基类
 */

public abstract class BaseStatusActivity extends BaseParentActivity{
    protected String TAG;
    protected Activity activity;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        TAG = this.getClass().getSimpleName();
        activity = this;
        super.onCreate(savedInstanceState);
        setStatusBar();
    }

    private void setStatusBar() {
        StatusBarUtil.setColor(this, getResources().getColor(R.color.colorPrimary), 0);
    }

    
}

到此为止我们的BaseActivity就封装完了,至于那个BaseEventActivity的问题,涛哥说"Eventbus2是反射取Class,EventBus3是注解apt,感觉子类应该不会被加入的",这个或许研究完源码可能会了解到,目前使用没什么问题。好了,BaseFragment懒加载我会在下一篇文章中介绍的,同时还要感谢大神的文章:

StatusBarUtil 状态栏工具类(实现沉浸式状态栏/变色状态栏)

李哥的文章

Android干货
Web note ad 1