X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FMouse.git;a=blobdiff_plain;f=lib%2FMouse%2FObject.pm;h=9eb8646bceacbe895e2d655148970920720dccf9;hp=89bd8cac9cccda0cba92355431fd8c49f60be373;hb=f3e1112299b631f1ab6150159eaa414dca37a42c;hpb=53875581c2449e237cc1135b8c2cf1674a874aed diff --git a/lib/Mouse/Object.pm b/lib/Mouse/Object.pm index 89bd8ca..9eb8646 100644 --- a/lib/Mouse/Object.pm +++ b/lib/Mouse/Object.pm @@ -1,118 +1,62 @@ package Mouse::Object; -use strict; -use warnings; +use Mouse::Util qw(does dump meta); # enables strict and warnings -use Mouse::Util qw(does dump); +sub new; +sub BUILDARGS; +sub BUILDALL; -sub new { - my $class = shift; - - $class->throw_error('Cannot call new() on an instance') if ref $class; - - my $args = $class->BUILDARGS(@_); - - my $instance = Mouse::Meta::Class->initialize($class)->new_object($args); - $instance->BUILDALL($args); - return $instance; -} - -sub BUILDARGS { - my $class = shift; - - if (scalar @_ == 1) { - (ref($_[0]) eq 'HASH') - || $class->meta->throw_error("Single parameters to new() must be a HASH ref"); - return {%{$_[0]}}; - } - else { - return {@_}; - } -} - -sub DESTROY { shift->DEMOLISHALL } - -sub BUILDALL { - my $self = shift; - - # short circuit - return unless $self->can('BUILD'); - - for my $class (reverse $self->meta->linearized_isa) { - no strict 'refs'; - no warnings 'once'; - my $code = *{ $class . '::BUILD' }{CODE} - or next; - $code->($self, @_); - } - 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 = do{ no strict 'refs'; *{"${class}::DEMOLISH"}{CODE} }; - $self->$demolish() - if defined $demolish; - } - return; -} +sub DESTROY; +sub DEMOLISHALL; 1; - __END__ =head1 NAME -Mouse::Object - we don't need to steenkin' constructor +Mouse::Object - The base object for Mouse classes + +=head1 VERSION + +This document describes Mouse version 0.50_03 =head1 METHODS -=head2 new arguments -> object +=head2 C<< new (Arguments) -> Object >> -Instantiates a new Mouse::Object. This is obviously intended for subclasses. +Instantiates a new C. This is obviously intended for subclasses. -=head2 BUILDALL \%args +=head2 C<< BUILDARGS (Arguments) -> HashRef >> -Calls L on each class in the class hierarchy. This is called at the -end of L. +Lets you override the arguments that C takes. Return a hashref of +parameters. -=head2 BUILD \%args +=head2 C<< BUILDALL (\%args) >> -You may put any business logic initialization in BUILD methods. You don't -need to redispatch or return any specific value. +Calls C on each class in the class hierarchy. This is called at the +end of C. -=head2 BUILDARGS +=head2 C<< BUILD (\%args) >> -Lets you override the arguments that C takes. Return a hashref of -parameters. +You may put any business logic initialization in BUILD methods. You don't +need to redispatch or return any specific value. -=head2 DEMOLISHALL +=head2 C<< DEMOLISHALL >> -Calls L on each class in the class hierarchy. This is called at -L time. +Calls C on each class in the class hierarchy. This is called at +C time. -=head2 DEMOLISH +=head2 C<< DEMOLISH >> You may put any business logic deinitialization in DEMOLISH methods. You don't need to redispatch or return any specific value. -=head2 does $role_name +=head2 C<< does ($role_name) -> Bool >> -This will check if the invocant's class "does" a given C<$role_name>. +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 B +=head2 C<< dump ($maxdepth) -> Str >> From the Moose POD: @@ -125,6 +69,9 @@ From the Moose POD: The implementation was lifted directly from Moose::Object. -=cut +=head1 SEE ALSO + +L +=cut