Die Klasse Request (gb.web) können Sie verwenden, um HTTP-Anfragen (HTTP-Requests) an einen HTTP-Server zu schreiben. Beispiele für die praktische Realisierung finden Sie im Kapitel 24.6.8 Projekte.
Die Klasse Request verfügt über diese Eigenschaften:
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| Cookies | Collection | Ermittelt eine Übersicht aller Cookies, die in einer HTTP-Anfrage (Request) enthalten sind. |
| Debug | Boolean | Gibt True zurück, wenn der Debug-Modus eingeschaltet ist oder setzt den Debug-Modus. Wenn der Debug-Modus eingeschaltet ist, so wird der Inhalt des Post-Request gespeichert und kann über die Eigenschaft Request.Post.Contents ausgelesen werden. |
| Delimiter | String | Setzt das Zeichen, das die Felder in einer GET- oder application/x-www-form-urlencoded-POST-Anfrage begrenzt oder gibt das Trenn-Zeichen zurück. Das Zeichen '&' ist das Standard-Trennzeichen. |
| Fields | String[ ] | Speichert eine Liste der Namen aller Feld-Variablen, die im Request enthalten sind, in einem String-Array. |
| Files | Collection | Ermittelt eine Auflistung aller Dateien, die dem Request beigefügt sind. Die Schlüssel dieser Collection sind die Datei-Namen, die im Request angegeben sind. Die Werte der Collection ist der Pfad der auf dem Server gespeicherten Dateien. Alle Dateien werden in das temporäre Verzeichnis der Anwendung hochgeladen. Sie werden zerstört, sobald die Anwendung beendet wird. |
| InternetExplorer | Integer | Gibt die Version des Internet-Explorers als HTTP-Client zurück oder NULL, wenn der Internet-Explorer nicht der HTTP-Client ist. |
| Path | String | Gibt den Request-Pfad der CGI-Applikation zurück. Ist das Äquivalent zu CGI[„PATH_INFO“]. |
| Query | String | Gibt den Abfrage-Teil der Anfrage zurück. Ist das Äquivalent zu CGI[„QUERY_STRING“]. |
| Method | String | Gibt die Methode „POST“ oder „GET“ der CGI-Applikation zurück, mit der Anfragen verschickt werden (Äquivalent zu CGI[„REQUEST_METHOD“]). |
| Language | String | Der Browser teilt dem Server bei einem Request mit, auf welche Sprache er eingestellt ist. Verwenden Sie System.Language = Request.Language, um die Webseite zu internationalisieren. |
Tabelle 24.6.4.1.1 : Eigenschaften der Klasse Request
Die Eigenschaft Request.Get liefert ein virtuelles Objekt '_Request_Get' zurück, um die in der GET-Anfrage gespeicherten Daten abrufen zu können, während die Eigenschaft Request.Post ein virtuelles Objekt '_Request_Post' zurück gibt, um die in der POST-Anfrage gespeicherten Daten abzurufen.
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| _Get.Fields | String[ ] | Gibt ein Daten-Array zurück, das alle im GET-Request-URL enthaltenen Felder enthält. |
| _Post.Contents | String | Gibt den Request-Inhalt zurück, sofern die Eigenschaft 'Request.Debug' auf den Wert True gesetzt ist. |
| _Post.Fields | String[ ] | Liefert ein Daten-Array mit allen Feldern im POST-Request-Inhalt zurück. |
| _Post.Files | Collection | Gibt eine Sammlung (Collection) der Dateien zurück, die mit dem POST-Request geschickt wurden. Der Schlüssel enthält den Dateinamen und der Dateipfad ist als korrespondierender Wert in dieser Sammlung gespeichert. |
Tabelle 24.6.4.1.2 : Eigenschaften der virtuellen Klassen _Request_Get und _Request_Post
Hinweise:
Die Klasse Request (gb.web) besitzt nur eine Methode:
Static Function Exist ( Field As String ) As Boolean
Die Funktion gibt True zurück, wenn das angegebene Feld in der HTTP-Anfrage existiert – unabhängig von der verwendeten Methode GET oder POST.
Auch die beiden virtuellen Klassen _Request_Get und _Request_Post besitzen jeweils eine Methode:
Function _Request_Get.Exist ( Field As String ) As Boolean Function _Request_Post.Exist ( Field As String ) As Boolean
Beide Funktionen geben jeweils als Funktionswert True zurück, wenn das angegebene Feld in der GET- oder POST-Anfrage existiert.