NAME DBIx::DBO2::ReadMe - Getting Started with DBIx::DBO2 SYNOPSIS package MyRecord; use DBIx::DBO2::Record '-isasubclass'; my $sql_engine = DBIx::SQLEngine->new( $dsn, $user, $pass ); MyRecord->table( DBIx::DBO2::Table->new(name=>'myrecords', datasource=>$sql_engine) ); package main; my $results = MyRecord->fetch_all; foreach my $record ( $results->records ) { if ( $record->{age} > 20 ) { $record->{status} = 'adult'; $record->save_row; } } DESCRIPTION DBIx::DBO2 is an object-relational mapping framework (or perhaps a relational-object mapping framework, if I understand the distinction correctly) that facilitates the development of Perl classes whose objects are stored in a SQL database table. INSTALLING You should be able to install this module using the CPAN shell interface: perl -MCPAN -e 'install DBIx::DBO2' If this module has not yet been posted to your local CPAN mirror, you may also retrieve the current distribution from the below address and follow the normal "gunzip", "tar xf", "cd", "perl Makefile.PL && make test && sudo make install" procedure or your local equivalent: http://www.evoscript.org/DBIx-DBO2/ Getting Started You may want to take a look at the test.pl and test-lib classes for a short example of how to use this framework to create your own classes. Prerequisites Requires DBIx::SQLEngine and Class::MakeMethods, both available on CPAN. Tested Platforms This release has been tested succesfully on the following platforms: 5.6.1 on darwin 5.005_03 on i386-freebsd VERSION This is version 0.002 of DBIx::DBO2. Distribution Summary This module's summary in the CPAN DSLIP is intended to read: Name DSLIP Description -------------- ----- --------------------------------------------- DBIx:: :: DBO2 bdpOp Objects mapping to SQL relational structures Beta Release Although it based on earlier code that was extensively tested over several years of production use, this code has recently been majorly refactored, and has not yet been sufficiently tested in its new form. Discussion and Support There is not currently any offical discussion and support forum for this pacakage. Further information and support for this module is available at http://www.evoscript.org. If you have questions or feedback about this module, please feel free to contact the author at the below address. I would be particularly interested in any suggestions towards improving the documentation, correcting any Perl-version or platform dependencies, as well as general feedback and sug SEE ALSO See the DBIx::SQLEngine manpage for information about the underlying database interface. See the DBIx::DBO2::Record manpage, the DBIx::DBO2::Fields manpage, the DBIx::DBO2::Table manpage, and the DBIx::DBO2::TableSet manpage for key interfaces. Similar Modules Several other CPAN modules provide a similar mapping layer. See the Class::DBI manpage for a similar objects-to-DBI mapping. CREDITS AND COPYRIGHT Developed By M. Simon Cavalletto, simonm@cavalletto.org Evolution Softworks, www.evoscript.org Contributors Piglet / EJ Evans, piglet@piglet.org Eric Schneider, roark@evolution.com Chaos / Matthew Sheahan Copyright Copyright 2002 Matthew Simon Cavalletto. Portions copyright 1997, 1998, 1999, 2000, 2001 Evolution Online Systems, Inc. License You may use, modify, and distribute this software under the same terms as Perl.