FMS-应用程序类(Application class)

应用程序类(Application class)

可用性

Flash Communication Server 1.

应用程序类包含关于FLash Media Server应用程序实例的的信息，它持续到应用程序实例被卸载。一个Flash Media Server应用程序是流对象(stream objects)，共享对象(shared objects)和客户(已经连接的用户)的集合。每个应用程序有唯一的名字，并且你可以使用命名方案去创建应用程序的若干实例。更多关于命名方案，请查看"使用命名约定"。

每一个FLash Media Serve应用程序的实例都有一个application对象，它是一个单独的应用程序类的实例。你不需要使用构造函数去创建application对象；它会在应用程序被服务器实例化时自动被创建。使用如下语法掉用应用程序类的方法，属性和处理事件:

application.methodPropertyOrHandler(方法属性或者事件处理);

使用application对象去接受和拒绝客户的连接请求，注册和不注册类和代理，和当一个应用程序启动或停止，或者当一个客户连接或断开连接时创建一些函数来处理。有关更多关于应用程序的生命周期的信息，请查看开发多媒体应用程序中的"应用程序流程(application flow)"。

除了内置的应用程序类的属性外，你可以创建其他的属性(必须为任何合法的动作脚本类型)，包含其他的动作脚本对象参考。举个例子，如下的代码创建一个新的数组类型属性和一个新的数字类型属性。

application.myarray = new Array();
application.num_requests = 1;

应用对象类的方法摘要
方法(Method)	描述(Description)
Application.acceptConnection()	应用程序接收一个来自客户的连接
Application.broadcaseMsg()	为当前所有的已连接客户广播一个消息
Application.clearSharedObjects()	清除所有和当前应用程序实例相关联的共享对象
Application.clearStreams()	清除所有和当前应用程序实例相关联的流对象
Application.disconnect()	一个用户从服务器断开时执行
Application.gc()	调用垃圾回收器来收回应用程序实例所有不使用的资源
Application.getStats()	返回应用程序实例的网络统计量信息
Application.registerClass()	在对象反序列化期间注册或不注册一个构造函数
Application.registerProxy()	注册一个NetConnection或者Client对象来完成一方法请求
Application.rejectConnection()	拒绝一个到应用程序的连接
Application.shutdown()	卸载应用程序实例
应用程序实例属性摘要
属性(Property)	描述(Description)
Application.allowDebug	一个布尔值，用来让管理员使用服务器动作脚本的approveDebugSession()方法可以(true)或者不可以(flase)访问你的Flash Media Server应用程序
Application.clients	只读；一个包含当前所有连接到应用程序的客户列表对象
Application.config	让你访问Application.xml配置文件中ApplicationObject标签的属性
Application.hostname	只读服务器或缺省虚拟主机的主机名称，和非缺省虚拟主机的虚拟主机名称。
Application.server	只读服务器的运行平台和版本
应用程序类事件处理摘要
事件处理(Event handler)	描述(Description)
Application.onAppStart	当应用程序被服务器载入时调用
Application.onAppStop	当应用程序被服务器卸载时调用
Application.onConnect	当客户端连接到应用程序时调用
Application.onConnectAccept	当客户端成功连接到应用程序时调用;仅能和多媒体组件一起使用
Application.onConnectReject	当服务端连接到应用程序失败时调用;仅能和通讯组件一起使用
Application.onDisconnect	当客户端断开到应用程序时调用
Application.onStatus	当脚本发生错误时调用