NAME
DBIx::Roles::Shared - Share DB connection handles
DESCRIPTION
Caches DB handles for already established connections, and returns these when another connect call is issued. Serves as a replacement to DBI-> connect_cached.
SIDE EFFECTS
The roles allows itself some freedom with calling $self-> dbh at will, in particular, it assumes that result of connect is stored in dbh, and is cleared after dbh. The role probably won't work if these conditions don't hold.
Any change to an intrinsic DBI attribute on a DB handle silently propagates the attribute value to the other DBIx::Roles objects that use the same handle. It is possible to extend the role to virtualize the attributes, but I think that would be an overkill.
Whenever connect is called without previously calling disconnect, the role assumes that the DB handle is being reconnected, and updates all objects that share the handle, with the new connection. This feature allows the role to coexist with DBIx::Roles::AutoReconnect.
SEE ALSO
COPYRIGHT
Copyright (c) 2005 catpipe Systems ApS. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
AUTHOR
Dmitry Karasik <dk@catpipe.net>