From 5f8de423f190bbb79a62f804151bc24824fa32d8 Mon Sep 17 00:00:00 2001 From: "Matt A. Tobin" Date: Fri, 2 Feb 2018 04:16:08 -0500 Subject: Add m-esr52 at 52.6.0 --- widget/nsIdleService.h | 225 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 225 insertions(+) create mode 100644 widget/nsIdleService.h (limited to 'widget/nsIdleService.h') diff --git a/widget/nsIdleService.h b/widget/nsIdleService.h new file mode 100644 index 000000000..17046201d --- /dev/null +++ b/widget/nsIdleService.h @@ -0,0 +1,225 @@ +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* vim:expandtab:shiftwidth=2:tabstop=2: + */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +#ifndef nsIdleService_h__ +#define nsIdleService_h__ + +#include "nsIIdleServiceInternal.h" +#include "nsCOMPtr.h" +#include "nsITimer.h" +#include "nsTArray.h" +#include "nsIObserver.h" +#include "nsIIdleService.h" +#include "nsCategoryCache.h" +#include "nsWeakReference.h" +#include "mozilla/TimeStamp.h" + +/** + * Class we can use to store an observer with its associated idle time + * requirement and whether or not the observer thinks it's "idle". + */ +class IdleListener { +public: + nsCOMPtr observer; + uint32_t reqIdleTime; + bool isIdle; + + IdleListener(nsIObserver* obs, uint32_t reqIT, bool aIsIdle = false) : + observer(obs), reqIdleTime(reqIT), isIdle(aIsIdle) {} + ~IdleListener() {} +}; + +// This one will be declared later. +class nsIdleService; + +/** + * Class to handle the daily idle timer. + */ +class nsIdleServiceDaily : public nsIObserver, + public nsSupportsWeakReference +{ +public: + NS_DECL_ISUPPORTS + NS_DECL_NSIOBSERVER + + explicit nsIdleServiceDaily(nsIIdleService* aIdleService); + + /** + * Initializes the daily idle observer. + * Keep this separated from the constructor, since it could cause pointer + * corruption due to AddRef/Release of "this". + */ + void Init(); + +private: + virtual ~nsIdleServiceDaily(); + + /** + * StageIdleDaily is the interim call made when an idle-daily event is due. + * However we don't want to fire idle-daily until the user is idle for this + * session, so this sets up a short wait for an idle event which triggers + * the actual idle-daily event. + * + * @param aHasBeenLongWait Pass true indicating nsIdleServiceDaily is having + * trouble getting the idle-daily event fired. If true StageIdleDaily will + * use a shorter idle wait time before firing idle-daily. + */ + void StageIdleDaily(bool aHasBeenLongWait); + + /** + * @note This is a normal pointer, part to avoid creating a cycle with the + * idle service, part to avoid potential pointer corruption due to this class + * being instantiated in the constructor of the service itself. + */ + nsIIdleService* mIdleService; + + /** + * Place to hold the timer used by this class to determine when a day has + * passed, after that it will wait for idle time to be detected. + */ + nsCOMPtr mTimer; + + /** + * Function that is called back once a day. + */ + static void DailyCallback(nsITimer* aTimer, void* aClosure); + + /** + * Cache of observers for the "idle-daily" category. + */ + nsCategoryCache mCategoryObservers; + + /** + * Boolean set to true when daily idle notifications should be disabled. + */ + bool mShutdownInProgress; + + /** + * Next time we expect an idle-daily timer to fire, in case timers aren't + * very reliable on the platform. Value is in PR_Now microsecond units. + */ + PRTime mExpectedTriggerTime; + + /** + * Tracks which idle daily observer callback we ask for. There are two: a + * regular long idle wait and a shorter wait if we've been waiting to fire + * idle daily for an extended period. Set by StageIdleDaily. + */ + int32_t mIdleDailyTriggerWait; +}; + +class nsIdleService : public nsIIdleServiceInternal +{ +public: + NS_DECL_ISUPPORTS + NS_DECL_NSIIDLESERVICE + NS_DECL_NSIIDLESERVICEINTERNAL + +protected: + static already_AddRefed GetInstance(); + + nsIdleService(); + virtual ~nsIdleService(); + + /** + * If there is a platform specific function to poll the system idel time + * then that must be returned in this function, and the function MUST return + * true, otherwise then the function should be left unimplemented or made + * to return false (this can also be used for systems where it depends on + * the configuration of the system if the idle time can be determined) + * + * @param aIdleTime + * The idle time in ms. + * + * @return true if the idle time could be polled, false otherwise. + * + * @note The time returned by this function can be different than the one + * returned by GetIdleTime, as that is corrected by any calls to + * ResetIdleTimeOut(), unless you overwrite that function too... + */ + virtual bool PollIdleTime(uint32_t* aIdleTime); + + /** + * Function that determines if we are in poll mode or not. + * + * @return true if polling is supported, false otherwise. + */ + virtual bool UsePollMode(); + +private: + /** + * Ensure that the timer is expiring at least at the given time + * + * The function might not restart the timer if there is one running currently + * + * @param aNextTimeout + * The last absolute time the timer should expire + */ + void SetTimerExpiryIfBefore(mozilla::TimeStamp aNextTimeout); + + /** + * Stores the next timeout time, 0 means timer not running + */ + mozilla::TimeStamp mCurrentlySetToTimeoutAt; + + /** + * mTimer holds the internal timer used by this class to detect when to poll + * for idle time, when to check if idle timers should expire etc. + */ + nsCOMPtr mTimer; + + /** + * Array of listeners that wants to be notified about idle time. + */ + nsTArray mArrayListeners; + + /** + * Object keeping track of the daily idle thingy. + */ + RefPtr mDailyIdle; + + /** + * Number of observers currently in idle mode. + */ + uint32_t mIdleObserverCount; + + /** + * Delta time from last non idle time to when the next observer should switch + * to idle mode + * + * Time in seconds + * + * If this value is 0 it means there are no active observers + */ + uint32_t mDeltaToNextIdleSwitchInS; + + /** + * Absolute value for when the last user interaction took place. + */ + mozilla::TimeStamp mLastUserInteraction; + + + /** + * Function that ensures the timer is running with at least the minimum time + * needed. It will kill the timer if there are no active observers. + */ + void ReconfigureTimer(void); + + /** + * Callback function that is called when the internal timer expires. + * + * This in turn calls the IdleTimerCallback that does the real processing + */ + static void StaticIdleTimerCallback(nsITimer* aTimer, void* aClosure); + + /** + * Function that handles when a timer has expired + */ + void IdleTimerCallback(void); +}; + +#endif // nsIdleService_h__ -- cgit v1.2.3