# end bootstrapped away method section.
# (all methods below here are kept intact)
+sub get_read_method { $_[0]->reader || $_[0]->accessor }
+sub get_write_method { $_[0]->writer || $_[0]->accessor }
+
sub is_default_a_coderef {
('CODE' eq (reftype($_[0]->{'$!default'} || $_[0]->{default}) || ''))
}
sub remove_accessors {
my $self = shift;
+ # TODO:
+ # we really need to make sure to remove from the
+ # associates methods here as well. But this is
+ # such a slimly used method, I am not worried
+ # about it right now.
$_remove_accessor->($self->accessor(), $self->associated_class()) if $self->has_accessor();
$_remove_accessor->($self->reader(), $self->associated_class()) if $self->has_reader();
$_remove_accessor->($self->writer(), $self->associated_class()) if $self->has_writer();
=head2 Value management
+These methods are basically "backdoors" to the instance, which can be used
+to bypass the regular accessors, but still stay within the context of the MOP.
+
+These methods are not for general use, and should only be used if you really
+know what you are doing.
+
=over 4
=item B<set_value ($instance, $value)>
=item B<has_value ($instance)>
+Returns a boolean indicating if the item in the C<$instance> has a value in it.
+This is basically what the default C<predicate> method calls.
+
=item B<clear_value ($instance)>
+This will clear the value in the C<$instance>. This is basically what the default
+C<clearer> would call. Note that this may be done even if the attirbute does not
+have any associated read, write or clear methods.
+
=back
=head2 Informational
Returns a list of slots required by the attribute. This is usually
just one, which is the name of the attribute.
+=item B<get_read_method>
+
+=item B<get_write_method>
+
+Return the name of a method suitable for reading / writing the value of the
+attribute in the associated class. Suitable for use whether C<reader> and
+C<writer> or C<accessor> was used.
+
=back
=head2 Informational predicates
=head2 Class association
+These methods allow you to manage the attributes association with
+the class that contains it. These methods should not be used
+lightly, nor are they very magical, they are mostly used internally
+and by metaclass instances.
+
=over 4
=item B<associated_class>
+This returns the metaclass this attribute is associated with.
+
=item B<attach_to_class ($class)>
+This will store a weaken reference to C<$class> internally. You should
+note that just changing the class assocation will not remove the attribute
+from it's old class, and initialize it (and it's accessors) in the new
+C<$class>. It is up to you to do this manually.
+
=item B<detach_from_class>
+This will remove the weakened reference to the class. It does B<not>
+remove the attribute itself from the class (or remove it's accessors),
+you must do that yourself if you want too. Actually if that is what
+you want to do, you should probably be looking at
+L<Class::MOP::Class::remove_attribute> instead.
+
=back
=head2 Attribute Accessor generation
=item B<accessor_metaclass>
-=item B<associate_method>
+Accessors are generated by an accessor metaclass, which is usually
+a subclass of C<Class::MOP::Method::Accessor>. This method returns
+the name of the accessor metaclass that this attribute uses.
+
+=item B<associate_method ($method)>
+
+This will associate a C<$method> with the given attribute which is
+used internally by the accessor generator.
=item B<associated_methods>
+This will return the list of methods which have been associated with
+the C<associate_method> methods.
+
=item B<install_accessors>
This allows the attribute to generate and install code for it's own
I<accessor/reader/writer/predicate/clearer>. This is called by
C<Class::MOP::Class::remove_attribute>.
+NOTE: This does not currently remove methods from the list returned
+by C<associated_methods>, that is on the TODO list.
+
=back
=head2 Introspection
=head1 COPYRIGHT AND LICENSE
-Copyright 2006 by Infinity Interactive, Inc.
+Copyright 2006, 2007 by Infinity Interactive, Inc.
L<http://www.iinteractive.com>
projects / gitmo/Class-MOP.git / blobdiff