Options
All
  • Public
  • Public/Protected
  • All
Menu

Class ResourceService

资源管理器,提供了资源的加载、更新和删除操作,支持从配置文件或者构造参数构建资源,提供了资源ID级别的事件监听 具有复用价值的资源才需要使用管理器管理

Hierarchy

Index

Constructors

Properties

registerCreator: ((resourceType: string, creator: ResourceCreator) => void) = ResourceService.registerCreator

Type declaration

    • 注册资源的构建器

      static
      memberof

      ResourceService

      Parameters

      • resourceType: string

        支持的资源类型

      • creator: ResourceCreator

        构建函数

      Returns void

EventTypes: { resAdd: string; resLoaded: string; resRemoved: string; resUpdated: string } = ...

资源的事件基类型,监听某个具体资源的事件,可以使用 基类型+":"+资源ID 进行监听,如: res:add:style1(即ResourceService.EventTypes.resAdd+":"+"style1" ),表示对style1这个资源的增删改进行监听

static
memberof

ResourceService

Type declaration

  • resAdd: string

    当资源第一次被加载之后触发

  • resLoaded: string

    当资源被加载之后触发(第一次加载或者更新都会触发)

  • resRemoved: string

    当资源被移出之后触发

  • resUpdated: string

    当资源被更新后触发

Methods

  • addResource(key: string, resourceObj: IResourceObject, updateIfExists?: boolean): void
  • 添加一个资源实例

    memberof

    ResourceService

    Parameters

    • key: string

      资源ID

    • resourceObj: IResourceObject

      实例对象

    • updateIfExists: boolean = false

      资源存在的时候是否进行更新,默认为否

    Returns void

  • 获取一个资源实例

    memberof

    ResourceService

    Parameters

    • key: string

      要获取的key

    Returns IResourceObject

    {*} 资源实例

  • hasResource(key: string): boolean
  • 检查是否存在指定key的资源实例

    memberof

    ResourceService

    Parameters

    • key: string

    Returns boolean

    {boolean} 返回是否存在

  • listens(type: any, propagate?: any): boolean
  • Parameters

    • type: any
    • Optional propagate: any

    Returns boolean

  • 加载一个资源实例

    memberof

    ResourceService

    Parameters

    • resourceInfo: IResourceInfo

      资源描述信息。

    • updateIfExists: boolean = false

      如果当前资源已经存在,则更新。默认为否

    Returns Promise<IResourceObject>

    {Promise} 返回一个Promise对象,当资源加载完成后进行回调

  • loadResourceFromConfig(resourceConfig: any, updateIfExists?: boolean): Promise<IResourceObject[]>
  • 从资源配置对象信息加载资源

    memberof

    ResourceService

    Parameters

    • resourceConfig: any

      资源配置对象。 预定义的资源集合配置对象。 如果希望增加自定义的资源支持,可以注册creator用于创建自定义类型的资源实例 该对象中的key就是资源的类型 每一个二级对象中的key表示具体资源的唯一ID,如下所示

      //这里是资源的类型
      featureStyles:{
      //这里是资源的ID
      style1:{
      },
      style2:{
      }
      },
      images:{
      img1:"",
      img2:""
      }
    • updateIfExists: boolean = false

      如果资源存在的时候,是否重新加载。默认为false,表示不重新加载。 注意如果是相同的资源应该只在一个地方加载

    Returns Promise<IResourceObject[]>

    {Promise<IResourceObject[]>} 返回一个Promise对象,当所有资源全部加载完成后回调

  • loadResourceFromConfigPath(requestInfo: RequestInfo, init?: RequestInit, updateIfExists?: boolean): Promise<IResourceObject[]>
  • 从一个配置地址请求资源。 该配置文件返回的信息为预定义的资源集合配置对象。 如果希望增加自定义的资源支持,可以注册creator用于创建自定义类型的资源实例 该对象中的key就是资源的类型 每一个二级对象中的key表示具体资源的唯一ID,如下所示

    //这里是资源的类型
    featureStyles:{
    //这里是资源的ID
    style1:{
    },
    style2:{
    }
    },
    images:{
    img1:"",
    img2:""
    }
    memberof

    ResourceService

    Parameters

    • requestInfo: RequestInfo

      请求信息 绝对路径请以/开头,否则认为是相对于静态资源目录下的目录(consts.resourcePath中配置静态资源目录,默认是public)

    • Optional init: RequestInit
    • updateIfExists: boolean = false

      如果资源存在的时候,是否重新加载。默认为false,表示不重新加载。 注意如果是相同的资源应该只在一个地方加载

    Returns Promise<IResourceObject[]>

    {Promise<IResourceObject[]>}

  • 加载一组资源

    memberof

    ResourceService

    Parameters

    Returns Promise<IResourceObject[]>

    {Promise<IResourceObject[]>} 返回一个Promise对象,当所有资源加载完成后回调,当有一个资源出现失败即加载失败

  • Parameters

    • types: any
    • fn: any
    • Optional context: any

    Returns ResourceService

  • removeResource(key: string): boolean
  • 移除一个资源实例

    memberof

    ResourceService

    Parameters

    • key: string

      要移除的key

    Returns boolean

    {boolean} 返回是否成功移除

  • unlock(fireLocked?: boolean): void
  • Parameters

    • fireLocked: boolean = true

    Returns void

  • 添加指定资源第一次增加的监听(删除后再添加也算第一次增加)

    memberof

    ResourceService

    Parameters

    Returns Promise<IResourceObject>

  • whenResourceLoaded(key: string, loaded: ((resource: IResourceObject) => void)): void
  • 添加指定资源被加载后的回调

    memberof

    ResourceService

    Parameters

    Returns void

  • whenResourceRemoved(key: string, removed: ((resource: IResourceObject) => void)): void
  • 添加指定资源被移出后的回调

    memberof

    ResourceService

    Parameters

    Returns void

  • 注册资源的构建器

    static
    memberof

    ResourceService

    Parameters

    • resourceType: string

      支持的资源类型

    • creator: ResourceCreator

      构建函数

    Returns void

Generated using TypeDoc