Class: AlWorker::NumberedMessage

Inherits:
Object
  • Object
show all
Includes:
Sync_m
Defined in:
lib/al_worker_message.rb

Overview

Numbered message queue

(note) 接続が断続的になる場合（httpなど）を想定して、 クライアントがメッセージの取りこぼしがないように、番号付きでキューを構成する。番号はトランザクションIDと称し、単調増加させる。クライアントはトランザクションIDを指定して、どこまでメッセージを得たかを管理する。メッセージオブジェクトは、Hashのみ。スレッドセーフに実装してある。

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(size = 10) ⇒ NumberedMessage

constructor

Parameters:

  • size (Integer) (defaults to: 10) —

    キューサイズ



135
136
137
138
139
140
141
 
# File 'lib/al_worker_message.rb', line 135

def initialize( size = 10 )
  super()     # Sync_m needs.
  @tid = 0
  @max_queue_size = size
  @queue = []
  @bc = AlWorker::BroadcastMessage.new()
end

Instance Attribute Details

#bc ⇒ BroadcastMessage (readonly)

Returns send/receiveのためのBroadcastMessage.

Returns:



127
128
129
 
# File 'lib/al_worker_message.rb', line 127

def bc
  @bc
end

#max_queue_size ⇒ Integer (readonly)

Returns キューサイズ.

Returns:

  • (Integer) —

    キューサイズ



121
122
123
 
# File 'lib/al_worker_message.rb', line 121

def max_queue_size
  @max_queue_size
end

#queue ⇒ Array<Hash> (readonly)

Returns メッセージキュー.

Returns:

  • (Array<Hash>) —

    メッセージキュー



124
125
126
 
# File 'lib/al_worker_message.rb', line 124

def queue
  @queue
end

#tid ⇒ Integer (readonly)

Returns トランザクションID　1から単調増加する。.

Returns:

  • (Integer) —

    トランザクションID　1から単調増加する。



118
119
120
 
# File 'lib/al_worker_message.rb', line 118

def tid
  @tid
end

Instance Method Details

#add(msg) ⇒ Integer

Note:

:TIDが予約語としてメッセージ内に追加される。

キューへメッセージ追加

Parameters:

  • msg (Hash) —

    メッセージ

Returns:

  • (Integer) —

    トランザクションID



153
154
155
156
157
158
159
160
161
162
 
# File 'lib/al_worker_message.rb', line 153

def add( msg )
  synchronize( Sync::EX ) {
    msg[:TID] = (@tid += 1)
    @queue << msg
    while @queue.size > @max_queue_size
      @queue.shift
    end
    return @tid
  }
end

#cycle(tid, timeout = nil) ⇒ Object

Note:

メッセージ受信繰り返し動作

メッセージを待ち、指示された動作を実行することを繰り返す。タイムアウト以外では帰らない。

Parameters:

  • tid (Integer) —

    初期トランザクションID

  • timeout (Integer) (defaults to: nil) —

    待ち時間タイムアウト



245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
 
# File 'lib/al_worker_message.rb', line 245

def cycle( tid, timeout = nil )
  @bc.attach()
  loop do
    # get messages.
    msg = get( tid )
    tid = @tid  if msg == []
    msg = @queue.dup()  if msg == nil         # message has gone.

    # process each messages.
    msg.each do |m|
      yield( m )
      tid = m[:TID]
    end
    tid += 1

    # wait next messages.
    Timeout::timeout( timeout ) {
      @bc.receive()     # waiting message.
    }
  end

rescue Timeout::Error
  return nil

ensure
  @bc.detach()
end

#get(tid) ⇒ Array<Hash>, NilClass

キューからメッセージを取り出し

Parameters:

  • tid (Integer) —

    トランザクションID

Returns:

  • (Array<Hash>) —

    メッセージの配列。まだ指定された番号のトランザクションが発生していない場合は、空配列を返す。

  • (NilClass) —

    メッセージキューからすでに消えている場合



172
173
174
175
176
177
178
179
180
181
182
183
184
185
 
# File 'lib/al_worker_message.rb', line 172

def get( tid )
  synchronize( Sync::SH ) {
    i = @queue.size - 1
    return []  if i < 0 || @queue[i][:TID] < tid

    while i >= 0
      if @queue[i][:TID] <= tid
        return @queue[i..-1]
      end
      i -= 1
    end
  }
  return nil
end

#receive(tid) ⇒ Array<Hash>, NilClass

Note:

キューからメッセージを取り出し

トランザクションがまだ発生していない場合、次メッセージがsendされるまで待つ。

Parameters:

  • tid (Integer) —

    トランザクションID

Returns:

  • (Array<Hash>) —

    メッセージの配列。

  • (NilClass) —

    メッセージキューからすでに消えている場合



211
212
213
214
215
216
217
218
219
220
221
222
 
# File 'lib/al_worker_message.rb', line 211

def receive( tid )
  @bc.attach()
  ret = get( tid )
  if ret == []
    tid = @bc.receive()
    ret = get( tid )
  end
  return ret

ensure
  @bc.detach()
end

#send(msg) ⇒ Integer

キューへメッセージ追加するとともに receive待ちをしているスレッドを起こす

Parameters:

  • msg (Hash) —

    メッセージ

Returns:

  • (Integer) —

    トランザクションID



194
195
196
197
198
199
 
# File 'lib/al_worker_message.rb', line 194

def send( msg )
  tid = add( msg )
  @bc.send( tid )
  Thread.pass
  return tid
end

#tid_min ⇒ Integer

キュー内の最小TIDを返す

Returns:

  • (Integer) —

    最小TID



230
231
232
 
# File 'lib/al_worker_message.rb', line 230

def tid_min()
  return @queue[0] == nil ? 0 : @queue[0][:TID]
end