Package de.svws_nrw.davapi.api

Klasse PropfindAddressbookDispatcher

java.lang.Object
de.svws_nrw.davapi.api.PropfindAddressbookDispatcher
public class PropfindAddressbookDispatcher extends Object
Dispatcher-Klasse für die Verarbeitung von Requests auf das DAV-API mittels der HTTP-Methode PROPFIND auf die Ressource Adressbuch.

  • Konstruktordetails

    • PropfindAddressbookDispatcher

      public PropfindAddressbookDispatcher(IAdressbuchRepository repository, DavUriParameter uriParameter)
      Konstruktor für einen neuen Dispatcher mit Repository und den gegebenen UriParametern
      Parameter:
      repository - das Repository zum Zugriff auf Adressbuecher der Datenbank
      uriParameter - die UriParameter zum Erstellen von URIs

  • Methodendetails

    • dispatch

      public Object dispatch(InputStream inputStream, String ressourceId) throws IOException
      Verarbeitung eines PropFind auf Adressbuchebene anhand des InputStreams und der gegebenen Ressource
      Parameter:
      inputStream - der InputStream mit dem zu verarbeitenden XML-Request
      ressourceId - die Ressource für die dieser Request gilt
      Gibt zurück:
      die entsprechend des Requests verarbeitete Datenstruktur, welche das Antwort-XML repräsentiert. Als Objekt zurückgegeben, da das Zielobjekt vor der Verarbeitung nicht festgestellt wird
      Löst aus:
      IOException - bei Fehlern in der Streambehandlung/dem XML-Unmarshalling

    • createResourceNotFoundError

      protected Error createResourceNotFoundError(String message)
      Erzeugt ein Error-Rückgabeobjekt mit der angegebenen Message. Dieses Objekt wird von den Dispatchern zurückgegeben, wenn die angefragten Ressource nicht gefunden wurde.
      Parameter:
      message - Fehlermeldung
      Gibt zurück:
      Error-Objekt

    • createResponse

      protected static final Response createResponse(@NotNull @NotNull Prop propRequested, @NotNull @NotNull Prop propResponded)
      Erzeugt ein Response-Rückgabeobjekt. Diese wird dynamisch aufgebaut auf der Basis der im Request angefragten Properties zu einer Ressource und den tatsächlich gefundenen/ermittelten Properties. Nicht-gefundene Properties oder Ressourcen werden in einem speziellen Block (404) im Response aufgelistet.
      Parameter:
      propRequested - Angeforderte Properties zu einer Ressource
      propResponded - Gefundene/Ermittelte Properties zu einer Ressource
      Gibt zurück:
      Response-Objekt

    • getReadOnlyPrivilegeSet

      protected static final CurrentUserPrivilegeSet getReadOnlyPrivilegeSet()
      Erzeugt ein DAV-Objekt vom Typ CurrentUserPrivilegeSet, das alle erforderlichen Rechte (Privileges) für einen lesenden Zugriff auf DAV-Ressourcen enthält.
      Gibt zurück:
      CurrentUserPrivilegeSet mit Privileges für einen lesenden Zugriff.

    • getPrivilegeSet

      protected static final CurrentUserPrivilegeSet getPrivilegeSet(boolean darfLesen, boolean darfSchreiben)
      Erzeugt ein DAV-Objekt vom Typ CurrentUserPrivilegeSet, das alle erforderlichen Rechte (Privileges) für einen lesenden Zugriff auf DAV-Ressourcen enthält.
      Parameter:
      darfLesen - ob der angemeldete Nutzer den Kalender Lesen darf
      darfSchreiben - ob der angemeldete Nutzer auf dem Kalender schreiben darf
      Gibt zurück:
      CurrentUserPrivilegeSet mit Privileges für einen lesenden Zugriff.

    • adjustETags

      protected String adjustETags(String value)
      Homogenisiert eTag-Werte von unterschiedlichen Quellsystemen. In Abhängigkeit der Quellsysteme (z.B. Thunderbird, Outlook) werden teilweise Anführungszeichen als Bestandteil der Werte von eTags oder ifMatch-Headers mitgesendet oder nicht. Die DAV-Dispatcher benötigen diese Methode, um eine einheitliche Auswertung dieser Werte sicherzustellen.
      Parameter:
      value - String, kann Anführungszeichen enthalten
      Gibt zurück:
      String, enthält keine Anführungszeichen mehr