项目需求讨论 — 手把手带你写RxPermission

2,861 阅读8分钟

首先既然是Rx系列,前提是会Rxjava相关的基本知识,如果没有Rxjava的相关知识,请补好Rxjava相关知识再来看。

关于权限申请的基础前面也写过相应的文章:

项目需求讨论 - 动态权限申请分析及相关第三方库源码分析

一天,产品经理走过来扫了扫我的电脑上的支付宝收款码,打了一笔钱给我后,跟我说了几个需求:

  1. 一天做一个视频功能
  2. 半天做一个界面
  3. 四天做一个日历控件

比如第一个任务,你觉得你是肯定做不完的,我们就直接告诉产品经理不可能,第二个可以完成,直接给肯定回复,第三个任务你可能要评估一下,说晚点再告诉产品经理,给他答复能不能做这个控件。

三个任务的三个答复我们就这么写:

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)

我们可以看到,我们已经可以把第一次情况反馈给了产品经理,但这里可以有二种情况发生(主要看你跟产品经理关系铁不铁):

  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

正式起航

对其,初步的知识点我们已经讲完了。我们来看下我们的权限申请跟上诉这个故事的相同点:

产品经理给程序员提需求

手机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.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 {

        }
});

结尾

以图片结尾,没错。这是个看脸的时代,还好我长的帅气。(^▽^)