C:\cpanrun\depot\main\contrib-patched\perl\CPAN\src\Class-Maker\blib/lib/Class/Maker/Basic/Reflection.pm



SYNOPSIS

        {
                package Human::Role;
                Class::Maker::class
                {
                        public =>
                        {
                                string => [qw( name desc )],
                        },
                        default =>
                        {
                                name => 'Role Name',
                                desc => 'Role Descrition',
                                                        },
                                                };
                sub anew : method
                {
                        my $this = shift;
                        return $this->new( name => $_[0] );
                                        }
        }
        {
                package Human::Role::Simple;
                @ISA = qw(Human::Role);
                sub new : method
                {
                        my $this = shift;
                        return $this->SUPER::new( name => $_[0] );
                                        }
                                }


reflect

        Now a Class::Maker::Reflex object is returned (btw it is not created with Class::Maker):
                ->{parents} = href with all ->{isa} classes reflexes (only if $DEEP is true).
                ->{methods} = aref of ': method' functions of that package
                ->{def} = the original class definition (undef if not created with Class::Maker)
                ->{isa} = the actual @ISA value of the class package
                ->{name} = name of the reflected class


find

Returns a snapshot aref to all instances (objects) of a class in a given package.

CAVEAT: It only finds instance variables not created with 'my'

Example:

                # finds all objects which are return true for ->isa( 'Human' ) in the 'main' package
        my $aref_humans = Class::Maker::Reflection::find( 'main' => 'Human' );

Comment:

This function is extremly inefficient, because it is traversing the complete symbol table instead of maintaning a registry of the classes/objects. This seems the lessest error-prone approach, and the time will show if there will be need for efficients.


Function classes

        classes( fakultativ $scalref_mainpackage, [ $package ], .. );
 Purpose
        Traverses the symbol table and find "reflectable" classes.      Returns a list of hash references containing:
                "package_identifier" => $HREF_CLASS_HASH
        Meaning it gets references to the reflection of the class.
        { 'main::MyClass' => $href_myclass }, { 'main::YourClass' => $href_yclass }, ..