Android談談封裝那些事--BaseActivity和BaseFragment(-)

Hankkin發表於2016-12-25

緒論

聖誕節怎麼過?我不過聖誕節,被票圈的曬幸福虐慘了,還是在家裡面總結總結自己吧。上篇文章
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 狀態列工具類(實現沉浸式狀態列/變色狀態列)

李哥的文章

相關文章