The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
package Class::AutoDB::OidDeleted;
use Carp;
use Scalar::Util qw(refaddr);
use base qw(Class::AutoDB::Oid);

# oid, put defined in Oid. 
#   'oid' is fine as is -- just returns _OID from hash 
#   'put' is fine as is -- nop 
# NG 10-09-09: decided to remove these methods to avoid polluting namespace further
# #   override 'is_extant' to always say 'no' & 'is_deleted' the opposite
# #   override 'put' to confess
# #   override 'del' to nop -- seems the right semantics because application might traverse a
# #      stucture deleting sub-objects as it goes; should be okay to hit same sub-object twice 
# sub del {0}
# sub is_extant {0}
# sub is_deleted {1}

# NG 10-09-09: changed my mind about 'put'. made it nop
# sub put {
#   my $self=shift;
#   local $AUTOLOAD='put';
#   $self->AUTOLOAD(@_);
# }

# NG 12-10-28: UNIVERSAL methods confess. do it via AUTOLOAD
sub isa {$AUTOLOAD='isa'; shift->AUTOLOAD(@_)}
sub can {$AUTOLOAD='can'; shift->AUTOLOAD(@_)}
sub DOES {$AUTOLOAD='DOES'; shift->AUTOLOAD(@_)}
sub VERSION {$AUTOLOAD='VERSION'; shift->AUTOLOAD(@_)}

# AUTOLOAD always confesses, since it is impossible to access deleted object
use vars qw($AUTOLOAD);
sub AUTOLOAD {
  my $self=shift;
  my $method=$AUTOLOAD;
  $method=~s/^.*:://;             # strip class qualification
  return if $method eq 'DESTROY'; # the books say you should do this
  my $oid=$self->{_OID};
  my $class=$self->{_CLASS} || '(unknown)';
  confess "Trying to access deleted object of class $class via method $method (oid=$oid)";
}

####################
# stringify to empty string, just like undef would
sub stringify {''}

# since OidDeleted isa Oid, entries that are identical to those in Oid could be omitted.
# I'm keeping them out of an abundance of caution 
# NG 10-09-11: removed eq, ne. Perl autogenerates from stringify
# NG 10-09-17: added '0+' (convert to number), since Perls >= 5.10 stringify objects otherwise
use overload
  '""' => \&stringify,
  '0+' => sub {refaddr($_[0])},
  'bool'=>sub {undef},
  fallback => 'TRUE';
####################
1;