examples/InstanceCountingClass.pod

   1
   2 package # hide the package from PAUSE
   3     InstanceCountingClass;
   4
   5 use strict;
   6 use warnings;
   7
   8 our $VERSION = '0.02';
   9
  10 use base 'Class::MOP::Class';
  11
  12 InstanceCountingClass->meta->add_attribute('$:count' => (
  13     reader  => 'get_count',
  14     default => 0
  15 ));
  16
  17 sub construct_instance {
  18     my ($class, %params) = @_;
  19     $class->{'$:count'}++;
  20     return $class->SUPER::construct_instance(%params);
  21 }
  22
  23 1;
  24
  25 __END__
  26
  27 =pod
  28
  29 =head1 NAME
  30
  31 InstanceCountingClass - An example metaclass which counts instances
  32
  33 =head1 SYNOPSIS
  34
  35   package Foo;
  36
  37   use metaclass 'InstanceCountingClass';
  38
  39   sub new  {
  40       my $class = shift;
  41       $class->meta->new_object(@_);
  42   }
  43
  44   # ... meanwhile, somewhere in the code
  45
  46   my $foo = Foo->new();
  47   print Foo->meta->get_count(); # prints 1
  48
  49   my $foo2 = Foo->new();
  50   print Foo->meta->get_count(); # prints 2
  51
  52   # ... etc etc etc
  53
  54 =head1 DESCRIPTION
  55
  56 This is a classic example of a metaclass which keeps a count of each
  57 instance which is created.
  58
  59 =head1 AUTHOR
  60
  61 Stevan Little E<lt>stevan@iinteractive.comE<gt>
  62
  63 =head1 COPYRIGHT AND LICENSE
  64
  65 Copyright 2006 by Infinity Interactive, Inc.
  66
  67 L<http://www.iinteractive.com>
  68
  69 This library is free software; you can redistribute it and/or modify
  70 it under the same terms as Perl itself.
  71
  72 =cut