X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMouse%2FObject.pm;h=fea02ce5665d4bcba05536cb4d3fcaf3f2ba8d30;hb=983d58a5ea543a21c48cb04311883f1b36de1874;hp=33a1ce7642b21b5d3c88d568b7e8678dd225e20f;hpb=074a414dea92037837ef040f5b0c0e75d0c075a0;p=gitmo%2FMouse.git diff --git a/lib/Mouse/Object.pm b/lib/Mouse/Object.pm index 33a1ce7..fea02ce 100644 --- a/lib/Mouse/Object.pm +++ b/lib/Mouse/Object.pm @@ -1,98 +1,13 @@ package Mouse::Object; -use Mouse::Util qw(does dump); # enables strict and warnings +use Mouse::Util qw(does dump meta); # enables strict and warnings +# all the stuff are defined in XS or PP -sub _new { - my $class = shift; - - $class->meta->throw_error('Cannot call new() on an instance') if ref $class; - - my $args = $class->BUILDARGS(@_); - - my $meta = Mouse::Meta::Class->initialize($class); - my $self = $meta->new_object($args); - - # BUILDALL - if( $self->can('BUILD') ) { - for my $class (reverse $meta->linearized_isa) { - my $build = Mouse::Util::get_code_ref($class, 'BUILD') - || next; - - $self->$build($args); - } - } - - return $self; -} - -sub DESTROY { - my $self = shift; - - return unless $self->can('DEMOLISH'); # short circuit - - local $?; - - my $e = do{ - local $@; - eval{ - - # DEMOLISHALL - - # We cannot count on being able to retrieve a previously made - # metaclass, _or_ being able to make a new one during global - # destruction. However, we should still be able to use mro at - # that time (at least tests suggest so ;) - - foreach my $class (@{ Mouse::Util::get_linear_isa(ref $self) }) { - my $demolish = Mouse::Util::get_code_ref($class, 'DEMOLISH') - || next; - - $self->$demolish(); - } - }; - $@; - }; - - no warnings 'misc'; - die $e if $e; # rethrow -} - -sub BUILDALL { - my $self = shift; - - # short circuit - return unless $self->can('BUILD'); - - for my $class (reverse $self->meta->linearized_isa) { - my $build = Mouse::Util::get_code_ref($class, 'BUILD') - || next; - - $self->$build(@_); - } - return; -} - -sub DEMOLISHALL { - my $self = shift; - - # short circuit - return unless $self->can('DEMOLISH'); - - # We cannot count on being able to retrieve a previously made - # metaclass, _or_ being able to make a new one during global - # destruction. However, we should still be able to use mro at - # that time (at least tests suggest so ;) - - foreach my $class (@{ Mouse::Util::get_linear_isa(ref $self) }) { - my $demolish = Mouse::Util::get_code_ref($class, 'DEMOLISH') - || next; - - $self->$demolish(); - } - return; +sub DOES { + my($self, $class_or_role_name) = @_; + return $self->isa($class_or_role_name) || $self->does($class_or_role_name); } 1; - __END__ =head1 NAME @@ -101,57 +16,52 @@ Mouse::Object - The base object for Mouse classes =head1 VERSION -This document describes Mouse version 0.40_05 +This document describes Mouse version 0.94 =head1 METHODS -=head2 C<< new (Arguments) -> Object >> +=head2 C<< $class->new(%args | \%args) -> Object >> Instantiates a new C. This is obviously intended for subclasses. -=head2 C<< BUILDARGS (Arguments) -> HashRef >> +=head2 C<< $class->BUILDARGS(@args) -> HashRef >> -Lets you override the arguments that C takes. Return a hashref of -parameters. +Lets you override the arguments that C takes. +It must return a HashRef of parameters. -=head2 C<< BUILDALL (\%args) >> +=head2 C<< $object->BUILDALL(\%args) >> Calls C on each class in the class hierarchy. This is called at the end of C. -=head2 C<< BUILD (\%args) >> +=head2 C<< $object->BUILD(\%args) >> You may put any business logic initialization in BUILD methods. You don't need to redispatch or return any specific value. -=head2 C<< DEMOLISHALL >> +=head2 C<< $object->DEMOLISHALL >> Calls C on each class in the class hierarchy. This is called at C time. -=head2 C<< DEMOLISH >> +=head2 C<< $object->DEMOLISH >> You may put any business logic deinitialization in DEMOLISH methods. You don't need to redispatch or return any specific value. - -=head2 C<< does ($role_name) -> Bool >> +=head2 C<< $object->does($role_name) -> Bool >> This will check if the invocant's class B a given C<$role_name>. -This is similar to "isa" for object, but it checks the roles instead. - -=head2 C< Str >> - -From the Moose POD: +This is similar to C for object, but it checks the roles instead. - C'mon, how many times have you written the following code while debugging: +=head2 C<< $object->dump($maxdepth) -> Str >> - use Data::Dumper; - warn Dumper $obj; +This is a handy utility for dumping an object with Data::Dumper. +By default, the maximum depth is 3, to avoid making a mess. - It can get seriously annoying, so why not just use this. +=head2 C<< $object->meta() -> MetaClass >> -The implementation was lifted directly from Moose::Object. +This is a method which provides access to the object's metaclass. =head1 SEE ALSO