Android優雅地處理按鈕重複點選

XBaron發表於2019-01-19

App中,有很大一部分場景是點選按鈕,向服務端提交資料,由於網路請求需要時間,使用者很可能會多次點選,造成資料重複提交,造成各種莫名其妙的問題。

因此,防止按鈕多次點選,是Android開發中一個很重要的技術手段。

以前的處理方式

網上查詢到的,或者你可能會想到的方法大概有這些:

1.每個按鈕點選事件中,記錄點選時間,判斷是否超過點選時間間隔

private long mLastClickTime = 0;
public static final long TIME_INTERVAL = 1000L;
private Button btTest;
private void initView() {
    btTest = findViewById(R.id.bt_test);
    btTest.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            long nowTime = System.currentTimeMillis();
            if (nowTime - mLastClickTime > TIME_INTERVAL) {
                // do something
                mLastClickTime = nowTime;
            } else {
                Toast.makeText(MainActivity.this, "不要重複點選", Toast.LENGTH_SHORT).show();
            }
        }
    });
}
複製程式碼

這種方式,每個點選事件都需要寫一個時間判斷,重複程式碼很多。

2.封裝一個點選事件,處理點選間隔判斷

public abstract class CustomClickListener implements View.OnClickListener {
    private long mLastClickTime;
    private long timeInterval = 1000L;

    public CustomClickListener() {

    }

    public CustomClickListener(long interval) {
        this.timeInterval = interval;
    }

    @Override
    public void onClick(View v) {
        long nowTime = System.currentTimeMillis();
        if (nowTime - mLastClickTime > timeInterval) {
            // 單次點選事件
            onSingleClick();
            mLastClickTime = nowTime;
        } else {
            // 快速點選事件
            onFastClick();
        }
    }

    protected abstract void onSingleClick();
    protected abstract void onFastClick();
}
複製程式碼

使用:

btTest.setOnClickListener(new CustomClickListener() {
    @Override
    protected void onSingleClick() {
        Log.d("xxx", "onSingleClick");
    }

    @Override
    protected void onFastClick() {
        Log.d("xxx", "onFastClick");
    }
});
複製程式碼

相比於第一種方式,這種方法將重複點選的判斷封裝在CustomClickListener內部,外部無需處理時間判斷,只需要實現點選方法即可。

3.利用RxAndroid處理重複點選

RxView.clicks(view)
    .throttleFirst(1, TimeUnit.SECONDS)
    .subscribe(new Consumer<Object>() {
        @Override
        public void accept(Object o) throws Exception {
            // do something
        }
     });
複製程式碼

響應式地處理按鈕點選,利用rxjava的操作符,來防止重複點選,相較於第1,2方案來說,此方法更為優雅一些。

思考一下:

這三種方法,不論哪一種,都對原有點選事件有很大的侵入性,要麼你需要往Click事件中加方法,要麼你需要替換整個Click事件,那麼,有沒有一種方式,可以在不改動原有邏輯的情況下,又能很好地處理按鈕的重複點選呢?

Android優雅地處理按鈕重複點選

更為優雅的處理方式

往同一型別的所有方法,都加上統一的處理邏輯,我們很快就能想到一個詞:AOP,沒錯,面向切面程式設計

如何使用AOP來解決重複點選問題?

1.引入Aspectj

Android 上使用AOP程式設計,一般使用Aspectj這個庫

站在巨人的肩膀上,滬江已經開源了Aspectj的Gradle外掛,方便我們使用Aspectj

  • 在專案根目錄下的build.gradle中,新增依賴:
dependencies {
     ......
     classpath 'com.hujiang.aspectjx:gradle-android-plugin-aspectjx:2.0.0'
}
複製程式碼
  • 在app或其他module目錄下的build.gradle中,新增:
apply plugin: 'android-aspectjx'
dependencies {
    ......
    implementation 'org.aspectj:aspectjrt:1.8.9'
}
複製程式碼

2.新增一個自定義註解

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface SingleClick {
    /* 點選間隔時間 */
    long value() default 1000;
}
複製程式碼

新增自定義註解的原因是,方便管理哪些方法使用了重複點選的AOP,同時可以在註解中傳入點選時間間隔,更加靈活。

3.封裝一個重複點選判斷工具類

public final class XClickUtil {

    /**
     * 最近一次點選的時間
     */
    private static long mLastClickTime;
    /**
     * 最近一次點選的控制元件ID
     */
    private static int mLastClickViewId;

    /**
     * 是否是快速點選
     *
     * @param v  點選的控制元件
     * @param intervalMillis  時間間期(毫秒)
     * @return  true:是,false:不是
     */
    public static boolean isFastDoubleClick(View v, long intervalMillis) {
        int viewId = v.getId();
        long time = System.currentTimeMillis();
        long timeInterval = Math.abs(time - mLastClickTime);
        if (timeInterval < intervalMillis && viewId == mLastClickViewId) {
            return true;
        } else {
            mLastClickTime = time;
            mLastClickViewId = viewId;
            return false;
        }
    }
}
複製程式碼

4.編寫Aspect AOP處理類

@Aspect
public class SingleClickAspect {
    private static final long DEFAULT_TIME_INTERVAL = 5000;

    /** 
     * 定義切點,標記切點為所有被@SingleClick註解的方法
     */
    @Pointcut("execution(@me.baron.test.annotation.SingleClick * *(..))")
    public void methodAnnotated() {}

    /** 
     * 定義一個切面方法,包裹切點方法
     */
    @Around("methodAnnotated()")
    public void aroundJoinPoint(ProceedingJoinPoint joinPoint) throws Throwable {
        // 取出方法的引數
        View view = null;
        for (Object arg : joinPoint.getArgs()) {
            if (arg instanceof View) {
                view = (View) arg;
                break;
            }
        }
        if (view == null) {
            return;
        }
        // 取出方法的註解
        MethodSignature methodSignature = (MethodSignature) joinPoint.getSignature();
        Method method = methodSignature.getMethod();
        if (!method.isAnnotationPresent(SingleClick.class)) {
            return;
        }
        SingleClick singleClick = method.getAnnotation(SingleClick.class);
        // 判斷是否快速點選
        if (!XClickUtil.isFastDoubleClick(view, singleClick.value())) {
            // 不是快速點選,執行原方法
            joinPoint.proceed();
        }
    }
}
複製程式碼

使用方法

private void initView() {
    btTest = findViewById(R.id.bt_test);
    btTest.setOnClickListener(new View.OnClickListener() {
        @SingleClick
        @Override
        public void onClick(View v) {
            // do something
        }
    });
}
複製程式碼

只需要一個註解,即完成了按鈕的防止重複點選,其他所有工作交給編譯器,程式碼清爽了很多有木有。

Android優雅地處理按鈕重複點選

想必大家對於AOP一定產生了興趣,關於AOP的更多用法,請關注微信公眾號:Android必修課

後面會出一個Android AOP的專題,讓大家更好地學習和使用AOP

Android優雅地處理按鈕重複點選

相關文章