class::inner(3pm) [debian man page]
Class::Inner(3pm) User Contributed Perl Documentation Class::Inner(3pm) NAME
Class::Inner - A perlish implementation of Java like inner classes 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 new HASH Takes a hash like argument list with the following keys. parent The name of the parent class. Note that you can only get single inheritance with this or SUPER won't work. methods A hash, keys are method names, values are CODEREFs. constructor The name of the constructor method. Defaults to 'new'. args 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: SUPER If you were to pass something like $obj = Class::Inner->new( parent => 'Parent', methods => { method => sub { ...; $self->SUPER::method(@_) } }, ); then "$self-"gt"SUPER::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. DESTROY Because Class::Inner 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. clean_symbol_table The helper subroutine that DESTROY uses to remove the class from the symbol table. new_classname 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. perl v5.10.1 2009-11-21 Class::Inner(3pm)
Check Out this Related Man Page
Class::Adapter::Clear(3pm) User Contributed Perl Documentation Class::Adapter::Clear(3pm) NAME
Class::Adapter::Clear - A handy base Adapter class that makes no changes SYNOPSIS
Hello World with CGI.pm the normal way # Load and create the CGI use CGI; $q = new CGI; # Create the page print $q->header, # HTTP Header $q->start_html('hello world'), # Start the page $q->h1('hello world'), # Hello World! $q->end_html; # End the page Hello World with CGI.pm the Adapter'ed way # Load and create the CGI use CGI; $q = new CGI; # Convert to an Adapter use Class::Adapter::Clear; $q = new Class::Adapter::Clear( $q ); # Create the page print $q->header, # HTTP Header $q->start_html('hello world'), # Start the page $q->h1('hello world'), # Hello World! $q->end_html; # End the page Creating a CGI Adapter class using Class::Adapter::Clear package My::CGI; use base 'Class::Adapter::Clear'; # Optional - Create the thing we are decorating auto-magically sub new { my $class = shift; # Create the object we are decorating my $query = CGI->new(@_); # Wrap it in the Adapter $class->SUPER::new($query); } # Decorate the h1 method to change what is created sub h1 { my $self = shift; my $str = shift; # Do something before the real method call if ( defined $str and $str eq 'hello world' ) { $str = 'Hello World!'; } $self->_OBJECT_->($str, @_); } DESCRIPTION
"Class::Adapter::Clear" provides the base class for creating one common type of Class::Adapter classes. For more power, move up to Class::Adapter::Builder. On it's own "Class::Adapter::Clear" passes all methods through to the same method in the parent object with the same parameters, responds to "->isa" like the parent object, and responds to "->can" like the parent object. It looks like a "Duck", and it quacks like a "Duck". On this base, you simple implement whatever method you want to do something special to. # Different method, same parameters sub method1 { my $self = shift; $self->_OBJECT_->method2(@_); # Call a different method } # Same method, different parameters sub method1 { my $self = shift; $self->_OBJECT_->method1( lc($_[0]) ); # Lowercase the param } # Same method, same parameters, tweak the result sub method1 { my $self = shift; my $rv = $self->_OBJECT_->method1(@_); $rv =~ s/ /<br> /g; # Add line-break HTML tags at each newline return $rv; } As you can see, the advantage of this full-scale Adapter approach, compared to inheritance, or function wrapping (see Class::Hook), is that you have complete and utter freedom to do anything you might need to do, without stressing the Perl inheritance model or doing anything unusual or tricky with "CODE" references. You may never need this much power. But when you need it, you really need it. As an aside, Class::Adapter::Clear is implemented with the following Class::Adapter::Builder formula. use Class::Adapter::Builder ISA => '_OBJECT_', AUTOLOAD => 1; METHODS
new $object As does the base Class::Adapter class, the default "new" constructor takes a single object as argument and creates a new object which holds the passed object. Returns a new "Class::Adapter::Clear" object, or "undef" if you do not pass in an object. SUPPORT
Bugs should be reported via the CPAN bug tracker at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Class-Adapter> For other issues, contact the author. AUTHOR
Adam Kennedy <adamk@cpan.org> SEE ALSO
Class::Adapter, Class::Adapter::Builder COPYRIGHT
Copyright 2005 - 2010 Adam Kennedy. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The full text of the license can be found in the LICENSE file included with this module. perl v5.10.1 2010-04-11 Class::Adapter::Clear(3pm)