ZAOP

ZAOP是Android平台上的一个工具类库，结合了AOP思想，基于ASM实现，通过织入代码完成功能的实现。

特点

• 1 使用注解的方式达到效果，使用起来方便直观。
• 2 和业务代码解耦，业务代码逻辑中不需要考虑其他代码。
• 3 基于ASM，轻量级的代码织入。
• 4 混淆之前完成织入，不会被混淆影响。
• 5 使用方便，无需过多配置。

使用

1.@RTSupport

配合Android提供的一些编译期注解使用，将其只在编译期作用带入到运行时。
之所以采用@RTSupport配合原生注解的的方式，是想保持编辑器对原生注解的警告支持基础上加入运行时检查。

• 1 @NonNull：作用可以指明一个参数不可以为null，如果传入了null值，开发工具IDE会警告程序可能会有崩溃的风险，但是运行时不会起作用。
  配合@RTSupport使用，会在运行时检查标记了@NonNull的参数是否为null，没有标记@NonNull的参数不会加入运行时检查。

    //运行时会检查str1 而不会检查str2
    @RTSupport
    public void f(@NonNull String str1, String str2) {
        
    }
    
    //可以在Application中配置检查到Null的时候的全局策略
    ZAOP.config()
                .setGlobalRTSupportCallback(new ZAOP.GlobalRTSupportCallback() {
                    @Override
                    public void onParamIsNull(String className, String method, int paramIndex, String paramName) {
                        throw new NullPointerException(String.format("Parameter '%s' is null. Index: %s,  Class : %s, Method : %s", paramName, paramIndex, className, method));
                    }
                })

2.过滤快速点击

• 1 默认会对实现OnClickListener.onClick(View)的方法加入快速点击过滤处理，只需要像平常一样使用setOnClickListener()就可以有过滤效果。

    //正常使用就已经默认加入了过滤处理
    view.setOnClickListener(new OnClickListener {
        public void onClick(View v){}
    })

    //如果想实现某个OnClick允许快速点击，可以使用@FastClickAllowed, 就不会加入过滤处理了。
    view.setOnClickListener(new OnClickListener {
        @FastClickAllowed
        public void onClick(View v){}
    })

• 2 如果想对OnClickListener.onClick(View)之外的方法 (例如使用ButterKnife定义的点击方法) 加入快速点击过滤，可以使用@FastClickFilter

    @FastClickFilter
    @BindView(R.id.view)
    public void login() {
    }

3.@ThreadOn

将被标记的方法运行在指定的线程上。 有4种模式：
ThreadMode.MAIN : 主线程运行
ThreadMode.POSTING : 保持在被调用的线程运行
ThreadMode.BACKGROUD : 如果在工作线程被调用就保持在这个的线程，如果在主线程被调用就开一个工作线程运行
ThreadMode.ASYNC : 无论在哪个线程调用，都新开一个工作线程运行

    @ThreadOn(ThreadMode.MAIN)
    //@ThreadOn(ThreadMode.POSTING)
    //@ThreadOn(ThreadMode.BACKGROUD)
    //@ThreadOn(ThreadMode.ASYNC)
    public void f() {}

需要注意的一点：一旦使用到了线程，就会破坏方法的同步性变成异步的，对于有返回值的方法，就没有办法返回正确处理过的返回值了，所以使用了@ThreadOn的方法，不建议有返回。如果有返回值，会默认返回这个类型对应的默认值。

    //将会返回 0。
    @ThreadOn(ThreadMode.MAIN)
    public int f() {
        return 10
    }

如果想实现有返回值功能的方法，建议使用Callback形式拿到返回值, 这样@ThreadOn就不会影响到返回值了。

    @ThreadOn(ThreadMode.MAIN)
    public int f(Callback callback) {
        callback.onReturn(10);
    }

4.@CheckPermission

标记执行该方法需要哪些权限，并在运行时检查是否有这些权限。

    @CheckPermission({Manifest.permission.CAMERA, Manifest.permission.READ_CALENDAR})
    public int f() {
    }
    
    //可以在Application中配置权限被拒绝时的全局策略
    ZAOP.config()
                .setGlobalPermissionCallback(new ZAOP.GlobalPermissionCallback() {
                    @Override
                    public void onShouldShowRational(String permission) {
                        Log.d("checkSelfPermissions", "onShouldShowRational");
                    }

                    @Override
                    public void onPermissionReject(String permission) {
                        Log.d("checkSelfPermissions", "onPermissionReject");
                    }
                })

需要注意的一点：和@ThreadOn一样，不建议方法有返回值。如果有返回值，会默认返回这个类型对应的默认值。

5.StartActivityForResult

用于替代Activity.onActivityResult, 将startActivity和接受activity返回值的逻辑放在一起，更好的维持逻辑的清晰性。并且屏蔽了requestCode, 不用在写if else 的判断了。

    ZAOP.startActivityForResult(
                activity
                , new Intent(activity, Main2Activity.class)
                , new OnActResultBridge.ActivityResultCallback() {
                    @Override
                    public void onActivityResult(int resultCode, Intent data) {
                        Toast.makeText(MainActivity.this, "来自第2个Acitivity : " + resultCode + ", " + data.getStringExtra("Data"), Toast.LENGTH_LONG).show();
                    }
                });

使用这种方法需要保持Activity.OnActivityResult调用super.onActivityResult(),为了保证上面的方法一定起作用，默认对Activity子类的OnActivityResult做了代码织入。

6.requestPermissions

用于替代Activity.onRequestPermissionsResult, 将requestPermissions和接受返回值的逻辑放在一起，更好的维持逻辑的清晰性。并且屏蔽了requestCode, 不用在写if else 的判断了。

    ZAOP.requestPermissions(
                    context
                    , permissions
                    , new PermissionRequestBridge.PermissionResultCallback() {
                        @Override
                        public void onRequestPermissionsResult(
                                @NonNull String[] permissions
                                , @NonNull int[] grantResults) {
                        }
                    });

和ZAOP.startActivityForResult一样，默认对Activity.onRequestPermissionsResult进行了代码织入处理。

更多示例请见Demo，之后会继续更新更多的AOP方法。

7. License

 Copyright 2019 Mr_Joker (zsimplest@gmail.com)

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.