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
|
/***************************************************************************************************
* Copyright © All Contributors. See LICENSE and AUTHORS in the root directory for details.
**************************************************************************************************/
package at.bitfire.ical4android
import android.accounts.Account
import android.annotation.SuppressLint
import android.content.ContentProviderClient
import android.content.Context
import android.content.pm.PackageManager
import android.net.Uri
import androidx.core.content.pm.PackageInfoCompat
import at.bitfire.ical4android.MiscUtils.ContentProviderClientHelper.closeCompat
import org.dmfs.tasks.contract.TaskContract
import java.io.Closeable
import java.util.logging.Level
class TaskProvider private constructor(
val name: ProviderName,
val client: ContentProviderClient
): Closeable {
enum class ProviderName(
val authority: String,
val packageName: String,
val minVersionCode: Long,
val minVersionName: String,
private val readPermission: String,
private val writePermission: String
) {
OpenTasks("org.dmfs.tasks", "org.dmfs.tasks", 103, "1.1.8.2", PERMISSION_OPENTASKS_READ, PERMISSION_OPENTASKS_WRITE),
TasksOrg("org.tasks.opentasks", "org.tasks", 100000, "10.0", PERMISSION_TASKS_ORG_READ, PERMISSION_TASKS_ORG_WRITE),
JtxBoard("at.techbee.jtx.provider", "at.techbee.jtx", 1, "0.1", PERMISSION_JTX_READ, PERMISSION_JTX_WRITE);
companion object {
fun fromAuthority(authority: String): ProviderName {
for (provider in values())
if (provider.authority == authority)
return provider
throw IllegalArgumentException("Unknown tasks authority $authority")
}
}
val permissions: Array<String>
get() = arrayOf(readPermission, writePermission)
}
companion object {
val TASK_PROVIDERS = listOf(
ProviderName.OpenTasks,
ProviderName.TasksOrg,
ProviderName.JtxBoard
)
const val PERMISSION_OPENTASKS_READ = "org.dmfs.permission.READ_TASKS"
const val PERMISSION_OPENTASKS_WRITE = "org.dmfs.permission.WRITE_TASKS"
val PERMISSIONS_OPENTASKS = arrayOf(PERMISSION_OPENTASKS_READ, PERMISSION_OPENTASKS_WRITE)
const val PERMISSION_TASKS_ORG_READ = "org.tasks.permission.READ_TASKS"
const val PERMISSION_TASKS_ORG_WRITE = "org.tasks.permission.WRITE_TASKS"
val PERMISSIONS_TASKS_ORG = arrayOf(PERMISSION_TASKS_ORG_READ, PERMISSION_TASKS_ORG_WRITE)
const val PERMISSION_JTX_READ = "at.techbee.jtx.permission.READ"
const val PERMISSION_JTX_WRITE = "at.techbee.jtx.permission.WRITE"
val PERMISSIONS_JTX = arrayOf(PERMISSION_JTX_READ, PERMISSION_JTX_WRITE)
/**
* Acquires a content provider for a given task provider. The content provider will
* be released when the TaskProvider is closed with [close].
* @param context will be used to acquire the content provider client
* @param name task provider to acquire content provider for; *null* to try all supported providers
* @return content provider for the given task provider (may be *null*)
* @throws [ProviderTooOldException] if the tasks provider is installed, but doesn't meet the minimum version requirement
*/
@SuppressLint("Recycle")
fun acquire(context: Context, name: ProviderName? = null): TaskProvider? {
val providers =
name?.let { arrayOf(it) } // provider name given? create array from it
?: ProviderName.values() // otherwise, try all providers
for (provider in providers)
try {
checkVersion(context, provider)
val client = context.contentResolver.acquireContentProviderClient(provider.authority)
if (client != null)
return TaskProvider(provider, client)
} catch(e: SecurityException) {
Ical4Android.log.log(Level.WARNING, "Not allowed to access task provider", e)
} catch(e: PackageManager.NameNotFoundException) {
Ical4Android.log.warning("Package ${provider.packageName} not installed")
}
return null
}
fun fromProviderClient(
context: Context,
provider: ProviderName,
client: ContentProviderClient
): TaskProvider {
checkVersion(context, provider)
return TaskProvider(provider, client)
}
/**
* Checks the version code of an installed tasks provider.
* @throws PackageManager.NameNotFoundException if the tasks provider is not installed
* @throws [ProviderTooOldException] if the tasks provider is installed, but doesn't meet the minimum version requirement
* */
private fun checkVersion(context: Context, name: ProviderName) {
// check whether package is available with required minimum version
val info = context.packageManager.getPackageInfo(name.packageName, 0)
val installedVersionCode = PackageInfoCompat.getLongVersionCode(info)
if (installedVersionCode < name.minVersionCode) {
val exception = ProviderTooOldException(name, installedVersionCode, info.versionName)
Ical4Android.log.log(Level.WARNING, "Task provider too old", exception)
throw exception
}
}
fun syncAdapterUri(uri: Uri, account: Account) = uri.buildUpon()
.appendQueryParameter(TaskContract.ACCOUNT_NAME, account.name)
.appendQueryParameter(TaskContract.ACCOUNT_TYPE, account.type)
.appendQueryParameter(TaskContract.CALLER_IS_SYNCADAPTER, "true")
.build()!!
}
fun taskListsUri() = TaskContract.TaskLists.getContentUri(name.authority)!!
fun syncStateUri() = TaskContract.SyncState.getContentUri(name.authority)!!
fun tasksUri() = TaskContract.Tasks.getContentUri(name.authority)!!
fun propertiesUri() = TaskContract.Properties.getContentUri(name.authority)!!
fun alarmsUri() = TaskContract.Alarms.getContentUri(name.authority)!!
fun categoriesUri() = TaskContract.Categories.getContentUri(name.authority)!!
override fun close() {
client.closeCompat()
}
class ProviderTooOldException(
val provider: ProviderName,
installedVersionCode: Long,
val installedVersionName: String
): Exception("Package ${provider.packageName} has version $installedVersionName ($installedVersionCode), " +
"required: ${provider.minVersionName} (${provider.minVersionCode})")
}
|
