de.svws_nrw.davapi.api.PutCalendarDispatcher Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of svws-module-dav-api Show documentation
Show all versions of svws-module-dav-api Show documentation
Diese Bibliothek enthält die Java-Server-Definition der CalDAV und CardDAV-Schnittstelle für die Schulverwaltungssoftware in NRW
The newest version!
package de.svws_nrw.davapi.api;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import java.util.Optional;
import de.svws_nrw.core.data.kalender.KalenderEintrag;
import de.svws_nrw.davapi.data.IKalenderEintragRepository;
import de.svws_nrw.davapi.data.repos.dav.DavException;
import de.svws_nrw.davapi.data.repos.dav.DavException.ErrorCode;
import de.svws_nrw.davapi.model.dav.Error;
import de.svws_nrw.davapi.util.icalendar.DateTimeUtil;
import de.svws_nrw.davapi.util.icalendar.VCalendar;
import jakarta.ws.rs.core.EntityTag;
/**
* Dispatcher-Klasse für die Verarbeitung von Requests auf das DAV-API mittels
* der HTTP-Methode REPORT auf die Ressource Kalender.
*/
public class PutCalendarDispatcher extends DavDispatcher {
/**
* Repository-Klasse zur Abfrage von Kalendereinträgen aus der SVWS-Datenbank
*/
private final IKalenderEintragRepository kalenderEintragRepository;
/** URI-Parameter für die Erzeugung von URIs des Ergebnisobjekts */
private final DavUriParameter uriParameter;
/**
* Erstellt einen neuen Dispatcher mit den angegebenen Repositorys und
* URI-Parametern
*
* @param kalenderEintragRepository das Repository für Kalendereinträge
* @param uriParameter die URI-Parameter für im Response verwendete
* URIs
*/
public PutCalendarDispatcher(final IKalenderEintragRepository kalenderEintragRepository,
final DavUriParameter uriParameter) {
this.kalenderEintragRepository = kalenderEintragRepository;
this.uriParameter = uriParameter;
}
/**
* Aktualisiert einen vorhandenen Kalendereintrag in der gegebenen
* Ressourcensammlung mit der gegebenen RessourcenUID, sofern das gegebene eTag
* (die Version des Clients) der Version des Servers entspricht.
*
* @param inputStream der InputStream mit dem VCalendar payload
* @param ressourceCollectionId die ID des Kalenders
* @param ressourceUID die UID des Kalendereintrags
* @param eTag eTag des Clients, also die Versionsnummer, die
* dem Client zuletzt bekannt war
* @return das aktuellste eTag des Servers nach aktualisieren (also die
* Versionsnummer) oder ein {@link Error}-Objekt im Fehlerfall
*/
public Object dispatchUpdate(final InputStream inputStream, final String ressourceCollectionId, final String ressourceUID,
final String eTag) {
return dispatchCreateOrUpdate(inputStream, ressourceCollectionId, ressourceUID, Optional.of(eTag));
}
/**
* Erstellt einen neuen Kalendereintrag in der gegebenen Ressourcensammlung mit
* der gegebenen Ressourcen-UID.
*
* @param inputStream der InputStream mit dem VCalendar payload
* @param ressourceCollectionId die ID des Kalenders
* @param ressourceUID die UID des Kalendereintrags dem Client zuletzt
* bekannt war
* @return das aktuellste eTag des Servers nach Erstellen (also die
* Versionsnummer) oder ein {@link Error}-Objekt im Fehlerfall
*/
public Object dispatchCreate(final InputStream inputStream, final String ressourceCollectionId, final String ressourceUID) {
return dispatchCreateOrUpdate(inputStream, ressourceCollectionId, ressourceUID, Optional.empty());
}
/**
* Erstellt einen neuen Kalendereintrag oder aktualisiert einen vorhandenen.
* Zwischen erstellen und aktualisieren wird anhand des gegebenen eTags
* entschieden, ein leeres {@link Optional} versucht einen neuen Eintrag mit der
* gegebenen UID zu erstellen, ist das Optional mit einem eTag gefüllt, wird der
* vorhandene Kalendereintrag bei gleicher UID aktualisiert, sofern der Client
* die aktuellste Version hatte.
*
* @param inputStream der InputStream mit dem VCalendar payload
* @param ressourceCollectionId die ID des Kalenders
* @param ressourceUID die UID des Kalendereintrags
* @param eTag eTag des Clients, also die Versionsnummer, die
* dem Client zuletzt bekannt war
* @return das aktuellste eTag des Servers nach aktualisieren (also die
* Versionsnummer) oder ein {@link Error}-Objekt im Fehlerfall
*/
private Object dispatchCreateOrUpdate(final InputStream inputStream, final String ressourceCollectionId, final String ressourceUID,
final Optional eTag) {
// iCalender Payload aus dem Request auslesen
// request content ist kein xml String, sondern direkt das .ics
uriParameter.setResourceCollectionId(ressourceCollectionId);
uriParameter.setResourceId(ressourceUID);
final ByteArrayOutputStream bos = new ByteArrayOutputStream();
final byte[] buffer = new byte[2048];
try {
for (int length; (length = inputStream.read(buffer)) != -1;) {
bos.write(buffer, 0, length);
}
final String vCalPayload = bos.toString(StandardCharsets.UTF_8);
final VCalendar vCalendar = VCalendar.parse(vCalPayload);
final KalenderEintrag updatedKalendereintrag = new KalenderEintrag();
updatedKalendereintrag.data = vCalPayload;
updatedKalendereintrag.kalenderId = ressourceCollectionId;
updatedKalendereintrag.uid = ressourceUID;
updatedKalendereintrag.kalenderEnde = DateTimeUtil.toSQLTimeStamp(vCalendar.getMaxDTEnd());
updatedKalendereintrag.kalenderStart = DateTimeUtil.toSQLTimeStamp(vCalendar.getMinDTStart());
updatedKalendereintrag.kalenderTyp = vCalendar.getTyp().name();
if (eTag.isPresent() && !eTag.get().isBlank()) {
updatedKalendereintrag.version = adjustETags(eTag.get());
}
final KalenderEintrag saveKalenderEintrag = this.kalenderEintragRepository
.saveKalenderEintrag(updatedKalendereintrag);
return new EntityTag(saveKalenderEintrag.version);
} catch (final IOException e) {
return ErrorCode.INTERNAL_SERVER_ERROR.getDavResponse(DavUriBuilder.getCalendarEntryUri(uriParameter))
.getError();
} catch (final DavException e) {
// hier wird das ErrorObjekt zurückgegeben
return e.getDavResponse(DavUriBuilder.getCalendarEntryUri(uriParameter)).getError();
}
}
}