1 /* 2 * Copyright (C) 2010 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.launcher3; 18 19 import android.os.Handler; 20 import android.os.SystemClock; 21 22 public class Alarm implements Runnable{ 23 // if we reach this time and the alarm hasn't been cancelled, call the listener 24 private long mAlarmTriggerTime; 25 26 // if we've scheduled a call to run() (ie called mHandler.postDelayed), this variable is true. 27 // We use this to avoid having multiple pending callbacks 28 private boolean mWaitingForCallback; 29 30 private Handler mHandler; 31 private OnAlarmListener mAlarmListener; 32 private boolean mAlarmPending = false; 33 private long mLastSetTimeout; 34 Alarm()35 public Alarm() { 36 mHandler = new Handler(); 37 } 38 setOnAlarmListener(OnAlarmListener alarmListener)39 public void setOnAlarmListener(OnAlarmListener alarmListener) { 40 mAlarmListener = alarmListener; 41 } 42 43 // Sets the alarm to go off in a certain number of milliseconds. If the alarm is already set, 44 // it's overwritten and only the new alarm setting is used setAlarm(long millisecondsInFuture)45 public void setAlarm(long millisecondsInFuture) { 46 long currentTime = SystemClock.uptimeMillis(); 47 mAlarmPending = true; 48 long oldTriggerTime = mAlarmTriggerTime; 49 mAlarmTriggerTime = currentTime + millisecondsInFuture; 50 mLastSetTimeout = millisecondsInFuture; 51 52 // If the previous alarm was set for a longer duration, cancel it. 53 if (mWaitingForCallback && oldTriggerTime > mAlarmTriggerTime) { 54 mHandler.removeCallbacks(this); 55 mWaitingForCallback = false; 56 } 57 if (!mWaitingForCallback) { 58 mHandler.postDelayed(this, mAlarmTriggerTime - currentTime); 59 mWaitingForCallback = true; 60 } 61 } 62 cancelAlarm()63 public void cancelAlarm() { 64 mAlarmPending = false; 65 } 66 67 // this is called when our timer runs out run()68 public void run() { 69 mWaitingForCallback = false; 70 if (mAlarmPending) { 71 long currentTime = SystemClock.uptimeMillis(); 72 if (mAlarmTriggerTime > currentTime) { 73 // We still need to wait some time to trigger spring loaded mode-- 74 // post a new callback 75 mHandler.postDelayed(this, Math.max(0, mAlarmTriggerTime - currentTime)); 76 mWaitingForCallback = true; 77 } else { 78 mAlarmPending = false; 79 if (mAlarmListener != null) { 80 mAlarmListener.onAlarm(this); 81 } 82 } 83 } 84 } 85 alarmPending()86 public boolean alarmPending() { 87 return mAlarmPending; 88 } 89 90 /** Returns the last value passed to {@link #setAlarm(long)} */ getLastSetTimeout()91 public long getLastSetTimeout() { 92 return mLastSetTimeout; 93 } 94 } 95