背景before:
在我們APP啟動過程,我們可能常常有這樣的需求:在APP第一次進入的時候根據網路請求的結果彈一個對話方塊式的廣告, ok~ 很簡單,那麼程式碼大致就是這樣(這邊都是虛擬碼,為了方便理解):
@Override protected void onCreate(@Nullable Bundle savedInstanceState) { checkFirstDialogIfNeed(); } /** * step 1 */ private void checkFirstDialogIfNeed(){ Utils.fakeRequest("http://www.api1.com", new HttpCallBack() { @Override public void onOk() { showADialog(); } @Override public void onFailure() { //do nothing } }); }
ok,做完上線
step1過了一陣子,產品同學又跑過來了說:
“老闆的需求,我們要在首頁第一次進來的時候加一個註冊協議的彈框”
程式設計師小A: “可是首頁已經之前有一個彈框了,直接一起展示嗎?”
產品同學: “一起彈出來體驗不好,那你放在A彈框之後吧!”
ok,那麼程式設計師小A尋思了一下,那應該就是這麼改了:
@Override protected void onCreate(@Nullable Bundle savedInstanceState) { checkFirstDialogIfNeed(); } private void checkFirstDialogIfNeed(){ Utils.fakeRequest("http://www.api1.com", new HttpCallBack() { @Override public void onOk() { showADialog(); } @Override public void onFailure() { //請求失敗直接跳過，請求註冊協議 checkRegisterAgreement(); } }); } private void showADialog() { new AlertDialog.Builder(this) .setTitle("這是一條有態度的廣告") .setPositiveButton("我看完了", null) .setOnDismissListener(new DialogInterface.OnDismissListener() { @Override public void onDismiss(DialogInterface dialogInterface) { //彈框結束後請求註冊協議 checkRegisterAgreement(); } }).create().show(); } private void checkRegisterAgreement() { Utils.fakeRequest("http://www.api2.com", new HttpCallBack() { @Override public void onOk() { showBDialog(); } @Override public void onFailure() { //do nothing } }); }這麼下來,我們先請求介面APi1,如果成功了彈廣告彈框A,彈框結束了呼叫註冊協議的方法,如果APi1 請求失敗,直接跳過廣告彈框A,繼而請求註冊協議,當註冊協議請求成功了彈出我們的註冊協議彈框,這麼下來,我們確實可以保證註冊協議彈框在廣告彈框之後~
step2過了幾天,產品同學又來了:“這次我們首頁初次進來再加一個H5頁面跳轉,這次就加在 廣告和註冊協議之間吧…”
於是乎,小A繼續改了改程式碼,整個程式碼就成了這樣:
@Override protected void onCreate(@Nullable Bundle savedInstanceState) { checkFirstDialogIfNeed(); } private void checkFirstDialogIfNeed() { Utils.fakeRequest("http://www.api1.com", new HttpCallBack() { @Override public void onOk() { showADialog(); } @Override public void onFailure() {// //請求失敗直接跳過，請求註冊協議// checkRegisterAgreement(); checkNeedShowH5(); } }); } private void showADialog() { new AlertDialog.Builder(this) .setTitle("這是一條有態度的廣告") .setPositiveButton("我看完了", null) .setOnDismissListener(new DialogInterface.OnDismissListener() { @Override public void onDismiss(DialogInterface dialogInterface) { // //彈框結束後請求註冊協議// checkRegisterAgreement(); //現在產品要插入一個H5頁面優先請求 checkNeedShowH5(); } }).create().show(); } private void checkRegisterAgreement() { Utils.fakeRequest("http://www.api2.com", new HttpCallBack() { @Override public void onOk() { showBDialog(); } @Override public void onFailure() { //do nothing } }); } private void showBDialog() { new AlertDialog.Builder(this) .setTitle("這是註冊協議") .setPositiveButton("我看完了", null) .setOnDismissListener(new DialogInterface.OnDismissListener() { @Override public void onDismiss(DialogInterface dialogInterface) { //do nothing } }).create().show(); } private void checkNeedShowH5() { Utils.fakeRequest("http://www.api3.com", new HttpCallBack() { @Override public void onOk() { toH5Page(); } @Override public void onFailure() { checkRegisterAgreement(); } }); } private void toH5Page() { startActivityForResult(new Intent(this, TestH5Activity.class), REQUEST_CODE_H5); } @Override protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_CODE_H5: checkRegisterAgreement(); break; default: break; } }首先將原有step1 結束之後不再呼叫註冊協議,而是呼叫請求H5的方法.
由於去H5是一個Activity的跳轉,所以我們在onActivityResult裡我們繼續之前的註冊協議的呼叫.
看看大致demo效果:
再後來…幾經迭代,首頁首次的彈框和頁面跳轉已經有7、8個了,當每次產品有類似需求的時候,我們又要重複上面的過程了,每次大概梳理個大半天吧.
大家是否有發現什麼問題嗎?1.首頁次序之間強耦合,每次一旦要在二者之前插入一個其他彈框或者頁面,我們每次都要修改在它之前和之後的呼叫鏈,至少要修改三處,很容易漏掉,但是實際上它們彼此之間除了次序之外,沒有其他關聯.
2.每次新需求來的時候都要完整梳理原有邏輯,比較浪費時間,影響效率.
怎麼辦？思考:1.能否在一個鏈中統一管理要處理的事情,每個事情之間互相不關聯,只要簡單配置就可以輕鬆替換它們之間的順序.
2.後來維護者,很清晰的就能知道呼叫的次序,無需每次重新梳理整個業務程式碼.
設計:1.我們是否可以把每件要做的事情抽象成一個節點,每個節點只關心自己的任務是否完成,它並不知道它是第幾個,也不知道它前面或者後面的是誰.
2.每個節點統一由一個流來管理,它作為全域性統籌者,可以控制從任意節點開始、控制整個流的開啟與結束等,每個節點的順序由流來管理.
實現:帶著以上設計思路,我對程式碼做了一下重構,程式碼變成了這樣:
public class AfterActivity extends AppCompatActivity { private static final int REQUEST_CODE_H5 = 1; /** * 初次廣告彈框 */ private static final int NODE_FIRST_AD = 10; /** * 初次進入h5頁 */ private static final int NODE_CHECK_H5 = 20; /** * 初次進入的註冊協議 */ private static final int NODE_REGISTER_AGREEMENT = 30; private WorkFlow workFlow; @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); startWorkFlow(); } private void startWorkFlow() { workFlow = new WorkFlow.Builder() .withNode(getFirstAdNode()) .withNode(getShowRegisterAgreementNode()) .withNode(getShowH5Node()) .create(); workFlow.start(); } private WorkNode getFirstAdNode() { return WorkNode.build(NODE_FIRST_AD, new Worker() { @Override public void doWork(final Node current) { Utils.fakeRequest("http://www.api1.com", new HttpCallBack() { @Override public void onOk() { new AlertDialog.Builder(AfterActivity.this) .setTitle("這是一條有態度的廣告") .setPositiveButton("我看完了", null) .setOnDismissListener(new DialogInterface.OnDismissListener() { @Override public void onDismiss(DialogInterface dialogInterface) { //僅僅只需關心自己是否完成，下一個節點會自動執行 current.onCompleted(); } }).create().show(); } @Override public void onFailure() { //僅僅只需關心自己是否完成，下一個節點會自動執行 current.onCompleted(); } }); } }); } private WorkNode getShowRegisterAgreementNode() { return WorkNode.build(NODE_REGISTER_AGREEMENT, new Worker() { @Override public void doWork(final Node current) { Utils.fakeRequest("http://www.api2.com", new HttpCallBack() { @Override public void onOk() { new AlertDialog.Builder(AfterActivity.this) .setTitle("這是註冊協議") .setPositiveButton("我看完了", null) .setOnDismissListener(new DialogInterface.OnDismissListener() { @Override public void onDismiss(DialogInterface dialogInterface) { current.onCompleted(); } }).create().show(); } @Override public void onFailure() { current.onCompleted(); } }); } }); } private WorkNode getShowH5Node() { return (WorkNode.build(NODE_CHECK_H5, new Worker() { @Override public void doWork(final Node current) { Utils.fakeRequest("http://www.api3.com", new HttpCallBack() { @Override public void onOk() { startActivityForResult(new Intent(AfterActivity.this, TestH5Activity.class), REQUEST_CODE_H5); } @Override public void onFailure() { current.onCompleted(); } }); } })); } @Override protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) { super.onActivityResult(requestCode, resultCode, data); switch (requestCode) { case REQUEST_CODE_H5: workFlow.continueWork(); break; default: break; } }}經過上述重構,現在的首頁流程:
1. 進入首頁要做的幾件事之間相互無關聯,它們的位置可以任意切換,只需改變id大小便可輕鬆調整它們的執行順序.
2. 想要加入或者插入節點無需改動原有邏輯.
實現思路
設計每個工作節點
1.我希望每個任務間彼此獨立,只關心自己的事情是否完成,我把它抽象成一個節點,每個節點只有自己的節點id 和 完成的方法:
public interface Node { /** * 節點id * * @return 當前節點id */ int getId(); /** * 任務完成時觸發 */ void onCompleted();}
至於為什麼要提供id,後面會講到.
我們再來看看它的實現類WorkNode的核心程式碼:
public class WorkNode implements Node { /** * 節點id */ private int nodeId; /** * 節點工作者 */ private Worker worker; private WorkCallBack callBack; public static WorkNode build(int nodeId, Worker worker) { return new WorkNode(nodeId, worker); } /** * @param worker 呼叫者傳入，即真正執行要做的事情 */ public WorkNode(int nodeId, Worker worker) { this.nodeId = nodeId; this.worker = worker; } /** * 由workFlow來決定呼叫 * * @param callBack 當呼叫onCompleted 之後回撥給WorkFlow */ void doWork(WorkCallBack callBack) { this.callBack = callBack; worker.doWork(this); } @Override public int getId() { return nodeId; } @Override public void onCompleted() { if (null != callBack) { callBack.onWorkCompleted(); } } interface WorkCallBack { /** * 當前任務完成 */ void onWorkCompleted(); }}構造方法中傳入了節點id,和Worker, 這個Worker的doWork方法的實現就是我們這個節點真正要做的事情:
public interface Worker { /** * 執行任務 * * @param current 當前節點 */ void doWork(Node current);}
至此我們回看下demo中對WorkNode的構建:
private WorkNode getFirstAdNode() { return WorkNode.build(NODE_FIRST_AD, new Worker() { @Override public void doWork(final Node current) { Utils.fakeRequest("http://www.api1.com", new HttpCallBack() { @Override public void onOk() { new AlertDialog.Builder(AfterActivity.this) .setTitle("這是一條有態度的廣告") .setPositiveButton("我看完了", null) .setOnDismissListener(new DialogInterface.OnDismissListener() { @Override public void onDismiss(DialogInterface dialogInterface) { //僅僅只需關心自己是否完成，下一個節點會自動執行 current.onCompleted(); } }).create().show(); } @Override public void onFailure() { //僅僅只需關心自己是否完成，下一個節點會自動執行 current.onCompleted(); } }); } }); }是不是很清晰?
節點只需要關心自己是否做完了,呼叫完onCompleted之後,一切與我無關了,後續做什麼就交給WorkFlow去處理了.
那節點的doWork方法是什麼時候被呼叫的呢? 它內部是怎麼安排工作的呢?,我們來設計WorkFlow.
設計工作流:
首先作為所有節點的管理者,當然要把它們存下來,用什麼資料結構來存呢?回顧一下我的需求: 可以靈活控制節點的執行順序, so…經過反覆篩選,我最終選擇了SparseArray來存放我們所有的節點,因為我們為每個節點提供id作為key:
一來可以提高程式碼可讀性。
二來,SparseArray內部是陣列實現的,而且是按照key的大小升序排列的,基於這個特性,我們只需要改變定義Key值的大小關係就可以改變它們在陣列中的順序。
我們再來看看用SparseArray來實現的WorkFlow:
public class WorkFlow { private SparseArray<WorkNode> flowNodes; public WorkFlow(SparseArray<WorkNode> flowNodes) { this.flowNodes = flowNodes; } /** * 開始工作，預設從第一個節點 */ public void start() { startWithNode(flowNodes.keyAt(0)); } /** * 基於某個節點Id 開始工作 * * @param startNodeId 節點id */ public void startWithNode(int startNodeId) { final int startIndex = flowNodes.indexOfKey(startNodeId); WorkNode startNode = flowNodes.valueAt(startIndex); startNode.doWork(new WorkNode.WorkCallBack() { @Override public void onWorkCompleted() { findAndExecuteNextNodeIfExist(startIndex); } }); } private void findAndExecuteNextNodeIfExist(int startIndex) { final int nextIndex = startIndex + 1; final WorkNode nextNode = flowNodes.valueAt(nextIndex); if (null != nextNode) { nextNode.doWork(new WorkNode.WorkCallBack() { @Override public void onWorkCompleted() { findAndExecuteNextNodeIfExist(nextIndex); } }); } }}我們在demo中呼叫的start()的方法,其實內部呼叫的是 startWithNode 方法,這個方法接收一個引數 startNodeId ,也就是我們構建節點的id,我們在 SparseArray 中找到節點,直接開始執行。
當我們在節點內部呼叫完 onCompleted 方法之後, 會直接回調 onWorkCompleted 方法,此時我們再看看是否有下一個節點,當有下一個節點之後,一直遞迴到下一個沒有節點為止。
至此,我們原理基本分析完成,通過內部 SparseArray的設計,我們可以靈活從任意節點開始執行,外部的WorkFlow就是一個全域性的管理者,我們可以拓展很多其他功能,比如 continueWork() :當我們在節點以外希望讓流程繼續執行下去的時候(參考Demo的 onActivityResult), revert():回退到上一節點 等等。
總結WorkFlow,很好的接耦了各個次序任務直接的相互依賴,提高了開發效率。它也很好的提高了程式碼的可維護性和可讀性,非常便於後來新次序任務的拓展。最後對於程式設計師來說，要學習的知識內容、技術有太多太多，要想不被環境淘汰就只有不斷提升自己，從來都是我們去適應環境，而不是環境來適應我們！
相信它會給大家帶來很多收穫：
當程式設計師容易，當一個優秀的程式設計師是需要不斷學習的，從初級程式設計師到高階程式設計師，從初級架構師到資深架構師，或者走向管理，從技術經理到技術總監，每個階段都需要掌握不同的能力。早早確定自己的職業方向，才能在工作和能力提升中甩開同齡人。
- Android程式設計師現狀：沒有架構師的命，卻得了架構師的病
- 終於有人把安卓程式設計師必學知識點全整理出來了，有如醍醐灌頂
- 測試一直都是Android程式設計師忽視的重要一環,再不重視起來就GG了
- 多少程式設計師的夢想職位,成為阿里P7真的就這麼難嗎?學會這些就夠了
- Android開發未來該怎麼走？阿里8年開發經驗程式設計師這麼說的！
- 一天入手Flutter，一週完成一個APP，附教程
- 蘋果警告微信，沒有「黑暗模式」就下架？微信：已與蘋果達成合作
- 前端程式設計師：疫情在家不能出門用vue開發了一個抖音app
- Flutter呼聲越來越高，但唱衰的人依舊不少，跨平臺何時能統一？
- 「前端開發」一篇文章概括目前流行的前端開發框架