GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CLASS::INNER (3)

.ds Aq ’

NAME

Class::Inner - A perlish implementation of Java like inner classes

CONTENTS

SYNOPSIS



    use Class::Inner;

    my $object = Class::Inner->new(
        parent => ParentClass,
        methods => { method => sub { ... } }, },
        constructor => new,
        args => [@constructor_args],
    );



DESCRIPTION

Yet another implementation of an anonymous class with per object overrideable methods, but with the added attraction of sort of working dispatch to the parent class’s method.

    METHODS

<B>new HASHB> Takes a hash like argument list with the following keys.
<B>parentB> The name of the parent class. Note that you can only get single inheritance with this or <B>SUPERB> won’t work.
<B>methodsB> A hash, keys are method names, values are CODEREFs.
<B>constructorB> The name of the constructor method. Defaults to ’new’.
<B>argsB> An anonymous array of arguments to pass to the constructor. Defaults to an empty list.

Returns an object in an ’anonymous’ class which inherits from the parent class. This anonymous class has a couple of ’extra’ methods:
<B>SUPERB> If you were to pass something like



    $obj = Class::Inner->new(
        parent  => Parent,
        methods => { method =>  sub { ...; $self->SUPER::method(@_) } },
    );



then $self-gtSUPER::method almost certainly wouldn’t do what you expect, so we provide the SUPER method which dispatches to the parent implementation of the current method. There seems to be no good way of getting the full SUPER:: functionality, but I’m working on it.

<B>DESTROYB> Because <B>Class::InnerB> works by creating a whole new class name for your object, it could potentially leak memory if you create a lot of them. So we add a DESTROY method that removes the class from the symbol table once it’s finished with.

If you need to override a parent’s DESTROY method, adding a call to Class::Inner::clean_symbol_table(ref $self) to it. Do it at the end of the method or your other method calls won’t work.

<B>clean_symbol_tableB> The helper subroutine that DESTROY uses to remove the class from the symbol table.
<B>new_classnameB> Returns a name for the next anonymous class.

AUTHOR

Maintained by Arun Prasaad <arunbear@cpan.org>

Copyright (c) 2001 by Piers Cawley <pdcawley@iterative-software.com>.

All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as perl itself.

Thanks to the Iterative Software people: Leon Brocard, Natalie Ford and Dave Cross. Also, this module was written initially for use in the PerlUnit project, AKA Test::Unit. Kudos to Christian Lemburg and the rest of that team.

SEE ALSO

There are a million and one differen Class constructors available on CPAN, none of them does quite what I want, so I wrote this one to add to that population where hopefully it will live and thrive.

BUGS

Bound to be some. Actually the SUPER method is a workaround for what I consider to be a bug in perl.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CLASS::INNER (3) 2009-11-21

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.