lib

lib/at.bitfire.synctools.storage.calendar/AndroidCalendar

AndroidCalendar

class AndroidCalendar(provider: AndroidCalendarProvider, values: ContentValues)

Represents a locally stored calendar, containing AndroidEvent2 objects. Communicates with the Android Contacts Provider which uses an SQLite database to store the events.

Methods that use ContentValues operate directly on rows of the Events table. Methods that use Entity operate on EventsEntity URIs to access the Events rows together with associated data rows (reminders, attendees etc.)

Parameters

client

calendar provider

values

content values as read from the calendar provider; android.provider.BaseColumns._ID must be set

Throws

IllegalArgumentException

when Calendars._ID is not set

Constructors

AndroidCalendar

constructor(provider: AndroidCalendarProvider, values: ContentValues)

Properties

val accessLevel: Int

see Calendars.CALENDAR_ACCESS_LEVEL

val account: Account

val client: ContentProviderClient

val displayName: String?

see Calendars.CALENDAR_DISPLAY_NAME

eventEntitiesUri

val eventEntitiesUri: Uri

val eventsUri: Uri

val id: Long

see Calendars._ID

val name: String?

see Calendars.NAME

val ownerAccount: String?

see Calendars.OWNER_ACCOUNT

val syncId: String?

see Calendars._SYNC_ID

Functions

fun addEvent(entity: Entity): Long

Inserts an event to the calendar provider.

fun delete(): Int

Calls AndroidCalendarProvider.deleteCalendar for this calendar.

fun deleteEvent(id: Long)

Deletes an event row.

fun eventEntityUri(id: Long): Uri

fun eventUri(id: Long): Uri

fun findEvent(where: String?, whereArgs: Array<String>?, sortOrder: String? = null): AndroidEvent2?

Gets the first event from this calendar that matches the given query.

findEventEntities

fun findEventEntities(where: String?, whereArgs: Array<String>?): List<Entity>

Queries events from this calendar.

fun findEventRow(projection: Array<String>?, where: String?, whereArgs: Array<String>?): ContentValues?

Gets the first event row that matches the given query.

fun findEvents(where: String?, whereArgs: Array<String>?): <Error class: unknown class>

Queries events from this calendar.

fun getEvent(id: Long): AndroidEvent2?

Gets a specific event, identified by its ID, from this calendar.

fun getEventEntity(id: Long, where: String? = null, whereArgs: Array<String>? = null): Entity?

fun getEventRow(id: Long, projection: Array<String>? = null, where: String? = null, whereArgs: Array<String>? = null): ContentValues?

Gets the event row of a specific event, identified by its ID, from this calendar.

iterateEventRows

fun iterateEventRows(projection: Array<String>?, where: String?, whereArgs: Array<String>?, body: (ContentValues) -> Unit)

Iterates event rows from this calendar.

fun iterateEvents(where: String?, whereArgs: Array<String>?, body: (Entity) -> Unit)

Iterates event entities from this calendar.

numDirectInstances

fun numDirectInstances(eventId: Long): Int?

Finds the amount of instances this event has. Exceptions generate their own instances and are not taken into account by this method.

fun numInstances(eventId: Long): Int?

fun readSyncState(): String?

Calls AndroidCalendarProvider.readCalendarSyncState for this calendar.

fun update(values: ContentValues): Int

Calls AndroidCalendarProvider.updateCalendar for this calendar.

fun updateEvent(id: Long, entity: Entity): Long

fun updateEventRow(id: Long, values: ContentValues)

Updates a specific event's main row with the given values. Doesn't influence data rows.

updateEventRows

fun updateEventRows(values: ContentValues, where: String?, whereArgs: Array<String>?): Int

Updates event rows in this calendar.

fun writeSyncState(newState: String?)

Calls AndroidCalendarProvider.writeCalendarSyncState for this calendar.