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 # This doesn't always get initialized in a constructor because there is a
40 # weird object construction path for subclasses of Class::MOP::Class. At one
41 # point, this always got initialized by calling into the XS code first, but
42 # that is no longer guaranteed to happen.
43 sub _method_map { $_[0]->{'methods'} ||= {} }
45 sub wrap_method_body {
46 my ( $self, %args ) = @_;
48 ( 'CODE' eq ref $args{body} )
49 || confess "Your code block must be a CODE reference";
51 $self->method_metaclass->wrap(
52 package_name => $self->name,
58 my ( $self, $method_name, $method ) = @_;
59 ( defined $method_name && length $method_name )
60 || confess "You must define a method name";
62 my $package_name = $self->name;
65 if ( blessed($method) ) {
66 $body = $method->body;
67 if ( $method->package_name ne $package_name ) {
68 $method = $method->clone(
69 package_name => $package_name,
71 ) if $method->can('clone');
74 $method->attach_to_class($self);
77 # If a raw code reference is supplied, its method object is not created.
78 # The method object won't be created until required.
82 $self->_method_map->{$method_name} = $method;
84 my ( $current_package, $current_name ) = Class::MOP::get_code_info($body);
86 if ( !defined $current_name || $current_name =~ /^__ANON__/ ) {
87 my $full_method_name = ( $package_name . '::' . $method_name );
88 subname( $full_method_name => $body );
91 $self->add_package_symbol(
92 { sigil => '&', type => 'CODE', name => $method_name },
98 my ( $self, $code ) = @_;
100 my ( $code_package, $code_name ) = Class::MOP::get_code_info($code);
102 return $code_package && $code_package eq $self->name
103 || ( $code_package eq 'constant' && $code_name eq '__ANON__' );
107 my ( $self, $method_name ) = @_;
109 ( defined $method_name && length $method_name )
110 || confess "You must define a method name";
112 return defined( $self->_get_maybe_raw_method($method_name) );
116 my ( $self, $method_name ) = @_;
118 ( defined $method_name && length $method_name )
119 || confess "You must define a method name";
121 my $method = $self->_get_maybe_raw_method($method_name)
124 return $method if blessed $method;
126 return $self->_method_map->{$method_name} = $self->wrap_method_body(
128 name => $method_name,
129 associated_metaclass => $self,
133 sub _get_maybe_raw_method {
134 my ( $self, $method_name ) = @_;
136 my $method_map = $self->_method_map;
137 my $map_entry = $method_map->{$method_name};
138 my $code = $self->get_package_symbol(
140 name => $method_name,
146 # The !$code case seems to happen in some weird cases where methods
147 # modifiers are added via roles or some other such bizareness. Honestly, I
148 # don't totally understand this, but returning the entry works, and keeps
149 # various MX modules from blowing up. - DR
151 if blessed $map_entry && ( !$code || $map_entry->body == $code );
153 unless ($map_entry) {
154 return unless $code && $self->_code_is_mine($code);
161 my ( $self, $method_name ) = @_;
162 ( defined $method_name && length $method_name )
163 || confess "You must define a method name";
165 my $removed_method = delete $self->_full_method_map->{$method_name};
167 $self->remove_package_symbol(
168 { sigil => '&', type => 'CODE', name => $method_name } );
170 $removed_method->detach_from_class
171 if $removed_method && blessed $removed_method;
173 # still valid, since we just removed the method from the map
174 $self->update_package_cache_flag;
176 return $removed_method;
179 sub get_method_list {
182 my $namespace = $self->namespace;
184 # Constants may show up as some sort of non-GLOB reference in the
185 # namespace hash ref, depending on the Perl version.
187 defined $namespace->{$_}
188 && ( ref( \$namespace->{$_} ) ne 'GLOB'
189 || *{ $namespace->{$_} }{CODE} )
190 && $self->has_method($_)
195 # This should probably be what get_method_list actually does, instead of just
196 # returning names. This was created as a much faster alternative to
197 # $meta->get_method($_) for $meta->get_method_list
198 sub _get_local_methods {
201 my $namespace = $self->namespace;
203 return map { $self->get_method($_) }
205 defined $namespace->{$_}
206 && ( ref $namespace->{$_}
207 || *{ $namespace->{$_} }{CODE} )
212 sub _restore_metamethods_from {
216 for my $method ($old_meta->_get_local_methods) {
217 # XXX: this is pretty gross. the issue here is that
218 # CMOP::Method::Wrapped objects are subclasses of CMOP::Method, but
219 # when we get to moose, they'll need to be compatible with
220 # Moose::Meta::Method, which isn't possible. the right solution here is
221 # to make ::Wrapped into a role that gets applied to whatever the
222 # method_metaclass happens to be and get rid of
223 # wrapped_method_metaclass entirely, but that's not going to happen
224 # until we ditch cmop and get roles into the bootstrapping, so.
225 # i'm not maintaining the previous behavior of turning them into
226 # instances of the new method_metaclass because that's equally broken,
227 # and at least this way any issues will at least be detectable and
228 # potentially fixable. -doy
229 if (!$method->isa($self->wrapped_method_metaclass)
230 # and the same issue occurs with CMOP::Method::Meta objects/:
231 && !$method->isa($self->_meta_method_class)) {
232 $method->_make_compatible_with($self->method_metaclass);
234 $self->add_method($method->name => $method);
246 Class::MOP::Mixin::HasMethods - Methods for metaclasses which have methods
250 This class implements methods for metaclasses which have methods
251 (L<Class::MOP::Package> and L<Moose::Meta::Role>). See L<Class::MOP::Package>
256 Dave Rolsky E<lt>autarch@urth.orgE<gt>
258 =head1 COPYRIGHT AND LICENSE
260 Copyright 2006-2010 by Infinity Interactive, Inc.
262 L<http://www.iinteractive.com>
264 This library is free software; you can redistribute it and/or modify
265 it under the same terms as Perl itself.