Module: Dramatis::Actor

Defined in:
lib/dramatis/actor.rb,
lib/dramatis/actor.rb,
lib/dramatis/actor/name.rb,
lib/dramatis/actor/interface.rb,
lib/dramatis/actor/name/interface.rb

Overview

The Dramatis::Actor module is used to create actor classes and objects. An actor class can be created by mixing Dramatis::Actor, e.g.,

class MyClass
  include Dramatis::Actor
  ...
end

or can be used to create so called naked actors, e.g.,

my_hash_actor = Dramatis::Actor.new Hash.new

When mixed in to a class, Dramatis::Actor has two effects:

  1. It causes new to return a Dramatis::Actor::Name rather than an object reference

  2. It defines an actor method which can be used by the class to access its actor name and otherwise affect its actor semantics

Defined Under Namespace

Classes: Interface, Name

Class Method Summary collapse

Class Method Details

.included(cls) ⇒ Object

:nodoc:



22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
 
# File 'lib/dramatis/actor.rb', line 22

def self.included cls #:nodoc:
  cls.instance_eval do
    include Dramatis
  end
  class << cls
    def new *args
      new_actor = Dramatis::Runtime::Actor.new
      object = allocate
      eigenclass = ( class << object; self; end )
      eigenclass.send :define_method, :actor,
              ( lambda { new_actor.object_interface } )
      new_actor.bind object
      new_actor.instance_eval { @gate.refuse :object }
      new_actor.actor_send [ :object_initialize, *args ], 
                             :continuation => :rpc
      new_actor.name
    end
  end
end

.new(behavior = nil) ⇒ Object

call-seq:

new( *args, &block ) -> an_actor_name
new( behavior = nil ) -> an_actor_name

The first case is used when a class has mixed in Dramatis::Actor. In this case, the arguments are passed to the initialize of method of the including class like normal.

The second case is used when creating so called naked actors, e.g.,

my_hash = Dramatis::Actor.new Hash.new

If no behavior is provided, the actor can be later bound to a behavior by calling Dramatis::Actor::Name::Interface.bind

In all cases, new returns a Dramatis::Actor::Name proxy object.



73
74
75
 
# File 'lib/dramatis/actor.rb', line 73

def self.new behavior = nil
  ( Dramatis::Runtime::Actor.new behavior ).name
end