| Index: base/android/application_status_listener.h
|
| diff --git a/base/android/application_status_listener.h b/base/android/application_status_listener.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..9107394f2e868a1aa0945cee83699f74a67c829e
|
| --- /dev/null
|
| +++ b/base/android/application_status_listener.h
|
| @@ -0,0 +1,79 @@
|
| +// Copyright 2013 The Chromium Authors. All rights reserved.
|
| +// Use of this source code is governed by a BSD-style license that can be
|
| +// found in the LICENSE file.
|
| +
|
| +#ifndef BASE_ANDROID_APPLICATION_STATUS_LISTENER_H_
|
| +#define BASE_ANDROID_APPLICATION_STATUS_LISTENER_H_
|
| +
|
| +#include <jni.h>
|
| +
|
| +#include "base/android/jni_android.h"
|
| +#include "base/base_export.h"
|
| +#include "base/basictypes.h"
|
| +#include "base/memory/ref_counted.h"
|
| +#include "base/memory/singleton.h"
|
| +#include "base/observer_list_threadsafe.h"
|
| +
|
| +namespace base {
|
| +namespace android {
|
| +
|
| +// Define application state values like APPLICATION_STATE_VISIBLE in a
|
| +// way that ensures they're always the same than their Java counterpart.
|
| +enum ApplicationState {
|
| +#define DEFINE_APPLICATION_STATE(x, y) APPLICATION_STATE_##x = y,
|
| +#include "base/android/application_state_list.h"
|
| +#undef DEFINE_APPLICATION_STATE
|
| +};
|
| +
|
| +// A native helper class to listen to state changes of the Android
|
| +// Application. This mirrors org.chromium.base.ApplicationStatus.
|
| +// any thread.
|
| +//
|
| +// To start listening, create a new instance, passing a callback to a
|
| +// function that takes an ApplicationState parameter. To stop listening,
|
| +// simply delete the listener object. The implementation guarantees
|
| +// that the callback will always be called on the thread that created
|
| +// the listener.
|
| +//
|
| +// Example:
|
| +//
|
| +// void OnApplicationStateChange(ApplicationState state) {
|
| +// ...
|
| +// }
|
| +//
|
| +// // Start listening.
|
| +// ApplicationStatusListener* my_listener =
|
| +// new ApplicationStatusListener(
|
| +// base::Bind(&OnApplicationStateChange));
|
| +//
|
| +// ...
|
| +//
|
| +// // Stop listening.
|
| +// delete my_listener
|
| +//
|
| +class BASE_EXPORT ApplicationStatusListener {
|
| + public:
|
| + typedef base::Callback<void(ApplicationState)> ApplicationStateChangeCallback;
|
| +
|
| + explicit ApplicationStatusListener(
|
| + const ApplicationStateChangeCallback& callback);
|
| + ~ApplicationStatusListener();
|
| +
|
| + // Internal use: must be public to be called from base_jni_registrar.cc
|
| + static bool RegisterBindings(JNIEnv* env);
|
| +
|
| + // Internal use only: must be public to be called from JNI and unit tests.
|
| + static void NotifyApplicationStateChange(ApplicationState state);
|
| +
|
| + private:
|
| + void Notify(ApplicationState state);
|
| +
|
| + ApplicationStateChangeCallback callback_;
|
| +
|
| + DISALLOW_COPY_AND_ASSIGN(ApplicationStatusListener);
|
| +};
|
| +
|
| +} // namespace android
|
| +} // namespace base
|
| +
|
| +#endif // BASE_ANDROID_APPLICATION_STATUS_LISTENER_H_
|
|
|