2 package # hide the package from PAUSE
3 ClassEncapsulatedAttributes;
10 use base 'Class::MOP::Class';
13 (shift)->SUPER::initialize(@_,
14 # use the custom attribute metaclass here
15 ':attribute_metaclass' => 'ClassEncapsulatedAttributes::Attribute'
19 sub construct_instance {
20 my ($class, %params) = @_;
21 my $meta_instance = Class::MOP::Instance->new($class);
22 foreach my $current_class ($class->class_precedence_list()) {
23 $meta_instance->add_slot($current_class => {})
24 unless $meta_instance->has_slot($current_class);
25 my $meta = $current_class->meta;
26 foreach my $attr_name ($meta->get_attribute_list()) {
27 my $attr = $meta->get_attribute($attr_name);
28 $attr->initialize_instance_slot($meta, $meta_instance, \%params);
31 return $meta_instance->get_instance;
34 package # hide the package from PAUSE
35 ClassEncapsulatedAttributes::Attribute;
40 our $VERSION = '0.04';
42 use base 'Class::MOP::Attribute';
44 sub initialize_instance_slot {
45 my ($self, $class, $meta_instance, $params) = @_;
46 # if the attr has an init_arg, use that, otherwise,
47 # use the attributes name itself as the init_arg
48 my $init_arg = $self->init_arg();
49 # try to fetch the init arg from the %params ...
51 $val = $params->{$class->name}->{$init_arg}
52 if exists $params->{$class->name} &&
53 exists ${$params->{$class->name}}{$init_arg};
54 # if nothing was in the %params, we can use the
55 # attribute's default value (if it has one)
56 if (!defined $val && $self->has_default) {
57 $val = $self->default($meta_instance->get_instance);
59 # now add this to the instance structure
60 $meta_instance->get_slot_value(
61 $meta_instance->get_instance,
63 )->{$self->name} = $val;
66 sub generate_accessor_method {
67 my ($self, $attr_name) = @_;
68 my $class_name = $self->associated_class->name;
70 \$_[0]->{'$class_name'}->{'$attr_name'} = \$_[1] if scalar(\@_) == 2;
71 \$_[0]->{'$class_name'}->{'$attr_name'};
75 sub generate_reader_method {
76 my ($self, $attr_name) = @_;
77 my $class_name = $self->associated_class->name;
79 Carp::confess "Cannot assign a value to a read-only accessor" if \@_ > 1;
80 \$_[0]->{'$class_name'}->{'$attr_name'};
84 sub generate_writer_method {
85 my ($self, $attr_name) = @_;
86 my $class_name = $self->associated_class->name;
88 \$_[0]->{'$class_name'}->{'$attr_name'} = \$_[1];
92 sub generate_predicate_method {
93 my ($self, $attr_name) = @_;
94 my $class_name = $self->associated_class->name;
96 defined \$_[0]->{'$class_name'}->{'$attr_name'} ? 1 : 0;
100 ## &remove_attribute is left as an exercise for the reader :)
110 ClassEncapsulatedAttributes - A set of example metaclasses with class encapsulated attributes
116 use metaclass 'ClassEncapsulatedAttributes';
118 Foo->meta->add_attribute('foo' => (
119 accessor => 'Foo_foo',
120 default => 'init in FOO'
125 $class->meta->new_object(@_);
131 # duplicate the attribute name here
132 Bar->meta->add_attribute('foo' => (
133 accessor => 'Bar_foo',
134 default => 'init in BAR'
137 # ... later in other code ...
139 my $bar = Bar->new();
140 prints $bar->Bar_foo(); # init in BAR
141 prints $bar->Foo_foo(); # init in FOO
146 'Foo' => { 'foo' => 'Foo::foo' },
147 'Bar' => { 'foo' => 'Bar::foo' }
150 prints $bar->Bar_foo(); # Foo::foo
151 prints $bar->Foo_foo(); # Bar::foo
155 This is an example metaclass which encapsulates a class's
156 attributes on a per-class basis. This means that there is no
157 possibility of name clashes with inherited attributes. This
158 is similar to how C++ handles its data members.
160 =head1 ACKNOWLEDGEMENTS
162 Thanks to Yuval "nothingmuch" Kogman for the idea for this example.
166 Stevan Little E<lt>stevan@iinteractive.comE<gt>
168 =head1 COPYRIGHT AND LICENSE
170 Copyright 2006 by Infinity Interactive, Inc.
172 L<http://www.iinteractive.com>
174 This library is free software; you can redistribute it and/or modify
175 it under the same terms as Perl itself.