X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FClass%2FMOP%2FMethod.pm;h=6bb65ad3b0019bf333d3fc64537758f5ad40b21c;hb=e00524a03329f89358767302ffc62cd15ec33571;hp=5e44fba67d87b02558fd7c78473b3b25ea350381;hpb=88b8ac17305b1bf7f1795337d7d443aec0bd3057;p=gitmo%2FClass-MOP.git diff --git a/lib/Class/MOP/Method.pm b/lib/Class/MOP/Method.pm index 5e44fba..6bb65ad 100644 --- a/lib/Class/MOP/Method.pm +++ b/lib/Class/MOP/Method.pm @@ -7,7 +7,7 @@ use warnings; use Carp 'confess'; use Scalar::Util 'weaken'; -our $VERSION = '0.70_01'; +our $VERSION = '0.83'; $VERSION = eval $VERSION; our $AUTHORITY = 'cpan:STEVAN'; @@ -43,7 +43,7 @@ sub wrap { ($params{package_name} && $params{name}) || confess "You must supply the package_name and name parameters $UPGRADE_ERROR_TEXT"; - my $self = (ref($class) || $class)->_new(\%params); + my $self = $class->_new(\%params); weaken($self->{associated_metaclass}) if $self->{associated_metaclass}; @@ -64,8 +64,6 @@ sub _new { ## accessors -sub body { (shift)->{'body'} } - sub associated_metaclass { shift->{'associated_metaclass'} } sub attach_to_class { @@ -79,10 +77,6 @@ sub detach_from_class { delete $self->{associated_metaclass}; } -sub package_name { (shift)->{'package_name'} } - -sub name { (shift)->{'name'} } - sub fully_qualified_name { my $self = shift; $self->package_name . '::' . $self->name; @@ -121,6 +115,11 @@ sub original_fully_qualified_name { : $self->fully_qualified_name; } +sub execute { + my $self = shift; + $self->body->(@_); +} + # NOTE: # the Class::MOP bootstrap # will create this for us @@ -140,109 +139,121 @@ Class::MOP::Method - Method Meta Object =head1 DESCRIPTION The Method Protocol is very small, since methods in Perl 5 are just -subroutines within the particular package. We provide a very basic +subroutines in a specific package. We provide a very basic introspection interface. =head1 METHODS -=head2 Introspection - =over 4 -=item B +=item B<< Class::MOP::Method->wrap($code, %options) >> -This will return a B instance which is related -to this class. +This is the constructor. It accepts a subroutine reference and a hash +of options. -=back +The options are: -=head2 Construction +=over 8 -=over 4 +=item * name + +The method name (without a package name). This is required. -=item B +=item * package_name -This is the basic constructor, it returns a B -instance which wraps the given C<$code> reference. You can also -set the C and C attributes using the C<%params>. -If these are not set, then thier accessors will attempt to figure -it out using the C function. +The package name for the method. This is required. -=item B +=item * associated_metaclass -This will make a copy of the object, allowing you to override -any values by stuffing them in C<%params>. +An optional L object. This is the metaclass for the +method's class. =back -=head2 Informational +=item B<< $metamethod->clone(%params) >> -=over 4 +This makes a shallow clone of the method object. In particular, +subroutine reference itself is shared between all clones of a given +method. + +When a method is cloned, the original method object will be available +by calling C on the clone. -=item B +=item B<< $metamethod->body >> -This returns the actual CODE reference of the particular instance. +This returns a reference to the method's subroutine. -=item B +=item B<< $metamethod->name >> -This returns the name of the CODE reference. +This returns the method's name -=item B +=item B<< $metamethod->package_name >> -The metaclass of the method +This returns the method's package name. -=item B +=item B<< $metamethod->fully_qualified_name >> -This returns the package name that the CODE reference is attached to. +This returns the method's fully qualified name (package name and +method name). -=item B +=item B<< $metamethod->associated_metaclass >> -This returns the fully qualified name of the CODE reference. +This returns the L object for the method, if one +exists. -=item B +=item B<< $metamethod->original_method >> If this method object was created as a clone of some other method object, this returns the object that was cloned. -=item B +=item B<< $metamethod->original_name >> -This returns the original name of the CODE reference, wherever it was -first defined. +This returns the method's original name, wherever it was first +defined. If this method is a clone of a clone (of a clone, etc.), this method returns the name from the I method in the chain of clones. -=item B +=item B<< $metamethod->original_package_name >> -This returns the original package name that the CODE reference is -attached to, wherever it was first defined. +This returns the method's original package name, wherever it was first +defined. If this method is a clone of a clone (of a clone, etc.), this method returns the package name from the I method in the chain of clones. -=item B +=item B<< $metamethod->original_fully_qualified_name >> -This returns the original fully qualified name of the CODE reference, -wherever it was first defined. +This returns the method's original fully qualified name, wherever it +was first defined. If this method is a clone of a clone (of a clone, etc.), this method returns the fully qualified name from the I method in the chain of clones. -=back +=item B<< $metamethod->attach_to_class($metaclass) >> -=head2 Metaclass +Given a L object, this method sets the associated +metaclass for the method. This will overwrite any existing associated +metaclass. -=over 4 +=item B<< $metamethod->detach_from_class >> + +Removes any associated metaclass object for the method. + +=item B<< $metamethod->execute(...) >> -=item B +This executes the method. Any arguments provided will be passed on to +the method itself. -Sets the associated metaclass +=item B<< Class::MOP::Method->meta >> -=item B +This will return a L instance for this class. -Disassociates the method from the metaclass +It should also be noted that L will actually bootstrap +this module by installing a number of attribute meta-objects into its +metaclass. =back @@ -252,7 +263,7 @@ Stevan Little Estevan@iinteractive.comE =head1 COPYRIGHT AND LICENSE -Copyright 2006-2008 by Infinity Interactive, Inc. +Copyright 2006-2009 by Infinity Interactive, Inc. L