User Guide

96 Chapter 5: The NetConnection Debugger
You can send a trace message that includes the connection ID by using the GatewayConnection
object’s
trace() method, as in the following example:
gatewayConnection.trace("I just created myService2 over this connection.");
Additionally, the getDebugId() method returns the ID set by the setDebugId() method, and
the
getDebugConfig() method returns the NetDebugConfig object for the specific connection.
For more information on using the
getDebugConfig() method, see, “Configuring debugger
output in ActionScript” on page 96.
Configuring debugger output in ActionScript
You can specify the information that the NetConnection Debugger displays by selecting options
on the debugger Filters panel, or you can do it programmatically in ActionScript. This section
describes how to use ActionScript to display debugger output. For information on using the
Filters panel, see Flash Help.
In ActionScript, you configure NetConnection Debugger output for each connection
individually. As a result, if your Flash Remoting application has multiple connections, you can
configure different levels of debugging detail for each connection.
To configure debugging output:
1. Use the Connection getDebugConfig() method to get the connection’s NetDebugConfig
object.
2. Set the required property of the NetDebugConfig object. The table in “Specific event
information” on page 89 specifies the properties you can set.
You can combine both steps in a single line, as in the following example, which turns off
application server AMF debugging messages:
gatewayConnection.getDebugConfig().app_server.amf = false;
Note: You can only use this technique to select or disable individual event types. You cannot use a
single call to select or disable all debugging information for the client, application server, or Flash
Communication Server.