Was ist GraphQL?

Es handelt es sich um eine Query Language für Web APIs, wessen Syntax genau beschreibt welche Daten vom Server benötigt werden und besteht aus zwei Komponenten:

• Das Schema beschreibt relevanten Daten sowie die Beziehungen untereinander und wird am Server erstellt
• Die Query Language wird am Client verwendet und beschreibt welche Daten vom Server benötigt werden.

Vergleich von REST und GraphQL

Mehrfache Endpunkte

Da in RESTful Applikationen eine URL genau eine Ressource beschreibt, jedoch oft mehrere Ressourcen benötigt werden, kommt es vor, dass man mehrere Endpunkte nacheinander aufrufen muss, was oft zu Rundreisen führt, um an alle Daten ranzukommen.

Für einen einfachen Vergleich zwischen REST und GraphQL, können wir in einem klassischen REST Client nach Kommentaren von Blogposts suchen lassen.

Im Vergleich dazu verwendet GraphQL genau einen Request der vom Client, um an alle nötigen Daten zu kommen.

Überflüssige/Unzureichende Daten

Oft werden bei der Kommunikation mit einer API zusätzlich zu den benötigten, eine Vielzahl an nicht benötigten Daten mitgeschickt. Auf der anderen Seite werden nicht alle Daten geliefert und es sind mehrere Request notwendig um an alle relevanten Informationen zu kommen. Das sind zwei Probleme, die bei RESTful APIs des Öfteren auftreten und zu einer Ansteigung der Response Zeiten führen.

Wie im vorherigen Punkt beschrieben, wird bei einem GraphQL Request genau definiert welche Daten benötigt werden. Diese werden dann im Response, wie ein Spiegelbild des Request zurückgeliefert.

Typisierung

Nicht alle Daten, welche wir von RESTful APIs empfangen sind typisiert bzw. werden die Daten nicht anständig übergeben. Das führt zu Problemen bei der Dokumentation, da es schwer ist zu spezifizieren welche Daten der Client vom Server erwarten kann.

Das GraphQL Schema ist streng typisiert und erlaubt der API eine automatische Dokumentation zu erstellen, welche der Client nützen kann.

Client tappt im Dunklen

Der Client weiß bis er den Response empfängt nicht wie dieser aussieht bzw. strukturiert ist. Dies führt oft zu Fehlern und nicht richtig behandelten Daten.

Im Gegensatz dazu bestimmt bei GraphQL der Client welche Daten er braucht und wie der Response aussehen soll.

Nachteile von GraphQL

Cachfunktion

Natives HTTP Caching ist nicht möglich.

Schema ist nach Außen bekannt

Da das Schema am Client ersichtlich ist, gibt man preis wie die Datenstrukturen der Applikation aussehen.

Sicherheit/Authentifizierung

Es ist noch keine native Lösung für die Handhabung von Authentifizierungen vorhanden.

Zusammenfassend kann man sagen, dass beider Technologien ihre Vorzüge haben, wobei REST mit Zuverlässigkeit und GraphQL mit Performance überzeugt. Bevor man also den Umstieg wagt, sollte man sich genau mit den Anforderungen der Applikation vertraut machen.

Quellen:

https://dev.to/sadarshannaiynar/graphql-or-rest-what-should-i-use-38mj

https://graphql.org/

The post GraphQL, eine neue Alternative zu REST? appeared first on Mobile USTP MKL.

Um sich genau diese Fragen zu sparen bzw. diese Probleme zu umgehen wurden Error Tracking Tools wie zum Beispiel Rollbar entwickelt. Diese Tools lassen sich oft mit wenig Codezeilen einbinden, helfen dabei Fehler in Echtzeit zu tracken und können den Entwickler über einen Messenger seines Vertrauens verständigen. Die wichtigsten Funktionen von Rollbar möchte ich hier kurz auflisten.

Funktionen von Rollbar

Tracken von unerwarteten sowie erwarteten Fehlern

Diese Fehler werden nicht nur in Echtzeit getrackt und in das Protokoll eingetragen, sondern es werden auch Daten zur Rückverfolgung eingetragen. Diese Informationen beinhalten zum Beispiel: Infos in welcher Datei der Fehler aufgetreten ist, welche Request Paramater gesendet wurden, welche URL und welcher User betroffen war sowie Telemetrie Daten zur Nachverfolgung der Interaktion des Users mit der Webanwendung.

Error Log von Rollbar

Intelligentes Gruppieren

Ein einziger Fehler kann innerhalb kürzester Zeit hunderte oder tausende male hintereinander auftreten. Um zu verhindern, dass der komplette Verlauf mit diesem Fehler zugemüllt wird, bietet Rollbar verschiedenste Regeln die die zusammengehörigen Fehler miteinander gruppiert.

Sofortnachrichten und Issue Tracking

Es besteht die Möglichkeit einen Messenger wie zum Beispiel Slack oder Hipchat einzubinden. Durch selbst definierte Regeln wird man sofort über auftretende Fehler informiert und kann per Mausklick zu diesem Eintrag weitergeleitet werden.

Sofortnachricht an Slack Chatroom

Weiters besteht die Möglichkeit Onlinedienste wie GitHub oder GitLab einzubinden. Dadurch besteht die Möglichkeit aus einem Fehler direkt ein Issue mit beliebigen Labels zu erstellen.

Von Rollbar erstelltes Issue mit definierten Labels

Deploy History

Bindet man Plattformen wie BitBucket oder Heroku ein, besteht die Möglichkeit Informationen über jedes Deployment sowie über die beinhalteten Commits zu erhalten. Somit wäre zu jedem auftretenden Fehler auch der verantwortliche Commit angegeben.

Unterstützte Sprachen

Die Liste der unterstützten Sprachen bei Rollbar hört gar nicht auf. Es wird eigentlich jede bekannte Sprache für Frontend, Mobile und Backend unterstützt, wodurch es möglich ist seine Web Anwendung Client- sowie Serverseitig zu überwachen.

Unterstütze Sprachen von Rollbar

Zum Schluss möchte ich euch noch ermutigen selbst Erfahrungen mit Rollbar zu sammeln. Das Tool ist bis 5000 Events pro Monat gratis und somit super geeignet um es in kleinere Projekte einzubinden.

Quelle: https://rollbar.com

The post Error Tracking leicht gemacht appeared first on Mobile USTP MKL.

Geocaching, eine mittels GPS-Koordinaten funktionierende Schatzsuche, hat mittlerweile schon einen beachtlichen Bekanntheitsgrad. Hat man einen sogenannten „Cache“ gefunden, kann man sich mittels Stift und einem bereitgelegten Buch in die Liste der fündig gewordenen eintragen. Leider kommt es immer wieder vor, dass diese Materialien verloren gehen. Um dieses Unglück vorzubeugen wurde die mobile Web Applikation „QR-Caching” entwickelt, die es ermöglicht mittels QR-Code ein online Gästebuch aufzurufen.

Funktionen der App

Suche

Besucht man die Applikation werden alle in der Nähe gefunden QR-Caches, mit der Entfernung zum aktuellen Standort des Users aufgelistet. Klickt man einen dieser QR-Caches an werden zu diesem nähere Informationen, sowie der Schwierigkeitsgrad und Kommentare bzw. Gästebucheinträge anderer User angezeigt. 

Entschließt sich der User diesen Cache zu suchen, wird eine Google Maps Karte angezeigt in der seine aktuelle Position sowie die Position des QR-Caches eingetragen sind. Weiters werden diese zwei Punkte mittels einer möglichen Route miteinander verbunden.

Scanner

Wurde der QR-Cache vom User gefunden, besteht die Möglichkeit diesen mittels integrierten Scanner zu einzuscannen. Wird der QR-Cache in der Datenbank gefunden wird man auf eine Gästebuchseite weitergeleitet, in der es möglich ist sich mit Name und Kommentar einzutragen. Diese Daten werden beim QR-Cache hinterlegt und angezeigt.

Cache erstellen

Falls jemand die Lust verspürt sich bei dieser Schatzsuche zu beteiligen, besteht weiters die Möglichkeit einen QR-Cache selbst anzulegen. Dazu muss ein Name, sowie der Längen- und Breitengrad angegeben werden. Es besteht auch die Möglichkeit denaktuellen Standort als Positionauszuwählen. Zusätzlich ist es mögliche eine Beschreibung und den Schwierigkeitsgrad einzutragen. Nach erfolgreichen speichern des QR-Caches, kann man direkt in der App einen QR-Code als PDF Datei erstellen um diesen später auszudrucken.

Umsetzung

Serverseitig wurde die Applikation mit einem Node.js Server und dem MVC Framework Sails.js umgesetzt. Um die Daten zu speichern, wurde eine MySQL Datenbank gewählt und für das UI wurde HTML5, Bootstrap, CSS sowie jQuery eingesetzt.

Für die Erstellung einer PDF Datei mit QR-Code wurden folgende NPM Packages verwendet: pdfkit, qr-image.

Um die aktuelle Position des Users sowie die Entfernung der Caches wurdedas NPM Package google-distance-matrix sowie die Google Javascript API verwendet.

Für den HTML5 Scanner wurde die Instascan Bibliothek verwendet.

The post „Print-to-Mobile“ – QR-Caching appeared first on Mobile USTP MKL.