Ricardo SIGNES > Object-Capsule > Object::Capsule

Download:
Object-Capsule-0.012.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.012   Source  

NAME ^

Object::Capsule - wrap any object in a flavorless capsule (don't use this)

VERSION ^

version 0.012

SYNOPSIS ^

 use Object::Capsule;
 use Widget;

 my $widget = new Widget;

 my $capsule = encapsulate($widget);

 $capsule->some_widget_method; # performs method on widget

 print ref $capsule;  # prints "Object::Capsule"

 print ref $$capsule; # prints "Widget"

DESCRIPTION ^

Achtung!: This code is stupid. I wrote it to abuse Class::DBI. You probably shouldn't use it.

An Object::Capsule is a thin, permeable membrane that fits nicely around an object. Method calls are passed on to the object, which functions normally inside the capsule. The object can be retrieved by dereferencing the capsule as a scalar.

My intent is to use an object capsule subclass to allow the inflation of multiple object types from a single column in Class::DBI.

FUNCTIONS ^

encapsulate

  $capsule = encapsulate($object);

This function encases the given object in an Object::Capsule and returns the capsule. It's exported by default and is otherwise non-existent.

BUGS ^

Please report any bugs or feature requests to bug-object-capsule@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

TODO ^

The proxy overloading code is hideous. The "future" version in the code had bizarre problems that I couldn't quite solve, but I'll try again sometime.

AUTHOR ^

Ricardo SIGNES <rjbs@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2004 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: