Object-InsideOut version 4.03
=============================

This module provides comprehensive support for implementing classes using the
inside-out object model.

This module implements inside-out objects as anonymous scalar references that
are blessed into a class with the scalar containing the ID for the object
(usually a sequence number).  Object data (i.e., fields) are stored within the
class's package in either arrays indexed by the object's ID, or hashes keyed
to the object's ID.

The virtues of the inside-out object model over the 'blessed hash' object
model have been extolled in detail elsewhere.  Briefly, inside-out objects
offer the following advantages over 'blessed hash' objects:

* Encapsulation

Object data is enclosed within the class's code and is accessible only through
the class-defined interface.

* Field Name Collision Avoidance

Inheritance using 'blessed hash' classes can lead to conflicts if any classes
use the same name for a field (i.e., hash key).  Inside-out objects are immune
to this problem because object data is stored inside each class's package, and
not in the object itself.

* Compile-time Name Checking

A common error with 'blessed hash' classes is the misspelling of field names:

    $obj->{'coment'} = 'No comment';   # Should be 'comment' not 'coment'

As there is no compile-time checking on hash keys, such errors do not usually
manifest themselves until runtime.

With inside-out objects, data is accessed using methods, the names of which
are checked by the Perl compiler such that any typos are easily caught using
"perl -c".


This module offers all the capabilities of other inside-out object modules
with the following additional key advantages:

* Speed

When using arrays for storing object data, Object::InsideOut objects are as
much as 40% faster than 'blessed hash' objects for fetching and setting data,
and even with hashes they are still several percent faster than 'blessed hash'
objects.

* Threads

Object::InsideOut is thread safe, and thoroughly supports sharing objects
between threads using threads::shared.

* Flexibility

Allows control over object ID specification, accessor naming, parameter name
matching, and more.

* 'Runtime' Support

Supports classes that may be loaded at runtime (i.e., using "eval { require
...; };").  This makes it usable from within mod_perl, as well.  Also supports
additions to class hierarchies, and dynamic creation of object fields during
runtime.

* Perl 5.6

Tested on Perl v5.6.0 through v5.6.2, v5.8.0 through v5.8.8, and v5.9.3.

* Exception Objects

As recommended in "Perl Best Practices", Object::InsideOut uses
Exception::Class for handling errors in an OO-compatible manner.

* Object Serialization

Object::InsideOut has built-in support for object dumping and reloading that
can be accomplished in either an automated fashion or through the use of
class-supplied subroutines.  Serialization using 'Storable' is also supported.

* Foreign Class Inheritance

Object::InsideOut allows classes to inherit from foreign (i.e.,
non-Object::InsideOut) classes, thus allowing you to sub-class other Perl
class, and access their methods from your own objects.

* Introspection

Obtain constructor parameters and method metadata for Object::InsideOut
classes.

INSTALLATION

To install this module type the following:

    perl Makefile.PL
    make
    make test
    make install

or if you have Module::Build installed:

    perl Build.PL
    perl Build
    perl Build test
    perl Build install

DEPENDENCIES

Requires Perl 5.6.0 or later.

This module uses the following 'standard' modules:

  ExtUtils::MakeMaker          - For installation
  Test::More (0.50 or later)   - For installation
  Scalar::Util (1.10 or later) - Standard in 5.8 or obtain from CPAN
  Data::Dumper
  attributes
  overload
  B

This module requires the following module available from CPAN:

  Exception::Class (1.22 or later)

Using the :lvalue accessor feature of this module requires the following
module from CPAN:

  Want (0.12 or later)

For :SECURE mode, this module requires the following module from CPAN:

  Math::Random::MT::Auto (5.04 or later)

COPYRIGHT AND LICENCE

Copyright 2005 - 2012 Jerry D. Hedden <jdhedden AT cpan DOT org>

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

# EOF