21 Jun 2008 18:10:42 UTC
- Distribution: Devel-Events-Objects
- Source (raw)
- Browse (raw)
- How to Contribute
- Issues (1)
- Testers (1000 / 0 / 1)
- KwaliteeBus factor: 3
- 72.73% Coverage
- License: unknown
- Activity24 month
- Download (7.25KB)
- MetaCPAN Explorer
- Subscribe to distribution
- This version
- Latest version
Devel::Events::Generator::Objects - Generate events for
blessing and destruction of objects.
use Devel::Events::Generator::Objects; # must be loaded before any code you want to instrument my $g = Devel::Events::Generator::Objects->new( handler => $h, ); $g->enable(); # only one Objects generator may be enabled at a time $code->(); # objects being created and destroyed cause events to be generated $g->disable();
This module overrides
CORE::GLOBAL::blesson load. The altered version will delegate back to the original version until an instance of a generator is enabled.
When a generator is enabled (only one Devel::Events::Generator::Objects instance may be enabled at a time. Use Devel::Events::Handler::Multiplex to dup events to multiple listeners), the overridden version of
blesswill cause an
object_blessevent to fire, and will also attach magic to the object to keep track of it's destruction using Variable::Magic.
When the object is freed by the interpreter an
object_destroyevent is fired. Unfortunately by this time
perlhas already unblessed the object in question, so in order to keep track of the class you must associate it yourself with the reference address.
Devel::Events::Handler::ObjectTracker contains a detailed usage example.
When the generator is enabled, this event will fire on every call to
blessfor all code loaded after this module was loaded.
In the future this event might omit objects created during event handling, but currently it does not.
The object that was blessed
If this is a rebless then this parameter contains the class the object was in just before the bless.
These fields correspond to the location o the call to
For every object created while the generator was enabled, magic to track destruction will be attached. When the object is freed this magic callback will fire this event.
This field contains a reference to the object.
NOTE: by the time this callback fires the object is no longer blessed. Be sure to keep track of the class of every refaddr as reported by
object_blessin your handler if you need to know the class the object belonged to at destroy time..
Make this instance the enabled one (disabling any other instance which is enabled).
This only applies to the
Disable this instance. Will stop generating
The method called by the
CORE::blessto bless the data, and then calls
Attach magic to an object that will call
object_destroywhen the data is about to be freed.
Currently empty. A subclass with a different implementation of
track_objectmight want to override this.
Module Install Instructions
To install Devel::Events::Objects, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell install Devel::Events::Objects
For more information on module installation, please visit the detailed CPAN module installation guide.