use Carp 'confess';
use Scalar::Util 'blessed', 'weaken', 'looks_like_number';
-our $VERSION = '0.01';
+our $VERSION = '0.80';
+$VERSION = eval $VERSION;
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}};
-
- my $self = bless {
+
+ (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};
+
+ ($options{package_name} && $options{name})
+ || confess "You must supply the package_name and name parameters $Class::MOP::Method::UPGRADE_ERROR_TEXT";
+
+ my $self = $class->_new(\%options);
+
+ # we don't want this creating
+ # a cycle in the code, if not
+ # needed
+ weaken($self->{'associated_metaclass'});
+
+ $self->_initialize_body;
+
+ return $self;
+}
+
+sub _new {
+ my $class = shift;
+ my $options = @_ == 1 ? $_[0] : {@_};
+
+ bless {
# from our superclass
- '&!body' => undef,
+ 'body' => undef,
+ 'package_name' => $options->{package_name},
+ 'name' => $options->{name},
# specific to this subclass
- '%!options' => $options{options},
- '$!meta_instance' => $options{meta_instance},
- '@!attributes' => $options{attributes},
- } => $class;
+ '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
- # needed
- weaken($self->{'$!meta_instance'});
+sub can_be_inlined { 1 }
- $self->intialize_body;
+## accessors
- return $self;
+sub options { (shift)->{'options'} }
+sub associated_metaclass { (shift)->{'associated_metaclass'} }
+
+## cached values ...
+
+sub meta_instance {
+ warn 'The meta_instance method has been made private.'
+ . " The public version is deprecated and will be removed in a future release.\n";
+ shift->_meta_instance;
}
-## accessors
+sub _meta_instance {
+ my $self = shift;
+ $self->{'meta_instance'} ||= $self->associated_metaclass->get_meta_instance;
+}
-sub options { (shift)->{'%!options'} }
-sub meta_instance { (shift)->{'$!meta_instance'} }
-sub attributes { (shift)->{'@!attributes'} }
+sub attributes {
+ warn 'The attributes method is deprecated.'
+ . " Use ->associated_metaclass->get_all_attributes instead.\n";
+
+ my $self = shift;
+ $self->{'attributes'} ||= [ $self->associated_metaclass->get_all_attributes ]
+}
## method
-sub intialize_body {
+sub initialize_body {
+ warn 'The initialize_body method has been made private.'
+ . " The public version is deprecated and will be removed in a future release.\n";
+ shift->_initialize_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 {
+ warn 'The generate_constructor_method method has been made private.'
+ . " The public version is deprecated and will be removed in a future release.\n";
+ shift->_generate_constructor_method;
+}
+
+sub _generate_constructor_method {
+ return sub { Class::MOP::Class->initialize(shift)->new_object(@_) }
+}
+
+sub generate_constructor_method_inline {
+ warn 'The generate_constructor_method_inline method has been made private.'
+ . " The public version is deprecated and will be removed in a future release.\n";
+ shift->_generate_constructor_method_inline;
+}
+
+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 $close_over = {};
+
my $source = 'sub {';
- $source .= "\n" . 'my ($class, %params) = @_;';
- $source .= "\n" . 'my $instance = ' . $self->meta_instance->inline_create_instance('$class');
- $source .= ";\n" . (join ";\n" => map {
- $self->_generate_slot_initializer($_)
- } 0 .. (@{$self->attributes} - 1));
+ $source .= "\n" . 'my $class = shift;';
+
+ $source .= "\n" . 'return Class::MOP::Class->initialize($class)->new_object(@_)';
+ $source .= "\n" . ' if $class ne \'' . $self->associated_metaclass->name . '\';';
+
+ $source .= "\n" . 'my $params = @_ == 1 ? $_[0] : {@_};';
+
+ $source .= "\n" . 'my $instance = ' . $self->_meta_instance->inline_create_instance('$class');
+ $source .= ";\n" . (join ";\n" => map {
+ $self->_generate_slot_initializer($_, $close_over)
+ } $self->associated_metaclass->get_all_attributes);
$source .= ";\n" . 'return $instance';
- $source .= ";\n" . '}';
- warn $source if $self->options->{debug};
-
- my $code;
- {
- # NOTE:
- # create the nessecary lexicals
- # 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;
+ $source .= ";\n" . '}';
+ warn $source if $self->options->{debug};
+
+ my $code = $self->_eval_closure(
+ $close_over,
+ $source
+ );
+ confess "Could not eval the constructor :\n\n$source\n\nbecause :\n\n$@" if $@;
+
+ return $code;
}
sub _generate_slot_initializer {
my $self = shift;
- my $index = shift;
-
- my $attr = $self->attributes->[$index];
-
+ my $attr = shift;
+ my $close = shift;
+
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.
if ($attr->is_default_a_coderef) {
- $default = '$attrs->[' . $index . ']->default($instance)';
+ my $idx = @{$close->{'@defaults'}||=[]};
+ push(@{$close->{'@defaults'}}, $attr->default);
+ $default = '$defaults[' . $idx . ']->($instance)';
}
else {
$default = $attr->default;
$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) : ''))
- );
-}
-1;
+ 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->execute($metaclass->name, %params);
+
=head1 DESCRIPTION
+This is a subclass of C<Class::MOP::Method> which generates
+constructor methods.
+
=head1 METHODS
=over 4
-=item B<new>
+=item B<< Class::MOP::Method::Constructor->new(%options) >>
+
+This creates a new constructor object. It accepts a hash reference of
+options.
+
+=over 8
+
+=item * metaclass
+
+This should be a L<Class::MOP::Class> object. It is required.
+
+=item * name
+
+The method name (without a package name). This is required.
+
+=item * package_name
+
+The package name for the method. This is required.
+
+=item * is_inline
+
+This indicates whether or not the constructor should be inlined. This
+defaults to false.
+
+=back
+
+=item B<< $metamethod->is_inline >>
+
+Returns a boolean indicating whether or not the constructor is
+inlined.
-=item B<attributes>
+=item B<< $metamethod->associated_metaclass >>
-=item B<meta_instance>
+This returns the L<Class::MOP::Class> object for the method.
-=item B<options>
+=item B<< $metamethod->can_be_inlined >>
-=item B<intialize_body>
+This method always returns true in this class. It exists so that
+subclasses (as in Moose) can do some sort of checking to determine
+whether or not inlining the constructor is safe.
=back
=head1 COPYRIGHT AND LICENSE
-Copyright 2006 by Infinity Interactive, Inc.
+Copyright 2006-2009 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