The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
SPOPS-0.80
River stage one • 2 direct dependents • 2 total dependents

Changes for version 0.80 - 2003-11-29

  • Overall:
    • Add auto-generated mutators and clearing mutators along with the accessors.
    • Customize the 'links_to' mechanism for DBI object relationships.
  • Individual:
    • MANIFEST:
      • Add eg/My/CommonResources.pm, forgotten from earlier version. Thanks to Simon Ilyushchenko (simonf@cshl.edu) for the report.
    • SPOPS.pm:
      • AUTOLOAD-created accessor now also acts as a mutator. I thought it was already doing this but Simon set me straight.
      • Also generate a '{fieldname}_clear' to act as a clearing mutator (set a field to undef).
      • Allow SPOPS subclasses to define their own accessor/mutator/clearing mutator methods by overriding '_internal_create_field_methods()'. See docs for details.
    • SPOPS/ClassFactory/DBI.pm:
      • Allow 'links_to' declarations to customize the to/from ID fields and alias in addition to the linking table. Thanks to Stathy Touloumis (stathy@edisonaffiliates.com) for the idea.
      • In 'links_to' generation stage, try to require the linked class before getting its configuration. This allows us to declare the SPOPS class as a superclass of our customized class.
    • SPOPS/ClassFactory/Default.pm:
      • In 'has_a' generation stage, try to require the contained class before getting its configuration. This allows us to declare the SPOPS class as a superclass of our customized class.
    • SPOPS/DBI.pm:
      • In save() allow the user to pass in an empty arrayref for 'no_insert' and 'no_update' that will override whatever is defined in the object configuration.
    • SPOPS/Manual/Object.pod:
      • Modify the accessor/mutator discussion to reflect changed code.
    • SPOPS/Manual/Relationships.pod:
      • Add new 'links_to' configuration options.
    • SPOPS/Secure.pm:
      • Fix typo in message generated from 'register_security_error()', thanks to Simon for the report.
    • t/00_base.t:
      • Test auto-created mutators and clearing mutators.
    • t/62_export_perl.t:
      • Fix bug in tests exposed by modified hash key ordering in 5.8+. (Note: use 'is_deeply()'!)

Documentation

SPOPS::Manual
User Guide and Reference Manual for SPOPS
SPOPS::Manual::CodeGeneration
How SPOPS builds classes
SPOPS::Manual::Configuration
Description of variables used in the SPOPS configuration process
SPOPS::Manual::Cookbook
Recipes for SPOPS usage
SPOPS::Manual::Datasource
SPOPS datasource use and how you can customize
SPOPS::Manual::Exceptions
Error handling in SPOPS
SPOPS::Manual::ImportExport
Moving data (and more) with SPOPS
SPOPS::Manual::Intro
Introduction and overview of SPOPS
SPOPS::Manual::Object
Shows how you interact with SPOPS objects.
SPOPS::Manual::ObjectRules
Use rules to give your object custom behavior
SPOPS::Manual::Relationships
SPOPS object relationships
SPOPS::Manual::Security
SPOPS security system and how you can customize
SPOPS::Manual::Serialization
How SPOPS serializes objects
test_dbd_driver.pl
Perform tests on a DBD driver to see if it may work with SPOPS

Modules

SPOPS
Simple Perl Object Persistence with Security
SPOPS::ClassFactory
Create SPOPS classes from configuration and code
SPOPS::ClassFactory::DBI
Define additional configuration methods
SPOPS::ClassFactory::DefaultBehavior
Default configuration methods called from SPOPS.pm
SPOPS::ClassFactory::LDAP
Create relationships among LDAP objects
SPOPS::DBI
Implement SPOPS class, serializing into a DBI database
SPOPS::DBI::InterBase
InterBase-specific routines for the SPOPS::DBI
SPOPS::DBI::MySQL
MySQL-specific code for DBI collections
SPOPS::DBI::Oracle
Oracle-specific routines for the SPOPS::DBI
SPOPS::DBI::Pg
PostgreSQL-specific routines for the SPOPS::DBI
SPOPS::DBI::SQLite
SQLite-specific code for DBI collections
SPOPS::DBI::Sybase
Sybase-specific routines for the SPOPS::DBI
SPOPS::DBI::TypeInfo
Represent type information for a single table
SPOPS::Error
(DEPRECATED) Centralized error messages from all SPOPS objects.
SPOPS::Exception
Base class for exceptions in SPOPS
SPOPS::Exception::DBI
SPOPS exception with extra DBI parameters
SPOPS::Exception::LDAP
SPOPS exception with extra LDAP parameters
SPOPS::Exception::Security
SPOPS exception with extra security parameters
SPOPS::Export
Export SPOPS objects to various formats
SPOPS::Export::DBI::Data
Export SPOPS objects as data for importing directly into a DBI table
SPOPS::Export::Object
Dump SPOPS objects to a portable format
SPOPS::Export::Perl
Dump SPOPS objects to a pure serialized Perl format
SPOPS::Export::SQL
Export SPOPS objects as a series of SQL statements
SPOPS::Export::XML
Export SPOPS objects in XML format
SPOPS::GDBM
Store SPOPS objects in a GDBM database
SPOPS::HashFile
Implement as objects files containing perl hashrefs dumped to text
SPOPS::Import
Factory and parent for importing SPOPS objects
SPOPS::Import::DBI::Data
Import raw data to a DBI table
SPOPS::Import::DBI::Table
Import a DBI table structure
SPOPS::Import::DBI::TableTransform
Factory class for database-specific transformations
SPOPS::Import::DBI::TableTransform::InterBase
Table transformations for InterBase/FirebirdSQL
SPOPS::Import::DBI::TableTransform::MySQL
Table transformations for MySQL
SPOPS::Import::DBI::TableTransform::Oracle
Table transformations for Oracle
SPOPS::Import::DBI::TableTransform::Pg
Table transformations for PostgreSQL
SPOPS::Import::DBI::TableTransform::SQLite
Table transformations for SQLite
SPOPS::Import::DBI::TableTransform::Sybase
Table transformations for Sybase/MSSQL
SPOPS::Import::Object
Import SPOPS objects
SPOPS::Initialize
Provide methods for initializing groups of SPOPS objects at once
SPOPS::Iterator
Class to cycle through results and return SPOPS objects
SPOPS::Iterator::DBI
Implementation of SPOPS::Iterator for SPOPS::DBI
SPOPS::Iterator::LDAP
Implementation of SPOPS::Iterator for SPOPS::LDAP
SPOPS::Iterator::WrapList
SPOPS::Iterator wrapper around object lists
SPOPS::Key::DBI::HandleField
Retrieve an auto-increment value from a DBI statement or database handle
SPOPS::Key::DBI::Identity
Retrieve IDENTITY values from a supported DBI database
SPOPS::Key::DBI::Pool
Retrieves ID field information from a pool
SPOPS::Key::DBI::Sequence
Retrieve sequence values from a supported DBI database
SPOPS::Key::Random
Creates a random alphanumeric code for the ID field
SPOPS::Key::UUID
Creates a Universally Unique ID (UUID) as a key
SPOPS::LDAP
Implement object persistence in an LDAP datastore
SPOPS::LDAP::MultiDatasource
SPOPS::LDAP functionality but fetching objects from multiple datasources
SPOPS::Loopback
Simple SPOPS class used for testing rules and other goodies
SPOPS::SQLInterface
Generic routines for DBI database interaction
SPOPS::Secure
Implement security across one or more classes of SPOPS objects
SPOPS::Secure::DBI
Implement a security object and basic operations for DBI datasources
SPOPS::Secure::Hierarchy
Define hierarchical security
SPOPS::Secure::Loopback
Security object implementation for testing (loopback) objects
SPOPS::Secure::Util
Common utilities for SPOPS::Secure and subclasses
SPOPS::Tie
Simple class implementing tied hash with some goodies
SPOPS::Tie::StrictField
Enable field checking for SPOPS objects
SPOPS::Tool::CreateOnly
Make a particular object create-only -- it cannot be updated
SPOPS::Tool::DBI::Datasource
Embed the parameters for a DBI handle in object configuration
SPOPS::Tool::DBI::DiscoverField
SPOPS::ClassFactory rule implementing autofield discovery
SPOPS::Tool::DBI::FindDefaults
Load default values from a particular record
SPOPS::Tool::DBI::MaintainLinkedList
Support objects that automatically maintain a link to the previous and next objects
SPOPS::Tool::DateConvert
Convert dates to objects to/from your datastore
SPOPS::Tool::LDAP::Datasource
Embed the parameters for a LDAP handle in object configuration
SPOPS::Tool::ReadOnly
Make a particular object read-only
SPOPS::Tool::UTFConvert
Provide automatic UTF-8 conversion
SPOPS::Utility
Utility methods for SPOPS objects
My::User

Provides

SPOPS::TieFileHash
in SPOPS/HashFile.pm

Examples

Other files