classafButter::Body
sys::Obj afButter::Body
Convenience methods for reading and writing content.
- buf
Buf? buf
Gets and sets the body content as a
Buf
.- charset
Charset? charset
The charset used to en / decode the string and json objects. If left as
null
then it defaults to theContent-Type
HTTP Header, or UTF-8 if not set.charset
should be set before the body content.- form
Gets and sets the body content as a URL encoded form (think forms on web pages).
Uri.encodeQuery()
/Uri.decodeQuery()
methods are used to convert objects to and from form values.When set, the
Content-Type
is set toapplication/x-www-form-urlencoded
(if it's not been set already).Returns
null
if the body has not been set or if it's empty.- in
InStream? in()
Returns the contents of the body as in
InStream
. Shortcut forbuf?.seek(0)?.in
.- json
Str? json
Gets and sets the body content as a JSON string.
When set, the
Content-Type
is set toapplication/json
(if it's not been set already).Returns
null
if the body has not been set or if it is empty.- jsonList
Obj?[]? jsonList
Gets and set the body content as a JSON list. Convenience for
(Obj?[]?) body.jsonObj
.When set, the
Content-Type
is set toapplication/json
(if it's not been set already).Returns
null
if the body has not been set or if it's empty.Note that JsonOutStream is used for the conversion. See the Json library should you need pretty printing or more control over conversion.
- jsonMap
Gets and set the body content as a JSON map. Convenience for
([Str:Obj?]?) body.jsonObj
.When set, the
Content-Type
is set toapplication/json
(if it's not been set already).Returns
null
if the body has not been set or if it's empty.Note that JsonOutStream is used for the conversion. See the Json library should you need pretty printing or more control over conversion.
- jsonObj
Obj? jsonObj
Gets and sets the body content as a JSON object.
JsonInStream
/JsonOutStream
are used to convert objects to and from JSON strings.When set, the
Content-Type
is set toapplication/json
(if it's not been set already).Returns
null
if the body has not been set or if it's empty.Note that JsonOutStream is used for the conversion. See the Json library should you need pretty printing or more control over conversion.
- size
Int size()
Returns the size of the body in bytes. Shortcut for
buf?.size ?: 0
.- str
Str? str
Gets and sets the body content as a string. The string is en / decoded using a charset found in the following precedence:
- any charset set via the
charset
field - the charset defined in a
Content-Type
HTTP header - UTF-8
When set, the
Content-Type
is set totext/plain
(if it's not been set already).Returns
null
if the body has not been set, and an empty Str if it's empty.- any charset set via the