1 package Class::MOP::Mixin::HasMethods;
6 use Class::MOP::Method::Meta;
9 $VERSION = eval $VERSION;
10 our $AUTHORITY = 'cpan:STEVAN';
12 use Scalar::Util 'blessed';
14 use Sub::Name 'subname';
16 use base 'Class::MOP::Mixin';
18 sub method_metaclass { $_[0]->{'method_metaclass'} }
19 sub wrapped_method_metaclass { $_[0]->{'wrapped_method_metaclass'} }
20 sub _meta_method_class { 'Class::MOP::Method::Meta' }
22 sub _add_meta_method {
25 my $existing_method = $self->can('find_method_by_name')
26 ? $self->find_method_by_name($name)
27 : $self->get_method($name);
28 return if $existing_method
29 && $existing_method->isa($self->_meta_method_class);
31 $name => $self->_meta_method_class->wrap(
33 package_name => $self->name,
34 associated_metaclass => $self,
39 sub wrap_method_body {
40 my ( $self, %args ) = @_;
42 ( 'CODE' eq ref $args{body} )
43 || confess "Your code block must be a CODE reference";
45 $self->method_metaclass->wrap(
46 package_name => $self->name,
52 my ( $self, $method_name, $method ) = @_;
53 ( defined $method_name && length $method_name )
54 || confess "You must define a method name";
56 my $package_name = $self->name;
59 if ( blessed($method) ) {
60 $body = $method->body;
61 if ( $method->package_name ne $package_name ) {
62 $method = $method->clone(
63 package_name => $package_name,
65 ) if $method->can('clone');
68 $method->attach_to_class($self);
71 # If a raw code reference is supplied, its method object is not created.
72 # The method object won't be created until required.
76 $self->_method_map->{$method_name} = $method;
78 my ( $current_package, $current_name ) = Class::MOP::get_code_info($body);
80 if ( !defined $current_name || $current_name =~ /^__ANON__/ ) {
81 my $full_method_name = ( $package_name . '::' . $method_name );
82 subname( $full_method_name => $body );
85 $self->add_package_symbol(
86 { sigil => '&', type => 'CODE', name => $method_name },
92 my ( $self, $code ) = @_;
94 my ( $code_package, $code_name ) = Class::MOP::get_code_info($code);
96 return $code_package && $code_package eq $self->name
97 || ( $code_package eq 'constant' && $code_name eq '__ANON__' );
101 my ( $self, $method_name ) = @_;
103 ( defined $method_name && length $method_name )
104 || confess "You must define a method name";
106 my $method = $self->_get_maybe_raw_method($method_name)
109 return defined($self->_method_map->{$method_name} = $method);
113 my ( $self, $method_name ) = @_;
115 ( defined $method_name && length $method_name )
116 || confess "You must define a method name";
118 my $method = $self->_get_maybe_raw_method($method_name)
121 return $method if blessed $method;
123 return $self->_method_map->{$method_name} = $self->wrap_method_body(
125 name => $method_name,
126 associated_metaclass => $self,
130 sub _get_maybe_raw_method {
131 my ( $self, $method_name ) = @_;
133 my $map_entry = $self->_method_map->{$method_name};
134 return $map_entry if defined $map_entry;
136 my $code = $self->get_package_symbol(
138 name => $method_name,
144 unless ($map_entry) {
145 return unless $code && $self->_code_is_mine($code);
152 my ( $self, $method_name ) = @_;
153 ( defined $method_name && length $method_name )
154 || confess "You must define a method name";
156 my $removed_method = delete $self->_method_map->{$method_name};
158 $self->remove_package_symbol(
159 { sigil => '&', type => 'CODE', name => $method_name } );
161 $removed_method->detach_from_class
162 if $removed_method && blessed $removed_method;
164 # still valid, since we just removed the method from the map
165 $self->update_package_cache_flag;
167 return $removed_method;
170 sub get_method_list {
173 return keys %{ $self->_full_method_map };
176 # This should probably be what get_method_list actually does, instead of just
177 # returning names. This was created as a much faster alternative to
178 # $meta->get_method($_) for $meta->get_method_list
179 sub _get_local_methods {
182 return values %{ $self->_full_method_map };
185 sub _restore_metamethods_from {
189 for my $method ($old_meta->_get_local_methods) {
190 $method->_make_compatible_with($self->method_metaclass);
191 $self->add_method($method->name => $method);
195 sub reset_package_cache_flag { (shift)->{'_package_cache_flag'} = undef }
196 sub update_package_cache_flag {
199 # we can manually update the cache number
200 # since we are actually adding the method
201 # to our cache as well. This avoids us
202 # having to regenerate the method_map.
204 $self->{'_package_cache_flag'} = Class::MOP::check_package_cache_flag($self->name);
207 sub _full_method_map {
210 my $pkg_gen = Class::MOP::check_package_cache_flag($self->name);
212 if (($self->{_package_cache_flag_full} || -1) != $pkg_gen) {
213 # forcibly reify all method map entries
214 $self->get_method($_)
215 for $self->list_all_package_symbols('CODE');
216 $self->{_package_cache_flag_full} = $pkg_gen;
219 return $self->_method_map;
230 Class::MOP::Mixin::HasMethods - Methods for metaclasses which have methods
234 This class implements methods for metaclasses which have methods
235 (L<Class::MOP::Package> and L<Moose::Meta::Role>). See L<Class::MOP::Package>
240 Dave Rolsky E<lt>autarch@urth.orgE<gt>
242 =head1 COPYRIGHT AND LICENSE
244 Copyright 2006-2010 by Infinity Interactive, Inc.
246 L<http://www.iinteractive.com>
248 This library is free software; you can redistribute it and/or modify
249 it under the same terms as Perl itself.