Class: DataObjects::Pooling::Pool

Inherits:
Object
  • Object
show all
Defined in:
lib/data_objects/pooling.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(max_size, resource, args) ⇒ Pool

Returns a new instance of Pool.

Raises:

  • (ArgumentError)


144
145
146
147
148
149
150
151
152
153
154
155
# File 'lib/data_objects/pooling.rb', line 144

def initialize(max_size, resource, args)
  raise ArgumentError.new("+max_size+ should be a Fixnum but was #{max_size.inspect}") unless Fixnum === max_size
  raise ArgumentError.new("+resource+ should be a Class but was #{resource.inspect}") unless Class === resource

  @max_size = max_size
  @resource = resource
  @args = args

  @available = []
  @used      = {}
  DataObjects::Pooling.append_pool(self)
end

Instance Attribute Details

#availableObject (readonly)

Returns the value of attribute available.



141
142
143
# File 'lib/data_objects/pooling.rb', line 141

def available
  @available
end

#usedObject (readonly)

Returns the value of attribute used.



142
143
144
# File 'lib/data_objects/pooling.rb', line 142

def used
  @used
end

Instance Method Details

#delete(instance) ⇒ Object



206
207
208
209
210
211
212
213
# File 'lib/data_objects/pooling.rb', line 206

def delete(instance)
  lock.synchronize do
    instance.instance_variable_set(:@__pool, nil)
    @used.delete(instance.object_id)
    wait.signal
  end
  nil
end

#disposeObject



228
229
230
231
232
# File 'lib/data_objects/pooling.rb', line 228

def dispose
  flush!
  @resource.__pools.delete(@args)
  !DataObjects::Pooling.pools.delete?(self).nil?
end

#expired?Boolean

Returns:

  • (Boolean)


234
235
236
237
238
239
240
241
242
# File 'lib/data_objects/pooling.rb', line 234

def expired?
  @available.each do |instance|
    if DataObjects.exiting || instance.instance_variable_get(:@__allocated_in_pool) + DataObjects::Pooling.scavenger_interval <= (Time.now + 0.02)
      instance.dispose
      @available.delete(instance)
    end
  end
  size == 0
end

#flush!Object



224
225
226
# File 'lib/data_objects/pooling.rb', line 224

def flush!
  @available.pop.dispose until @available.empty?
end

#inspectObject



220
221
222
# File 'lib/data_objects/pooling.rb', line 220

def inspect
  "#<DataObjects::Pooling::Pool<#{@resource.name}> available=#{@available.size} used=#{@used.size} size=#{@max_size}>"
end

#lockObject



157
158
159
# File 'lib/data_objects/pooling.rb', line 157

def lock
  @resource.__pool_lock
end

#newObject



169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
# File 'lib/data_objects/pooling.rb', line 169

def new
  instance = nil
  begin
    lock.synchronize do
      if @available.size > 0
        instance = @available.pop
        @used[instance.object_id] = instance
      elsif @used.size < @max_size
        instance = @resource.__new(*@args)
        raise InvalidResourceError.new("#{@resource} constructor created a nil object") if instance.nil?
        raise InvalidResourceError.new("#{instance} is already part of the pool") if @used.include? instance
        instance.instance_variable_set(:@__pool, self)
        instance.instance_variable_set(:@__allocated_in_pool, Time.now)
        @used[instance.object_id] = instance
      else
        # Wait for another thread to release an instance.
        # If we exhaust the pool and don't release the active instance,
        # we'll wait here forever, so it's *very* important to always
        # release your services and *never* exhaust the pool within
        # a single thread.
        wait.wait(lock)
      end
    end
  end until instance
  instance
end

#release(instance) ⇒ Object



196
197
198
199
200
201
202
203
204
# File 'lib/data_objects/pooling.rb', line 196

def release(instance)
  lock.synchronize do
    instance.instance_variable_set(:@__allocated_in_pool, Time.now)
    @used.delete(instance.object_id)
    @available.push(instance)
    wait.signal
  end
  nil
end

#scavenge_intervalObject



165
166
167
# File 'lib/data_objects/pooling.rb', line 165

def scavenge_interval
  @resource.scavenge_interval
end

#sizeObject Also known as: length



215
216
217
# File 'lib/data_objects/pooling.rb', line 215

def size
  @used.size + @available.size
end

#waitObject



161
162
163
# File 'lib/data_objects/pooling.rb', line 161

def wait
  @resource.__pool_wait
end