Kalender Interface - HochschuleHofStundenplanapp/AndroidStundenplanHof GitHub Wiki

Einleitung

Das Kalender Interface wird dazu genutzt die Vorlesungen und Änderungen in den Kalender des Gerätes einzutragen. Dazu wird die Klasse CalendarSynchronization genutzt.

CalendarInterface Diagram

CalendarSynchronization

Über diese Klasse wird das CalendarInterface gesteuert. Sie bietet folgende Methoden:

  • getCalendars()
  • setCalendar()
  • createAllEvents()
  • deleteAllEvents()
  • updateChanges()
  • updateCalendar()
  • stopCalendarSynchronization()

getCalendars()

Gibt alle Kalender des Nutzers zurück. Mit Hilfe der getCalendars-Methode des CalendarInterfaces.

setCalendar(String calendarName)

Setzt den übergebenen Kalender. Falls null oder ein leerer String übergeben wird wird der lokale Kalender verwendet. Mit Hilfe der setCalendar-Methode des CalendarInterfaces.

createAllEvents()

Erzeugt die Events für entweder die übergebende(-n) Vorlesung(-en) oder für alle wenn nichts übergeben wird mit Hilfe der createLectureEvent-Methode des CalendarInterfaces.

deleteAllEvents()

Entfernt entweder alle Events für die Vorlesung der übergebenen Vorlesungs ID oder alle Events wenn nichts übergeben wird mit Hilfe der deleteAllEvents-Methode des CalendarInterfaces.

updateChanges()

Passt die Events für die Änderungen an mit Hilfe der updateChanges-Methode des CalendarInterfaces.

stopCalendarSynchronization()

Löscht den lokalen Calendar mit Hilfe der removeCalendar-Methode des CalendarInterfaces. Falls es kein lokaler Kalender war werden alle Events aus dem ausgewählten Kalender gelöscht.

CalendarInterface

Dies ist das Interface das direkt auf den Kalender zugreift. Es besteht aus folgenden Methoden:

  • getCalendars()
  • setCalendar()
  • createLectureEvent()
  • updateChange()
  • getLocation()
  • deleteAllEvents()
  • saveIDs()

getCalendars()

Gibt alle Kalender des Nutzers zurück.

setCalendar(Long calendarID)

Setzt den übergebenen Kalender. Falls null übergeben wird wird der lokale Kalender verwendet.

createLectureEvent()

Erzeugt ein Event für eine Vorlesung.

updateChange()

Passt das Event der Vorlesung der Änderung an.

getLocation()

Gibt den Ort der Vorlesung zurück.

deleteAllEvents()

Löscht alle Events für die Vorlesung der übergebenen Vorlesungs ID oder alle Events aller Vorlesungen wenn nichts übergeben wird.

saveIDs()

Speichert das Object der CalendarEventIds-Klasse, in der die EventIDs gespeichert sind, mit Hilfe des DataManager.

CalendarEventIds

In dieser Klasse wird die CalendarID des ausgewählten Kalender und die EventIDs für die Vorlesungen und Änderungen gespeichert.