NetDebugConfig Class | Flash 6 |
contains properties of the current debug settings |
Returns the current state of debugging.
Allows you to set the state of debugging.
Flash Remoting events that occur on the application server or in the Flash Gateway on the server.
Flash Remoting activity from the client.
Flash Communication Server MX events.
The NetDebugConfig object is included when you include the NetDebug.as file in your Flash Remoting application. It holds the properties of your current NetConnection debugger configuration and also allows you to turn NetConnection debugging on and off for ActionScript objects. To use the NetDebugConfig object for your specific connection, retrieve it with the NetConnection.getDebugConfig( ) method:
var myConfigObject = myConnection.getDebugConfig( );
You can then call methods on the NetDebugConfig object to turn debugging on and off programmatically and set the status of reporting for individual events. The events are associated with one of the properties of the object (app_server, client, or flashcomm_server/realtime_server), each of which are objects in their own right. Events for which debugging is active are logged in the NetConnection Debugger panel. The full listing of events is shown in Table 15-2.
Event |
Default |
Description |
---|---|---|
app_server.amf |
false |
Server AMF events |
app_server.amfheaders |
false |
AMF headers from the Flash Remoting gateway |
app_server.coldfusion |
true |
ColdFusion debug events if ColdFusion Server debug mode is on |
app_server.error |
true |
Any error that occurs on the server |
app_server.httpheaders |
false |
HTTP headers from the server |
app_server.recordset |
true |
Events from pageable recordsets |
app_server.trace |
true |
Trace events on the server |
client.http |
true |
Client-initiated HTTP events such as connections and service calls |
client.recordset |
true |
Pageable recordset events |
client.rtmp |
true |
Flash Communication Server client events which use Real Time Messaging Protocol (RTMP); not used by Flash Remoting |
client.trace |
true |
Client NetConnection.trace( ) events |
flashcomm_server.tracerealtime_server.trace |
true |
Flash Communication Server trace events |
To retrieve individual settings of the NetDebugConfig object, use dot notation to address the event type and the event. Remember to retrieve the object using NetConnection.getDebugConfig( ) first:
debugConfigObj = my_conn.getDebugConfig( ) trace(debugConfigObj.client.http);
The preceding code displays true in the Output window if the client.http debug setting is turned on. To turn it off, simply set the property to false:
debugConfigObj.client.http = false;
You can disable all debugging to the NetConnection debugger for the specified object using:
debugConfigObj.setDebug(false);
For more information on the NetConnection debugger and the NetDebugConfig object see:
NetConnection.getDebugConfig( ), the NetDebug object; Chapter 13