專案需求討論 — 手把手帶你寫RxPermission

青蛙要fly發表於2018-01-03

首先既然是Rx系列,前提是會Rxjava相關的基本知識,如果沒有Rxjava的相關知識,請補好Rxjava相關知識再來看。

關於許可權申請的基礎前面也寫過相應的文章:

專案需求討論 - 動態許可權申請分析及相關第三方庫原始碼分析

專案需求討論 — 手把手帶你寫RxPermission

一天,產品經理走過來掃了掃我的電腦上的支付寶收款碼,打了一筆錢給我後,跟我說了幾個需求:

  1. 一天做一個視訊功能
  2. 半天做一個介面
  3. 四天做一個日曆控制元件

比如第一個任務,你覺得你是肯定做不完的,我們就直接告訴產品經理不可能,第二個可以完成,直接給肯定回覆,第三個任務你可能要評估一下,說晚點再告訴產品經理,給他答覆能不能做這個控制元件。

專案需求討論 — 手把手帶你寫RxPermission

三個任務的三個答覆我們就這麼寫:

1.建立需求的答覆物件:

public class TaskAnswer {

    private String taskName;//需求名字
    private Boolean taskResult;//需求結果

    public TaskAnswer(String taskName, Boolean taskResult) {
        this.taskName = taskName;
        this.taskResult = taskResult;
    }
    
    public String getTaskName() {
        return taskName;
    }

    public boolean isTaskResult() {
        return taskResult;
    }
}
複製程式碼

2. 建立答覆的給產品經理(建立Observable)

傳送答覆給產品經理:

TaskAnswer answer1 = new TaskAnswer("第一個需求",false);
TaskAnswer answer2 = new TaskAnswer("第二個需求",true);

Observable<TaskAnswer> task1 = Observable.just(answer1);
Observable<TaskAnswer> task2 = Observable.just(answer2);
PublishSubject<TaskAnswer> task3 = PublishSubject.create();
複製程式碼

因為前面二個我們是已經知道了結果,第三個我們需要考慮晚點再通過task3.onNext(new TaskAnswer("第三個需求",(true/false)))來給產品經理答覆。

我們知道我們需要先走到產品經理那裡,告訴他目前三個需求的結果,不可能走過去先說第一個不行,然後回到自己位子上,然後再走過去告訴他第二個可以,然後再回來,然後再去告訴他第三個看情況,後面給結果。肯定是一次性走過去告訴他三個需求的初步結果:

String[] taskList = {"第一個需求","第二個需求","第三個需求"};

final PublishSubject<TaskAnswer> taskPub = PublishSubject.create();

//我們把三個需求對應的Observable放在一個List中
List<Observable<TaskAnswer>> list = new ArrayList<>();
for (String task : taskList){
    TaskAnswer answer;
    if(task.equals("第一個需求")){
        answer = new TaskAnswer(task,false);
        //因為我們知道了第一個需求不能完成,直接馬上告訴產品經理,所以直接Observable.just就可以
        Observable<TaskAnswer> taskOb = Observable.just(answer);
        list.add(taskOb);
        continue;
    }

    if(task.equals("第二個需求")){
        answer = new TaskAnswer(task,true);
        //因為我們知道了第二個需求能完成,直接馬上告訴產品經理,所以直接Observable.just就可以
        Observable<TaskAnswer> taskOb = Observable.just(answer);
        list.add(taskOb);
        continue;
    }
    
    //這是第三個需求,因為是要晚點再告訴產品經理,所以它是PublishSubject
    list.add(taskPub);
}

//我們使用concat操作符把三個需求Observable連在一起變成一個
Observable<List<TaskAnswer>> total = Observable.concat(Observable.fromIterable(list)).buffer(3);

複製程式碼

3. 產品經理針對答覆做出相應處理(訂閱Observable)

我們可以看到,我們已經可以把第一次情況反饋給了產品經理,但這裡可以有二種情況發生(主要看你跟產品經理關係鐵不鐵):

專案需求討論 — 手把手帶你寫RxPermission

  1. 如果你跟產品經理的關係特別鐵,產品經理說:這次的任務是有點急,而且難度也特別大,所以你沒能按時沒完成也不要緊,我們那時候具體一個個來看,哪幾個完成了,哪幾個沒完成,日程上面對這幾個需求有記錄就行。
total.flatMap(new Function<List<TaskAnswer>, ObservableSource<TaskAnswer>>() {
            @Override
            public ObservableSource<TaskAnswer> apply(@NonNull List<TaskAnswer> taskAnswers) throws Exception {
                return Observable.fromIterable(taskAnswers);
            }
        }).subscribe(new Consumer<TaskAnswer>() {
            @Override
            public void accept(TaskAnswer taskAnswer) throws Exception {
                Log.v("dyp","名字:"+taskAnswer.getTaskName()+",結果:"+taskAnswer.isTaskResult());
            }
        });
複製程式碼
  1. 如果產品經理跟你的關係不是很鐵, 他威脅你:你一定要就這幾天把我提的需求都做出來,不然只要一個沒完成,就記你這個月的任務沒有按時完成,會計入到考核中。
total.flatMap(new Function<List<TaskAnswer>, ObservableSource<Boolean>>() {
            @Override
            public ObservableSource<Boolean> apply(@NonNull List<TaskAnswer> taskAnswers) throws Exception {
                if(taskAnswers.isEmpty()){
                    return Observable.empty();
                }
                for (TaskAnswer answer : taskAnswers){
                    if(!answer.isTaskResult()){
                        return Observable.just(false);
                    }
                }
                return Observable.just(true);
            }
        });
複製程式碼

我們可以看到,我們遍歷了三個需求,只要有一個需求的結果不是true,我們就直接返回了Observable.just(false);,只有當三個需求的答覆結果都是true,才會返回Observable.just(true);。 這時候產品經理只需要:

Observable.just(false/true)
    .subscribe(new Consumer<Boolean>() {
        @Override
        public void accept(Boolean aBoolean) throws Exception {
            if(aBoolean){
                Toast.makeText(this, "不錯麼,小夥子,需求都完成了。", Toast.LENGTH_SHORT).show();
            }else{
                Toast.makeText(this, "你死定了,獎金啥的都別指望了。", Toast.LENGTH_SHORT).show();
            }
        }
    });
複製程式碼

4. 最後一個需求經過考慮過後告訴產品經理最終答案

這時候產品經理也已經跟我們對接了,我們還記不記得我們的第三個需求是不能馬上告訴產品經理的,所以我們經過N分鐘的思考後,決定告訴產品經理,這個需求貌似可以按時完成。

//我們使用第三個需求的PublishSubject物件來傳送結果給產品經理
taskPub.onNext(new TaskAnswer("第三個需求",true));
taskPub.onComplete();
複製程式碼

這時候產品經理那裡就會收到(假設我們跟產品經理是很鐵的那種關係):

V: 名字:第一個需求,結果:false
V: 名字:第二個需求,結果:true
V: 名字:第三個需求,結果:true
複製程式碼

專案需求討論 — 手把手帶你寫RxPermission

正式起航

對其,初步的知識點我們已經講完了。我們來看下我們的許可權申請跟上訴這個故事的相同點:

專案需求討論 — 手把手帶你寫RxPermission
產品經理給程式設計師提需求

專案需求討論 — 手把手帶你寫RxPermission
手機APP向系統提許可權

沒錯,基本一模一樣,唯一不同的地方就是圖中藍色那一塊:

產品經理提需求 手機APP提許可權
腦子想了一會,呼叫了onNext和onComplete回覆。 跳出彈框,讓使用者點選,然後再呼叫onNext和onComplete回覆。

所以我們目前把RxPermission功能進行劃分:

RxPermission檔案分塊

  • Permission.java:許可權物件
  • RxPermissions.java :裡面對許可權進行分組(分成已經確定了結果的,還有沒有確定結果需要詢問的),並且生成Observable,
  • RxPermissionsFragment.java:也就是圖片藍色的內容,對於那些還沒有確定結果的許可權進行彈框詢問,等使用者點選了,然後再呼叫onNext,onComplete等進行通知。

我們需要先按照我們上面提過的產品經理的故事一樣,把三個需求分成已經確定了結果的和還需要思考一會的。我們這裡也要把許可權也先分組分好(也就是在RxPermissions.java中):

@TargetApi(Build.VERSION_CODES.M)
private Observable<Permission> requestImplementation(final String... permissions) {
    //傳入引數為許可權的名字字元組。

    //用來放所有的許可權集合
    List<Observable<Permission>> list = new ArrayList<>(permissions.length);
    //用來放等會要詢問的許可權集合
    List<String> unrequestedPermissions = new ArrayList<>();

    //對於傳進來的許可權進行遍歷
    for (String permission : permissions) {
        mRxPermissionsFragment.log("Requesting permission " + permission);
        
        //如果已經處於同意狀態就把這個許可權物件給放入list中。
        if (isGranted(permission)) {
            // Already granted, or not Android M
            // Return a granted Permission object.
            list.add(Observable.just(new Permission(permission, true, false)));
            continue;
        }

        //如果已經處於拒絕狀態就把這個許可權物件放入list中
        if (isRevoked(permission)) {
            // Revoked by a policy, return a denied Permission object.
            list.add(Observable.just(new Permission(permission, false, false)));
            continue;
        }

        /*
        就跟我們產品經理的故事裡面一樣,我們要對還不確定結果的需求,
        建立一個PublishSubject,然後計入到unrequestedPermissions列表中用來傳遞給Fragment,
        同時也加入到中的list列表中。
        */
        PublishSubject<Permission> subject = mRxPermissionsFragment.getSubjectByPermission(permission);
        // Create a new subject if not exists
        if (subject == null) {
            unrequestedPermissions.add(permission);
            subject = PublishSubject.create();
            //把PublishSubject存入fragment中,等會方便確定好結果後呼叫
            mRxPermissionsFragment.setSubjectForPermission(permission, subject);
        }
        list.add(subject);
    }
    
    /*
    這裡就是把帶詢問列表的所有內容都送到RxPermissionsFragment.java中,
    然後在fragment中會針對這個列表裡面的每個許可權,去呼叫系統方法進行詢問,
    然後根據不同的結果去onNext和onComplete通知。
    */
    if (!unrequestedPermissions.isEmpty()) {
        
        String[] unrequestedPermissionsArray = unrequestedPermissions.toArray(new String[unrequestedPermissions.size()]);
        //把list轉換成String[]再傳入到fragment中。
        requestPermissionsFromFragment(unrequestedPermissionsArray);
    }
    
    //這裡跟產品經理的故事裡面一樣,我們會把所有的許可權都放在一個Observable裡面。
    return Observable.concat(Observable.fromIterable(list));
}
複製程式碼

然後剩下的就是具體的fragment中處理的事情:

@TargetApi(Build.VERSION_CODES.M)
void requestPermissionsFromFragment(String[] permissions) {
    mRxPermissionsFragment.log("requestPermissionsFromFragment " + TextUtils.join(", ", permissions));
    
    //呼叫系統方法,對傳入的需要詢問的許可權進行彈框申請,讓使用者來決定
    mRxPermissionsFragment.requestPermissions(permissions);
}
複製程式碼

當使用者進行點選同意或者拒絕的時候,系統會自動回撥:

@TargetApi(Build.VERSION_CODES.M)
public void onRequestPermissionsResult(int requestCode, @NonNull String permissions[], @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);

    if (requestCode != PERMISSIONS_REQUEST_CODE) return;

    boolean[] shouldShowRequestPermissionRationale = new boolean[permissions.length];

    for (int i = 0; i < permissions.length; i++) {
        shouldShowRequestPermissionRationale[i] = shouldShowRequestPermissionRationale(permissions[i]);
    }
    
    //主要就是呼叫這個方法
    onRequestPermissionsResult(permissions, grantResults, shouldShowRequestPermissionRationale);
}


void onRequestPermissionsResult(String permissions[], int[] grantResults, boolean[] shouldShowRequestPermissionRationale) {

    //根據進行詢問的許可權來進行遍歷
    for (int i = 0, size = permissions.length; i < size; i++) {
        log("onRequestPermissionsResult  " + permissions[i]);
        // Find the corresponding subject
        PublishSubject<Permission> subject = mSubjects.get(permissions[i]);
        if (subject == null) {
            // No subject found
            Log.e(RxPermissions.TAG, "RxPermissions.onRequestPermissionsResult invoked but didn't find the corresponding permission request.");
            return;
        }
        
        mSubjects.remove(permissions[i]);
        
        //獲取反饋的結果,使用者是同意還是拒絕
        boolean granted = grantResults[i] == PackageManager.PERMISSION_GRANTED;
        
        //然後傳送結果,onNext(new Permissinon.....)
        subject.onNext(new Permission(permissions[i], granted, shouldShowRequestPermissionRationale[i]));
        
        //然後呼叫onComplete()進行結束
        subject.onComplete();
    }
}
複製程式碼

專案需求討論 — 手把手帶你寫RxPermission

還記不記得我們跟產品經理的關係鐵與不鐵,還有不同的處理,就是都成功還算任務完成,或者分批告訴你每個需求的評估結果。RxPermission在RxPermission.java中也有這二種情況,分別對應了:requestrequestEach方法。

最後我們就可以在Activity中安心的使用:

//你跟產品經理關係不好的時候,一個完成不了就算輸:
rxPermissions.request(Manifest.permission.CAMERA,
        Manifest.permission.READ_PHONE_STATE)
        .subscribe(new Consumer<Boolean>() {
        @Override
        public void accept(@io.reactivex.annotations.NonNull Boolean aBoolean) throws Exception {
            
            
        }
});

//你跟產品經理關係不錯。只要反饋每個具體的情況即可
rxPermissions.requestEach(Manifest.permission.CAMERA,
        Manifest.permission.READ_PHONE_STATE)
        .subscribe(new Consumer<Permission>() {
        @Override
        public void accept(@io.reactivex.annotations.NonNull Permission permission) throws Exception {

        }
});
複製程式碼

結尾

以圖片結尾,沒錯。這是個看臉的時代,還好我長的帥氣。(^▽^)

專案需求討論 — 手把手帶你寫RxPermission

相關文章