Class: Needle::Registry
Overview
Registry is a specialization of Container, with additional functionality for bootstrapping basic services into a new registry. It also supports a #define! method for easily registering new services.
Usage:
require 'needle'
registry = Needle::Registry.new
registry.register( :foo ) { Foo.new }
registry.register( :bar ) { |c| Bar.new( c.foo ) }
= registry.
Instance Attribute Summary
Attributes inherited from Container
Class Method Summary collapse
-
.define(*parms, &block) ⇒ Object
Instantiate a new Registry (via #new) and immediately invoke #define using the given block.
-
.define!(*parms, &block) ⇒ Object
Instantiate a new Registry (via #new) and immediately invoke #define! using the given block.
Instance Method Summary collapse
-
#fullname ⇒ Object
Returns
nil
, unless the registry has a parent, in which case it acts like Container#fullname. -
#initialize(opts = {}) {|_self| ... } ⇒ Registry
constructor
Instantiate a new Registry.
Methods inherited from Container
#[], #builder, #define, #define!, #find_definition, #has_key?, #intercept, #keys, #knows_key?, #method_missing, #namespace, #namespace_define, #namespace_define!, #pipeline, #register, #require, #respond_to?, #root
Constructor Details
#initialize(opts = {}) {|_self| ... } ⇒ Registry
Instantiate a new Registry. The options hash may include the following keys:
:logs
-
options used to initialize the logger factory. The value to this key should be another hash.
:parent
-
The parent container of this registry.
:name
-
The name of this registry.
If a block is given, the constructed registry instance is yielded to it.
Usage:
registry = Needle::Registry.new
or
registry = Needle::Registry.new do |reg|
reg.register( :add ) { Adder.new }
end
or
registry = Needle::Registry.new(
:logs => { :filename => "/dev/null" }
)
103 104 105 106 107 |
# File 'lib/needle/registry.rb', line 103 def initialize( opts={} ) super( opts[:parent], opts[:name] ) bootstrap( opts ) if parent.nil? yield( self ) if block_given? end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method in the class Needle::Container
Class Method Details
.define(*parms, &block) ⇒ Object
Instantiate a new Registry (via #new) and immediately invoke #define using the given block.
Usage:
registry = Needle::Registry.define do |b|
b.add { Adder.new }
...
end
adder = registry.add
73 74 75 76 |
# File 'lib/needle/registry.rb', line 73 def self.define( *parms, &block ) raise NeedleError, "needs a block" if block.nil? new( *parms ) { |reg| reg.define( &block ) } end |
.define!(*parms, &block) ⇒ Object
Instantiate a new Registry (via #new) and immediately invoke #define! using the given block.
Usage:
registry = Needle::Registry.define! do
add { Adder.new }
...
end
adder = registry.add
57 58 59 60 |
# File 'lib/needle/registry.rb', line 57 def self.define!( *parms, &block ) raise NeedleError, "needs a block" if block.nil? new( *parms ) { |reg| reg.define!( &block ) } end |
Instance Method Details
#fullname ⇒ Object
Returns nil
, unless the registry has a parent, in which case it acts like Container#fullname. Registries are usually unnamed containers.
111 112 113 |
# File 'lib/needle/registry.rb', line 111 def fullname parent ? super : nil end |