use Scalar::Util 'blessed';
-our $VERSION = '0.68';
+our $VERSION = '0.96';
$VERSION = eval $VERSION;
our $AUTHORITY = 'cpan:STEVAN';
use base 'Moose::Meta::Role';
# NOTE:
-# we need to override the ->name
+# we need to override the ->name
# method from Class::MOP::Package
-# since we don't have an actual
+# since we don't have an actual
# package for this.
# - SL
__PACKAGE__->meta->add_attribute('name' => (reader => 'name'));
# NOTE:
-# Again, since we don't have a real
-# package to store our methods in,
-# we use a HASH ref instead.
+# Again, since we don't have a real
+# package to store our methods in,
+# we use a HASH ref instead.
# - SL
-__PACKAGE__->meta->add_attribute('methods' => (
- reader => 'get_method_map',
+__PACKAGE__->meta->add_attribute('_methods' => (
+ reader => '_method_map',
default => sub { {} }
));
+__PACKAGE__->meta->add_attribute(
+ 'application_role_summation_class',
+ reader => 'application_role_summation_class',
+ default => 'Moose::Meta::Role::Application::RoleSummation',
+);
+
sub new {
my ($class, %params) = @_;
+
# the roles param is required ...
- ($_->isa('Moose::Meta::Role'))
- || Moose->throw_error("The list of roles must be instances of Moose::Meta::Role, not $_")
- foreach @{$params{roles}};
+ foreach ( @{$params{roles}} ) {
+ unless ( $_->isa('Moose::Meta::Role') ) {
+ require Moose;
+ Moose->throw_error("The list of roles must be instances of Moose::Meta::Role, not $_");
+ }
+ }
+
+ my @composition_roles = map {
+ $_->composition_class_roles
+ } @{ $params{roles} };
+
+ if (@composition_roles) {
+ my $meta = Moose::Meta::Class->create_anon_class(
+ superclasses => [ $class ],
+ roles => [ @composition_roles ],
+ cache => 1,
+ );
+ $meta->add_method(meta => sub { $meta });
+ $class = $meta->name;
+ }
+
# and the name is created from the
# roles if one has not been provided
$params{name} ||= (join "|" => map { $_->name } @{$params{roles}});
# add the symbol.
sub add_method {
my ($self, $method_name, $method) = @_;
- (defined $method_name && $method_name)
- || Moose->throw_error("You must define a method name");
+
+ unless ( defined $method_name && $method_name ) {
+ Moose->throw_error("You must define a method name");
+ }
my $body;
if (blessed($method)) {
if ($method->package_name ne $self->name) {
$method = $method->clone(
package_name => $self->name,
- name => $method_name
+ name => $method_name
) if $method->can('clone');
}
}
$method = $self->wrap_method_body( body => $body, name => $method_name );
}
- $self->get_method_map->{$method_name} = $method;
+ $self->_method_map->{$method_name} = $method;
+}
+
+sub get_method_list {
+ my $self = shift;
+ return keys %{ $self->_method_map };
+}
+
+sub has_method {
+ my ($self, $method_name) = @_;
+
+ return exists $self->_method_map->{$method_name};
+}
+
+sub get_method {
+ my ($self, $method_name) = @_;
+
+ return $self->_method_map->{$method_name};
+}
+
+sub apply_params {
+ my ($self, $role_params) = @_;
+ Class::MOP::load_class($self->application_role_summation_class);
+
+ $self->application_role_summation_class->new(
+ role_params => $role_params,
+ )->apply($self);
+
+ return $self;
+}
+
+sub reinitialize {
+ my ( $class, $old_meta, @args ) = @_;
+
+ Moose->throw_error(
+ 'Moose::Meta::Role::Composite instances can only be reinitialized from an existing metaclass instance'
+ )
+ if !blessed $old_meta
+ || !$old_meta->isa('Moose::Meta::Role::Composite');
+
+ my %existing_classes = map { $_ => $old_meta->$_() } qw(
+ application_role_summation_class
+ );
+
+ return $old_meta->meta->clone_object( $old_meta, %existing_classes, @args );
}
1;
=head1 DESCRIPTION
+A composite is a role that consists of a set of two or more roles.
+
+The API of a composite role is almost identical to that of a regular
+role.
+
+=head1 INHERITANCE
+
+C<Moose::Meta::Role::Composite> is a subclass of L<Moose::Meta::Role>.
+
=head2 METHODS
=over 4
-=item B<new>
+=item B<< Moose::Meta::Role::Composite->new(%options) >>
+
+This returns a new composite role object. It accepts the same
+options as its parent class, with a few changes:
+
+=over 8
+
+=item * roles
+
+This option is an array reference containing a list of
+L<Moose::Meta::Role> object. This is a required option.
-=item B<meta>
+=item * name
-=item B<name>
+If a name is not given, one is generated from the roles provided.
-=item B<get_method_map>
+=item * apply_params(\%role_params)
-=item B<add_method>
+Creates a new RoleSummation role application with C<%role_params> and applies
+the composite role to it. The RoleSummation role application class used is
+determined by the composite role's C<application_role_summation_class>
+attribute.
+
+=item * reinitialize($metaclass)
+
+Like C<< Class::MOP::Package->reinitialize >>, but doesn't allow passing a
+string with the package name, as there is no real package for composite roles.
+
+=back
=back
=head1 BUGS
-All complex software has bugs lurking in it, and this module is no
-exception. If you find a bug please either email me, or add the bug
-to cpan-RT.
+See L<Moose/BUGS> for details on reporting bugs.
=head1 AUTHOR
=head1 COPYRIGHT AND LICENSE
-Copyright 2006-2009 by Infinity Interactive, Inc.
+Copyright 2006-2010 by Infinity Interactive, Inc.
L<http://www.iinteractive.com>
projects / gitmo/Moose.git / blobdiff