Die RESTful-Bibliothek kennenlernen

Um zu verstehen, was eine REST-API ist und wie sie funktioniert, stellen Sie sich eine Bibliothek mit Büchern, einem Bibliothekar/ einer Bibliothekarin vor und Personen, die eben diese Bücher ausleihen möchten, welche hinzufügen möchten, diese aktualisieren oder sogar Bücher entfernen möchten. Auf der einen Seite haben wir den Client. Dies ist die Web-Anwendung, eine mobile App oder eine Smartwatch oder welche Schnittstelle auch immer Zugriff auf die Daten verwenden möchte. Auf der anderen Seite haben wir den Datenspeicher. Normalerweise eine Datenbank oder ein Datenbank-Server oder irgendeine andere Art von Server. In der Mitte sitzt unser Bibliothekar oder unsere Bibliothekarin, die REST-API, die Anfragen und Antworten empfängt, verarbeitet und handhabt. Und so funktioniert unsere Bibliothek. Wenn der Client eine Anfrage sendet, in diesem Fall, um eine Ressource zu erhalten, empfängt die REST-API diese Anfrage, identifiziert die angeforderte Ressource, ermittelt, welche Daten gesammelt werden müssen und in welchem Format. Daraufhin erstellt die REST-API eine Darstellung der Daten, die mit dem angeforderten Format übereinstimmen muss und bündelt alles mit den Metadaten der Ressource zusammen. Diese Metadaten können u.a. die Ressourcen-ID sein, Hyperlinks zu verfügbaren Aktionen, wie z.B. das Aktualisieren oder Löschen einer Ressource, das Medienformat und die Größe seiner Antwort, d.h. die Größe der Ressource. Der Client empfängt die Daten und parst sie an seinem Ende in etwas Sinnvolles, während die REST-API ruhig auf die nächste Anfrage wartet. Als Nächstes möchte der Client oder besser gesagt sein Benutzer etwas ändern. Diese Änderungen werden auf den Inhalt angewendet, der in der ursprünglichen Antwort empfangen wurde und als PUT-Anforderung unter Verwendung der ursprünglichen ID zurückgesendet. Die REST-API empfängt die Anforderung, erkennt diese als PUT-Anforderung für eine vorhandene Ressource an, notiert das angeforderte Medienformat, identifiziert die angeforderte Ressource, konvertiert die angeforderten Daten in ein Medienformat, das für den Datenspeicher funktioniert, nimmt die übermittelten Änderungen vor und gibt die neue Darstellung der Ressource zusammen mit einer Erfolgsmeldung zurück, um den Client darüber zu informieren, dass alles wie erwartet gelaufen ist. In diesem Beispiel sendet ein Client Anforderungen an die REST-API. In den meisten Anwendungen haben wir mehrere, vielleicht Hunderte oder Tausende oder Millionen von Kunden, die Anfragen stellen, sodass der Bibliothekar, die Bibliothekarin sehr beschäftigt sein wird. Aber der tatsächliche Fluss ist genau derselbe. Der Client stellt die Anfrage, die REST-API empfängt die Anfrage, sammelt und analysiert die Daten und gibt diese Daten und den Antwort-Header mit all seinen Metadaten an den Client zurück.