| 1 |
NAME |
NAME |
| 2 |
Data::Storage - Interface for accessing various Storage implementations |
Data::Storage - Interface for accessing various Storage implementations for Perl in an independent way |
|
for Perl in an independent way |
|
| 3 |
|
|
| 4 |
AIMS |
AIMS |
| 5 |
- should encapsulate Tangram, DBI, DBD::CSV and LWP:: to access them in an unordinary (more convenient) way ;) |
- should encapsulate Tangram, DBI, DBD::CSV and LWP:: to access them in an unordinary (more convenient) way ;) |
| 107 |
|
|
| 108 |
NOTE |
NOTE |
| 109 |
|
|
| 110 |
This module heavily relies on DBI and Tangram, but adds a lot of |
This module heavily relies on DBI and Tangram, but adds a lot of additional bugs and quirks. |
| 111 |
additional bugs and quirks. Please look at their documentation and/or |
Please look at their documentation and/or this code for additional information. |
|
this code for additional information. |
|
| 112 |
|
|
| 113 |
REQUIREMENTS |
REQUIREMENTS |
| 114 |
For full functionality: |
For full functionality: |
| 122 |
... and all their dependencies |
... and all their dependencies |
| 123 |
|
|
| 124 |
DESCRIPTION |
DESCRIPTION |
| 125 |
Data::Storage is a module for accessing various "data structures" stored |
Data::Storage |
|
inside various "data containers". It sits on top of DBI and/or Tangram. |
|
| 126 |
|
|
| 127 |
AUTHORS / COPYRIGHT |
Data::Storage is a module for accessing various "data structures / kinds of structured data" stored inside |
| 128 |
The Data::Storage module is Copyright (c) 2002 Andreas Motl. All rights |
various "data containers". |
| 129 |
reserved. |
We tried to use the AdapterPattern (http://c2.com/cgi/wiki?AdapterPattern) to implement a wrapper-layer |
| 130 |
|
around core CPAN modules (Tangram, DBI). |
| 131 |
|
|
| 132 |
|
Why? |
| 133 |
|
|
| 134 |
|
You will get a better code-structure (not bad for later maintenance) in growing Perl code projects, |
| 135 |
|
especially when using multiple database connections at the same time. |
| 136 |
|
You will be able to switch between different _kinds_ of implementations used for storing data. |
| 137 |
|
Your code will use the very same API to access these storage layers. |
| 138 |
|
... implementation has to be changed for now |
| 139 |
|
Maybe you will be able to switch "on-the-fly" without changing any bits in code in the future.... |
| 140 |
|
... but that's not the focus |
| 141 |
|
|
| 142 |
|
What else? |
| 143 |
|
|
| 144 |
You may distribute it under the terms of either the GNU General Public |
Having this, we were able to do implement a generic data synchronization module more easy, |
| 145 |
License or the Artistic License, as specified in the Perl README file. |
please look at Data::Transfer. |
| 146 |
|
|
| 147 |
|
AUTHORS / COPYRIGHT |
| 148 |
|
The Data::Storage module is Copyright (c) 2002 Andreas Motl. |
| 149 |
|
All rights reserved. |
| 150 |
|
You may distribute it under the terms of either the GNU General Public |
| 151 |
|
License or the Artistic License, as specified in the Perl README file. |
| 152 |
|
|
| 153 |
ACKNOWLEDGEMENTS |
ACKNOWLEDGEMENTS |
| 154 |
Larry Wall for Perl, Tim Bunce for DBI, Jean-Louis Leroy for Tangram and |
Larry Wall for Perl, Tim Bunce for DBI, Jean-Louis Leroy for Tangram and Set::Object, |
| 155 |
Set::Object, Sam Vilain for Class::Tangram, Jochen Wiedmann and Jeff |
Sam Vilain for Class::Tangram, Jochen Wiedmann and Jeff Zucker for DBD::CSV & Co., |
| 156 |
Zucker for DBD::CSV and related, Adam Spiers for MySQL::Diff and all |
Adam Spiers for MySQL::Diff and all contributors. |
|
contributors. |
|
| 157 |
|
|
| 158 |
SUPPORT / WARRANTY |
SUPPORT / WARRANTY |
| 159 |
Data::Storage is free software. IT COMES WITHOUT WARRANTY OF ANY KIND. |
Data::Storage is free software. IT COMES WITHOUT WARRANTY OF ANY KIND. |
| 160 |
|
|
| 161 |
TODO |
TODO |
| 162 |
BUGS |
BUGS |
| 223 |
- .pst - files (Outlook Post Storage?) |
- .pst - files (Outlook Post Storage?) |
| 224 |
- XML (e.g. via XML::Simple?) |
- XML (e.g. via XML::Simple?) |
| 225 |
- Move to t3, look at InCASE |
- Move to t3, look at InCASE |
| 226 |
|
- some kind of security layer for methods/objects |
| 227 |
|
- acls (stored via tangram/ldap?) for functions, methods and objects (entity- & data!?) |
| 228 |
|
- where are the hooks needed then? |
| 229 |
|
- is Data::Storage & Co. okay, or do we have to touch the innards of DBI and/or Tangram? |
| 230 |
|
- an attempt to start could be: |
| 231 |
|
- 'sub getACLByObjectId($id, $context)' |
| 232 |
|
- 'sub getACLByMethodname($id, $context)' |
| 233 |
|
- 'sub getACLByName($id, $context)' |
| 234 |
|
( would require a kinda registry to look up these very names pointing to arbitrary locations (code, data, ...) ) |
| 235 |
|
|
| 236 |
LINKS / REFERENCES |
LINKS / REFERENCES |
| 237 |
|
|