Author: REHSACK
Date: Sun Aug 29 02:51:37 2010
New Revision: 14350
Modified:
dbi/trunk/lib/DBI/DBD/SqlEngine/Developer.pod
dbi/trunk/lib/DBI/DBD/SqlEngine/HowTo.pod
Log:
minor corrections and improvements
Modified: dbi/trunk/lib/DBI/DBD/SqlEngine/Developer.pod
==============================================================================
--- dbi/trunk/lib/DBI/DBD/SqlEngine/Developer.pod (original)
+++ dbi/trunk/lib/DBI/DBD/SqlEngine/Developer.pod Sun Aug 29 02:51:37 2010
@@ -4,7 +4,77 @@
=head1 SYNOPSIS
- perldoc DBI::DBD::SqlEngine::Developers
+ package DBD::myDriver;
+
+ use base qw(DBI::DBD::SqlEngine);
+
+ sub driver
+ {
+ ...
+ my $drh = $proto->SUPER::driver($attr);
+ ...
+ return $drh->{class};
+ }
+
+ sub CLONE { ... }
+
+ package DBD::myDriver::dr;
+
+ @ISA = qw(DBI::DBD::SqlEngine::dr);
+
+ sub data_sources { ... }
+ ...
+
+ package DBD::myDriver::db;
+
+ @ISA = qw(DBI::DBD::SqlEngine::db);
+
+ sub init_valid_attributes { ... }
+ sub init_default_attributes { ... }
+ sub set_versions { ... }
+ sub validate_STORE_attr { my ($dbh, $attrib, $value) = @_; ... }
+ sub validate_FETCH_attr { my ($dbh, $attrib) = @_; ... }
+ sub get_myd_versions { ... }
+ sub get_avail_tables { ... }
+
+ package DBD::myDriver::st;
+
+ @ISA = qw(DBI::DBD::SqlEngine::st);
+
+ sub FETCH { ... }
+ sub STORE { ... }
+
+ package DBD::myDriver::Statement;
+
+ @ISA = qw(DBI::DBD::SqlEngine::Statement);
+
+ sub open_table { ... }
+
+ package DBD::myDriver::Table;
+
+ @ISA = qw(DBI::DBD::SqlEngine::Table);
+
+ sub new { ... }
+
+ sub fetch_row { ... }
+ sub push_row { ... }
+ sub push_names { ... }
+ sub seek { ... }
+ sub truncate { ... }
+ sub drop { ... }
+
+ # optimize the SQL engine by add one or more of
+ sub update_current_row { ... }
+ # or
+ sub update_specific_row { ... }
+ # or
+ sub update_one_row { ... }
+ # or
+ sub insert_new_row { ... }
+ # or
+ sub delete_current_row { ... }
+ # or
+ sub delete_one_row { ... }
=head1 DESCRIPTION
Modified: dbi/trunk/lib/DBI/DBD/SqlEngine/HowTo.pod
==============================================================================
--- dbi/trunk/lib/DBI/DBD/SqlEngine/HowTo.pod (original)
+++ dbi/trunk/lib/DBI/DBD/SqlEngine/HowTo.pod Sun Aug 29 02:51:37 2010
@@ -1,16 +1,22 @@
=head1 NAME
-DBI::DBD::SqlEngine::Developers - Developers documentation for
DBI::DBD::SqlEngine
+DBI::DBD::SqlEngine::HowTo - Guide to create DBI::DBD::SqlEngine based driver
=head1 SYNOPSIS
+ perldoc DBI::DBD::SqlEngine::HowTo
+ perldoc DBI
+ perldoc DBI::DBD
perldoc DBI::DBD::SqlEngine::Developers
+ perldoc DBI::DBD::SqlEngine
+ perldoc DBI::DBD::SqlEngine::HowTo
+ perldoc DBD::File::Developers
=head1 DESCRIPTION
This document provides a step-by-step guide, how to create a new
C<DBI::DBD::SqlEngine> based DBD. It expects that you carefully read the
-L<DBI> documentation and that you're familiar with L<DBI::DBI> and had
+L<DBI> documentation and that you're familiar with L<DBI::DBD> and had
read and understood L<DBD::ExampleP>.
This document addresses experienced developers who are really sure that
@@ -183,8 +189,9 @@
=head2 Testing
-Now you should have your first own DBD. Was easy, wasn't it?
-
+Now you should have your first own DBD. Was easy, wasn't it? But does
+it work well? Prove it by writing tests and remember to use
+dbd_edit_mm_attribs from L<DBI::DBD> to ensure testing even rare cases.
=head1 AUTHOR
