Zugriff auf HTTP Body Daten 

Verwendung

In manchen Fällen soll ein HTTP Request-Handler auf die unverarbeiteten Daten des HTTP-Bodies zugreifen. Dies könnte der Fall sein, wenn der Content-Typ ‚text/html’ oder ‚text/xml’ ist, und der HTTP-Body keine HTML-Formfelder beinhaltet.

Dafür können die Methoden

·        GET_DATA()[Liefert den HTTP Body dieser Entity als Binär-Daten]

·        GET_CDATA()[Liefert den HTTP Body dieser Entity als Character-Daten]

genutzt werden.

Die Methoden

·        SET_DATA()  [Setzt den HTTP Body dieser Entity auf die geg. Binär-Daten]

·        SET_CDATA()  [Setzt den HTTP Body dieser Entity auf die geg. Character-Daten]

erlauben es, die Request-Daten, falls notwendig, zu verändern.

Funktionsumfang

Während die Methode

·        APPEND_CDATA()[Fügt Character-Daten an den HTTP Body dieser Entity an]

immer mit Rohdaten arbeitet, enthält die Methode

·        APPEND_CDATA2()[Fügt Character-Daten an den HTTP Body dieser Entity an]

einen zusätzlichen Parameter, der angibt, in welchem Encoding die Daten vorliegen.

Dieser Parameter kann folgende Werte besitzen:

·        CO_ENCODING_RAW

·        CO_ENCODING_URL

·        CO_ENCODING_HTML

·        CO_ENCODING_WML

Diese Werte zeigen an, wie der Text ausgegeben werden soll. Normalerweise wird der Text so ausgegeben, wie er angegeben wurde (CO_ENCODING_RAW). Wenn er jedoch in einem URL (z.B. als Parameter) auftritt, muss er eine bestimmte Codierung besitzen (z.B. werden Leerzeichen durch '+' oder '%20' ersetzt). In diesem Fall wird der Parameter CO_ENCODING_URL verwendet. Wenn ein Text in einer HTML-Seite so auftauchen soll, wie er angegeben ist, müssen Zeichen, die in HTML mit einer speziellen Semantik belegt sind, ( z.B. '<' ) durch ihr HTML-encodiertes Gegenstück ( '&lt' ) ersetzt werden (CO_ENCODING_HTML). Für die WML-Codierung für WML steht die Konstante CO_ENCODING_WML zur Verfügung.

Diese Codierungen werden hauptsächlich in BSP-Seiten durch Ausdrücke wie '<%html= mystring %>' mit den Werten html, url und rawverwendet. Die WML-Codierung wird durchgeführt, wenn als Codierung html angegeben ist, die Seite aber den MIME-Typ eines WML-Dokumentes hat.

Weitere Informationen

Eine detaillierte Beschreibung der Request-Daten finden Sie unter:

·        IF_HTTP_ENTITY