ContentCache

包	spark.core
类	public class ContentCache
继承	ContentCache EventDispatcher Object
实现	IContentLoader

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

为 BitmapImage 和 Spark Image 组件提供适合使用共享图像缓存的缓存和队列图像内容加载器。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		enableCaching : Boolean 启用缓存行为和功能。	ContentCache
		enableQueueing : Boolean 启用队列行为和功能。	ContentCache
		maxActiveRequests : int 启用队列时同时处于活动状态的请求最大数量。	ContentCache
		maxCacheEntries : int 基于 MRU 的缓存的最大大小。	ContentCache
		numCacheEntries : int [只读] 活动/正在使用的缓存条目计数。	ContentCache

受保护的属性

	属性		由以下参数定义
		activeRequests : LinkedList 当前执行排队的 CacheEntryNode 实例的列表。	ContentCache
		cachedData : Dictionary 源到 CacheEntryNode 的映射。	ContentCache
		cacheEntries : LinkedList CacheEntryNode 实例的有序 (MRU) 列表。	ContentCache
		priorityGroup : String = "_DEFAULT_" 当前按优先级排列的内容分组的标识符。	ContentCache
		requestQueue : LinkedList 排队的 CacheEntryNode 实例的列表。	ContentCache

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		ContentCache() 构造函数。	ContentCache
		addCacheEntry(source:Object, value:Object):void 将新条目添加到缓存（或替换现有条目）。	ContentCache
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getCacheEntry(source:Object):Object 如果存在，则获取给定键的条目。	ContentCache
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		load(source:Object, contentLoaderGrouping:String = null):ContentRequest 为由指定的键标识的资源启动内容请求。	ContentCache
		prioritize(contentLoaderGrouping:String):void 将内容分组提升到加载队列的开头。	ContentCache
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeAllCacheEntries():void 将缓存内容重置为初始空状态。	ContentCache
		removeAllQueueEntries():void 将队列重置为初始空状态。	ContentCache
		removeCacheEntry(source:Object):void 从缓存中删除特定条目。	ContentCache
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
invalidateLoader	在缓存条目无效时调度，在确定条目不受信任，同时一个或多个未处理的加载请求对于给定缓存条目处于活动状态时，通常会发生这种情况。	ContentCache

受保护的常量

	常量		由以下参数定义
		UNTRUSTED : String = "untrusted" [静态] 用于标记检测到的来自不受信任的源（意味着它们将不再为可共享）的缓存 URL 的值。	ContentCache

属性详细信息

activeRequests

属性

protected var activeRequests:LinkedList

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

当前执行排队的 CacheEntryNode 实例的列表。

cachedData

属性

protected var cachedData:Dictionary

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

源到 CacheEntryNode 的映射。

cacheEntries

属性

protected var cacheEntries:LinkedList

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

CacheEntryNode 实例的有序 (MRU) 列表。

enableCaching

属性

enableCaching:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

启用缓存行为和功能。仅适用于新 load() 请求。

默认值为 true。

实现
public function get enableCaching():Boolean
public function set enableCaching(value:Boolean):void

enableQueueing

属性

enableQueueing:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

启用队列行为和功能。仅适用于新 load() 请求。

默认值为 false。

实现
public function get enableQueueing():Boolean
public function set enableQueueing(value:Boolean):void

maxActiveRequests

属性

maxActiveRequests:int

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

启用队列时同时处于活动状态的请求最大数量。

默认值为 2。

实现
public function get maxActiveRequests():int
public function set maxActiveRequests(value:int):void

maxCacheEntries

属性

maxCacheEntries:int

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

基于 MRU 的缓存的最大大小。当 numCacheEntries 超过 maxCacheEntries 时，则修剪最近使用的条目以适应最大数量。

默认值为 100。

实现
public function get maxCacheEntries():int
public function set maxCacheEntries(value:int):void

numCacheEntries

属性

numCacheEntries:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

活动/正在使用的缓存条目计数。

实现
public function get numCacheEntries():int

priorityGroup

属性

protected var priorityGroup:String = "_DEFAULT_"

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

当前按优先级排列的内容分组的标识符。

默认值为 "_DEFAULT_"。

requestQueue

属性

protected var requestQueue:LinkedList

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

排队的 CacheEntryNode 实例的列表。

构造函数详细信息

()

构造函数

public function ContentCache()

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

方法详细信息

addCacheEntry

()

方法

public function addCacheEntry(source:Object, value:Object):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

将新条目添加到缓存（或替换现有条目）。

参数

	`source:Object` — 要与缓存中提供的值关联的唯一键。

	`value:Object` — 要为给定键缓存的值。

getCacheEntry

()

方法

public function getCacheEntry(source:Object):Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

如果存在，则获取给定键的条目。

参数

source:Object — 用于表示请求的内容资源的唯一键。

Object — 针对提供的键由缓存存储的值。如果未找到或此值很可能存储为 null，则返回 null。

load

()

方法

public function load(source:Object, contentLoaderGrouping:String = null):ContentRequest

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.5

为由指定的键标识的资源启动内容请求。

参数

	`source:Object` — 用于表示请求的内容资源的唯一键。此参数一般为 URL 或 URLRequest。

	`contentLoaderGrouping:String` (default = `null`) — -（可选）已加载的资源的分组标识符。支持内容组的 ContentLoader 实例通常允许命名相同的分组中的资源作为一个整体进行处理。例如，ContentCache 的加载器队列允许通过 contentLoaderGrouping 排列请求的先后顺序。

ContentRequest — 表示请求的资源的 ContentRequest 实例。

prioritize

()

方法

public function prioritize(contentLoaderGrouping:String):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

将内容分组提升到加载队列的开头。

参数

contentLoaderGrouping:String — 要在加载队列中提升的内容分组的名称。所有带有匹配的 contentLoaderGroup 的排队请求都将移动到队列的开头。

removeAllCacheEntries

()

方法

public function removeAllCacheEntries():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

将缓存内容重置为初始空状态。

removeAllQueueEntries

()

方法

public function removeAllQueueEntries():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

将队列重置为初始空状态。取消所有请求（包括活动的请求和排队的请求）。所有与取消的请求相关联的缓存条目将无效。

removeCacheEntry

()

方法

public function removeCacheEntry(source:Object):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 1.5

从缓存中删除特定条目。

参数

source:Object — 要从缓存中删除的值的唯一键。

事件详细信息

invalidateLoader

事件

事件对象类型: spark.events.LoaderInvalidationEvent
属性 LoaderInvalidationEvent.type = spark.events.LoaderInvalidationEvent

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10, AIR 2.0

在缓存条目无效时调度，在确定条目不受信任，同时一个或多个未处理的加载请求对于给定缓存条目处于活动状态时，通常会发生这种情况。由于缓存条目被视为“不能共享”，所以此机制允许重置任何未处理的内容请求。然后，每个通知的内容请求都会尝试重新请求资源。

常量详细信息

UNTRUSTED

常量

protected static const UNTRUSTED:String = "untrusted"

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 9, AIR 1.1

用于标记检测到的来自不受信任的源（意味着它们将不再为可共享）的缓存 URL 的值。

法律声明 | 在线隐私策略

ContentCache - AS3 Flex

包x

语言元素

附录

包 spark.core

activeRequests

cachedData

cacheEntries

enableCaching

enableQueueing

maxActiveRequests

maxCacheEntries

numCacheEntries

priorityGroup

requestQueue

ContentCache

addCacheEntry

getCacheEntry

load

prioritize

removeAllCacheEntries

removeAllQueueEntries

removeCacheEntry

invalidateLoader

UNTRUSTED