Package de.svws_nrw.davapi.data.caldav

Klasse DataCalDavEigenerKalender

java.lang.Object
de.svws_nrw.davapi.data.caldav.DataManagerCalDav
de.svws_nrw.davapi.data.caldav.DataCalDavEigenerKalender
public final class DataCalDavEigenerKalender extends DataManagerCalDav
Diese Klasse dient dem Zugriff auf die Datenbank, um einen Eigenen Kalender zu verwalten.

  • Konstruktordetails

    • DataCalDavEigenerKalender

      public DataCalDavEigenerKalender(DBEntityManager conn)
      Erzeugt eine neue Data-Klasse für den Zugriff auf den Eigenen Kalender
      Parameter:
      conn - die Datenbank-Verbindung

  • Methodendetails

    • getKalender

      public Kalender getKalender(String idCal)
      Beschreibung aus Klasse kopiert: DataManagerCalDav
      Gibt den Kalender mit der übergebenen ID ohne Einträge zurück.
      Angegeben von:
      getKalender in Klasse DataManagerCalDav
      Parameter:
      idCal - die ID des Kalenders
      Gibt zurück:
      der Kalender oder null, wenn die ID ungültig ist

    • getEintraege

      @NotNull public @NotNull List<KalenderEintrag> getEintraege(String idCal, boolean withPayload)
      Beschreibung aus Klasse kopiert: DataManagerCalDav
      Gibt die Liste der Einträge aus dem Kalender mit der übergebenen ID zurück.
      Angegeben von:
      getEintraege in Klasse DataManagerCalDav
      Parameter:
      idCal - die ID des Kalenders
      withPayload - gibt an, ob die eigentlichen Daten bei der Generierung der Einträge mit erstellt werden
      Gibt zurück:
      die Liste mit Einträgen des angegebenen Kalenders.

    • persistEintrag

      public String persistEintrag(@NotNull @NotNull KalenderEintrag eintrag)
      Beschreibung aus Klasse kopiert: DataManagerCalDav
      Erzeugt einen neuen Eintrag im Kalender mit den Daten aus dem übergebenen Kalender-Eintrag
      Angegeben von:
      persistEintrag in Klasse DataManagerCalDav
      Parameter:
      eintrag - der Kalender-Eintrag
      Gibt zurück:
      die neue Version des gespeicherten Kalender-Eintrags (Entity-Tag) oder null im Fehlerfall

    • getDeletedEintragUIDs

      @NotNull public @NotNull List<String> getDeletedEintragUIDs(@NotNull @NotNull String idCal, long syncToken) throws DavException
      Beschreibung aus Klasse kopiert: DataManagerCalDav
      Gibt die UIDs von gelöschten Einträgen eines Kalenders seit dem gegegebenen Zeitpunkt zurück.
      Angegeben von:
      getDeletedEintragUIDs in Klasse DataManagerCalDav
      Parameter:
      idCal - die ID des Kalenders
      syncToken - der Zeitpunkt als Millisekunden seit 1970, Timestamp.getTime()
      Gibt zurück:
      eine Liste der Ressourcen-UIDs, welche seit dem gesuchten Zeitpunkt als gelöscht markiert wurden
      Löst aus:
      DavException - im Fehlerfall

    • deleteEintrag

      public boolean deleteEintrag(@NotNull @NotNull String idCal, String uid, Long syncToken) throws DavException
      Beschreibung aus Klasse kopiert: DataManagerCalDav
      Entfernt einen Kalendereintrag anhand der UID aus dem Kalender mit der übergebenen ID, sofern der übergebene SyncToken mit dem gespeicherten übereinstimmt, d.h. die Anfrage auf dem aktuellen Kalendereintrag basiert.
      Angegeben von:
      deleteEintrag in Klasse DataManagerCalDav
      Parameter:
      idCal - die ID des Kalenders
      uid - die UID des Kalendereintrags
      syncToken - der SyncToken aus der Anfrage für den Abgleich der letzten Änderung an der Ressource
      Gibt zurück:
      true, wenn das Löschen erfolgreich war, und ansonsten false
      Löst aus:
      DavException - im Fehlerfall (z.B. fehlende Rechte auf dem Kalender, fehlender Kalendereintrag, abweichendes Synctoken, ...)