资源回收 Dispsable

---

在进行开发的时候，或多或少会使用到各种资源，如计时器、Http请求、事件监听
、数据库连接等等，而在使用完资源之后，是需要程序员记得去释放这些资源的。
为此提供了 Disposable 模块，负责资源回收操作。模块中也提供了 Groupdisposable、Uniquedisposable，用于不同的回收策略。

1 统一看待回收的资源

由于资源类型的不同，因此不同的资源会有不同的方式去释放它们。

--定义一个每2秒执行一个计时器
local timer = setInterval(function()
        print("每2秒打印一次")
    end, 2)

--忽略其他代码

--撤销计时器，并释放资源
timer:invalidate()
       代码1

--定义一个http请求
local httpReq = getApplication():getHttpComponent():sendHTTPRequest(url, method, requestHeaders, postBody, bNeedEncrypt, timeout, cb, cachePolicy)

--忽略其他代码

--若请求还没发送成功，取消http请求
httpReq:cancelHttpRequest()
       代码2

而当程序员接触到的资源类型变的越来越多的时候，就需要记忆多种不同的释放接口，同时对资源的管理也会变的更加不容易。
为减轻程序员负担，ColorTouch中将需要释放的资源统一看作是一种类型：Disposable，通过disposable.dispose()方法释放资源。由此代码1，2可写成代码3，4的样子。</br>

--定义一个每2秒执行一个计时器
local timerDisposable = setInterval(function()
        print("每2秒打印一次")
    end, 2)

--忽略其他代码

--撤销计时器，并释放资源
timerDisposable.dispose()
       代码3

--定义一个http请求
local httpReqDisposable = getApplication():getHttpComponent():sendHTTPRequest(url, method, requestHeaders, postBody, bNeedEncrypt, timeout, cb, cachePolicy)

--忽略其他代码

--若请求发送成功，取消http请求的发送
httpReqDisposable.dispose()
       代码4

2 不同的回收策略

程序员不仅需要记得释放资源，也需要提供策略决定何时释放资源。比较常见的有如下2种情况：

• 在一个 ViewController(Activity) 实例的生存期间，程序员需要使用了各种资源，而在ViewController(Activity) pop(finish) 的时候，释放全部的资源。
• 程序中可能需要多次发送http请求，而如果前一个http请求还未发送成功，则需要被取消掉，从而保证正在发送的请求仅有一个

为分别应对这 2 种需求，提供了 GroupDisposable、UniqueDisposable 这 2 种不同的资源管理策略。

• GroupDisposable 用来收集全部的待回收的资源，并统一回收

--引用GroupDisposable的模块
local GroupDisposable = require "stdlib.Disposable.GroupDisposable"
--定义一个GroupDisposable实例
local groupDisposable = GroupDisposable()

--自定义3个拥有dispose接口的实例，用来模拟需要释放的资源
local disposable0 = {}
disposable0.dispose = function()
    print("dispose disposable0")
  end
local disposable1 = {}
disposable1.dispose = function()
    print("dispose disposable1")
  end
local disposable2 = {}
disposable2.dispose = function()
    print("dispose disposable2")
  end

--将3个资源实例添加进groupDisposable
print("add disposable0")
groupDisposable.addDisposable(disposable0)
print("add disposable1")
groupDisposable.addDisposable(disposable1)
print("add disposable2")
groupDisposable.addDisposable(disposable2)

--统一释放资源
print("\ndispose groupDisposable")
groupDisposable.dispose()
      代码5

运行结果：
add disposable0
add disposable1
add disposable2

dispose groupDisposable
dispose disposable0
dispose disposable1
dispose disposable2

• UniqueDisposable用来保证待回收的资源为最新添加的 Disposable，每次添加会将老的Disposable 回收，并将新的 Disposable 覆盖老的 Disposable

--引用UniqueDisposable的模块
local UniqueDisposable = require "stdlib.Disposable.UniqueDisposable"
--定义一个UniqueDisposable实例
local uniqueDisposable = UniqueDisposable()

--将3个资源实例添加进uniqueDisposable
print("add disposable0")
uniqueDisposable.addDisposable(disposable0)
print("add disposable1")
uniqueDisposable.addDisposable(disposable1)
print("add disposable2")
uniqueDisposable.addDisposable(disposable2)

--统一释放资源
print("\ndispose uniqueDisposable")
uniqueDisposable.dispose()
      代码6

运行结果：
add disposable0
add disposable1
dispose disposable0
add disposable2
dispose disposable1

dispose uniqueDisposable
dispose disposable2

3 自由组合 Disposable

模块中提供 GroupDisposable、UniqueDisposable，可添加其他 Disposable。同时GroupDisposable、UniqueDisposable 也是 Disposable 类型，可作为子 Disposable。由此各种资源就可以任意组合，对于程序员来说也能方便地定制出自己需要的资源管理策略

--引用GroupDisposable的模块
local GroupDisposable = require "stdlib.Disposable.GroupDisposable"
--引用UniqueDisposable的模块
local UniqueDisposable = require "stdlib.Disposable.UniqueDisposable"

local uniqueDisposable = UniqueDisposable()
uniqueDisposable.addDisposable(disposable0)
uniqueDisposable.addDisposable(disposable1)

local groupDisposable = GroupDisposable()
groupDisposable.addDisposable(disposable2)
groupDisposable.addDisposable(uniqueDisposable)

groupDisposable.dispose()

由于 Disposable 的多次组合，很可能在一个 groupDisposable 或 uniqueDisposable 中存在重复的 Disposable 对象。为了进一步减轻程序员的负担，同时也为了方便资源的管理，Disposable 类型的数据允许多次调用 dispose 函数，其中仅有第一次调用会真正的释放资源，后续的重复调用并不做事情。