AUTHORS mass update; mst doesn't have to take credit for -everything- :)
[dbsrgits/DBIx-Class.git] / lib / DBIx / Class / PK / Auto.pm
index 75b017b..26bd6df 100644 (file)
@@ -1,73 +1,52 @@
 package DBIx::Class::PK::Auto;
 
-use base qw/Class::Data::Inheritable/;
+#use base qw/DBIx::Class::PK/;
+use base qw/DBIx::Class/;
 use strict;
 use warnings;
 
-=head1 NAME 
+1;
+
+=head1 NAME
 
-DBIx::Class::PK::Auto - Automatic Primary Key class
+DBIx::Class::PK::Auto - Automatic primary key class
 
 =head1 SYNOPSIS
 
-=head1 DESCRIPTION
+use base 'DBIx::Class::Core';
+__PACKAGE__->set_primary_key('id');
 
-This class overrides the insert method to get automatically
-incremented primary keys.
+=head1 DESCRIPTION
 
-You don't want to be using this directly - instead load the appropriate
-one for your database, e.g. PK::Auto::SQLite
+This class overrides the insert method to get automatically incremented primary
+keys.
 
-=head1 METHODS
+PK::Auto is now part of Core.
 
-=over 4
+See L<DBIx::Class::Manual::Component> for details of component interactions.
 
-=item insert
+=head1 LOGIC
 
-Overrides insert so that it will get the value of autoincremented
-primary keys.
+C<PK::Auto> does this by letting the database assign the primary key field and
+fetching the assigned value afterwards.
 
-=cut
+=head1 METHODS
 
-sub insert {
-  my ($self, @rest) = @_;
-  my $ret = $self->NEXT::ACTUAL::insert(@rest);
-  my ($pri, $too_many) =
-    (grep { $self->_primaries->{$_}{'auto_increment'} }
-       keys %{ $self->_primaries })
-    || (keys %{ $self->_primaries });
-  $self->throw( "More than one possible key found for auto-inc on ".ref $self )
-    if $too_many;
-  unless (defined $self->get_column($pri)) {
-    $self->throw( "Can't auto-inc for $pri on ".ref $self.": no _last_insert_id method" )
-      unless $self->can('last_insert_id');
-    my $id = $self->last_insert_id;
-    $self->throw( "Can't get last insert id" ) unless $id;
-    $self->store_column($pri => $id);
-  }
-  return $ret;
-}
-
-=item sequence
-
-Manually define the correct sequence for your table, to avoid the overhead
-associated with looking up the sequence automatically.
+=head2 insert
 
-=cut
+The code that was handled here is now in Row for efficiency.
 
-__PACKAGE__->mk_classdata('sequence');
+=head2 sequence
 
-1;
+The code that was handled here is now in ResultSource, and is being proxied to
+Row as well.
 
-=back
+=head1 AUTHOR AND CONTRIBUTORS
 
-=head1 AUTHORS
-
-Matt S. Trout <mst@shadowcatsystems.co.uk>
+See L<AUTHOR|DBIx::Class/AUTHOR> and L<CONTRIBUTORS|DBIx::Class/CONTRIBUTORS> in DBIx::Class
 
 =head1 LICENSE
 
 You may distribute this code under the same terms as Perl itself.
 
 =cut
-