CX_HTTP_REQUEST::SetBody
184205
Beschreibung:
Diese Methode setzt den Request-Body, der mit GetBody wieder ausgelesen werden kann. Diese Methode macht nur Sinn, wenn das Request-Objekt mit SendRequest versendet werden soll. Dabei sollte beachtet werden, dass durch das Setzen des Bodies alle Body-Parameter, die beim Erstellen des Request-Objekts vom Webservice-Server geparst wurden, oder mit SetParameter gesetzt wurden, fortan als Query-Parameter übermittelt werden. Bei gleichnamigen Query-Parametern, werden Werte der Query-Parameter gewählt.
Wichtig: Wenn Daten per SendRequest im Request-Body übermittelt werden sollen, dann sollte der Content-Type Header entsprechend gesetzt werden, damit der Server weiß, wie er die Daten interpretieren soll. Der Content-Length Header wird von SendRequest automatisch errechnet und überschrieben, falls er mit SetHeader gesetzt wurde.
Code-Beispiel:
Var(req)
//Create Request and set API-ur
CreateTransObject(CX_HTTP_REQUEST) -> req
"http://apihost.com:8080/create/person" req Call(SetURL)
//Create person via POST-method
"POST" req Call(SetMethod)
//Set correct content-type
"Content-Type" "application/json" req Call(SetHeader)
//Set the request body
"{\"name\":\"jimmy\", \"age\":13}" req Call(SetBody)
//Send request
req GetManager(WEB_SERVICE) Call(SendRequest)
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | STRING | Der zu setztende Body |
Stack(Out) | Top |