Manual Reference Pages - DBD::GOFER::POLICY::BASE (3)
DBD::Gofer::Policy::Base - Base class for DBD::Gofer policies
$dbh = DBI->connect("dbi:Gofer:transport=...;policy=...", ...)
DBD::Gofer can be configured via a policy mechanism that allows you to
fine-tune the number of round-trips to the Gofer server. The policies are
grouped into classes (which may be subclassed) and referenced by the name of
The DBD::Gofer::Policy::Base class is the base class for all the policy
classes and describes all the individual policy items.
The Base policy is not used directly. You should use a policy class derived from it.
Three policy classes are supplied with DBD::Gofer:
DBD::Gofer::Policy::pedantic is most transparent but slowest because it
makes more round-trips to the Gofer server.
DBD::Gofer::Policy::classic is a reasonable compromise - its the default policy.
DBD::Gofer::Policy::rush is fastest, but may require code changes in your applications.
Generally the default classic policy is fine. When first testing an existing
application with Gofer it is a good idea to start with the pedantic policy
first and then switch to classic or a custom policy, for final testing.
These are temporary docs: See the source code for list of policies and their defaults.
In a future version the policies and their defaults will be defined in the pod and parsed out at load-time.
See the source code to this module for more details.
XXX This area of DBD::Gofer is subject to change.
There are three ways to customize policies:
Policy classes are designed to influence the overall behaviour of DBD::Gofer
with existing, unaltered programs, so they work in a reasonably optimal way
without requiring code changes. You can implement new policy classes as
subclasses of existing policies.
In many cases individual policy items can be overridden on a case-by-case basis
within your application code. You do this by passing a corresponding
<go_<policy_name>> attribute into DBI methods by your application code.
This lets you fine-tune the behaviour for special cases.
The policy items are implemented as methods. In many cases the methods are
passed parameters relating to the DBD::Gofer code being executed. This means
the policy can implement dynamic behaviour that varies depending on the
particular circumstances, such as the particular statement being executed.
Tim Bunce, <http://www.tim.bunce.name>
LICENCE AND COPYRIGHT
Copyright (c) 2007, Tim Bunce, Ireland. All rights reserved.
This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself. See perlartistic.
|perl v5.20.3 ||DBD::GOFER::POLICY::BASE (3) ||2013-06-24 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.