Eine einfache Möglichkeit, HTTP-Anfragen während der Entwicklung zu testen

Web- und Web-Service-Entwickler benötigen oft die Möglichkeit, HTTP-Anfragen zu senden – sei es zum Testen von APIs, zum Testen von REST- und SOAP-Webdiensten oder zur Verwaltung von Websites.

XMLSpy erleichtert das Senden und Empfangen von HTTP-Anfragen direkt im XML- und JSON-Editor während der Entwicklung mithilfe des HTTP-Fensters und des WADL/WSDL-Import-Assistenten. Dies ist ein hervorragendes Werkzeug zur Zeitersparnis beim Debuggen von Webdiensten.

Testen von HTTP-Anfragen

Das HTTP-Protokoll definiert, wie Dateien (Text, Bilder usw.) über das Internet übertragen werden. Jeder Webserver führt ein Programm (bekannt als Daemon) aus, das kontinuierlich auf HTTP-Anfragen wartet und jede eingehende Anfrage bearbeitet.

Wenn Sie beispielsweise eine Webseite besuchen, sendet Ihr Browser einen HTTP-Befehl an den Webserver der Webseite, der den Download der Startseite anfordert. Der HTTP-Dienst des Servers empfängt diese Anfrage und sendet die angeforderte Seite. Es ist wichtig zu beachten, dass das HTTP-Protokoll zustandslos ist, was bedeutet, dass jeder HTTP-Befehl unabhängig ausgeführt wird, ohne Bezugnahme auf vorherige oder nachfolgende Befehle – und dies kann das Testen und die Fehlersuche erschweren.

Um Entwicklern dabei zu helfen, bietet das HTTP-Testfenster in XMLSpy eine Anleitung zum Erstellen und Senden einer HTTP-Anfrage an einen Webserver. Anschließend können Sie die Antwort empfangen, überprüfen und Fehler beheben.

Ein Request wird im Bereich auf der linken Seite des Fensters definiert und kann aus folgenden Dingen bestehen:

der HTTP-Methode des Request (GET, PUT, POST, usw.) und der Ziel-URL
den HTTP-Headern des Request
Verbindungseinstellungen, wie z.B. Timouts und Sicherheitsoptionen
bei der POST- und PUT-Methode dem HTTP Message Body

Das HTTP-Fenster enthält neun separate Register, die das Speichern und Testen mehrerer Messages und das Wechseln zwischen diesen gestatten.

Sobald die Anfrage definiert ist, klicken Sie auf "Senden", um sie an den Webserver zu übermitteln. Sie können die Antwort sofort im rechten Bereich analysieren, der den Inhalt (wie oben gezeigt) und die Header-Informationen anzeigt:

Importieren einer WADL- oder WSDL-Anfrage

Sie können auch einen Test starten, indem Sie eine Anfrage aus einer WADL-Datei (Web Application Description Language) importieren, die eine maschinenlesbare Beschreibung einer HTTP-basierten Anwendung bereitstellt, oder aus einem WSDL-Dokument, das SOAP-Webservice-Endpunkte beschreibt.

Das XMLSpy-HTTP-Fenster enthält einen WADL / WSDL-Importassistenten, der Sie Schritt für Schritt durch das Öffnen einer Datei, die Auswahl eines zu testenden Request und die Bearbeitung etwaiger editierbarer Request-Parameter führt.

Anschließend wird der Request in das HTTP-Fenster importiert, sodass sie ihn senden und die Response überprüfen können.

Fehlerbehebung bei einer REST-API

Schauen wir uns ein reales Beispiel an, bei dem wir das HTTP-Fenster verwenden, um die Antwort einer Web-API zu testen. Das Datenportal der Stadt Chicago ist eine öffentlich zugängliche REST-API, die interessante Daten zu verschiedenen Themen bereitstellt, von Baugenehmigungen über kommunale Budgets bis hin zu den Zahlen der Krankenhausaufenthalte aufgrund von Asthma in der Stadt.

Für dieses Beispiel werden wir uns die Kategorie "Verkehr" genauer ansehen und uns auf einen Datensatz von Verstößen gegen die Straßenverkehrsordnung konzentrieren, insbesondere auf das Überfahren von roten Ampeln. Ich kann die URL im HTTP-Fenster eingeben, um den gesamten Datensatz abzurufen. Die Angabe von ".xml" oder ".json" am Ende der Anfrage bestimmt das Format der zurückgegebenen Daten. Für diese Ausführung habe ich XML gewählt, aber XMLSpy verfügt natürlich über integrierte Tools zur Verarbeitung beider Formate. Das Ergebnis, das vom HTTP-Fenster zurückgegeben wird, ist unten dargestellt.

Wir können die Daten im Ergebnisbereich überprüfen oder auf "Neues Dokument erstellen" klicken, um das Dokument in XMLSpy im Text- oder Tabellenformat zu öffnen. Dort lässt sich die von der API zurückgelieferten Daten leichter durchsuchen und überprüfen.

Mit den Daten in einer Datei können wir sogar noch gezielter vorgehen, indem wir XQuery einsetzen. Sehen wir uns beispielsweise die Standorte von Kameras mit mehr als 20 Verstößen an.

Lassen Sie uns die Daten jetzt erneut abrufen, diesmal jedoch im JSON-Format.

Hier wird es im Textmodus geöffnet..

Und Sie können den JSON-Code auch in der einzigartigen JSON-Tabellenansicht von XMLSpy anzeigen lassen, um eine grafische Darstellung zu erhalten. Die JSON-Tabelle erleichtert das Durchsuchen und Verstehen der zurückgegebenen Daten erheblich, insbesondere bei großen Datensätzen wie diesem. Der JSON-Editor bietet außerdem eine integrierte Unterstützung für die Filterung von Daten mit XQuery, wie im Folgenden gezeigt. Ich habe die Daten gefiltert, um nur die Einträge anzuzeigen, die Schnittstellen mit der Halsted Street enthalten.

Das HTTP-Fenster, zusammen mit den integrierten Funktionen zur Anzeige und Bearbeitung, macht XMLSpy zu einem hervorragenden Werkzeug zum Testen und Debuggen von APIs, Webdiensten und anderen HTTP-Anwendungen.

Laden Sie eine kostenlose Testversion von XMLSpy herunter, um das HTTP-Fenster auszuprobieren.