$Class::MOP::Method::Accessor::VERSION = '2.1305'; # TRIAL
use strict;
use Carp 'confess';
use Scalar::Util 'blessed', 'weaken';
sub new {
my $class = shift;
my %options = @_;
(exists $options{attribute})
|| $class->_throw_exception( MustSupplyAnAttributeToConstructWith => params => \%options,
class => $class,
);
(exists $options{accessor_type})
|| $class->_throw_exception( MustSupplyAnAccessorTypeToConstructWith => params => \%options,
class => $class,
);
(blessed($options{attribute}) && $options{attribute}->isa('Class::MOP::Attribute'))
|| $class->_throw_exception( MustSupplyAClassMOPAttributeInstance => params => \%options,
class => $class
);
($options{package_name} && $options{name})
|| $class->_throw_exception( MustSupplyPackageNameAndName => params => \%options,
class => $class
);
my $self = $class->_new(\%options);
# we don't want this creating
# a cycle in the code, if not
# needed
weaken($self->{'attribute'});
$self->_initialize_body;
return $self;
}
sub _new {
my $class = shift;
return Class::MOP::Class->initialize($class)->new_object(@_)
if $class ne __PACKAGE__;
my $params = @_ == 1 ? $_[0] : {@_};
return bless {
# inherited from Class::MOP::Method
body => $params->{body},
associated_metaclass => $params->{associated_metaclass},
package_name => $params->{package_name},
name => $params->{name},
original_method => $params->{original_method},
# inherit from Class::MOP::Generated
is_inline => $params->{is_inline} || 0,
definition_context => $params->{definition_context},
# defined in this class
attribute => $params->{attribute},
accessor_type => $params->{accessor_type},
} => $class;
}
## accessors
sub associated_attribute { (shift)->{'attribute'} }
sub accessor_type { (shift)->{'accessor_type'} }
## factory
sub _initialize_body {
my $self = shift;
my $method_name = join "_" => (
'_generate',
$self->accessor_type,
'method',
($self->is_inline ? 'inline' : ())
);
$self->{'body'} = $self->$method_name();
}
## generators
sub _generate_accessor_method {
my $self = shift;
my $attr = $self->associated_attribute;
return sub {
if (@_ >= 2) {
$attr->set_value($_[0], $_[1]);
}
$attr->get_value($_[0]);
};
}
sub _generate_accessor_method_inline {
my $self = shift;
my $attr = $self->associated_attribute;
return try {
$self->_compile_code([
'sub {',
'if (@_ > 1) {',
$attr->_inline_set_value('$_[0]', '$_[1]'),
'}',
$attr->_inline_get_value('$_[0]'),
'}',
]);
}
catch {
$self->_throw_exception( CouldNotGenerateInlineAttributeMethod => instance => $self,
error => $_,
option => "accessor"
);
};
}
sub _generate_reader_method {
my $self = shift;
my $attr = $self->associated_attribute;
my $class = $attr->associated_class;
return sub {
$self->_throw_exception( CannotAssignValueToReadOnlyAccessor => class_name => $class->name,
value => $_[1],
attribute => $attr
)
if @_ > 1;
$attr->get_value($_[0]);
};
}
sub _generate_reader_method_inline {
my $self = shift;
my $attr = $self->associated_attribute;
my $attr_name = $attr->name;
return try {
$self->_compile_code([
'sub {',
'if (@_ > 1) {',
$self->_inline_throw_exception( CannotAssignValueToReadOnlyAccessor =>
'class_name => ref $_[0],'.
'value => $_[1],'.
"attribute_name => '".$attr_name."'",
) . ';',
'}',
$attr->_inline_get_value('$_[0]'),
'}',
]);
}
catch {
$self->_throw_exception( CouldNotGenerateInlineAttributeMethod => instance => $self,
error => $_,
option => "reader"
);
};
}
sub _inline_throw_exception {
my ( $self, $exception_type, $throw_args ) = @_;
return 'die Module::Runtime::use_module("Moose::Exception::' . $exception_type . '")->new(' . ($throw_args || '') . ')';
}
sub _generate_writer_method {
my $self = shift;
my $attr = $self->associated_attribute;
return sub {
$attr->set_value($_[0], $_[1]);
};
}
sub _generate_writer_method_inline {
my $self = shift;
my $attr = $self->associated_attribute;
return try {
$self->_compile_code([
'sub {',
$attr->_inline_set_value('$_[0]', '$_[1]'),
'}',
]);
}
catch {
$self->_throw_exception( CouldNotGenerateInlineAttributeMethod => instance => $self,
error => $_,
option => "writer"
);
};
}
sub _generate_predicate_method {
my $self = shift;
my $attr = $self->associated_attribute;
return sub {
$attr->has_value($_[0])
};
}
sub _generate_predicate_method_inline {
my $self = shift;
my $attr = $self->associated_attribute;
return try {
$self->_compile_code([
'sub {',
$attr->_inline_has_value('$_[0]'),
'}',
]);
}
catch {
$self->_throw_exception( CouldNotGenerateInlineAttributeMethod => instance => $self,
error => $_,
option => "predicate"
);
};
}
sub _generate_clearer_method {
my $self = shift;
my $attr = $self->associated_attribute;
return sub {
$attr->clear_value($_[0])
};
}
sub _generate_clearer_method_inline {
my $self = shift;
my $attr = $self->associated_attribute;
return try {
$self->_compile_code([
'sub {',
$attr->_inline_clear_value('$_[0]'),
'}',
]);
}
catch {
$self->_throw_exception( CouldNotGenerateInlineAttributeMethod => instance => $self,
error => $_,
option => "clearer"
);
};
}
1;
# ABSTRACT: Method Meta Object for accessors
__END__
=pod
=encoding UTF-8
=head1 NAME
Class::MOP::Method::Accessor - Method Meta Object for accessors
=head1 VERSION
version 2.1305
=head1 SYNOPSIS
use Class::MOP::Method::Accessor;
my $reader = Class::MOP::Method::Accessor->new(
attribute => $attribute,
is_inline => 1,
accessor_type => 'reader',
);
$reader->body->execute($instance); # call the reader method
=head1 DESCRIPTION
This is a subclass of C<Class::MOP::Method> which is used by
C<Class::MOP::Attribute> to generate accessor code. It handles
generation of readers, writers, predicates and clearers. For each type
of method, it can either create a subroutine reference, or actually
inline code by generating a string and C<eval>'ing it.
=head1 METHODS
=over 4
=item B<< Class::MOP::Method::Accessor->new(%options) >>
This returns a new C<Class::MOP::Method::Accessor> based on the
C<%options> provided.
=over 4
=item * attribute
This is the C<Class::MOP::Attribute> for which accessors are being
generated. This option is required.
=item * accessor_type
This is a string which should be one of "reader", "writer",
"accessor", "predicate", or "clearer". This is the type of method
being generated. This option is required.
=item * is_inline
This indicates whether or not the accessor should be inlined. This
defaults to false.
=item * name
The method name (without a package name). This is required.
=item * package_name
The package name for the method. This is required.
=back
=item B<< $metamethod->accessor_type >>
Returns the accessor type which was passed to C<new>.
=item B<< $metamethod->is_inline >>
Returns a boolean indicating whether or not the accessor is inlined.
=item B<< $metamethod->associated_attribute >>
This returns the L<Class::MOP::Attribute> object which was passed to
C<new>.
=item B<< $metamethod->body >>
The method itself is I<generated> when the accessor object is
constructed.
=back
=head1 AUTHORS
=over 4
=item *
Stevan Little <stevan.little@iinteractive.com>
=item *
Dave Rolsky <autarch@urth.org>
=item *
Jesse Luehrs <doy@tozt.net>
=item *
Shawn M Moore <code@sartak.org>
=item *
יובל קוג'מן (Yuval Kogman) <nothingmuch@woobling.org>
=item *
Karen Etheridge <ether@cpan.org>
=item *
Florian Ragwitz <rafl@debian.org>
=item *
Hans Dieter Pearcey <hdp@weftsoar.net>
=item *
Chris Prather <chris@prather.org>
=item *
Matt S Trout <mst@shadowcat.co.uk>
=back
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2006 by Infinity Interactive, Inc..
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut