99 lines
2.7 KiB
C
99 lines
2.7 KiB
C
|
// 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_ACTIVITY_STATUS_H_
|
||
|
|
#define BASE_ANDROID_ACTIVITY_STATUS_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 activity state values like ACTIVITY_STATE_CREATED in a
|
||
|
|
// way that ensures they're always the same than their Java counterpart.
|
||
|
|
enum ActivityState {
|
||
|
|
#define DEFINE_ACTIVITY_STATE(x, y) ACTIVITY_STATE_##x = y,
|
||
|
|
#include "base/android/activity_state_list.h"
|
||
|
|
#undef DEFINE_ACTIVITY_STATE
|
||
|
|
};
|
||
|
|
|
||
|
|
// A native helper class to listen to state changes of the current
|
||
|
|
// Android Activity. This mirrors org.chromium.base.ActivityStatus.
|
||
|
|
// any thread.
|
||
|
|
//
|
||
|
|
// To start listening, create a new instance, passing a callback to a
|
||
|
|
// function that takes an ActivityState 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 OnActivityStateChange(ActivityState state) {
|
||
|
|
// ...
|
||
|
|
// }
|
||
|
|
//
|
||
|
|
// // Start listening.
|
||
|
|
// ActivityStatus::Listener* my_listener =
|
||
|
|
// new ActivityStatus::Listener(base::Bind(&OnActivityStateChange));
|
||
|
|
//
|
||
|
|
// ...
|
||
|
|
//
|
||
|
|
// // Stop listening.
|
||
|
|
// delete my_listener
|
||
|
|
//
|
||
|
|
class BASE_EXPORT ActivityStatus {
|
||
|
|
public:
|
||
|
|
typedef base::Callback<void(ActivityState)> StateChangeCallback;
|
||
|
|
|
||
|
|
class Listener {
|
||
|
|
public:
|
||
|
|
explicit Listener(const StateChangeCallback& callback);
|
||
|
|
~Listener();
|
||
|
|
|
||
|
|
private:
|
||
|
|
friend class ActivityStatus;
|
||
|
|
|
||
|
|
void Notify(ActivityState state);
|
||
|
|
|
||
|
|
StateChangeCallback callback_;
|
||
|
|
|
||
|
|
DISALLOW_COPY_AND_ASSIGN(Listener);
|
||
|
|
};
|
||
|
|
|
||
|
|
// NOTE: The Java ActivityStatus is a singleton too.
|
||
|
|
static ActivityStatus* GetInstance();
|
||
|
|
|
||
|
|
// 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.
|
||
|
|
void OnActivityStateChange(ActivityState new_state);
|
||
|
|
|
||
|
|
private:
|
||
|
|
friend struct DefaultSingletonTraits<ActivityStatus>;
|
||
|
|
|
||
|
|
ActivityStatus();
|
||
|
|
~ActivityStatus();
|
||
|
|
|
||
|
|
void RegisterListener(Listener* listener);
|
||
|
|
void UnregisterListener(Listener* listener);
|
||
|
|
|
||
|
|
scoped_refptr<ObserverListThreadSafe<Listener> > observers_;
|
||
|
|
|
||
|
|
DISALLOW_COPY_AND_ASSIGN(ActivityStatus);
|
||
|
|
};
|
||
|
|
|
||
|
|
} // namespace android
|
||
|
|
} // namespace base
|
||
|
|
|
||
|
|
#endif // BASE_ANDROID_ACTIVITY_STATUS_H_
|