← Back to branch summary

~ubuntu-branches/ubuntu/feisty/fpc/feisty

« back to all changes in this revision

Viewing changes to fcl/db/README

  • Committer: Bazaar Package Importer
  • Author(s): Torsten Werner
  • Date: 2007-01-27 20:08:50 UTC
  • mfrom: (1.2.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20070127200850-9mrptaqqjsx9nwa7
Tags: 2.0.4-5
* Fixed Build-Depends.
* Add myself to Uploaders in debian/control.
* Make sure that the sources are really patched before building them.
* Build unit 'libc' on powerpc too.

Show diffs side-by-side

added added

removed removed

Lines of Context:
fcl/db/README
1
1
This is the Database directory of the Free Component Library.
2
2
 
3
 
At the moment, there is a read/write implementation of TDataset.
4
 
The blob support is not tested yet.
5
 
 
6
 
Compiling the units:
7
 
 
8
 
Just run 'make all' and all should go fine, provided
9
 
1) The mysql unit is in the compiler path (the makefile will try to compile
10
 
   it in the packages mysql subdirectory)
11
 
2) the mysqlclient library is in /usr/lib (if you want to compile the mtest 
12
 
   program)
13
 
if these conditions are not satisfied, you should edit the makefile
14
 
and add -Fl/path/to/libmysqlclient to NEEDOPTS as well as
15
 
the -Fu/path/to/mysql/unit option.
16
 
 
17
 
Compiling the examples:
18
 
 
19
 
If the units compile fine, then the examples can be compiled by doing
20
 
'make examples'. see also the above remarks.
21
 
 
22
 
there are 2 descendents of TDataset to demonstrate/test the 
23
 
TDataset implementation.
24
 
 
25
 
TddgDataset : 
26
 
 
27
 
  Implemented in ddg_ds and ddg_rec. The dataset as
28
 
  implemented in the Delphi 4 Developers Guide.
29
 
  To test it, do a 
30
 
   createds filename
31
 
   testds filename
32
 
   tested filename
33
 
  the first creates a flat file, filled with 100 records;
34
 
  the second tests the navigation methods of TDataset on this file.
35
 
  the third tests the editing methods of TDataset (Append,Insert 
36
 
  and edit)
37
 
 
38
 
TMySQLdataset :
39
 
  Implemented in mysqldb. You need the mysql units for this.
40
 
  This is a temporary implementation based on the code from
41
 
     Rangel Gustavo Reale (hitnrun@geocities.com) 
42
 
  it will be used as a base for the DBdataset scalable dataset
43
 
  implementation.
44
 
  To test it, do a 
45
 
     mtest db user pwd SQL
46
 
  this will run the query SQL on the database db with user
47
 
  'user' and password 'pwd', and dump the result. Take care
48
 
  that you don't specify blob fields.
49
 
  To test it on the table created by the mkdb shell script
50
 
  that comes with the Free Pascal mysql unit, I did a
51
 
      mtest test michael pwd 'select * from FPdev'
52
 
 
53
 
I haven't implemented/tested blob fields yet.
 
3
All base classes are in the db unit, the dbconst unit contains the 
 
4
used resourcestrings.
 
5
 
 
6
memds
 
7
  contains a dataset-class in memory which can be read from, and
 
8
  written to a stream
 
9
 
 
10
sqldb
 
11
  contains a framework to work with several SQL-based databases
 
12
  as Interbase, Firebird, MySQL, ODBC and Oracle
 
13
 
 
14
dbase
 
15
  contains the tDbf components, to work with DBASE and FoxPro
 
16
  file-based databases
 
17
 
 
18
sdf
 
19
  contains a dataset class to use text files directly as a
 
20
  database. That could be fixed-size, or limited (SDF)
 
21
 
 
22
sqlite
 
23
  contains datases classes to use sqlite and sqlite3
 
24
 
 
25
unmaintained
 
26
  contains some obsolete units which were replaced by better
 
27
  alternatives, or which are old tests which are not needed
 
28
  anymore
54
29
 
55
30
Enjoy !
56
31
 
57
 
Michael.              
 
32
Joost van der Sluis.