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.81
River stage one • 2 direct dependents • 2 total dependents

Changes for version 0.81 - 2004-03-15

  • Overall:
    • Use Log::Log4perl to do logging/debugging. All internal SPOPS classes, and the code generated by them, has been modified to use it. Previously existing debugging methods (_w and _wm) use log4perl under the hood. A script (eg/modify_debug_to_l4p.pl) is provided for you to convert your own code to log4perl calls.
    • Modify slightly the default behavior for 'sql_quote()' as defined in SPOPS::SQLInterface. Nobody should notice...
    • A fistful of bugfixes and minor enhancements.
  • Individual:
    • SPOPS.pm:
      • Add a 'initialize_custom()' step to 'new()' to allow subclasses to do customization in the constructor. Thanks Simon!
      • Replace '_w()' and '_wm()' with calls to log4perl -- this is for backwards compatibility only; you should run eg/modify_debug_to_l4p.pl to get on the bandwagon
      • Fix bug in AUTOLOAD that didn't create the accessor/mutator + clearing method on a first invocation of '{property}_clear' when you're not using strict field checking. Thanks to Lee Revell (rlrevell@dca.net) for reporting the error and the failure case.
      • Add new configuration property 'field_raw'; this can hold the actual fields used for the object in their original case. So if your database pulls 'person_ID' as a fieldname you can use both 'person_id' and 'person_ID' as a hash key *and* as a accessor/mutator, even when using strict field checking. Thanks to Simon for pointing this out.
    • SPOPS/ClassFactory/DefaultBehavior.pm:
      • Fix a 'return' where the error message was truncated due to commas rather than period being used. Thanks to Simon for the spot.
      • On class generation: if 'field_raw' isn't defined in the class configuration set it to the original (pre-munged) list of fields.
    • SPOPS/ClassFactory/DBI.pm:
      • Fix a 'return' where the error message was truncated due to commas rather than period being used. Thanks to Simon for the spot.
    • SPOPS/DBI.pm:
      • Provide better error message from 'id_clause()' when we don't have any type information available. Thanks to Simon Ilyushchenko (simonf@cshl.edu) for the report.
      • For constructing group queries (fetch_group, fetch_iterator), add the class's table to the 'from' array if it's not already there. This allows you to specify join queries and 'assume' the class table will be added.
      • In save() only call pre_fetch_id() or post_fetch_id() if an ID is NOT ALREADY DEFINED.
      • Applied patch from Pawel Gajda to fix lazy loading problem.
    • SPOPS/DBI/([:driver:]).pm:
      • Get rid of all driver implementations of 'sql_quote()' since it's defined in SPOPS::SQLinterface and they were all using the same definition anyway.
    • SPOPS/HashFile.pm:
      • Don't dereference a hash, gets rid of warning many OI users saw since they upgraded to 5.8...
    • SPOPS/Loopback.pm:
      • Add a simple (!) ability for 'fetch_group' to parse the 'where' clause and use options from 'value' to substitute for a placeholder.
      • Fix extraneous warnings regarding 'pre_fetch_id' and 'post_fetch_id' when using strict field checking.
    • SPOPS/Manual/Configuration.pm:
      • Fix configuration typo (using 'publisher_link' instead of 'publisher_book' in links_to configuration). Thanks Simon!
    • SPOPS/Secure.pm:
      • Add warnings when our definitions of global_current_user and global_current_groups are found.
    • SPOPS/SQLInterface.pm:
      • Add to default 'sql_quote()' a check to see if the $value to be quoted is defined; if not use 'NULL'. Thanks to Simon for the report. Also, document the 'sql_quote()' method and make the new default to use the two-argument form of DBI->quote( $value, $type ).
    • SPOPS/Tie/StrictField.pm:
      • Get rid of carp calls on strict field violations, replacing them with log4perl calls. (This means you cannot set a SIG{__WARN__} handler anymore...)
    • SPOPS/Tool/DateConvert.pm:
      • When converting FROM an object TO a string (e.g., during a save()), if the given item isn't a reference then just return it, assuming it's a date in the right string format.
    • SPOPS/Tool/UTFConvert.pm:
      • Determine at runtime whether we're running in 5.6.0 or less or 5.6.1 or greater and use different encoding/decoding schemes as appropriate. (Thanks to the Arvato folks for providing the post-5.6.1 version...)

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