Android
android.app
public static class

android.app.Instrumentation.ActivityMonitor

java.lang.Object
android.app.Instrumentation.ActivityMonitor

Information about a particular kind of Intent that is being monitored in execStartActivity(Context, IApplicationThread, IBinder, Activity, Intent, int). 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.

Summary

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.
Methods inherited from class java.lang.Object

Details

Public Constructors

public 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 The set of intents this monitor is responsible for.
result A canned result to return if the monitor is hit; can be null.
block Controls whether the monitor should block the activity start (returning its canned result) or let the call proceed.

public 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 The activity class this monitor is responsible for.
result A canned result to return if the monitor is hit; can be null.
block Controls whether the monitor should block the activity start (returning its canned result) or let the call proceed.

Public Methods

public final IntentFilter getFilter()

Retrieve the filter associated with this ActivityMonitor.

public final int getHits()

Retrieve the number of times the monitor has been hit so far.

public final Activity getLastActivity()

Retrieve the most recent activity class that was seen by this monitor.

public final Instrumentation.ActivityResult getResult()

Retrieve the result associated with this ActivityMonitor, or null if none.

public final boolean isBlocking()

Check whether this monitor blocks activity starts (not allowing the actual activity to run) or allows them to execute normally.

public final Activity waitForActivity()

Block until an Activity is created that matches this monitor, returning the resulting activity.

Returns

  • Activity

public 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. If the timeOut expires before the activity is started, return null.

Parameters

timeOut Time to wait before the activity is created.

Returns

  • Activity
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:48