2 package Moose::Meta::Class;
8 use Scalar::Util 'weaken';
10 our $VERSION = '0.04';
12 use base 'Class::MOP::Class';
14 sub construct_instance {
15 my ($class, %params) = @_;
16 my $instance = $params{'__INSTANCE__'} || {};
17 foreach my $attr ($class->compute_all_applicable_attributes()) {
18 my $init_arg = $attr->init_arg();
19 # try to fetch the init arg from the %params ...
21 if (exists $params{$init_arg}) {
22 $val = $params{$init_arg};
25 # skip it if it's lazy
26 next if $attr->is_lazy;
27 # and die if it is required
28 confess "Attribute (" . $attr->name . ") is required"
31 # if nothing was in the %params, we can use the
32 # attribute's default value (if it has one)
33 if (!defined $val && $attr->has_default) {
34 $val = $attr->default($instance);
37 if ($attr->has_type_constraint) {
38 if ($attr->should_coerce && $attr->type_constraint->has_coercion) {
39 $val = $attr->type_constraint->coercion->coerce($val);
41 (defined($attr->type_constraint->check($val)))
42 || confess "Attribute (" . $attr->name . ") does not pass the type contraint with '$val'";
45 $instance->{$attr->name} = $val;
46 if (defined $val && $attr->is_weak_ref) {
47 weaken($instance->{$attr->name});
53 sub add_override_method_modifier {
54 my ($self, $name, $method, $_super_package) = @_;
55 # need this for roles ...
56 $_super_package ||= $self->name;
57 my $super = $self->find_next_method_by_name($name);
59 || confess "You cannot override '$name' because it has no super method";
60 $self->add_method($name => sub {
63 no warnings 'redefine';
64 local *{$_super_package . '::super'} = sub { $super->(@args) };
65 return $method->(@args);
69 sub add_augment_method_modifier {
70 my ($self, $name, $method) = @_;
71 my $super = $self->find_next_method_by_name($name);
73 || confess "You cannot augment '$name' because it has no super method";
74 $self->add_method($name => sub {
77 no warnings 'redefine';
78 local *{$super->package_name . '::inner'} = sub { $method->(@args) };
79 return $super->(@args);
91 Moose::Meta::Class - The Moose metaclass
95 This is a subclass of L<Class::MOP::Class> with Moose specific
98 For the most part, the only time you will ever encounter an
99 instance of this class is if you are doing some serious deep
100 introspection. To really understand this class, you need to refer
101 to the L<Class::MOP::Class> documentation.
107 =item B<construct_instance>
109 This provides some Moose specific extensions to this method, you
110 almost never call this method directly unless you really know what
113 This method makes sure to handle the moose weak-ref, type-constraint
114 and type coercion features.
116 =item B<add_override_method_modifier ($name, $method)>
118 =item B<add_augment_method_modifier ($name, $method)>
124 All complex software has bugs lurking in it, and this module is no
125 exception. If you find a bug please either email me, or add the bug
130 Stevan Little E<lt>stevan@iinteractive.comE<gt>
132 =head1 COPYRIGHT AND LICENSE
134 Copyright 2006 by Infinity Interactive, Inc.
136 L<http://www.iinteractive.com>
138 This library is free software; you can redistribute it and/or modify
139 it under the same terms as Perl itself.