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: http://svn.code.sf.net/p/zeoslib/code-0/branches/testing

Linux/BSD

• Besorgen Sie sich einen SVN Client (esvn, kdesvn, etc.)
• Erstellen Sie ein Verzeichnis zeosdbo, gehen in das Verzeichnis und starten
• svn checkout http://svn.code.sf.net/p/zeoslib/code-0/branches/testing

Installieren der Komponenten

• Verwenden Sie einen aktuellen Lazarus Snapshot.

• Starten Sie eine Instanz von Lazarus.

1. Benutzen Sie Package -> Packagedatei (.lpk) öffnen im Hauptmenü.
2. Gehen Sie in das \packages\lazarus\ Unterverzeichnis von Zeoslib und öffnen Sie zcomponent.lpk
3. Drücken Sie Kompilieren, um (vor allem) die Abhängigkeiten des Packages zu kompilieren
4. Drücken Sie Nutzung... -> Installieren
5. Sie werden gefragt, ob Sie Lazarus rekompileren wollen.
6. Antworten Sie diesmal mit Ja .
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.

Wenn Sie die Fehlermeldung "Cannot find unit ZClasses" oder Ähnliches erhalten, prüfen Sie sorgfältig die Groß/Klein-Schreibung des Dateinamens Ihrer Zeos Dateien (orig.: Zeos source distribution).

Schreiben Sie alle Datei- und Verzeichnisnamen des zeoslib-Verzeichnisses in Kleinbuchstaben. (Mit dem freeware programm "freecommander" geht das z.B. ganz einfach) In Lazarus öffen Sie danach wieder alle Packages (.lpk) und passen die Schreibweise der Dateinamen an, indem Sie anklicken : "More..."/"Fix Files Case". Compile them.

• Auch wenn die Groß/Klein-Schreibung genau passt, können die automatisch erzeugten Package Quell-Dateien Namen mit falscher Schreibweise (Groß/klein) in der uses Clause erzeugen : (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.           

• Beachten Sie, dass Lazarus die unit ZClasses in Zclasses umgeschrieben hat, so dass sich ein Namenskonflikt ergibt. Das scheint ein Lazarus-Fehler zu sein, keiner des Zeos-Packages. Eine Möglichkeit, diesen Konflikt zu umgehen ist es, alle Zeos-Quelldateinamen kleinzuschreiben. Gehen Sie durch alle Unterverzeichnisse unter src/ and führen den Sie folgenden Befehl in einer bash-Kommandozeile aus:

 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') und ignoriert mehrere Zeichen in der zweiten Zeichenkette. Dieser Bug wurde von Jesusrmx gefunden. Er wird wahrscheinlich bald bereinigt, siehe Bug Report.