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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
/*
* Copyright (C) 2008 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.mock;
import android.content.ContentProvider;
import android.content.ContentResolver;
import android.content.Context;
import android.content.IContentProvider;
import android.database.ContentObserver;
import android.net.Uri;
import com.google.android.collect.Maps;
import java.util.Map;
/**
* <p>
* An extension of {@link android.content.ContentResolver} that is designed for
* testing.
* </p>
* <p>
* MockContentResolver overrides Android's normal way of resolving providers by
* authority. To have access to a provider based on its authority, users of
* MockContentResolver first instantiate the provider and
* use {@link MockContentResolver#addProvider(String, ContentProvider)}. Resolution of an
* authority occurs entirely within MockContentResolver.
* </p>
* <p>
* Users can also set an authority's entry in the map to null, so that a provider is completely
* mocked out.
* </p>
*
* <div class="special reference">
* <h3>Developer Guides</h3>
* <p>For more information about application testing, read the
* <a href="{@docRoot}guide/topics/testing/index.html">Testing</a> developer guide.</p>
* </div>
*/
public class MockContentResolver extends ContentResolver {
Map<String, ContentProvider> mProviders;
/*
* Creates a local map of providers. This map is used instead of the global map when an
* API call tries to acquire a provider.
*/
public MockContentResolver() {
super(null);
mProviders = Maps.newHashMap();
}
/**
* Adds access to a provider based on its authority
*
* @param name The authority name associated with the provider.
* @param provider An instance of {@link android.content.ContentProvider} or one of its
* subclasses, or null.
*/
public void addProvider(String name, ContentProvider provider) {
/*
* Maps the authority to the provider locally.
*/
mProviders.put(name, provider);
}
/** @hide */
@Override
protected IContentProvider acquireProvider(Context context, String name) {
return acquireExistingProvider(context, name);
}
/** @hide */
@Override
protected IContentProvider acquireExistingProvider(Context context, String name) {
/*
* Gets the content provider from the local map
*/
final ContentProvider provider = mProviders.get(name);
if (provider != null) {
return provider.getIContentProvider();
} else {
return null;
}
}
/** @hide */
@Override
public boolean releaseProvider(IContentProvider provider) {
return true;
}
/** @hide */
@Override
protected IContentProvider acquireUnstableProvider(Context c, String name) {
return acquireProvider(c, name);
}
/** @hide */
@Override
public boolean releaseUnstableProvider(IContentProvider icp) {
return releaseProvider(icp);
}
/** @hide */
@Override
public void unstableProviderDied(IContentProvider icp) {
}
/**
* Overrides {@link android.content.ContentResolver#notifyChange(Uri, ContentObserver, boolean)
* ContentResolver.notifChange(Uri, ContentObserver, boolean)}. All parameters are ignored.
* The method hides providers linked to MockContentResolver from other observers in the system.
*
* @param uri (Ignored) The uri of the content provider.
* @param observer (Ignored) The observer that originated the change.
* @param syncToNetwork (Ignored) If true, attempt to sync the change to the network.
*/
@Override
public void notifyChange(Uri uri,
ContentObserver observer,
boolean syncToNetwork) {
}
}
|
