ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / local / share / man / man3

.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DBD::File::HowTo 3"
.TH DBD::File::HowTo 3 "2020-01-26" "perl v5.16.3" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
DBD::File::HowTo \- Guide to create DBD::File based driver
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 12
\&  perldoc DBD::File::HowTo
\&  perldoc DBI
\&  perldoc DBI::DBD
\&  perldoc DBD::File::Developers
\&  perldoc DBI::DBD::SqlEngine::Developers
\&  perldoc DBI::DBD::SqlEngine
\&  perldoc SQL::Eval
\&  perldoc DBI::DBD::SqlEngine::HowTo
\&  perldoc SQL::Statement::Embed
\&  perldoc DBD::File
\&  perldoc DBD::File::HowTo
\&  perldoc DBD::File::Developers
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This document provides a step-by-step guide, how to create a new
\&\f(CW\*(C`DBD::File\*(C'\fR based \s-1DBD.\s0 It expects that you carefully read the \s-1DBI\s0
documentation and that you're familiar with \s-1DBI::DBD\s0 and had read and
understood DBD::ExampleP.
.PP
This document addresses experienced developers who are really sure that
they need to invest time when writing a new \s-1DBI\s0 Driver. Writing a \s-1DBI\s0
Driver is neither a weekend project nor an easy job for hobby coders
after work. Expect one or two man-month of time for the first start.
.PP
Those who are still reading, should be able to sing the rules of
\&\*(L"\s-1CREATING A NEW DRIVER\*(R"\s0 in \s-1DBI::DBD\s0.
.PP
Of course, DBD::File is a DBI::DBD::SqlEngine and you surely read
DBI::DBD::SqlEngine::HowTo before continuing here.
.SH "CREATING DRIVER CLASSES"
.IX Header "CREATING DRIVER CLASSES"
Do you have an entry in \s-1DBI\s0's \s-1DBD\s0 registry? For this guide, a prefix of
\&\f(CW\*(C`foo_\*(C'\fR is assumed.
.SS "Sample Skeleton"
.IX Subsection "Sample Skeleton"
.Vb 1
\&    package DBD::Foo;
\&
\&    use strict;
\&    use warnings;
\&    use vars qw(@ISA $VERSION);
\&    use base qw(DBD::File);
\&
\&    use DBI ();
\&
\&    $VERSION = "0.001";
\&
\&    package DBD::Foo::dr;
\&
\&    use vars qw(@ISA $imp_data_size);
\&
\&    @ISA = qw(DBD::File::dr);
\&    $imp_data_size = 0;
\&
\&    package DBD::Foo::db;
\&
\&    use vars qw(@ISA $imp_data_size);
\&
\&    @ISA = qw(DBD::File::db);
\&    $imp_data_size = 0;
\&
\&    package DBD::Foo::st;
\&
\&    use vars qw(@ISA $imp_data_size);
\&
\&    @ISA = qw(DBD::File::st);
\&    $imp_data_size = 0;
\&
\&    package DBD::Foo::Statement;
\&
\&    use vars qw(@ISA);
\&
\&    @ISA = qw(DBD::File::Statement);
\&
\&    package DBD::Foo::Table;
\&
\&    use vars qw(@ISA);
\&
\&    @ISA = qw(DBD::File::Table);
\&
\&    1;
.Ve
.PP
Tiny, eh? And all you have now is a \s-1DBD\s0 named foo which will be able to
deal with temporary tables, as long as you use SQL::Statement. In
DBI::SQL::Nano environments, this \s-1DBD\s0 can do nothing.
.SS "Start over"
.IX Subsection "Start over"
Based on DBI::DBD::SqlEngine::HowTo, we're now having a driver which
could do basic things. Of course, it should now derive from DBD::File
instead of DBI::DBD::SqlEngine, shouldn't it?
.PP
DBD::File extends DBI::DBD::SqlEngine to deal with any kind of files.
In principle, the only extensions required are to the table class:
.PP
.Vb 1
\&    package DBD::Foo::Table;
\&
\&    sub bootstrap_table_meta
\&    {
\&        my ( $self, $dbh, $meta, $table ) = @_;
\&
\&        # initialize all $meta attributes which might be relevant for
\&        # file2table
\&
\&        return $self\->SUPER::bootstrap_table_meta($dbh, $meta, $table);
\&    }
\&
\&    sub init_table_meta
\&    {
\&        my ( $self, $dbh, $meta, $table ) = @_;
\&
\&        # called after $meta contains the results from file2table
\&        # initialize all missing $meta attributes
\&
\&        $self\->SUPER::init_table_meta( $dbh, $meta, $table );
\&    }
.Ve
.PP
In case \f(CW\*(C`DBD::File::Table::open_file\*(C'\fR doesn't open the files as the driver
needs that, override it!
.PP
.Vb 7
\&    sub open_file
\&    {
\&        my ( $self, $meta, $attrs, $flags ) = @_;
\&        # ensure that $meta\->{f_dontopen} is set
\&        $self\->SUPER::open_file( $meta, $attrs, $flags );
\&        # now do what ever needs to be done
\&    }
.Ve
.PP
Combined with the methods implemented using the SQL::Statement::Embed
guide, the table is full working and you could try a start over.
.SS "User comfort"
.IX Subsection "User comfort"
\&\f(CW\*(C`DBD::File\*(C'\fR since \f(CW0.39\fR consolidates all persistent meta data of a table
into a single structure stored in \f(CW\*(C`$dbh\->{f_meta}\*(C'\fR. With \f(CW\*(C`DBD::File\*(C'\fR
version \f(CW0.41\fR and \f(CW\*(C`DBI::DBD::SqlEngine\*(C'\fR version \f(CW0.05\fR, this
consolidation moves to DBI::DBD::SqlEngine. It's still the
\&\f(CW\*(C`$dbh\->{$drv_prefix . "_meta"}\*(C'\fR attribute which cares, so what you
learned at this place before, is still valid.
.PP
.Vb 3
\&    sub init_valid_attributes
\&    {
\&        my $dbh = $_[0];
\&
\&        $dbh\->SUPER::init_valid_attributes ();
\&
\&        $dbh\->{foo_valid_attrs} = { ... };
\&        $dbh\->{foo_readonly_attrs} = { ...  };
\&
\&        $dbh\->{foo_meta} = "foo_tables";
\&
\&        return $dbh;
\&    }
.Ve
.PP
See updates at \*(L"User comfort\*(R" in DBI::DBD::SqlEngine::HowTo.
.SS "Testing"
.IX Subsection "Testing"
Now you should have your own DBD::File based driver. Was easy, wasn't it?
But does it work well?  Prove it by writing tests and remember to use
dbd_edit_mm_attribs from \s-1DBI::DBD\s0 to ensure testing even rare cases.
.SH "AUTHOR"
.IX Header "AUTHOR"
This guide is written by Jens Rehsack. DBD::File is written by Jochen
Wiedmann and Jeff Zucker.
.PP
The module DBD::File is currently maintained by
.PP
H.Merijn Brand < h.m.brand at xs4all.nl > and
Jens Rehsack  < rehsack at googlemail.com >
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright (C) 2010 by H.Merijn Brand & Jens Rehsack
.PP
All rights reserved.
.PP
You may freely distribute and/or modify this module under the terms of
either the \s-1GNU\s0 General Public License (\s-1GPL\s0) or the Artistic License, as
specified in the Perl \s-1README\s0 file.

[+] ..
[-] ExtUtils::Packlist.3pm [edit]
[-] DBI::Const::GetInfoType.3pm [edit]
[-] DBD::Sponge.3pm [edit]
[-] DBD::mysql::INSTALL.3pm [edit]
[-] ExtUtils::Install.3pm [edit]
[-] IO::Tty.3pm [edit]
[-] JSON::backportPP.3pm [edit]
[-] ExtUtils::Liblist.3pm [edit]
[-] DBI::DBD::Metadata.3pm [edit]
[-] Net::SSL.3pm [edit]
[-] libwww::lwpcook.3pm [edit]
[-] CPAN::Meta::History.3pm [edit]
[-] JSON::backportPP::Compat5006.3pm [edit]
[-] ExtUtils::Installed.3pm [edit]
[-] DBI::Gofer::Serializer::Storable.3pm [edit]
[-] IO::Tty::Constant.3pm [edit]
[-] ExtUtils::MM_UWIN.3pm [edit]
[-] LWP::MemberMixin.3pm [edit]
[-] LWP::UserAgent.3pm [edit]
[-] DBD::Gofer::Transport::Base.3pm [edit]
[-] DBD::File::Developers.3pm [edit]
[-] POD2::PT_BR::local::lib.3pm [edit]
[-] ExtUtils::MakeMaker::FAQ.3pm [edit]
[-] JSON::backportPP::Boolean.3pm [edit]
[-] DBI::Gofer::Request.3pm [edit]
[-] DBI::DBD::SqlEngine::Developers.3pm [edit]
[-] DBI::ProfileDumper.3pm [edit]
[-] LWP::Simple.3pm [edit]
[-] Bundle::DBI.3pm [edit]
[-] DBD::Gofer::Policy::pedantic.3pm [edit]
[-] DBI::ProfileData.3pm [edit]
[-] Net::HTTP.3pm [edit]
[-] libwww::lwptut.3pm [edit]
[-] Expect.3pm [edit]
[-] CPAN::Meta::Spec.3pm [edit]
[-] CPAN::Meta::Feature.3pm [edit]
[-] JSON.3pm [edit]
[-] JSON::backportPP::Compat5005.3pm [edit]
[-] Win32::DBIODBC.3pm [edit]
[-] ExtUtils::MakeMaker.3pm [edit]
[-] ExtUtils::MM_VOS.3pm [edit]
[-] DBD::Gofer::Transport::corostream.3pm [edit]
[-] ExtUtils::MM_OS2.3pm [edit]
[-] DBD::Gofer::Transport::null.3pm [edit]
[-] DBD::Gofer::Policy::classic.3pm [edit]
[-] IO::Socket::INET6.3pm [edit]
[-] ExtUtils::MM_Cygwin.3pm [edit]
[-] JSON::PP.3pm [edit]
[-] HTTP::Tiny.3pm [edit]
[-] Types::Serialiser.3pm [edit]
[-] ExtUtils::MM_Darwin.3pm [edit]
[-] Canary::Stability.3pm [edit]
[-] DBI::Util::CacheMemory.3pm [edit]
[-] DBI::PurePerl.3pm [edit]
[-] ExtUtils::MakeMaker::Tutorial.3pm [edit]
[-] DBI::Gofer::Transport::pipeone.3pm [edit]
[-] DBI::W32ODBC.3pm [edit]
[-] Path::Class::File.3pm [edit]
[-] CPAN::Meta::Requirements.3pm [edit]
[-] Net::HTTP::Methods.3pm [edit]
[-] DBI::Gofer::Serializer::DataDumper.3pm [edit]
[-] DBI::SQL::Nano.3pm [edit]
[-] ExtUtils::MM_BeOS.3pm [edit]
[-] ExtUtils::MM_QNX.3pm [edit]
[-] JSON::Syck.3pm [edit]
[-] version::Internals.3pm [edit]
[-] ExtUtils::MY.3pm [edit]
[-] IO::Pty.3pm [edit]
[-] DBI::Gofer::Response.3pm [edit]
[-] DBI::Gofer::Transport::Base.3pm [edit]
[-] ExtUtils::MM_MacOS.3pm [edit]
[-] ExtUtils::MM_DOS.3pm [edit]
[-] LWP::Authen::Ntlm.3pm [edit]
[-] DBI::ProxyServer.3pm [edit]
[-] DBI::Gofer::Serializer::Base.3pm [edit]
[-] Log::NullLogLite.3pm [edit]
[-] JSON::XS::Boolean.3pm [edit]
[-] LWP.3pm [edit]
[-] common::sense.3pm [edit]
[-] DBD::File::HowTo.3pm [edit]
[-] Types::Serialiser::Error.3pm [edit]
[-] LWP::Protocol::https.3pm [edit]
[-] Crypt::SSLeay.3pm [edit]
[-] Net::HTTPS.3pm [edit]
[-] POD2::DE::local::lib.3pm [edit]
[-] ExtUtils::testlib.3pm [edit]
[-] DBD::Gofer::Transport::stream.3pm [edit]
[-] ExtUtils::Command::MM.3pm [edit]
[-] ExtUtils::MM_AIX.3pm [edit]
[-] DBI::Const::GetInfo::ANSI.3pm [edit]
[-] JSON::XS.3pm [edit]
[-] ExtUtils::MM_Win32.3pm [edit]
[-] LWP::Debug.3pm [edit]
[-] Path::Class.3pm [edit]
[-] ExtUtils::MM_Any.3pm [edit]
[-] DBD::Gofer::Policy::Base.3pm [edit]
[-] DBD::Gofer::Transport::pipeone.3pm [edit]
[-] DBI::Profile.3pm [edit]
[-] IO::LockedFile::Flock.3pm [edit]
[-] CPAN::Meta.3pm [edit]
[-] Path::Class::Dir.3pm [edit]
[-] ExtUtils::MakeMaker::Locale.3pm [edit]
[-] LWP::ConnCache.3pm [edit]
[-] DBI::Gofer::Transport::stream.3pm [edit]
[-] CPAN::Meta::YAML.3pm [edit]
[-] DBD::Gofer.3pm [edit]
[-] ExtUtils::Command.3pm [edit]
[-] JSON::PP::Boolean.3pm [edit]
[-] lib::core::only.3pm [edit]
[-] LWP::Protocol.3pm [edit]
[-] LWP::RobotUA.3pm [edit]
[-] Try::Tiny.3pm [edit]
[-] DBI::ProfileSubs.3pm [edit]
[-] DBD::DBM.3pm [edit]
[-] Crypt::SSLeay::Version.3pm [edit]
[-] ExtUtils::MM_Win95.3pm [edit]
[-] ExtUtils::MM.3pm [edit]
[-] CPAN::Meta::Prereqs.3pm [edit]
[-] IO::LockedFile.3pm [edit]
[-] YAML::Syck.3pm [edit]
[-] ExtUtils::Mkbootstrap.3pm [edit]
[-] DBI::Const::GetInfo::ODBC.3pm [edit]
[-] DBD::Gofer::Policy::rush.3pm [edit]
[-] DBI::DBD.3pm [edit]
[-] ExtUtils::MakeMaker::Config.3pm [edit]
[-] version.3pm [edit]
[-] Devel::CheckLib.3pm [edit]
[-] CPAN::Meta::Converter.3pm [edit]
[-] DBI::DBD::SqlEngine::HowTo.3pm [edit]
[-] ExtUtils::MM_NW5.3pm [edit]
[-] CPAN::Meta::Validator.3pm [edit]
[-] DBD::File::Roadmap.3pm [edit]
[-] Log::LogLite.3pm [edit]
[-] DBD::mysql.3pm [edit]
[-] DBI::Gofer::Execute.3pm [edit]
[-] DBD::File.3pm [edit]
[-] DBD::Proxy.3pm [edit]
[-] Mozilla::CA.3pm [edit]
[-] ExtUtils::Mksymlists.3pm [edit]
[-] ExtUtils::MM_Unix.3pm [edit]
[-] local::lib.3pm [edit]
[-] Net::HTTP::NB.3pm [edit]
[-] ExtUtils::Manifest.3pm [edit]
[-] ExtUtils::MM_VMS.3pm [edit]
[-] DBI::ProfileDumper::Apache.3pm [edit]
[-] Bundle::DBD::mysql.3pm [edit]
[-] Parse::CPAN::Meta.3pm [edit]
[-] CPAN::Meta::Merge.3pm [edit]
[-] Path::Class::Entity.3pm [edit]
[-] DBI::DBD::SqlEngine.3pm [edit]
[-] DBI::Const::GetInfoReturn.3pm [edit]
[-] DBI.3pm [edit]
[-] DBD::Mem.3pm [edit]