User Guide

204 Server-Side ActionScript Language Reference
Description
Event handler; invoked when Flash Media Server receives an HTTP status code from the
server. This handler lets you capture and act on HTTP status codes.
The
onHTTPStatus handler is invoked before onData, which triggers calls to onLoad with a
value of
undefined if the load fails. After onHTTPStatus is triggered, onData is always
triggered, whether or not you override
onHTTPStatus. To best use the onHTTPStatus
handler, you should write a function to catch the result of the
onHTTPStatus call; you can
then use the result in your
onData and onLoad handlers. If onHTTPStatus is not invoked, this
indicates that the FMS did not try to make the URL request.
If Flash Media Server cannot get a status code from the server, or if it cannot communicate
with the server, the default value of 0 is passed to your ActionScript code.
Example
The following example shows how to use onHTTPStatus to help with debugging. The
example collects HTTP status codes and assigns their value and type to an instance of the
XML object. (Notice that this example creates the instance members
this.httpStatus and
this.httpStatusType at runtime.) The onData handler uses these instance members to
trace information about the HTTP response that can be useful in debugging.
var myXml = new XML();
myXml.onHTTPStatus = function(httpStatus) {
this.httpStatus = httpStatus;
if(httpStatus < 100) {
this.httpStatusType = "flashError";
}
else if(httpStatus < 200) {
this.httpStatusType = "informational";
}
else if(httpStatus < 300) {
this.httpStatusType = "successful";
}
else if(httpStatus < 400) {
this.httpStatusType = "redirection";
}
else if(httpStatus < 500) {
this.httpStatusType = "clientError";
}
else if(httpStatus < 600) {
this.httpStatusType = "serverError";
}
}
myXml.onData = function(src) {
trace(">> " + this.httpStatusType + ": " + this.httpStatus);