User Guide

32 Server-Side ActionScript Language Reference
If there are several simultaneous connection requests for an application, the server serializes
the requests so there is only one
application.onConnect handler executing at a time. It is a
good idea to write code for the
application.onConnect function that executes quickly to
prevent a long connection time for clients.
Example
The following examples show the three basic uses of the onConnect handler:
(Usage 1)
application.onConnect = function (clientObj [, p1, ..., pN]){
// Insert code here to call methods that do authentication.
// Returning null puts the client in a pending state.
return null;
};
(Usage 2)
application.onConnect = function (clientObj [, p1, ..., pN]){
// Insert code here to call methods that do authentication.
// The following code accepts the connection:
application.acceptConnection(clientObj);
};
(Usage 3)
application.onConnect = function (clientObj [, p1, ..., pN])
{
// Insert code here to call methods that do authentication.
// The following code accepts the connection by returning true:
return true;
};
The following example verifies that the user has sent the password “XXXX”. If the password is
sent, the user’s access rights are modified, and the user can complete the connection. In this
case, the user can create or write to streams and shared objects in the user’s own directory and
can read or view any shared object or stream in this application instance.
// This code should be placed in the global scope.
application.onConnect = function (newClient, userName, password){
// Do all the application-specific connect logic.
if (password == "XXXX"){
newClient.writeAccess = "/" + userName;
this.acceptConnection(newClient);
} else {
var err = new Object();
err.message = "Invalid password";
this.rejectConnection(newClient, err);
}
};
NOTE
If you are using the Component framework (that is, you are loading the components.asc
file in your server-side script file) you must use the
Application.onConnectAccept method
to accept client connections. For more information see
Application.onConnectAccept.