Android處理按鈕重複點擊

轉自https://www.jianshu.com/p/7b354eb8d0d3

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事件，那麼，有沒有一種方式，能夠在不改動原有邏輯的狀況下，又能很好地處理按鈕的重複點擊呢？

更爲優雅的處理方式

往同一類型的全部方法，都加上統一的處理邏輯，咱們很快就能想到一個詞：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中，添加：

// 注意：主App中請確保添加aspectjx
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註解的方法
     * 注意：這裏me.baron.test.annotation.SingleClick須要替換成
     * 你本身項目中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(2000)
        @SingleClick
        @Override
        public void onClick(View v) {
            // do something
        }
    });
}
複製代碼

只須要一個註解，即完成了按鈕的防止重複點擊，其餘全部工做交給編譯器，代碼清爽了不少有木有。