/[cvs]/nfo/perl/libs/Data/README.html
ViewVC logotype

Annotation of /nfo/perl/libs/Data/README.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (hide annotations)
Sat Nov 9 01:05:20 2002 UTC (21 years, 6 months ago) by joko
Branch: MAIN
Changes since 1.2: +15 -5 lines
File MIME type: text/html
+ updated pod

1 joko 1.1 <HTML>
2     <HEAD>
3     <TITLE>Data::Storage</TITLE>
4     <LINK REV="made" HREF="mailto:">
5     </HEAD>
6    
7     <BODY>
8    
9     <A NAME="__index__"></A>
10     <!-- INDEX BEGIN -->
11    
12     <UL>
13    
14     <LI><A HREF="#name">NAME</A></LI>
15     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
16     <UL>
17    
18     <LI><A HREF="#note">NOTE</A></LI>
19     </UL>
20    
21 joko 1.3 <LI><A HREF="#requirements">REQUIREMENTS</A></LI>
22 joko 1.1 <LI><A HREF="#description">DESCRIPTION</A></LI>
23     <LI><A HREF="#authors / copyright">AUTHORS / COPYRIGHT</A></LI>
24     <LI><A HREF="#acknowledgements">ACKNOWLEDGEMENTS</A></LI>
25     <LI><A HREF="#support / warranty">SUPPORT / WARRANTY</A></LI>
26     <LI><A HREF="#todo">TODO</A></LI>
27     <UL>
28    
29     <LI><A HREF="#handle the following errors/cases:">Handle the following errors/cases:</A></LI>
30     <UL>
31    
32     <LI><A HREF="#dbierror [tangram]: dbd::mysql::st execute failed: unknown column 't1.requestdump' in 'field list'">``DBI-Error [Tangram]: DBD::mysql::st execute failed: Unknown column 't1.requestdump' in 'field list'''</A></LI>
33     <LI><A HREF="#compare schema (structure diff) with database ...">Compare schema (structure diff) with database ...</A></LI>
34     </UL>
35    
36     <LI><A HREF="#introduce some features:">Introduce some features:</A></LI>
37     <UL>
38    
39     <LI><A HREF="#links:">Links:</A></LI>
40     </UL>
41    
42     </UL>
43    
44     </UL>
45     <!-- INDEX END -->
46    
47     <HR>
48     <P>
49     <H1><A NAME="name">NAME</A></H1>
50     <P>Data::Storage - Interface for accessing various Storage implementations for Perl in an independent way</P>
51     <P>
52     <HR>
53     <H1><A NAME="synopsis">SYNOPSIS</A></H1>
54     <PRE>
55     ... the basic way:</PRE>
56     <PRE>
57     ... via inheritance:
58     </PRE>
59     <PRE>
60    
61     use Data::Storage;
62     my $proxyObj = new HttpProxy;
63     $proxyObj-&gt;{url} = $url;
64     $proxyObj-&gt;{payload} = $content;
65     $self-&gt;{storage}-&gt;insert($proxyObj);</PRE>
66     <PRE>
67    
68     use Data::Storage;
69     my $proxyObj = HttpProxy-&gt;new(
70     url =&gt; $url,
71     payload =&gt; $content,
72     );
73     $self-&gt;{storage}-&gt;insert($proxyObj);</PRE>
74     <P>
75     <H2><A NAME="note">NOTE</A></H2>
76     <P>This module heavily relies on DBI and Tangram, but adds a lot of additional bugs and quirks.
77 joko 1.3 Please look at their documentation and/or this code for additional information.</P>
78     <P>
79     <HR>
80     <H1><A NAME="requirements">REQUIREMENTS</A></H1>
81     <P>For full functionality:
82     DBI from CPAN
83     Tangram from CPAN
84     Class::Tangram from CPAN
85     MySQL::Diff from <A HREF="http://adamspiers.org/computing/mysqldiff/">http://adamspiers.org/computing/mysqldiff/</A>
86     ... and all their dependencies</P>
87 joko 1.1 <P>
88     <HR>
89     <H1><A NAME="description">DESCRIPTION</A></H1>
90     <P>Data::Storage is module for a accessing various ``data structures'' stored inside
91     various ``data containers''. It sits on top of DBI and/or Tangram.</P>
92     <P>
93     <HR>
94     <H1><A NAME="authors / copyright">AUTHORS / COPYRIGHT</A></H1>
95     <P>The Data::Storage module is Copyright (c) 2002 Andreas Motl.
96     All rights reserved.</P>
97     <P>You may distribute it under the terms of either the GNU General Public
98     License or the Artistic License, as specified in the Perl README file.</P>
99     <P>
100     <HR>
101     <H1><A NAME="acknowledgements">ACKNOWLEDGEMENTS</A></H1>
102 joko 1.3 <P>Larry Wall for Perl, Tim Bunce for DBI, Jean-Louis Leroy for Tangram and Set::Object,
103     Sam Vilain for Class::Tangram, Adam Spiers for MySQL::Diff and all contributors.</P>
104 joko 1.1 <P>
105     <HR>
106     <H1><A NAME="support / warranty">SUPPORT / WARRANTY</A></H1>
107     <P>Data::Storage is free software. IT COMES WITHOUT WARRANTY OF ANY KIND.</P>
108     <P>
109     <HR>
110     <H1><A NAME="todo">TODO</A></H1>
111     <P>
112     <H2><A NAME="handle the following errors/cases:">Handle the following errors/cases:</A></H2>
113     <P>
114     <H3><A NAME="dbierror [tangram]: dbd::mysql::st execute failed: unknown column 't1.requestdump' in 'field list'">``DBI-Error [Tangram]: DBD::mysql::st execute failed: Unknown column 't1.requestdump' in 'field list'''</A></H3>
115     <PRE>
116     ... occours when operating on object-attributes not introduced yet:
117     this should be detected and appended/replaced through:
118     &quot;Schema-Error detected, maybe (just) an inconsistency.
119     Please check if your declaration in schema-module &quot;a&quot; matches structure in database &quot;b&quot; or try to run&quot;
120     db_setup.pl --dbkey=import --action=deploy</PRE>
121     <P>
122     <H3><A NAME="compare schema (structure diff) with database ...">Compare schema (structure diff) with database ...</A></H3>
123     <PRE>
124     ... when issuing &quot;db_setup.pl --dbkey=import --action=deploy&quot;
125     on a database with an already deployed schema, use an additional &quot;--update&quot; then
126     to lift the schema inside the database to the current declared schema.
127     You will have to approve removals and changes on field-level while
128     new objects and new fields are introduced silently without any interaction needed.
129     In future versions there may be additional options to control silent processing of
130     removals and changes.
131     See this CRUD-table applying to the actions occouring on Classes and Class variables when deploying schemas,
132     don't mix this up with CRUD-actions on Objects, these are already handled by (e.g.) Tangram itself.
133     Classes:
134     C create -&gt; yes, handled automatically
135     R retrieve -&gt; no, not subject of this aspect since it is about deployment only
136     U update -&gt; yes, automatically for Class meta-attributes, yes/no for Class variables (look at the rules down here)
137     D delete -&gt; yes, just by user-interaction
138     Class variables:
139     C create -&gt; yes, handled automatically
140     R retrieve -&gt; no, not subject of this aspect since it is about deployment only
141     U update -&gt; yes, just by user-interaction; maybe automatically if it can be determined that data wouldn't be lost
142     D delete -&gt; yes, just by user-interaction
143 joko 1.2 </PRE>
144     <PRE>
145    
146     It's all about not to be able to loose data simply while this is in pre-alpha stage.
147     And loosing data by being able to modify and redeploy schemas easily is definitely quite easy.</PRE>
148     <PRE>
149    
150     As we can see, creations of Classes and new Class variables is handled
151     automatically and this is believed to be the most common case under normal circumstances.</PRE>
152 joko 1.1 <P>
153     <H2><A NAME="introduce some features:">Introduce some features:</A></H2>
154     <PRE>
155 joko 1.2 - Get this stuff together with UML (Unified Modeling Language) and/or standards from ODMG.
156     - Make it possible to load/save schemas in XMI (XML Metadata Interchange),
157     which seems to be most commonly used today, perhaps handle objects with OIFML.
158     Integrate/bundle this with a web-/html-based UML modeling tool or
159     some other interesting stuff like the &quot;Co-operative UML Editor&quot; from Uni Darmstadt. (web-/java-based)
160     - Enable Round Trip Engineering. Keep code and diagrams in sync. Don't annoy/bother the programmers.
161     - Add some more handlers:
162     - look at DBD::CSV, Text::CSV, XML::CSV, XML::Excel
163     - Add some more locations/locators:
164     - PerlDAV: <A HREF="http://www.webdav.org/perldav/">http://www.webdav.org/perldav/</A>
165     - Move to t3, use InCASE</PRE>
166 joko 1.1 <P>
167     <H3><A NAME="links:">Links:</A></H3>
168     <PRE>
169 joko 1.2 Specs:
170 joko 1.1 UML 1.3 Spec: <A HREF="http://cgi.omg.org/cgi-bin/doc?ad/99-06-08.pdf">http://cgi.omg.org/cgi-bin/doc?ad/99-06-08.pdf</A>
171     XMI 1.1 Spec: <A HREF="http://cgi.omg.org/cgi-bin/doc?ad/99-10-02.pdf">http://cgi.omg.org/cgi-bin/doc?ad/99-10-02.pdf</A>
172     XMI 2.0 Spec: <A HREF="http://cgi.omg.org/docs/ad/01-06-12.pdf">http://cgi.omg.org/docs/ad/01-06-12.pdf</A>
173     ODMG: <A HREF="http://odmg.org/">http://odmg.org/</A>
174 joko 1.2 OIFML: <A HREF="http://odmg.org/library/readingroom/oifml.pdf">http://odmg.org/library/readingroom/oifml.pdf</A></PRE>
175     <PRE>
176     CASE Tools:
177     Rational Rose (commercial): <A HREF="http://www.rational.com/products/rose/">http://www.rational.com/products/rose/</A>
178     Together (commercial): <A HREF="http://www.oi.com/products/controlcenter/index.jsp">http://www.oi.com/products/controlcenter/index.jsp</A>
179     InCASE - Tangram-based Universal Object Editor
180     Sybase PowerDesigner: <A HREF="http://www.sybase.com/powerdesigner">http://www.sybase.com/powerdesigner</A>
181     </PRE>
182 joko 1.1 <PRE>
183 joko 1.2
184     UML Editors:
185     Fujaba (free, university): <A HREF="http://www.fujaba.de/">http://www.fujaba.de/</A>
186     ArgoUML (free): <A HREF="http://argouml.tigris.org/">http://argouml.tigris.org/</A>
187     Poseidon (commercial): <A HREF="http://www.gentleware.com/products/poseidonDE.php3">http://www.gentleware.com/products/poseidonDE.php3</A>
188     Co-operative UML Editor (research): <A HREF="http://www.darmstadt.gmd.de/concert/activities/internal/umledit.html">http://www.darmstadt.gmd.de/concert/activities/internal/umledit.html</A>
189     Metamill (commercial): <A HREF="http://www.metamill.com/">http://www.metamill.com/</A>
190     Violet (university, research, education): <A HREF="http://www.horstmann.com/violet/">http://www.horstmann.com/violet/</A>
191     PyUt (free): <A HREF="http://pyut.sourceforge.net/">http://pyut.sourceforge.net/</A>
192     (Dia (free): <A HREF="http://www.lysator.liu.se/~alla/dia/">http://www.lysator.liu.se/~alla/dia/</A>)
193     UMLet (free, university): <A HREF="http://www.swt.tuwien.ac.at/umlet/index.html">http://www.swt.tuwien.ac.at/umlet/index.html</A>
194 joko 1.3 Voodoo (free): <A HREF="http://voodoo.sourceforge.net/">http://voodoo.sourceforge.net/</A>
195     Umbrello UML Modeller: <A HREF="http://uml.sourceforge.net/">http://uml.sourceforge.net/</A></PRE>
196 joko 1.2 <PRE>
197     UML Tools:
198     <A HREF="http://www.objectsbydesign.com/tools/umltools_byPrice.html">http://www.objectsbydesign.com/tools/umltools_byPrice.html</A></PRE>
199     <PRE>
200     Further readings:
201 joko 1.1 <A HREF="http://www.google.com/search?q=web+based+uml+editor&amp">http://www.google.com/search?q=web+based+uml+editor&amp</A>;hl=en&amp;lr=&amp;ie=UTF-8&amp;oe=UTF-8&amp;start=10&amp;sa=N
202     <A HREF="http://www.fernuni-hagen.de/DVT/Aktuelles/01FHHeidelberg.pdf">http://www.fernuni-hagen.de/DVT/Aktuelles/01FHHeidelberg.pdf</A>
203     <A HREF="http://www.enhyper.com/src/documentation/">http://www.enhyper.com/src/documentation/</A>
204     <A HREF="http://cis.cs.tu-berlin.de/Dokumente/Diplomarbeiten/2001/skinner.pdf">http://cis.cs.tu-berlin.de/Dokumente/Diplomarbeiten/2001/skinner.pdf</A>
205     <A HREF="http://citeseer.nj.nec.com/vilain00diagrammatic.html">http://citeseer.nj.nec.com/vilain00diagrammatic.html</A>
206     <A HREF="http://archive.devx.com/uml/articles/Smith01/Smith01-3.asp">http://archive.devx.com/uml/articles/Smith01/Smith01-3.asp</A></PRE>
207    
208     </BODY>
209    
210     </HTML>

MailToCvsAdmin">MailToCvsAdmin
ViewVC Help
Powered by ViewVC 1.1.26 RSS 2.0 feed