1 /*
2  * Copyright (C) 2010 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License
15  */
16 package com.android.contacts;
17 
18 import android.content.Context;
19 import android.content.CursorLoader;
20 import android.net.Uri;
21 import android.provider.ContactsContract.Groups;
22 
23 import com.android.contacts.group.GroupUtil;
24 
25 /**
26  * Group meta-data loader. Loads all groups or just a single group from the
27  * database (if given a {@link Uri}).
28  */
29 public final class GroupMetaDataLoader extends CursorLoader {
30 
31     public final static String[] COLUMNS = new String[] {
32         Groups.ACCOUNT_NAME,
33         Groups.ACCOUNT_TYPE,
34         Groups.DATA_SET,
35         Groups._ID,
36         Groups.TITLE,
37         Groups.AUTO_ADD,
38         Groups.FAVORITES,
39         Groups.GROUP_IS_READ_ONLY,
40         Groups.DELETED,
41     };
42 
43     public final static int ACCOUNT_NAME = 0;
44     public final static int ACCOUNT_TYPE = 1;
45     public final static int DATA_SET = 2;
46     public final static int GROUP_ID = 3;
47     public final static int TITLE = 4;
48     public final static int AUTO_ADD = 5;
49     public final static int FAVORITES = 6;
50     public final static int IS_READ_ONLY = 7;
51     public final static int DELETED = 8;
52 
GroupMetaDataLoader(Context context, Uri groupUri)53     public GroupMetaDataLoader(Context context, Uri groupUri) {
54         super(context, ensureIsGroupUri(groupUri), COLUMNS, GroupUtil.DEFAULT_SELECTION, null,
55                 GroupUtil.getGroupsSortOrder());
56     }
57 
GroupMetaDataLoader(Context context, Uri groupUri, String selection)58     public GroupMetaDataLoader(Context context, Uri groupUri, String selection) {
59         super(context, ensureIsGroupUri(groupUri), COLUMNS, selection, null,
60                 GroupUtil.getGroupsSortOrder());
61     }
62 
63     /**
64      * Ensures that this is a valid group URI. If invalid, then an exception is
65      * thrown. Otherwise, the original URI is returned.
66      */
ensureIsGroupUri(final Uri groupUri)67     private static Uri ensureIsGroupUri(final Uri groupUri) {
68         // TODO: Fix ContactsProvider2 getType method to resolve the group Uris
69         if (groupUri == null) {
70             throw new IllegalArgumentException("Uri must not be null");
71         }
72         if (!GroupUtil.isGroupUri(groupUri)) {
73             throw new IllegalArgumentException("Invalid group Uri: " + groupUri);
74         }
75         return groupUri;
76     }
77 }
78