(仅限 BlazeDS)
mx.messaging.config
public class ServerConfig
继承ServerConfig Inheritance Object

此类提供对服务器消息传送配置信息的访问权限。此类可以将 services-config.xml 文件中的信息封装在客户端上,消息传送系统可利用这些信息为消息传递框架提供配置的 ChannelSet 和 Channel。

在编译过程中将提供 XML 源。但是,当前没有用于阻止通过其它方式(如网络、本地文件系统和运行时共享对象)获得 XML 数据的内部限制。



公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  xml : XML
[静态] XML 配置,此值必须包含 services-config.xml 文件中相关的 <services> 标记部分。
ServerConfig
公共方法
 方法定义方
  
checkChannelConsistency(destinationA:String, destinationB:String):void
[静态] 此方法可确保指定的目标包含相同的通道定义。
ServerConfig
  
getChannel(id:String, clustered:Boolean = false):Channel
[静态] 返回已配置的 Channel 的共享实例。
ServerConfig
  
[静态] 返回共享的 ChannelSet 以使用指定目标,该目标属于处理指定消息类型的服务。
ServerConfig
  
[静态] 返回指定目标的属性信息。
ServerConfig
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信息
xml属性
xml:XML  [读写]

XML 配置,此值必须包含 services-config.xml 文件中相关的 <services> 标记部分。



实现
    public static function get xml():XML
    public function set xml(value:XML):void
方法详细信息
checkChannelConsistency()方法
public static function checkChannelConsistency(destinationA:String, destinationB:String):void

此方法可确保指定的目标包含相同的通道定义。如果指定的两个目标之间的通道定义不同,则此方法将引发 ArgumentError。

参数

destinationA:String — destinationA:String 要与之比较的第一个目标
 
destinationB:String — destinationB:String 要与之比较通道的第二个目标

getChannel()方法 
public static function getChannel(id:String, clustered:Boolean = false):Channel

返回已配置的 Channel 的共享实例。

参数

id:String — 所需 Channel 的 id。
 
clustered:Boolean (default = false) — 如果以群集化方式使用 Channel,则为 true,否则为 false。

返回
Channel — Channel 实例。

引发
InvalidChannelError — 如果所有 Channel 都没有指定的 ID。
getChannelSet()方法 
public static function getChannelSet(destinationId:String):ChannelSet

返回共享的 ChannelSet 以使用指定目标,该目标属于处理指定消息类型的服务。

参数

destinationId:String — 目标 ID。

返回
ChannelSet — ChannelSet。

引发
InvalidDestinationError — 如果指定目标不包含通道,并且应用程序没有定义默认通道。
getProperties()方法 
public static function getProperties(destinationId:String):XMLList

返回指定目标的属性信息。

参数

destinationId:String — 所需目标的 ID。

返回
XMLList — 包含 <property> 标记信息的 XMLList。

引发
InvalidDestinationError — 如果找不到指定目标。