1 package Mouse::Meta::Role;
6 use Mouse::Meta::Attribute;
7 use Mouse::Util qw(version authority identifier);
12 # because Mouse doesn't introspect existing classes, we're forced to
13 # only pay attention to other Mouse classes
14 sub _metaclass_cache {
17 return $METACLASS_CACHE{$name};
23 $METACLASS_CACHE{$name} = $class->new(name => $name)
24 if !exists($METACLASS_CACHE{$name});
25 return $METACLASS_CACHE{$name};
33 $args{attributes} ||= {};
34 $args{required_methods} ||= [];
40 sub name { $_[0]->{name} }
42 sub add_required_methods {
45 push @{$self->{required_methods}}, @methods;
54 $self->{attributes}->{$name} = Mouse::Meta::Attribute->new($name, %$spec);
57 sub has_attribute { exists $_[0]->{attributes}->{$_[1]} }
58 sub get_attribute_list { keys %{ $_[0]->{attributes} } }
59 sub get_attribute { $_[0]->{attributes}->{$_[1]} }
61 # copied from Class::Inspector
64 my $name = $self->name;
67 # Get all the CODE symbol table entries
69 grep !/^(?:has|with|around|before|after|augment|inner|override|super|blessed|extends|confess|excludes|meta|requires)$/,
70 grep { defined &{"${name}::$_"} }
72 wantarray ? @functions : \@functions;
75 # Moose uses Application::ToInstance, Application::ToClass, Application::ToRole
78 my $selfname = $self->name;
80 my $classname = $class->name;
83 if ($class->isa('Mouse::Object')) {
84 Carp::croak('Mouse does not support Application::ToInstance yet');
87 if ($class->isa('Mouse::Meta::Class')) {
88 for my $name (@{$self->{required_methods}}) {
89 unless ($classname->can($name)) {
90 confess "'$selfname' requires the method '$name' to be implemented by '$classname'";
97 for my $name ($self->get_method_list) {
98 next if $name eq 'meta';
100 my $class_function = "${classname}::${name}";
101 my $role_function = "${selfname}::${name}";
102 if (defined &$class_function) {
103 # XXX what's Moose's behavior?
106 *{$class_function} = \&{$role_function};
108 if ($args{alias} && $args{alias}->{$name}) {
109 my $dstname = $args{alias}->{$name};
110 unless ($classname->can($dstname)) {
111 *{"${classname}::${dstname}"} = \&$role_function;
117 if ($class->isa('Mouse::Meta::Class')) {
118 # apply role to class
119 for my $name ($self->get_attribute_list) {
120 next if $class->has_attribute($name);
121 my $spec = $self->get_attribute($name);
123 my $metaclass = 'Mouse::Meta::Attribute';
124 if ( my $metaclass_name = $spec->{metaclass} ) {
125 my $new_class = Mouse::Util::resolve_metaclass_alias(
129 if ( $metaclass ne $new_class ) {
130 $metaclass = $new_class;
134 $metaclass->create($class, $name, %$spec);
138 # XXX Room for speed improvement
139 for my $name ($self->get_attribute_list) {
140 next if $class->has_attribute($name);
141 my $spec = $self->get_attribute($name);
142 $class->add_attribute($name, $spec);
146 # XXX Room for speed improvement in role to role
147 for my $modifier_type (qw/before after around override/) {
148 my $add_method = "add_${modifier_type}_method_modifier";
149 my $modified = $self->{"${modifier_type}_method_modifiers"};
151 for my $method_name (keys %$modified) {
152 for my $code (@{ $modified->{$method_name} }) {
153 $class->$add_method($method_name => $code);
159 push @{ $class->roles }, $self, @{ $self->roles };
163 my(undef, $class, @roles) = @_;
164 my $classname = $class->name;
166 if ($class->isa('Mouse::Meta::Class')) {
167 for my $role_spec (@roles) {
168 my $self = $role_spec->[0]->meta;
169 for my $name (@{$self->{required_methods}}) {
170 unless ($classname->can($name)) {
171 my $method_required = 0;
172 for my $role (@roles) {
173 $method_required = 1 if $self->name ne $role->[0] && $role->[0]->can($name);
175 confess "'".$self->name."' requires the method '$name' to be implemented by '$classname'"
176 unless $method_required;
184 for my $role_spec (@roles) {
185 my $self = $role_spec->[0]->meta;
186 my $selfname = $self->name;
187 my %args = %{ $role_spec->[1] };
188 for my $name ($self->get_method_list) {
189 next if $name eq 'meta';
191 my $class_function = "${classname}::${name}";
192 my $role_function = "${selfname}::${name}";
193 if (defined &$class_function) {
194 # XXX what's Moose's behavior?
197 *$class_function = *$role_function;
199 if ($args{alias} && $args{alias}->{$name}) {
200 my $dstname = $args{alias}->{$name};
201 unless ($classname->can($dstname)) {
202 *{"${classname}::${dstname}"} = \&$role_function;
210 if ($class->isa('Mouse::Meta::Class')) {
211 # apply role to class
212 for my $role_spec (@roles) {
213 my $self = $role_spec->[0]->meta;
214 for my $name ($self->get_attribute_list) {
215 next if $class->has_attribute($name);
216 my $spec = $self->get_attribute($name);
218 my $metaclass = 'Mouse::Meta::Attribute';
219 if ( my $metaclass_name = $spec->{metaclass} ) {
220 my $new_class = Mouse::Util::resolve_metaclass_alias(
224 if ( $metaclass ne $new_class ) {
225 $metaclass = $new_class;
229 $metaclass->create($class, $name, %$spec);
234 # XXX Room for speed improvement
235 for my $role_spec (@roles) {
236 my $self = $role_spec->[0]->meta;
237 for my $name ($self->get_attribute_list) {
238 next if $class->has_attribute($name);
239 my $spec = $self->get_attribute($name);
240 $class->add_attribute($name, $spec);
245 # XXX Room for speed improvement in role to role
246 for my $modifier_type (qw/before after around override/) {
247 my $add_method = "add_${modifier_type}_method_modifier";
248 for my $role_spec (@roles) {
249 my $self = $role_spec->[0]->meta;
250 my $modified = $self->{"${modifier_type}_method_modifiers"};
252 for my $method_name (keys %$modified) {
253 for my $code (@{ $modified->{$method_name} }) {
254 $class->$add_method($method_name => $code);
261 my %role_apply_cache;
262 my $apply_roles = $class->roles;
263 for my $role_spec (@roles) {
264 my $self = $role_spec->[0]->meta;
265 push @$apply_roles, $self unless $role_apply_cache{$self}++;
266 for my $role (@{ $self->roles }) {
267 push @$apply_roles, $role unless $role_apply_cache{$role}++;
272 for my $modifier_type (qw/before after around override/) {
274 *{ __PACKAGE__ . '::' . "add_${modifier_type}_method_modifier" } = sub {
275 my ($self, $method_name, $method) = @_;
277 push @{ $self->{"${modifier_type}_method_modifiers"}->{$method_name} },
281 *{ __PACKAGE__ . '::' . "get_${modifier_type}_method_modifiers" } = sub {
282 my ($self, $method_name, $method) = @_;
283 @{ $self->{"${modifier_type}_method_modifiers"}->{$method_name} || [] }
287 sub roles { $_[0]->{roles} }
290 # This is currently not passing all the Moose tests.
292 my ($self, $role_name) = @_;
295 || confess "You must supply a role name to look for";
297 # if we are it,.. then return true
298 return 1 if $role_name eq $self->name;
300 for my $role (@{ $self->{roles} }) {
301 return 1 if $role->does_role($role_name);