CX_HTTP_REQUEST::SetURL

CX_HTTP_REQUEST::SetURL

184192

Beschreibung:

Diese Methode setzt die Anfrage-URL und weitere mit der Anfrage verbundene Parameter.  Das Setzen der URL ist primär für den Einsatz mit SendRequest gedacht. Alternativ kann die Methode auch genutzt werden, um eine URL in ihre Bestandteile zu zerlegen, die über die Get-Methoden von CX_HTTP_REQUEST ausgelesen werden können.

Wird eine ungültig formatierte URL als Parameter übergeben, dann gibt die Methode eine Fehlermeldung aus. Die Methode arbeitet nach der URI-Definition aus RFC 3986. Das kann zu teils unerwarteten Ergebnissen führen, denn die URL "host-:80/home" enthält zwar den ungültigen Hostnamen: "host-", ist aber insgesamt ein gültiger Pfad und wird somit auch als Pfad ohne Fehlermeldung interpretiert.

Die folgende Tabelle Zeigt, welche Parameter durch welche URLs wie gesetzt werden. Ein leeres Feld bedeutet, dass der Wert nicht verändert wird. Ein - bedeutet, dass der vorhandene Wert durch einen leeren Wert überschrieben wird.

232556 wird zusätzlich zu http:// und https:// auch das neue morphit:// Protokoll unterstützt. (Siehe SendRequest)

Code-Beispiel:

Var(req,rep)
CreateTransObject(CX_HTTP_REQUEST) -> req
"http://www.google.de/" req Call(SetURL)
req GetManager(WEB_SERVICE) Call(SendRequest) -> rep
rep Call(GetBody) Attention

Funktionsaufruf: Call(SetURL)