use Carp 'confess';
use Scalar::Util 'blessed', 'weaken', 'looks_like_number';
-our $VERSION = '0.01';
+our $VERSION = '0.04';
our $AUTHORITY = 'cpan:STEVAN';
-use base 'Class::MOP::Method';
+use base 'Class::MOP::Method::Generated';
sub new {
my $class = shift;
my %options = @_;
-
- (exists $options{options} && ref $options{options} eq 'HASH')
- || confess "You must pass a hash of options";
-
- (blessed $options{meta_instance} && $options{meta_instance}->isa('Class::MOP::Instance'))
- || confess "You must supply a meta-instance";
-
- (exists $options{attributes} && ref $options{attributes} eq 'ARRAY')
- || confess "You must pass an array of options";
-
- (blessed($_) && $_->isa('Class::MOP::Attribute'))
- || confess "You must supply a list of attributes which is a 'Class::MOP::Attribute' instance"
- for @{$options{attributes}};
-
+
+ (blessed $options{metaclass} && $options{metaclass}->isa('Class::MOP::Class'))
+ || confess "You must pass a metaclass instance if you want to inline"
+ if $options{is_inline};
+
my $self = bless {
# from our superclass
'&!body' => undef,
# specific to this subclass
- '%!options' => $options{options},
- '$!meta_instance' => $options{meta_instance},
- '@!attributes' => $options{attributes},
+ '%!options' => $options{options} || {},
+ '$!associated_metaclass' => $options{metaclass},
+ '$!is_inline' => ($options{is_inline} || 0),
} => $class;
- # we don't want this creating
- # a cycle in the code, if not
+ # we don't want this creating
+ # a cycle in the code, if not
# needed
- weaken($self->{'$!meta_instance'});
+ weaken($self->{'$!associated_metaclass'});
- $self->intialize_body;
+ $self->initialize_body;
- return $self;
+ return $self;
}
-## accessors
+## accessors
+
+sub options { (shift)->{'%!options'} }
+sub associated_metaclass { (shift)->{'$!associated_metaclass'} }
-sub options { (shift)->{'%!options'} }
-sub meta_instance { (shift)->{'$!meta_instance'} }
-sub attributes { (shift)->{'@!attributes'} }
+## cached values ...
+
+sub meta_instance {
+ my $self = shift;
+ $self->{'$!meta_instance'} ||= $self->associated_metaclass->get_meta_instance;
+}
+
+sub attributes {
+ my $self = shift;
+ $self->{'@!attributes'} ||= [ $self->associated_metaclass->compute_all_applicable_attributes ]
+}
## method
-sub intialize_body {
+sub initialize_body {
+ my $self = shift;
+ my $method_name = 'generate_constructor_method';
+
+ $method_name .= '_inline' if $self->is_inline;
+
+ $self->{'&!body'} = $self->$method_name;
+}
+
+sub generate_constructor_method {
+ return sub { Class::MOP::Class->initialize(shift)->new_object(@_) }
+}
+
+sub generate_constructor_method_inline {
my $self = shift;
- # TODO:
- # the %options should also include a both
- # a call 'initializer' and call 'SUPER::'
- # options, which should cover approx 90%
- # of the possible use cases (even if it
- # requires some adaption on the part of
- # the author, after all, nothing is free)
+
my $source = 'sub {';
$source .= "\n" . 'my ($class, %params) = @_;';
+
+ $source .= "\n" . 'return Class::MOP::Class->initialize($class)->new_object(%params)';
+ $source .= "\n" . ' if $class ne \'' . $self->associated_metaclass->name . '\';';
+
$source .= "\n" . 'my $instance = ' . $self->meta_instance->inline_create_instance('$class');
- $source .= ";\n" . (join ";\n" => map {
- $self->_generate_slot_initializer($_)
+ $source .= ";\n" . (join ";\n" => map {
+ $self->_generate_slot_initializer($_)
} 0 .. (@{$self->attributes} - 1));
$source .= ";\n" . 'return $instance';
- $source .= ";\n" . '}';
- warn $source if $self->options->{debug};
-
+ $source .= ";\n" . '}';
+ warn $source if $self->options->{debug};
+
my $code;
{
# NOTE:
# create the nessecary lexicals
- # to be picked up in the eval
+ # to be picked up in the eval
my $attrs = $self->attributes;
-
+
$code = eval $source;
confess "Could not eval the constructor :\n\n$source\n\nbecause :\n\n$@" if $@;
}
- $self->{'&!body'} = $code;
+ return $code;
}
sub _generate_slot_initializer {
my $self = shift;
my $index = shift;
-
+
my $attr = $self->attributes->[$index];
-
+
my $default;
if ($attr->has_default) {
# NOTE:
# default values can either be CODE refs
- # in which case we need to call them. Or
+ # in which case we need to call them. Or
# they can be scalars (strings/numbers)
# in which case we can just deal with them
# in the code we eval.
$default = "'$default'";
}
}
+ } elsif( $attr->has_builder ) {
+ $default = '$instance->'.$attr->builder;
}
- $self->meta_instance->inline_set_slot_value(
- '$instance',
- ("'" . $attr->name . "'"),
- ('$params{\'' . $attr->init_arg . '\'}' . (defined $default ? (' || ' . $default) : ''))
- );
+
+ if ( defined $attr->init_arg ) {
+ return (
+ 'if(exists $params{\'' . $attr->init_arg . '\'}){' . "\n" .
+ $self->meta_instance->inline_set_slot_value(
+ '$instance',
+ ("'" . $attr->name . "'"),
+ '$params{\'' . $attr->init_arg . '\'}' ) . "\n" .
+ '} ' . (!defined $default ? '' : 'else {' . "\n" .
+ $self->meta_instance->inline_set_slot_value(
+ '$instance',
+ ("'" . $attr->name . "'"),
+ $default ) . "\n" .
+ '}')
+ );
+ } elsif ( defined $default ) {
+ return (
+ $self->meta_instance->inline_set_slot_value(
+ '$instance',
+ ("'" . $attr->name . "'"),
+ $default ) . "\n"
+ );
+ } else { return '' }
}
1;
=pod
-=head1 NAME
+=head1 NAME
Class::MOP::Method::Constructor - Method Meta Object for constructors
=head1 SYNOPSIS
+ use Class::MOP::Method::Constructor;
+
+ my $constructor = Class::MOP::Method::Constructor->new(
+ metaclass => $metaclass,
+ options => {
+ debug => 1, # this is all for now
+ },
+ );
+
+ # calling the constructor ...
+ $constructor->body->($metaclass->name, %params);
+
=head1 DESCRIPTION
+This is a subclass of C<Class::MOP::Method> which deals with
+class constructors. This is used when making a class immutable
+to generate an optimized constructor.
+
=head1 METHODS
=over 4
-=item B<new>
+=item B<new (metaclass => $meta, options => \%options)>
+
+=item B<options>
+
+This returns the options HASH which is passed into C<new>.
+
+=item B<associated_metaclass>
+
+This returns the metaclass which is passed into C<new>.
=item B<attributes>
+This returns the list of attributes which are associated with the
+metaclass which is passed into C<new>.
+
=item B<meta_instance>
-=item B<options>
+This returns the meta instance which is associated with the
+metaclass which is passed into C<new>.
+
+=item B<is_inline>
+
+This returns a boolean, but since constructors are very rarely
+not inlined, this always returns true for now.
+
+=item B<initialize_body>
+
+This creates the code reference for the constructor itself.
+
+=back
+
+=head2 Method Generators
+
+=over 4
+
+=item B<generate_constructor_method>
-=item B<intialize_body>
+=item B<generate_constructor_method_inline>
=back
=head1 COPYRIGHT AND LICENSE
-Copyright 2006 by Infinity Interactive, Inc.
+Copyright 2006-2008 by Infinity Interactive, Inc.
L<http://www.iinteractive.com>
This library is free software; you can redistribute it and/or modify
-it under the same terms as Perl itself.
+it under the same terms as Perl itself.
=cut