19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.content.pm; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcelable; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.PatternMatcher; 2285f5f8132015d8a5043ea4413702420d0d157c9fJeff Sharkeyimport android.util.Printer; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Holds information about a specific 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.ContentProvider content provider}. This is returned by 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.pm.PackageManager#resolveContentProvider(java.lang.String, int) 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PackageManager.resolveContentProvider()}. 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class ProviderInfo extends ComponentInfo 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project implements Parcelable { 322af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The name provider is published under content:// */ 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String authority = null; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Optional permission required for read-only access this content 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * provider. */ 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String readPermission = null; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Optional permission required for read/write access this content 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * provider. */ 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String writePermission = null; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** If true, additional permissions to specific Uris in this content 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * provider can be granted, as per the 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.R.styleable#AndroidManifestProvider_grantUriPermissions 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * grantUriPermissions} attribute. 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean grantUriPermissions = false; 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If non-null, these are the patterns that are allowed for granting URI 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * permissions. Any URI that does not match one of these patterns will not 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * allowed to be granted. If null, all URIs are allowed. The 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link PackageManager#GET_URI_PERMISSION_PATTERNS 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * PackageManager.GET_URI_PERMISSION_PATTERNS} flag must be specified for 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this field to be filled in. 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PatternMatcher[] uriPermissionPatterns = null; 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 612af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn /** 622af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn * If non-null, these are path-specific permissions that are allowed for 632af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn * accessing the provider. Any permissions listed here will allow a 642af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn * holding client to access the provider, and the provider will check 652af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn * the URI it provides when making calls against the patterns here. 662af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn */ 672af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn public PathPermission[] pathPermissions = null; 682af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** If true, this content provider allows multiple instances of itself 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to run in different process. If false, a single instances is always 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * run in {@link #processName}. */ 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean multiprocess = false; 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Used to control initialization order of single-process providers 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * running in the same process. Higher goes first. */ 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int initOrder = 0; 777d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn 787d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn /** 797d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn * Bit in {@link #flags}: If set, a single instance of the provider will 807d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn * run for all users on the device. Set from the 817d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn * {@link android.R.attr#singleUser} attribute. 827d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn */ 837d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn public static final int FLAG_SINGLE_USER = 0x40000000; 847d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn 857d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn /** 867d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn * Options that have been set in the provider declaration in the 877d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn * manifest. 887d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn * These include: {@link #FLAG_SINGLE_USER}. 897d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn */ 907d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn public int flags = 0; 917d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn 92718d8a2d7ff3e864a73879eb646f46c14ab74d07Fred Quintana /** 93718d8a2d7ff3e864a73879eb646f46c14ab74d07Fred Quintana * Whether or not this provider is syncable. 94718d8a2d7ff3e864a73879eb646f46c14ab74d07Fred Quintana * @deprecated This flag is now being ignored. The current way to make a provider 95718d8a2d7ff3e864a73879eb646f46c14ab74d07Fred Quintana * syncable is to provide a SyncAdapter service for a given provider/account type. 96718d8a2d7ff3e864a73879eb646f46c14ab74d07Fred Quintana */ 974a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn @Deprecated 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isSyncable = false; 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ProviderInfo() { 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ProviderInfo(ProviderInfo orig) { 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(orig); 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project authority = orig.authority; 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project readPermission = orig.readPermission; 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writePermission = orig.writePermission; 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project grantUriPermissions = orig.grantUriPermissions; 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project uriPermissionPatterns = orig.uriPermissionPatterns; 1102af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn pathPermissions = orig.pathPermissions; 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project multiprocess = orig.multiprocess; 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project initOrder = orig.initOrder; 1137d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn flags = orig.flags; 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project isSyncable = orig.isSyncable; 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11685f5f8132015d8a5043ea4413702420d0d157c9fJeff Sharkey 11785f5f8132015d8a5043ea4413702420d0d157c9fJeff Sharkey public void dump(Printer pw, String prefix) { 11885f5f8132015d8a5043ea4413702420d0d157c9fJeff Sharkey super.dumpFront(pw, prefix); 11985f5f8132015d8a5043ea4413702420d0d157c9fJeff Sharkey pw.println(prefix + "authority=" + authority); 12085f5f8132015d8a5043ea4413702420d0d157c9fJeff Sharkey pw.println(prefix + "flags=0x" + Integer.toHexString(flags)); 12185f5f8132015d8a5043ea4413702420d0d157c9fJeff Sharkey } 12285f5f8132015d8a5043ea4413702420d0d157c9fJeff Sharkey 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override public void writeToParcel(Parcel out, int parcelableFlags) { 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.writeToParcel(out, parcelableFlags); 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeString(authority); 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeString(readPermission); 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeString(writePermission); 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeInt(grantUriPermissions ? 1 : 0); 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeTypedArray(uriPermissionPatterns, parcelableFlags); 1342af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn out.writeTypedArray(pathPermissions, parcelableFlags); 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeInt(multiprocess ? 1 : 0); 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeInt(initOrder); 1377d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn out.writeInt(flags); 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project out.writeInt(isSyncable ? 1 : 0); 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<ProviderInfo> CREATOR 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<ProviderInfo>() { 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ProviderInfo createFromParcel(Parcel in) { 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new ProviderInfo(in); 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ProviderInfo[] newArray(int size) { 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new ProviderInfo[size]; 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 1537d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn return "ContentProviderInfo{name=" + authority + " className=" + name + "}"; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private ProviderInfo(Parcel in) { 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(in); 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project authority = in.readString(); 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project readPermission = in.readString(); 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writePermission = in.readString(); 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project grantUriPermissions = in.readInt() != 0; 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project uriPermissionPatterns = in.createTypedArray(PatternMatcher.CREATOR); 1632af632f87d487deaa5b2eb71341cfc4f0c0d1173Dianne Hackborn pathPermissions = in.createTypedArray(PathPermission.CREATOR); 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project multiprocess = in.readInt() != 0; 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project initOrder = in.readInt(); 1667d19e0242faac8017033dabb872cdf1542fa184cDianne Hackborn flags = in.readInt(); 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project isSyncable = in.readInt() != 0; 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 170