1 package Moose::Meta::Role::Composite;
7 use Class::Load qw(load_class);
8 use Scalar::Util 'blessed';
10 use base 'Moose::Meta::Role';
13 # we need to override the ->name
14 # method from Class::MOP::Package
15 # since we don't have an actual
18 __PACKAGE__->meta->add_attribute('name' => (
20 Class::MOP::_definition_context(),
24 # Again, since we don't have a real
25 # package to store our methods in,
26 # we use a HASH ref instead.
28 __PACKAGE__->meta->add_attribute('_methods' => (
29 reader => '_method_map',
30 default => sub { {} },
31 Class::MOP::_definition_context(),
34 __PACKAGE__->meta->add_attribute(
35 'application_role_summation_class',
36 reader => 'application_role_summation_class',
37 default => 'Moose::Meta::Role::Application::RoleSummation',
38 Class::MOP::_definition_context(),
42 my ($class, %params) = @_;
44 # the roles param is required ...
45 foreach ( @{$params{roles}} ) {
46 unless ( $_->isa('Moose::Meta::Role') ) {
48 Moose->throw_error("The list of roles must be instances of Moose::Meta::Role, not $_");
52 my @composition_roles = map {
53 $_->composition_class_roles
54 } @{ $params{roles} };
56 if (@composition_roles) {
57 my $meta = Moose::Meta::Class->create_anon_class(
58 superclasses => [ $class ],
59 roles => [ @composition_roles ],
65 # and the name is created from the
66 # roles if one has not been provided
67 $params{name} ||= (join "|" => map { $_->name } @{$params{roles}});
68 $class->_new(\%params);
71 # This is largely a copy of what's in Moose::Meta::Role (itself
72 # largely a copy of Class::MOP::Class). However, we can't actually
73 # call add_package_symbol, because there's no package to which which
76 my ($self, $method_name, $method) = @_;
78 unless ( defined $method_name && $method_name ) {
79 Moose->throw_error("You must define a method name");
83 if (blessed($method)) {
84 $body = $method->body;
85 if ($method->package_name ne $self->name) {
86 $method = $method->clone(
87 package_name => $self->name,
89 ) if $method->can('clone');
94 $method = $self->wrap_method_body( body => $body, name => $method_name );
97 $self->_method_map->{$method_name} = $method;
100 sub get_method_list {
102 return keys %{ $self->_method_map };
105 sub _get_local_methods {
107 return values %{ $self->_method_map };
111 my ($self, $method_name) = @_;
113 return exists $self->_method_map->{$method_name};
117 my ($self, $method_name) = @_;
119 return $self->_method_map->{$method_name};
123 my ($self, $role_params) = @_;
124 load_class($self->application_role_summation_class);
126 $self->application_role_summation_class->new(
127 role_params => $role_params,
134 my ( $class, $old_meta, @args ) = @_;
137 'Moose::Meta::Role::Composite instances can only be reinitialized from an existing metaclass instance'
139 if !blessed $old_meta
140 || !$old_meta->isa('Moose::Meta::Role::Composite');
142 my %existing_classes = map { $_ => $old_meta->$_() } qw(
143 application_role_summation_class
146 return $old_meta->meta->clone_object( $old_meta, %existing_classes, @args );
151 # ABSTRACT: An object to represent the set of roles
159 A composite is a role that consists of a set of two or more roles.
161 The API of a composite role is almost identical to that of a regular
166 C<Moose::Meta::Role::Composite> is a subclass of L<Moose::Meta::Role>.
172 =item B<< Moose::Meta::Role::Composite->new(%options) >>
174 This returns a new composite role object. It accepts the same
175 options as its parent class, with a few changes:
181 This option is an array reference containing a list of
182 L<Moose::Meta::Role> object. This is a required option.
186 If a name is not given, one is generated from the roles provided.
188 =item * apply_params(\%role_params)
190 Creates a new RoleSummation role application with C<%role_params> and applies
191 the composite role to it. The RoleSummation role application class used is
192 determined by the composite role's C<application_role_summation_class>
195 =item * reinitialize($metaclass)
197 Like C<< Class::MOP::Package->reinitialize >>, but doesn't allow passing a
198 string with the package name, as there is no real package for composite roles.
206 See L<Moose/BUGS> for details on reporting bugs.