类扩展

扩展基础类结构，完善事件、异常处理机制

TObject

• 说明
  • 以ES6规范，生成的基础类
  • 扩展了异常处理机制
  • 扩展了事件挂载处理机制
• 类函数
  • create()
    • 说明
      • 类对象初始化
    • 返回
      • object
• 函数
  • free()
    • 说明
      • 类对象释放
  • on(key, func)
    • 说明
      • 事件绑定
    • 参数
      • key 事件名称
      • func 事件函数
    • 返回
      • this
  • off([key], [func])
    • 说明
      • 事件移除
    • 参数
      • key 事件名称
      • func 事件函数
        • func不为空时，会遍历key事件删除特定回调函数
        • func为空时，删除全部key事件
      • 参数为空时，删除全部绑定事件
    • 返回
      • this
  • async call(key, [arg...])
    • 说明
      • 触发事件，当回调内容中含有异步函数时，会采用await方式处理
    • 参数
      • key 事件名称
      • arg 触发事件时，代入参数
    • 返回
      • this
  • getError(index)
    • 说明
      • 获取错误信息
    • 参数
      • index 错误记录序号
    • 返回
      • {level,code,msg} 错误信息
        • level 错误等级，log/info/error
        • code 错误编号
        • msg 错误消息
  • setError(level, code, msg)
    • 说明
      • 设置错误信息，并触发error事件
    • 参数
      • level 错误等级，log/info/error
      • code 错误编号
      • msg 错误消息
    • 返回
      • {level,code,msg} 错误信息
        • level 错误等级，log/info/error
        • code 错误编号
        • msg 错误消息
  • clearError()
    • 说明
      • 清空错误信息
    • 返回
      • this
• 属性
  • className
    • 说明
      • 类名，后续所有子类需要以自身类名改写
        • 通过在constructor函数中改写__className
    • 只读
    • 返回
      • string
  • errorMax
    • 说明
      • 错误记录最大值
    • 读写
    • 返回
      • number
  • lastError
    • 说明
      • 最后一次错误记录
    • 只读
    • 返回
      • {level,code,msg} 错误信息
        • level 错误等级，log/info/error
        • code 错误编号
        • msg 错误消息

---

TSeal

• 说明
  • 以函数挂载方式，生成的基础类
  • 扩展了异常处理机制，同TObject
  • 扩展了事件挂载处理机制，同TObject
• 类函数
  • extend(childAPI)
    • 说明
      • 以childAPI为子项进行继承（深复制方式）
    • 参数
      • childAPI api集合对象
    • 返回
      • class函数
• 函数
  • clone()
    • 说明
      • 复制类对象本身，包含当前已更改的属性内容及状态

---

TCache

• 说明
  • 缓存处理类，基于Buffer对象，对缓存进行循环运用
  • 继承于 TObject
• 类函数
  • alloc([max=128])
    • 说明
      • 创建TCache对象
    • 参数
      • max 缓存大小
    • 返回
      • 返回 TCache对象
• 函数
  • valueOf()
    • 说明
      • 对象真实值，Buffer对象
    • 返回
      • 返回 Buffer对象
  • resize([force=false])
    • 说明
      • 调整 缓存数据块位置，类似内存整理
    • 参数
      • force=false 是否强制进行内存整理
        • force=false时，会检测是否存在数据，并移动数据块位置到缓存头部，空闲出尾部未使用区域
    • 返回
      • 返回 剩余空间大小
  • clear()
    • 说明
      • 清空缓存
    • 返回
      • 返回 TCache对象
  • push(buf)
    • 说明
      • 填充数据
    • 参数
      • buf 填充目标数据，Buffer对象
    • 返回
      • 返回 TCache对象
  • remove(size)
    • 说明
      • 删除数据，从可用数据头部开始删除
    • 参数
      • size 删除数据数量
    • 返回
      • 返回 TCache对象
• 属性
  • max
    • 说明
      • 缓存大小，单位字节
    • 只读
    • 返回
      • number
  • index
    • 说明
      • 数据开始位置
    • 只读
    • 返回
      • number
  • length
    • 说明
      • 数据大小，单位字节
    • 只读
    • 返回
      • number
  • offset
    • 说明
      • 可用缓存开始位置
    • 只读
    • 返回
      • number
  • surplus
    • 说明
      • 可用缓存大小
    • 只读
    • 返回
      • number

---

TList

• 说明
  • 队列处理基类，基于Array对象，对队列进行扩展
  • 衍生出 堆、栈、泛型堆、泛型栈 等扩展形式
  • 继承于 TObject

---

TChinaDate

• 说明
  • 农历时间处理类，基于Date对象，对时间进行转换计算
  • 包含农历相关的天干、地支、节气、五行计算
  • 继承于 TObject
• 类函数
  • toString([fmt], [date])
    • 说明
      • 时间转字符串显示
    • 参数
      • fmt=Y年(Z) M月 D T 字符串转换格式
        • 转换格式同TChinaDate对象的toString函数
      • date 需要转换的Date对象，默认是当前时间
    • 返回
      • 返回 string
• 函数
  • valueOf()
    • 说明
      • 对象真实值
    • 返回
      • 返回 number，内置Date对象的getTime()
  • getTime()
    • 说明
      • 获取当前时间的毫秒数
    • 返回
      • 返回 number
  • setTime(dt)
    • 说明
      • 设置当前时间为dt
    • 参数
      • dt 目标时间
        • dt=number时，作为毫秒设定时间
        • dt=Date对象时，作为Date设定时间
    • 返回
      • 返回 this
  • toString([fmt])
    • 说明
      • 以fmt格式，转换当前时间为字符串
    • 参数
      • fmt=Y年(Z) M月 D T 字符串转换格式
        • CY 农历年
        • CM 农历月
        • CD 农历日
        • Y 年
        • M 月
        • D 日
        • T 24节气
        • Z 生肖
    • 返回
      • 返回 string
• 属性
  • Year
    • 说明
      • 当前年
    • 只读
    • 返回
      • string
  • Month
    • 说明
      • 当前月
    • 只读
    • 返回
      • string
  • Day
    • 说明
      • 当前日
    • 只读
    • 返回
      • string
  • CYear
    • 说明
      • 当前农历年
    • 只读
    • 返回
      • string
  • CMonth
    • 说明
      • 当前农历月
    • 只读
    • 返回
      • string
  • CDay
    • 说明
      • 当前农历日
    • 只读
    • 返回
      • string
  • Term
    • 说明
      • 当前节气
    • 只读
    • 返回
      • string
  • Zodiac
    • 说明
      • 当前生肖
    • 只读
    • 返回
      • string
  • IsLeapYear
    • 说明
      • 当前年是否是农历闰年
    • 只读
    • 返回
      • string

---

TGuid

• 说明
  • Guid转换类，无法通过硬件信息生成真实guid，只能模拟数据
  • guid值的判定及转换
  • 继承于 TObject
• 类函数
  • toString()
    • 说明
      • 获取新Guid并转换成字符串
    • 返回
      • 返回 string
  • toByteArray()
    • 说明
      • 获取新Guid并转换成字节数组
    • 返回
      • 返回 array
  • New()
    • 说明
      • 获取新Guid
    • 返回
      • 返回 TGuid对象
• 函数
  • valueOf()
    • 说明
      • 对象真实值，类似调用toString()
    • 返回
      • 返回 string
  • toString()
    • 说明
      • 转换成字符串
    • 返回
      • 返回 string
  • toByteArray()
    • 说明
      • 转换成字节数组
    • 返回
      • 返回 array
  • New()
    • 说明
      • 生成新Guid，当前this不变，替换内容
    • 返回
      • 返回 this

---

List([type])

• 说明
  • 队列函数，可以通过type限定队列类型
• 参数
  • type 限定类型，可以是类型的string值
• 返回
  • 返回 TList对象

---

ChinaDate([dt])

• 说明
  • 农历时间函数，基于TChinaDate对象
  • 基本操作模拟Date对象进行
• 参数
  • dt 带入时间值作为当前时间，可以是Number类型
• 返回
  • 返回 TChinaDate对象

---

NewGuid()

• 说明
  • 生成Guid，通过模拟方式生成Guid
  • guid值为符合规则的随机数，与硬件无关
• 返回
  • 返回 TGuid对象

---

EmptyGuid()

• 说明
  • 生成Guid，通过模拟方式生成Guid
  • guid值为全0
• 返回
  • 返回 TGuid对象