Extension Library

Introduce dependent libraries

dependencies {
     //Optional 👇This package provides some common annotation aspects
     implementation 'io.github.FlyJingFish.AndroidAop:android-aop-extra:2.2.3'
}

This library has some built-in functional annotations for you to use directly.

Annotation name	Parameter description	Function description
@SingleClick	value = interval of quick clicks, default 1000ms	Click the annotation and add this annotation to make your method accessible only when clicked
@DoubleClick	value = maximum time between two clicks, default 300ms	Double-click annotation, add this annotation to make your method enterable only when double-clicked
@IOThread	ThreadType = thread type	Switch to the sub-thread operation. Adding this annotation can switch the code in your method to the sub-thread for execution
@MainThread	No parameters	The operation of switching to the main thread. Adding this annotation can switch the code in your method to the main thread for execution
@OnLifecycle*	value = Lifecycle.Event	Monitor life cycle operations. Adding this annotation allows the code in your method to be executed only during the corresponding life cycle
@TryCatch	value = a flag you customized	Adding this annotation can wrap a layer of try catch code for your method
@Permission*	value = String array of permissions	The operation of applying for permissions. Adding this annotation will enable your code to be executed only after obtaining permissions
@Scheduled	initialDelay = delayed start time interval = interval repeatCount = number of repetitions isOnMainThread = whether to be the main thread id = unique identifier	Scheduled tasks, add this annotation to make your method Executed every once in a while, call AndroidAop.shutdownNow(id) or AndroidAop.shutdown(id) to stop
@Delay	delay = delay time isOnMainThread = whether the main thread id = unique identifier	Delay task, add this annotation to delay the execution of your method for a period of time, call AndroidAop.shutdownNow(id) or AndroidAop .shutdown(id) can be canceled
@CheckNetwork	tag = custom tag toastText = toast prompt when there is no network invokeListener = whether to take over the check network logic	Check whether the network is available, adding this annotation will allow your method to enter only when there is a network
@CustomIntercept	value = a flag of a string array that you customized	Custom interception, used with AndroidAop.setOnCustomInterceptListener, is a panacea

( * Supports suspend functions, returns results when conditions are met, and supports suspend functions whose return type is not Unit type)

All examples of the above annotations are here,Also This

Let me emphasize this @OnLifecycle

• 1. The object to which the method added by @OnLifecycle must belong is a method directly or indirectly inherited from FragmentActivity or Fragment to be useful, or the object annotated method can also implement LifecycleOwner
• 1. If the first point is not met, you can set the first parameter of the aspect method to the type of point 1, and you can also pass it in when calling the aspect method, for example:

  public class StaticClass {
       @SingleClick(5000)
       @OnLifecycle(Lifecycle.Event.ON_RESUME)
       public static void onStaticPermission(MainActivity activity, int maxSelect, ThirdActivity.OnPhotoSelectListener back){
           back.onBack();
       }
  
  }
  

Let’s focus on @TryCatch @Permission @CustomIntercept @CheckNetwork

• @TryCatch Using this annotation you can set the following settings (not required)

  AndroidAop.INSTANCE.setOnThrowableListener(new OnThrowableListener() {
       @Nullable
       @Override
       public Object handleThrowable(@NonNull String flag, @Nullable Throwable throwable,TryCatch tryCatch) {
           // TODO: 2023/11/11 If an exception occurs, you can handle it accordingly according to the flag you passed in at the time. If you need to rewrite the return value, just return at return
           return 3;
       }
  });
  

• @Permission Use of this annotation must match the following settings (⚠️This step is required, otherwise it will have no effect)Perfect usage inspiration

  AndroidAop.INSTANCE.setOnPermissionsInterceptListener(new OnPermissionsInterceptListener() {
       @SuppressLint("CheckResult")
       @Override
       public void requestPermission(@NonNull ProceedJoinPoint joinPoint, @NonNull Permission permission, @NonNull OnRequestPermissionListener call) {
           Object target = joinPoint.getTarget();
           if (target instanceof FragmentActivity){
               RxPermissions rxPermissions = new RxPermissions((FragmentActivity) target);
               rxPermissions.request(permission.value()).subscribe(call::onCall);
           }else if (target instanceof Fragment){
               RxPermissions rxPermissions = new RxPermissions((Fragment) target);
               rxPermissions.request(permission.value()).subscribe(call::onCall);
           }else{
               // TODO: target is not FragmentActivity or Fragment, which means the method where the annotation is located is not among them. Please handle this situation yourself.
               // Suggestion: The first parameter of the pointcut method can be set to FragmentActivity or Fragment, and then joinPoint.args[0] can be obtained
           }
       }
  });
  

• @CustomIntercept To use this annotation you must match the following settings (⚠️This step is required, otherwise what’s the point?)

  AndroidAop.INSTANCE.setOnCustomInterceptListener(new OnCustomInterceptListener() {
      @Nullable
      @Override
      public Object invoke(@NonNull ProceedJoinPoint joinPoint, @NonNull CustomIntercept customIntercept) {
          // TODO: 2023/11/11 在此写你的逻辑 在合适的地方调用 joinPoint.proceed()，
          //  joinPoint.proceed(args)可以修改方法传入的参数，如果需要改写返回值，则在 return 处返回即可
  
          return null;
      }
  });
  

• @CheckNetwork Using this annotation you can match the following settings (not required)

  AndroidAop.INSTANCE.setOnCheckNetworkListener(new OnCheckNetworkListener() {
       @Nullable
       @Override
       public Object invoke(@NonNull ProceedJoinPoint joinPoint, @NonNull CheckNetwork checkNetwork, boolean availableNetwork) {
           return null;
       }
  });
  

  When using invokeListener, set it to true to enter the callback above.

  @CheckNetwork(invokeListener = true)
  fun toSecondActivity(){
       startActivity(Intent(this,SecondActivity::class.java))
  }
  

  In addition, the built-in Toast allows you to take over

  AndroidAop.INSTANCE.setOnToastListener(new OnToastListener() {
       @Override
       public void onToast(@NonNull Context context, @NonNull CharSequence text, int duration) {
  
       }
  });
  

👆The above three monitors are best placed in your application