Class::MOP::Method::Accessor - Method Meta Object for accessors


Class-MOP documentation Contained in the Class-MOP distribution.

Index


Code Index:

NAME

Top

Class::MOP::Method::Accessor - Method Meta Object for accessors

SYNOPSIS

Top

    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

DESCRIPTION

Top

This is a subclass of Class::MOP::Method which is used by 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 eval'ing it.

METHODS

Top

Class::MOP::Method::Accessor->new(%options)

This returns a new Class::MOP::Method::Accessor based on the %options provided.

* attribute

This is the Class::MOP::Attribute for which accessors are being generated. This option is required.

* 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.

* is_inline

This indicates whether or not the accessor should be inlined. This defaults to false.

* name

The method name (without a package name). This is required.

* package_name

The package name for the method. This is required.

$metamethod->accessor_type

Returns the accessor type which was passed to new.

$metamethod->is_inline

Returns a boolean indicating whether or not the accessor is inlined.

$metamethod->associated_attribute

This returns the Class::MOP::Attribute object which was passed to new.

$metamethod->body

The method itself is generated when the accessor object is constructed.

AUTHORS

Top

Stevan Little <stevan@iinteractive.com>

COPYRIGHT AND LICENSE

Top


Class-MOP documentation Contained in the Class-MOP distribution.

package Class::MOP::Method::Accessor;

use strict;
use warnings;

use Carp         'confess';
use Scalar::Util 'blessed', 'weaken';

our $VERSION   = '1.12';
$VERSION = eval $VERSION;
our $AUTHORITY = 'cpan:STEVAN';

use base 'Class::MOP::Method::Generated';

sub new {
    my $class   = shift;
    my %options = @_;

    (exists $options{attribute})
        || confess "You must supply an attribute to construct with";

    (exists $options{accessor_type})
        || confess "You must supply an accessor_type to construct with";

    (blessed($options{attribute}) && $options{attribute}->isa('Class::MOP::Attribute'))
        || confess "You must supply an attribute which is a 'Class::MOP::Attribute' instance";

    ($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->{'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 $attr = (shift)->associated_attribute;
    return sub {
        $attr->set_value($_[0], $_[1]) if scalar(@_) == 2;
        $attr->get_value($_[0]);
    };
}

sub _generate_reader_method {
    my $attr = (shift)->associated_attribute;
    return sub {
        confess "Cannot assign a value to a read-only accessor" if @_ > 1;
        $attr->get_value($_[0]);
    };
}


sub _generate_writer_method {
    my $attr = (shift)->associated_attribute;
    return sub {
        $attr->set_value($_[0], $_[1]);
    };
}

sub _generate_predicate_method {
    my $attr = (shift)->associated_attribute;
    return sub {
        $attr->has_value($_[0])
    };
}

sub _generate_clearer_method {
    my $attr = (shift)->associated_attribute;
    return sub {
        $attr->clear_value($_[0])
    };
}

## Inline methods

sub _generate_accessor_method_inline {
    my $self = shift;
    my $attr = $self->associated_attribute;

    my ( $code, $e ) = $self->_eval_closure(
        {},
        'sub {'
            . $attr->inline_set( '$_[0]', '$_[1]' )
            . ' if scalar(@_) == 2; '
            . $attr->inline_get('$_[0]') . '}'
    );
    confess "Could not generate inline accessor because : $e" if $e;

    return $code;
}

sub _generate_reader_method_inline {
    my $self = shift;
    my $attr = $self->associated_attribute;

    my ( $code, $e ) = $self->_eval_closure(
        {},
        'sub {'
            . 'confess "Cannot assign a value to a read-only accessor" if @_ > 1;'
            . $attr->inline_get('$_[0]') . '}'
    );
    confess "Could not generate inline reader because : $e" if $e;

    return $code;
}

sub _generate_writer_method_inline {
    my $self = shift;
    my $attr = $self->associated_attribute;

    my ( $code, $e ) = $self->_eval_closure(
        {},
        'sub {' . $attr->inline_set( '$_[0]', '$_[1]' ) . '}'
    );
    confess "Could not generate inline writer because : $e" if $e;

    return $code;
}

sub _generate_predicate_method_inline {
    my $self = shift;
    my $attr = $self->associated_attribute;

    my ( $code, $e ) = $self->_eval_closure(
        {},
        'sub {' . $attr->inline_has('$_[0]') . '}'
    );
    confess "Could not generate inline predicate because : $e" if $e;

    return $code;
}

sub _generate_clearer_method_inline {
    my $self = shift;
    my $attr = $self->associated_attribute;

    my ( $code, $e ) = $self->_eval_closure(
        {},
        'sub {' . $attr->inline_clear('$_[0]') . '}'
    );
    confess "Could not generate inline clearer because : $e" if $e;

    return $code;
}

1;

__END__