public
static
class
Instrumentation.ActivityMonitor
extends Object
| java.lang.Object | |
| ↳ | android.app.Instrumentation.ActivityMonitor |
Information about a particular kind of Intent that is being monitored.
An instance of this class is added to the
current instrumentation through addMonitor(Instrumentation.ActivityMonitor); after being added,
when a new activity is being started the monitor will be checked and, if
matching, its hit count updated and (optionally) the call stopped and a
canned result returned.
An ActivityMonitor can also be used to look for the creation of an
activity, through the waitForActivity() method. This will return
after a matching activity has been created with that activity object.
Public constructors | |
|---|---|
Instrumentation.ActivityMonitor(IntentFilter which, Instrumentation.ActivityResult result, boolean block)
Create a new ActivityMonitor that looks for a particular kind of intent to be started. |
|
Instrumentation.ActivityMonitor(String cls, Instrumentation.ActivityResult result, boolean block)
Create a new ActivityMonitor that looks for a specific activity class to be started. |
|
Public methods | |
|---|---|
final
IntentFilter
|
getFilter()
Retrieve the filter associated with this ActivityMonitor. |
final
int
|
getHits()
Retrieve the number of times the monitor has been hit so far. |
final
Activity
|
getLastActivity()
Retrieve the most recent activity class that was seen by this monitor. |
final
Instrumentation.ActivityResult
|
getResult()
Retrieve the result associated with this ActivityMonitor, or null if none. |
final
boolean
|
isBlocking()
Check whether this monitor blocks activity starts (not allowing the actual activity to run) or allows them to execute normally. |
final
Activity
|
waitForActivity()
Block until an Activity is created that matches this monitor, returning the resulting activity. |
final
Activity
|
waitForActivityWithTimeout(long timeOut)
Block until an Activity is created that matches this monitor, returning the resulting activity or till the timeOut period expires. |
Inherited methods | |
|---|---|
 From
class
java.lang.Object
| |
Instrumentation.ActivityMonitor (IntentFilter which, Instrumentation.ActivityResult result, boolean block)
Create a new ActivityMonitor that looks for a particular kind of intent to be started.
| Parameters | |
|---|---|
which |
IntentFilter:
The set of intents this monitor is responsible for. |
result |
Instrumentation.ActivityResult:
A canned result to return if the monitor is hit; can
be null. |
block |
boolean:
Controls whether the monitor should block the activity
start (returning its canned result) or let the call
proceed. |
Instrumentation.ActivityMonitor (String cls, Instrumentation.ActivityResult result, boolean block)
Create a new ActivityMonitor that looks for a specific activity class to be started.
| Parameters | |
|---|---|
cls |
String:
The activity class this monitor is responsible for. |
result |
Instrumentation.ActivityResult:
A canned result to return if the monitor is hit; can
be null. |
block |
boolean:
Controls whether the monitor should block the activity
start (returning its canned result) or let the call
proceed. |
IntentFilter getFilter ()
Retrieve the filter associated with this ActivityMonitor.
| Returns | |
|---|---|
IntentFilter |
|
int getHits ()
Retrieve the number of times the monitor has been hit so far.
| Returns | |
|---|---|
int |
|
Activity getLastActivity ()
Retrieve the most recent activity class that was seen by this monitor.
| Returns | |
|---|---|
Activity |
|
Instrumentation.ActivityResult getResult ()
Retrieve the result associated with this ActivityMonitor, or null if none.
| Returns | |
|---|---|
Instrumentation.ActivityResult |
|
boolean isBlocking ()
Check whether this monitor blocks activity starts (not allowing the actual activity to run) or allows them to execute normally.
| Returns | |
|---|---|
boolean |
|
Activity waitForActivity ()
Block until an Activity is created that matches this monitor, returning the resulting activity.
| Returns | |
|---|---|
Activity |
Activity |
Activity waitForActivityWithTimeout (long timeOut)
Block until an Activity is created that matches this monitor, returning the resulting activity or till the timeOut period expires. If the timeOut expires before the activity is started, return null.
| Parameters | |
|---|---|
timeOut |
long:
Time to wait in milliseconds before the activity is created. |
| Returns | |
|---|---|
Activity |
Activity |
Developers