Application class

Every instance of a Flash Media Server application has an Application object, which is a single instance of the Application class. You don't need to use a constructor function to create an Application object; it is created automatically when an application is instantiated by the server.

Use the Application object to accept and reject client connection attempts, to register and unregister classes and proxies, and to manage the life cycle of an application. The Application object has callback functions that are invoked when an application starts and stops and when a client connects and disconnects.

For more information about the life cycle of an application, see Adobe Flash Media Server Developer Guide.

Availability

Flash Communication Server 1

Property summary

Property	Description
`application.allowDebug`	A boolean value that lets administrators access an application with the Administration API `approveDebugSession()` method (`true`) or not (`false`).
`application.clients`	Read-only; an Array object containing a list of all the clients connected to an application.
`application.config`	Provides access to properties of the `ApplicationObject` element in the Application.xml configuration file.
`application.hostname`	Read-only; the host name of the server for default virtual hosts; the virtual host name for all other virtual hosts.
`application.name`	Read-only; the name of the application instance.
`application.server`	Read-only; the platform and version of the server.

Method summary

Method	Description
`application.acceptConnection()`	Accepts a connection call from a client to the server.
`application.broadcastMsg()`	Broadcasts a message to all clients connected to an application instance.
`application.clearSharedObjects()`	Deletes persistent shared objects files (FSO files) specified by the soPath parameter and clears all properties from active shared objects (persistent and nonpersistent).
`application.clearStreams()`	Clears recorded streams files associated with an application instance.
`application.disconnect()`	Terminates a client connection to the application.
`application.gc()`	Invokes the garbage collector to reclaim any unused resources for this application instance.
`application.getStats()`	Returns statistics about an application.
`application.redirectConnection()`	Rejects a connection and provides a redirect URL.
`application.registerClass()`	Registers a constructor function that is used when deserializing an object of a certain class type.
`application.registerProxy()`	Maps a method call to another function.
`application.rejectConnection()`	Rejects the connection call from a client to the server.
`application.shutdown()`	Unloads the application instance.

Event handler summary

Event handler	Description
`application.onAppStart()`	Invoked when the server loads an application instance.
`application.onAppStop()`	Invoked when the server is about to unload an application instance.
`application.onConnect()`	Invoked when `NetConnection.connect()` is called from the client.
`application.onConnectAccept()`	Invoked when a client successfully connects to an application; for use with version 2 components only.
`application.onConnectReject()`	Invoked when a connection is rejected in an application that contains components.
`application.onDisconnect()`	Invoked when a client disconnects from an application.
`application.onPublish()`	Invoked when a client publishes a stream to an application.
`application.onStatus()`	Invoked when the server encounters an error while processing a message that was targeted at this application instance.
`application.onUnpublish()`	Invoked when a client stops publishing a stream to an application.

Flash Media Server Developer Documentation

Application class