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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
/*
* 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.annotation.NonNull;
import android.annotation.Nullable;
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 java.util.Collection;
import java.util.HashMap;
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() {
this(null);
}
/**
* 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(Context context) {
super(context);
mProviders = new HashMap<>();
}
/**
* 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 the behavior from the parent class to completely ignore any
* content notifications sent to this object. This effectively hides clients
* from observers elsewhere in the system.
*/
@Override
public void notifyChange(@NonNull Uri uri, @Nullable ContentObserver observer) {
}
/**
* Overrides the behavior from the parent class to completely ignore any
* content notifications sent to this object. This effectively hides clients
* from observers elsewhere in the system.
*
* @deprecated callers should consider migrating to
* {@link #notifyChange(Uri, ContentObserver, int)}, as it
* offers support for many more options than just
* {@link #NOTIFY_SYNC_TO_NETWORK}.
*/
@Override
@Deprecated
public void notifyChange(@NonNull Uri uri, @Nullable ContentObserver observer,
boolean syncToNetwork) {
}
/**
* Overrides the behavior from the parent class to completely ignore any
* content notifications sent to this object. This effectively hides clients
* from observers elsewhere in the system.
*/
@Override
public void notifyChange(@NonNull Uri uri, @Nullable ContentObserver observer,
@NotifyFlags int flags) {
}
/**
* Overrides the behavior from the parent class to completely ignore any
* content notifications sent to this object. This effectively hides clients
* from observers elsewhere in the system.
*/
@Override
public void notifyChange(@NonNull Collection<Uri> uris, @Nullable ContentObserver observer,
@NotifyFlags int flags) {
}
}
|
