Flash Remoting: The Definitive Guide

Name

NetConnection.setDebugId( ) Method

Synopsis

                     myNetConnectionObject.setDebugId(id)

Arguments

id

An arbitrary header name that can be recognized by the server.

Description

The setDebugId( ) method is used to specify an identifier for a NetConnection object. Each NetConnection object has an associated identifier that is typically a sequential integer. For example, if you call getDebugId( ) on a NetConnection object that is the only object in your movie, you will receive an ID of 0. To change this to a meaningful value, you can use the setDebugId( ) method.

The code syntax completion of Flash Remoting, as well as the Flash Remoting documentation, lists the syntax as setDebugID (capital I and D), but the correct spelling is setDebugId( ) (lowercase d ).

Example

The following code shows the basic syntax of the setDebugId( ) method:

if (connected == null) {
  connected = true;
  NetServices.setDefaultGatewayUrl("http://127.0.0.1/flashservices/gateway");
  var my_conn = NetServices.createGatewayConnection( );
  my_conn.setDebugId("Connection");
}

See Also

NetConnection.getDebugId( ), NetConnection.setCredentials( ); Chapter 13