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

XBaron發表於2019-01-19
Android

版權宣告：本文已授權微信公眾號：Android必修課，轉載請申明出處

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中，新增：
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
        }
    });
}

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

學技能，漲知識，就來微信公眾號：Android必修課

相關文章