part of angel_framework.http; /// A function that asynchronously generates a view from the given path and data. typedef Future ViewGenerator(String path, {Map data}); /// A convenience wrapper around an outgoing HTTP request. class ResponseContext { /// The [Angel] instance that is sending a response. Angel app; God god = new God(); /// Can we still write to this response? bool isOpen = true; /// A set of UTF-8 encoded bytes that will be written to the response. List> responseData = []; /// Sets the status code to be sent with this response. status(int code) { underlyingResponse.statusCode = code; } /// The underlying [HttpResponse] under this instance. HttpResponse underlyingResponse; ResponseContext(this.underlyingResponse); /// Any and all cookies to be sent to the user. List get cookies => underlyingResponse.cookies; /// Set this to true if you will manually close the response. bool willCloseItself = false; /// Sends a download as a response. download(File file, {String filename}) { header("Content-Disposition", 'Content-Disposition: attachment; filename="${filename ?? file.path}"'); header(HttpHeaders.CONTENT_TYPE, lookupMimeType(file.path)); header(HttpHeaders.CONTENT_LENGTH, file.lengthSync().toString()); responseData.add(file.readAsBytesSync()); } /// Prevents more data from being written to the response. end() => isOpen = false; /// Sets a response header to the given value, or retrieves its value. header(String key, [String value]) { if (value == null) return underlyingResponse.headers[key]; else underlyingResponse.headers.set(key, value); } /// Serializes JSON to the response. json(value) { write(god.serialize(value)); header(HttpHeaders.CONTENT_TYPE, ContentType.JSON.toString()); end(); } /// Returns a JSONP response. jsonp(value, {String callbackName: "callback"}) { write("$callbackName(${god.serialize(value)})"); header(HttpHeaders.CONTENT_TYPE, "application/javascript"); end(); } /// Renders a view to the response stream, and closes the response. Future render(String view, {Map data}) async { /// TODO: app.viewGenerator var generator = app.viewGenerator(view, data: data); write(await generator); header(HttpHeaders.CONTENT_TYPE, ContentType.HTML.toString()); end(); } /// Redirects to user to the given URL. redirect(String url, {int code: 301}) { header(HttpHeaders.LOCATION, url); status(code); write(''' Redirecting...

Currently redirecting you...

Click if you are not automatically redirected... '''); end(); } /// Streams a file to this response as chunked data. /// /// Useful for video sites. streamFile(File file, {int chunkSize, int sleepMs: 0, bool resumable: true}) async { if (!isOpen) return; header(HttpHeaders.CONTENT_TYPE, lookupMimeType(file.path)); willCloseItself = true; await file.openRead().pipe(underlyingResponse); /*await chunked(file.openRead(), chunkSize: chunkSize, sleepMs: sleepMs, resumable: resumable);*/ } /// Writes data to the response. write(value) { if (isOpen) responseData.add(UTF8.encode(value.toString())); } /// Magically transforms an [HttpResponse] object into a ResponseContext. static Future from (HttpResponse response, Angel app) async { ResponseContext context = new ResponseContext(response); context.app = app; return context; } }