package Class::MOP::Method::Accessor; our $VERSION = '2.2207'; use strict; use warnings; use Scalar::Util 'blessed', 'weaken'; use Try::Tiny; use parent 'Class::MOP::Method::Generated'; 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 _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.2207 =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 which is used by C 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'ing it. =head1 METHODS =over 4 =item B<< Class::MOP::Method::Accessor->new(%options) >> This returns a new C based on the C<%options> provided. =over 4 =item * attribute This is the C 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. =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 object which was passed to C. =item B<< $metamethod->body >> The method itself is I when the accessor object is constructed. =back =head1 AUTHORS =over 4 =item * Stevan Little =item * Dave Rolsky =item * Jesse Luehrs =item * Shawn M Moore =item * יובל קוג'מן (Yuval Kogman) =item * Karen Etheridge =item * Florian Ragwitz =item * Hans Dieter Pearcey =item * Chris Prather =item * Matt S Trout =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