2 package Class::MOP::Method::Constructor;
8 use Scalar::Util 'blessed', 'weaken';
11 our $VERSION = '1.11';
12 $VERSION = eval $VERSION;
13 our $AUTHORITY = 'cpan:STEVAN';
15 use base 'Class::MOP::Method::Inlined';
21 (blessed $options{metaclass} && $options{metaclass}->isa('Class::MOP::Class'))
22 || confess "You must pass a metaclass instance if you want to inline"
23 if $options{is_inline};
25 ($options{package_name} && $options{name})
26 || confess "You must supply the package_name and name parameters $Class::MOP::Method::UPGRADE_ERROR_TEXT";
28 my $self = $class->_new(\%options);
30 # we don't want this creating
31 # a cycle in the code, if not
33 weaken($self->{'associated_metaclass'});
35 $self->_initialize_body;
43 return Class::MOP::Class->initialize($class)->new_object(@_)
44 if $class ne __PACKAGE__;
46 my $params = @_ == 1 ? $_[0] : {@_};
49 # inherited from Class::MOP::Method
50 body => $params->{body},
51 # associated_metaclass => $params->{associated_metaclass}, # overriden
52 package_name => $params->{package_name},
53 name => $params->{name},
54 original_method => $params->{original_method},
56 # inherited from Class::MOP::Generated
57 is_inline => $params->{is_inline} || 0,
58 definition_context => $params->{definition_context},
60 # inherited from Class::MOP::Inlined
61 _expected_method_class => $params->{_expected_method_class},
63 # defined in this subclass
64 options => $params->{options} || {},
65 associated_metaclass => $params->{metaclass},
71 sub options { (shift)->{'options'} }
72 sub associated_metaclass { (shift)->{'associated_metaclass'} }
78 $self->{'attributes'} ||= [ $self->associated_metaclass->get_all_attributes ]
83 sub _initialize_body {
85 my $method_name = '_generate_constructor_method';
87 $method_name .= '_inline' if $self->is_inline;
89 $self->{'body'} = $self->$method_name;
92 sub _generate_constructor_method {
93 return sub { Class::MOP::Class->initialize(shift)->new_object(@_) }
96 sub _generate_constructor_method_inline {
99 my $defaults = [map { $_->default } @{ $self->_attributes }];
102 '$defaults' => \$defaults,
105 my $source = 'sub {';
106 $source .= "\n" . 'my $class = shift;';
108 $source .= "\n" . 'return Class::MOP::Class->initialize($class)->new_object(@_)';
109 $source .= "\n" . ' if $class ne \'' . $self->associated_metaclass->name . '\';';
111 $source .= "\n" . 'my $params = @_ == 1 ? $_[0] : {@_};';
113 $source .= "\n" . 'my $instance = ' . $self->associated_metaclass->inline_create_instance('$class');
115 $source .= ";\n" . (join ";\n" => map {
116 $self->_generate_slot_initializer($_, $idx++)
117 } @{ $self->_attributes });
118 if (Class::MOP::metaclass_is_weak($self->associated_metaclass->name)) {
119 $source .= ";\n" . $self->associated_metaclass->_inline_set_mop_slot('$instance', 'Class::MOP::class_of($class)');
121 $source .= ";\n" . 'return $instance';
122 $source .= ";\n" . '}';
123 warn $source if $self->options->{debug};
126 $self->_compile_code(
128 environment => $close_over,
132 confess "Could not eval the constructor :\n\n$source\n\nbecause :\n\n$_";
138 sub _generate_slot_initializer {
144 if ($attr->has_default) {
145 $default = $self->_generate_default_value($attr, $idx);
146 } elsif( $attr->has_builder ) {
147 $default = '$instance->'.$attr->builder;
150 if ( defined( my $init_arg = $attr->init_arg ) ) {
152 'if(exists $params->{\''
153 . $init_arg . '\'}){' . "\n"
156 '$params->{\'' . $init_arg . '\'}'
160 !defined $default ? '' : 'else {' . "\n"
169 elsif ( defined $default ) {
183 sub _generate_default_value {
184 my ($self, $attr, $index) = @_;
186 # default values can either be CODE refs
187 # in which case we need to call them. Or
188 # they can be scalars (strings/numbers)
189 # in which case we can just deal with them
190 # in the code we eval.
191 if ($attr->is_default_a_coderef) {
192 return '$defaults->[' . $index . ']->($instance)';
195 return '$defaults->[' . $index . ']';
207 Class::MOP::Method::Constructor - Method Meta Object for constructors
211 use Class::MOP::Method::Constructor;
213 my $constructor = Class::MOP::Method::Constructor->new(
214 metaclass => $metaclass,
216 debug => 1, # this is all for now
220 # calling the constructor ...
221 $constructor->body->execute($metaclass->name, %params);
225 This is a subclass of C<Class::MOP::Method> which generates
232 =item B<< Class::MOP::Method::Constructor->new(%options) >>
234 This creates a new constructor object. It accepts a hash reference of
241 This should be a L<Class::MOP::Class> object. It is required.
245 The method name (without a package name). This is required.
249 The package name for the method. This is required.
253 This indicates whether or not the constructor should be inlined. This
258 =item B<< $metamethod->is_inline >>
260 Returns a boolean indicating whether or not the constructor is
263 =item B<< $metamethod->associated_metaclass >>
265 This returns the L<Class::MOP::Class> object for the method.
271 Stevan Little E<lt>stevan@iinteractive.comE<gt>
273 =head1 COPYRIGHT AND LICENSE
275 Copyright 2006-2010 by Infinity Interactive, Inc.
277 L<http://www.iinteractive.com>
279 This library is free software; you can redistribute it and/or modify
280 it under the same terms as Perl itself.