Zeos tutorial/de

│ Deutsch (de) │ English (en) │ español (es) │ français (fr) │ português (pt) │ русский (ru) │ 中文（中国大陆）‎ (zh_CN) │

Überblick

Dieses Tutorial handelt vom Bekommen, Installieren und Verwenden von Zeoslib mit Lazarus und FPC.

Das Zeos Team hat vor kurzem ein neues Forum erstellt. Bitte besuchen sie das neue Forum für mehr Informationen über ZeosLib und um Fragen zu stellen / zu beantworten über die Verwendung von Zeos und um Bugs zu melden. Das neue Forum ist hier zu finden Forum für ZeosLib

Erhalten von Zeos

Sie können Zeos einfach mittels SVN erhalten, wenn sie diesen Schritten folgen:

Windows

• Besorgen sie sich einen SVN Client (z.B.TortoiseSVN) und installieren sie diesen.
• Siehe Getting Started with TortoiseSVN
• machen sie einen Checkout vom Windows Explorer aus: svn://zeos.firmos.at/zeos/trunk

Linux/BSD

• Besorgen sie sich einen SVN Client (esvn, kdesvn, etc.)
• Erstellen sie ein Verzeichnis zeosdbo, gehen in das Verzeichnis und starten
• svn checkout svn://zeos.firmos.at/zeos/trunk

Installieren der Komponenten

• Stellen sie sicher, dass sie den neuesten Lazarus Snapshot haben und mindestens FPC 2.0.3 nicht älter als vom 6. März 2006.

• Starten sie eine Instanz von Lazarus.

1. Benutzen sie Komponenten/Paketdatei (.lpk) öffnen im Hauptmenü.
2. Gehen sie zu zeosdbo_rework\packages\lazarus\ und öffnen zcomponent.lpk
3. Drücken sie [Kompilieren] nur dann, wenn sie die Komponenten nicht in die IDE installieren wollen
4. Drücken sie [Installieren]
5. Sie werden gefragt, ob sie Lazarus rekompileren wollen.
6. Antworten sie diesmal mit [Yes] .
7. Warten sie bis die Kompilierung beendet ist. Lazarus sollte sich danach selbst neu starten.
8. Wenn alles ok ist, sollten sie jetzt den [Zeos Access] Tab in der Komponentenpalette sehen.

If you receive the error "Cannot find unit ZClasses" or something similar, then you need to carefully check the case of the filenames in your Zeos source distribution.

Change all file and directory names of then zeoslib-directory to lowercase. (easy to do with freeware tool "freecommander" for example) Then, in Lazarus, reopen all packages (.lpk) and fix the filename cases by clicking on "More..."/"Fix Files Case". Compile them.

• Even if the cases match exactly, the autogenerated package source file can generate the wrong case name in the uses clause (Lazarus 0.9.18), i.e.:

 { This file was automatically created by Lazarus. Do not edit!
   This source is only used to compile and install the package.
 }
 unit Zcore; 
 interface
 uses
   Zclasses, Zcollections, Zcompatibility, Zexprparser, Zexprtoken, Zexpression, 
   Zfunctions, Zmatchpattern, Zmessages, Zsysutils, Ztokenizer, Zvariables, 
   Zvariant; 
 implementation
 end.           

• Notice that Lazarus has named the unit ZClasses Zclasses, resulting in a naming conflict. Presumably this is a bug in Lazarus, not the Zeos packages. One way around this is to rename all the zeos source files to lowercase. Trawl through each subdirectory under src/ and execute this command in a bash window:

 rename -v 'y/A-Z/a-z/' *

Erstellen ihrer ersten Zeos Anwendung

• Legen sie eine ZConnection ab (auf ihrem Formular).
  • Setzen sie ihren User, Password, Host, Port und Protocol (und jeden anderen Parameter falls benötigt).
  • Setzen sie Connected auf True.

• Legen sie eine ZQuery ab (nicht mit ZReadOnlyQuery verwechseln).
  • Setzen sie Connection auf ihre aktive ZConnection.
  • Setzen sie die SQL Eigenschaft auf etwas wie SELECT * FROM MyTable
  • Setzen sie Active auf True.

• Legen sie eine DataSource vom [Data Access] Tab ab.
  • Setzen sie DataSet auf ihre aktive ZQuery.

• Legen sie ein DBGrid vom [Data Controls] Tab ab.
  • Setzen sie Datasource auf ihre DataSource.
  • Wenn alles ok ist, sollten sie jetzt die Datensätze aus ihrer Tabelle sehen.

Mehr Informationen über das Arbeiten mit Zeos

Hier können sie einige wirklich hilfreiche Artikel finden, welche die Verwendung von Zeos beschreiben und seine Interna, einige von ihnen handeln auch über Delphi spezifischen Stoff aber meistens können die gleichen Techniken ebenfalls in Lazarus verwendet werden.

• Die ZeosLib DBOs 6.1.5 - Mit Delphi 7 und Firebird 1.5
• Überblick über die Zeos Database Objects Architecture
• Eine Einführung in das ZDBC API
• Prüfen sie auch den Downloads Abschnitt für echte Beispiele, welche einfach nach Lazarus portiert werden können.

Bitte ergänzen sie diesen Bereich

Mögliche Bugs und Probleme

1. Ich habe bemerkt, dass manchmal wenn Lazarus erstellt wird, einige Zeos Dateien nicht gefunden werden, als provisorische Hilfe versuchen sie dies:
   • Benutzen sie Komponenten/Paketgraph im Hauptmenü.
   • Öffnen sie das ZComponent Package.
   • Klicken sie rechts auf den Dateien Punkt in der Liste.
   • Wählen sie [Recompile all required].
   • Wenn gefragt wird "Re-Compile this and all required packages?" antworten sie [Ja].
   • Rekompilieren sie Lazarus normal (mit Packages).
     
     
2. Es gibt einen Bug in FPC's AnsiStrComp, welcher einen unzuverlässigen PChar Vergleich verursacht, das ist deutlich wenn ein DBGrid zum Bearbeiten der Daten verwendet wird, AnsiStrComp('abc', 'abcd') kann sie nicht als unterschiedlich erkennen aber es erkennt AnsiStrComp('abd', 'abcd') ignorierend mehrere Zeichen in der zweiten Zeichenkette. Dieser Bug wurde von Jesusrmx gefunden. Er wird wahrscheinlich bald bereinigt, siehe Bug Report.