liudong
2023-05-29 340f156319b863525e50e900c58e59b86ecb3d5e
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
/**
 * MessageIdProvider
 */
declare interface IMessageIdProvider {
  /**
   * Allocate the first vacant messageId. The messageId become occupied status.
   * @return {Number} - The first vacant messageId. If all messageIds are occupied, return null.
   */
  allocate (): Number | null
 
  /**
   * Get the last allocated messageId.
   * @return {Number} - messageId.
   */
  getLastAllocated (): Number | null
 
  /**
   * Register the messageId. The messageId become occupied status.
   * If the messageId has already been occupied, then return false.
   * @param {Number} num - The messageId to request use.
   * @return {Boolean} - If `num` was not occupied, then return true, otherwise return false.
   */
  register (num: Number): Boolean
 
  /**
   * Deallocate the messageId. The messageId become vacant status.
   * @param {Number} num - The messageId to deallocate. The messageId must be occupied status.
   *                       In other words, the messageId must be allocated by allocate() or
   *                       occupied by register().
   */
  deallocate (num: Number): void
 
  /**
   * Clear all occupied messageIds.
   * The all messageIds are set to vacant status.
   */
  clear (): void
}
 
export { IMessageIdProvider }