const classafBedSheet::Text
sys::Obj afBedSheet::Text
(Response Object) - Use to send a text response to the client.
Text.fromHtml("<html>Hello!<html>")
This is purposely a concrete final class so there is no ambiguity as to what it is. For example, if a handler returned an Obj that was both a Text
and a Redirect
what is BedSheet supposed to do?
Best practice is to have your Entities implement a toText()
or a toJson()
method and return the result of that.
Text myHandler(MyEntity entity) { ... return entity.toJson }
Note: prior to Fantom 1.0.66 the charset would always default to UTF-8 regardless of what Text is constructed with. See http://fantom.org/sidewalk/topic/2166#c13992.
- contentType
const MimeType contentType
- fromContentType
static new fromContentType(Str text, MimeType contentType)
Creates a
Text
with the given content type.- fromHtml
static new fromHtml(Str html, Charset charset := Charset.utf8())
Creates a
Text
with the mime typetext/html
.- fromJson
static new fromJson(Str json, Charset charset := Charset.utf8())
Creates a
Text
from the givenStr
with the mime typeapplication/json
.- fromJsonObj
static new fromJsonObj(Obj jsonObj, Charset charset := Charset.utf8())
Creates a
Text
with the mime typeapplication/json
.jsonObj
should be serialisable into Json via util::JsonOutStream- fromJsonObjP
static new fromJsonObjP(Obj jsonObj, Str callbackFuncName, Charset charset := Charset.utf8())
Creates a
Text
with the mime typeapplication/json
. The json is wrapped in the given callback function name.jsonObj
should be serialisable into Json via util::JsonOutStream.- fromJsonP
static new fromJsonP(Str json, Str callbackFuncName, Charset charset := Charset.utf8())
Creates a
Text
with the mime typeapplication/json
. The json is wrapped in the given callback function name.- fromPlain
static new fromPlain(Str text, Charset charset := Charset.utf8())
Creates a
Text
with the mime typetext/plain
.- fromXhtml
static new fromXhtml(Str xhtml, Charset charset := Charset.utf8())
Creates a
Text
with the mime typeapplication/xhtml+xml
.Be sure to give your XHTML an XML namespace:
<html xmlns="http://www.w3.org/1999/xhtml"> ... </html>
Or it will not be displayed correctly in the browser!
- fromXml
static new fromXml(Str xml, Charset charset := Charset.utf8())
Creates a
Text
with the mime typeapplication/xml
.- text
const Str text
- toBuf
Buf toBuf()
Converts the wrapped text to a
Buf
, encoded with the contentType's charset.- toStr
virtual override Str toStr()