blob: 679ad406c7335b96d393371b2acb58e6c0a94b9a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
/*
* Copyright (C) 2006 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.test;
/**
* More complex interface performance for test cases.
*
* If you want your test to be used as a performance test, you must
* implement this interface.
*/
public interface PerformanceTestCase
{
/**
* Callbacks for {@link PerformanceTestCase}.
*/
public interface Intermediates
{
void setInternalIterations(int count);
void startTiming(boolean realTime);
void addIntermediate(String name);
void addIntermediate(String name, long timeInNS);
void finishTiming(boolean realTime);
}
/**
* Set up to begin performance tests. The 'intermediates' is a
* communication channel to send back intermediate performance numbers --
* if you use it, you will probably want to ensure your test is only
* executed once by returning 1. Otherwise, return 0 to allow the test
* harness to decide the number of iterations.
*
* <p>If you return a non-zero iteration count, you should call
* {@link Intermediates#startTiming intermediates.startTiming} and
* {@link Intermediates#finishTiming intermediates.endTiming} to report the
* duration of the test whose performance should actually be measured.
*
* @param intermediates Callback for sending intermediate results.
*
* @return int Maximum number of iterations to run, or 0 to let the caller
* decide.
*/
int startPerformance(Intermediates intermediates);
/**
* This method is used to determine what modes this test case can run in.
*
* @return true if this test case can only be run in performance mode.
*/
boolean isPerformanceOnly();
}
|
