UltraLite Static Java Benutzerhandbuch - Downloads - Sybase

UltraLite Static Java
Benutzerhandbuch
Bestellnummer: DC50035-01-0902-01
Stand: Oktober 2004

Copyright © 1989–2004 Sybase Inc. Teil-Copyright © 2001–2004 iAnywhere Solutions Inc. Alle Rechte vorbehalten.
Diese Publikation darf weder ganz noch in Teilen, weder elektronisch, mechanisch, manuell, optisch oder auf sonstige Weise ohne vorherige
schriftliche Genehmigung von iAnywhere Solutions, Inc reproduziert, übertragen oder übersetzt werden. iAnywhere Solutions Inc. ist eine
Tochtergesellschaft von Sybase Inc.
Sybase, SYBASE (Logo), AccelaTrade, ADA Workbench, Adaptable Windowing Environment, Adaptive Component Architecture, Adaptive
Server, Adaptive Server Anywhere, Adaptive Server Enterprise, Adaptive Server Enterprise Monitor, Adaptive Server Enterprise Replication,
Adaptive Server Everywhere, Adaptive Server IQ, Adaptive Warehouse, AnswerBase, Anywhere Studio, Application Manager, AppModeler,
APT Workbench, APT-Build, APT-Edit, APT-Execute, APT-Library, APT-Translator, ASEP, AvantGo, AvantGo Application Alerts, AvantGo
Mobile Delivery, AvantGo Mobile Document Viewer, AvantGo Mobile Inspection, AvantGo Mobile Marketing Channel, AvantGo Mobile Pharma,
AvantGo Mobile Sales, AvantGo Pylon, AvantGo Pylon Application Server, AvantGo Pylon Conduit, AvantGo Pylon PIM Server, AvantGo
Pylon Pro, Backup Server, BayCam, Bit-Wise, BizTracker, Certified PowerBuilder Developer, Certified SYBASE Professional, Certified SYBASE
Professional-Logo, ClearConnect, Client Services, Client-Library, CodeBank, Column Design, ComponentPack, Connection Manager, Convoy/DM,
Copernicus, CSP, Data Pipeline, Data Workbench, DataArchitect, Database Analyzer, DataExpress, DataServer, DataWindow, DB-Library,
dbQueue, Developers Workbench, Direct Connect Anywhere, DirectConnect, Distribution Director, Dynamic Mobility Model, Dynamo, e-ADK,
E-Anywhere, e-Biz Integrator, EC Gateway, ECMAP, ECRTP, eFulfillment Accelerator, Electronic Case Management, Embedded SQL, EMS,
Enterprise Application Studio, Enterprise Client/Server, Enterprise Connect, Enterprise Data Studio, Enterprise Manager, Enterprise Portal (Logo),
Enterprise SQL Server Manager, Enterprise Work Architecture, Enterprise Work Designer, Enterprise Work Modeler, eProcurement Accelerator,
eremote, Everything Works Better When Everything Works Together, EWA, E-Whatever, Financial Fusion, Financial Fusion (and design), Financial
Fusion Server, Formula One, Fusion Powered e-Finance, Fusion Powered Financial Destinations, Fusion Powered STP, Gateway Manager,
GeoPoint, GlobalFIX, iAnywhere, iAnywhere Solutions, ImpactNow, Industry Warehouse Studio, InfoMaker, Information Anywhere, Information
Everywhere, InformationConnect, InstaHelp, Intelligent Self-Care, InternetBuilder, iremote, iScript, Jaguar CTS, jConnect for JDBC,
KnowledgeBase, Logical Memory Manager, Mail Anywhere Studio, MainframeConnect, Maintenance Express, Manage Anywhere Studio, MAP,
M-Business Channel, M-Business Network, M-Business Server, MDI Access Server, MDI Database Gateway, media.splash, Message Anywhere
Server, MetaWorks, MethodSet, ML Query, MobiCATS, My AvantGo, My AvantGo Media Channel, My AvantGo Mobile Marketing, MySupport,
Net-Gateway, Net-Library, New Era of Networks, Next Generation Learning, Next Generation Learning Studio, O DEVICE, OASiS, OASiS-Logo,
ObjectConnect, ObjectCycle, OmniConnect, OmniSQL Access Module, OmniSQL Toolkit, Open Biz, Open Business Interchange, Open Client,
Open Client/Server, Open Client/Server Interfaces, Open ClientConnect, Open Gateway, Open Server, Open ServerConnect, Open Solutions,
Optima++, Orchestration Studio, Partnerships that Work, PB-Gen, PC APT Execute, PC DB-Net, PC Net Library, PhysicalArchitect, Pocket
PowerBuilder, PocketBuilder, Power Through Knowledge, power.stop, Power++, PowerAMC, PowerBuilder, PowerBuilder Foundation Class
Library, PowerDesigner, PowerDimensions, PowerDynamo, Powering the New Economy, PowerJ, PowerScript, PowerSite, PowerSocket,
Powersoft, Powersoft Portfolio, Powersoft Professional, PowerStage, PowerStudio, PowerTips, PowerWare Desktop, PowerWare Enterprise,
ProcessAnalyst, QAnywhere, Rapport, Relational Beans, RepConnector, Replication Agent, Replication Driver, Replication Server, Replication
Server Manager, Replication Toolkit, Report Workbench, Report-Execute, Resource Manager, RW-DisplayLib, RW-Library, S.W.I.F.T. Message
Format Libraries, SAFE, SAFE/PRO, SDF, Secure SQL Server, Secure SQL Toolset, Security Guardian, SKILS, smart.partners, smart.parts,
smart.script, SQL Advantage, SQL Anywhere, SQL Anywhere Studio, SQL Code Checker, SQL Debug, SQL Edit, SQL Edit/TPU,
SQL Everywhere, SQL Modeler, SQL Remote, SQL Server, SQL Server Manager, SQL Server SNMP SubAgent, SQL Server/CFT,
SQL Server/DBM, SQL SMART, SQL Station, SQL Toolset, SQLJ, Stage III Engineering, Startup.Com, STEP, SupportNow, Sybase Central,
Sybase Client/Server Interfaces, Sybase Development Framework, Sybase Financial Server, Sybase Gateways, Sybase Learning Connection,
Sybase MPP, Sybase SQL Desktop, Sybase SQL Lifecycle, Sybase SQL Workgroup, Sybase Synergy Program, Sybase User Workbench, Sybase
Virtual Server Architecture, SybaseWare, Syber Financial, SyberAssist, SybMD, SyBooks, System 10, System 11, System XI (Logo), SystemTools,
Tabular Data Stream, The Enterprise Client/Server Company, The Extensible Software Platform, The Future Is Wide Open, The Learning
Connection, The Model For Client/Server Solutions, The Online Information Center, The Power of One, TotalFix, TradeForce, Transact-SQL,
Translation Toolkit, Turning Imagination Into Reality, UltraLite, UltraLite.NET, UNIBOM, Unilib, Uninull, Unisep, Unistring, URK Runtime Kit
for UniCode, Versacore, Viewer, VisualWriter, VQL, Warehouse Control Center, Warehouse Studio, Warehouse WORKS, WarehouseArchitect,
Watcom, Watcom SQL, Watcom SQL Server, Web Deployment Kit, Web.PB, Web.SQL, WebSights, WebViewer, WorkGroup SQL Server,
XA-Library, XA-Server und XP Server sind Marken von Sybase Inc. oder ihren Tochtergesellschaften.
Copyright © 1997–2001 Certicom Corp. Teil-Copyright © 1997–1998, Consensus Development Corporation, eine 100% Tochtergesellschaft von
Certicom Corp. Alle Rechte vorbehalten. Enthält eine Implementierung von NR-Signaturen, die im Rahmen des U.S.-Patents 5,600,725. lizenziert
wurden. Durch U.S.-Patente 5,787,028, 4,745,568, 5,761,305 geschützt. Patente angemeldet.
Alle anderen Marken gehören ihren jeweiligen Eigentümern.
ii

Inhaltsverzeichnis
Über dieses Handbuch v
Dokumentation zu SQL Anywhere Studio . . . . . . . . . . . vi
Konventionen in dieser Dokumentation . . . . . . . . . . . . . x
Beispieldatenbank CustDB . . . . . . . . . . . . . . . . . . . xii
Wenn Sie mehr wissen und uns Ihre Anregungen mitteilen
möchten . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
1 Einführung in die Static Java-API Schnittstelle 1
Erforderliche Systemausstattung und unterstützte Plattformen 2
Static Java-Anwendungen entwickeln . . . . . . . . . . . . . 3
Vorteile und Einschränkungen der Static Java-API . . . . . . 4
2 Praktische Einführung: Anwendung mit Java erstellen 5
Überblick . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Lektion 1: SQL-Anweisungen zur Referenzdatenbank hinzufügen
. . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Lektion 2: UltraLite-Generator ausführen . . . . . . . . . . . . 11
Lektion 3: Anwendungscode schreiben . . . . . . . . . . . . . 12
Lektion 4: Anwendung erstellen und ausführen . . . . . . . . 16
Lektion 5: Synchronisation zur Anwendung hinzufügen . . . . 18
Lektion 6: Änderungen rückgängig machen . . . . . . . . . . 21
3 Datenzugriff über Static Java-API 23
Überblick . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
UltraLite Static Java-Beispielanwendung . . . . . . . . . . . . 25
Mit der UltraLite-Datenbank verbinden und die Datenbank
konfigurieren . . . . . . . . . . . . . . . . . . . . . . . . 30
SQL-Anweisungen in UltraLite Static Java-Anwendungen
einbeziehen . . . . . . . . . . . . . . . . . . . . . . . . . 37
Benutzerauthentifizierung zu Ihrer Anwendung hinzufügen . . 38
Datenbankspeicher konfigurieren und verwalten . . . . . . . 41
Anwendungen eine Synchronisationsfunktion hinzufügen . . 46
Hinweise zur UltraLite Static Java-Entwicklung . . . . . . . . 57
UltraLite Static Java-Anwendungen erstellen . . . . . . . . . 58
4 UltraLite Static Java API-Referenz 61
UltraLite-API-Referenz . . . . . . . . . . . . . . . . . . . . . . 62
iii

5 Referenz der Synchronisationsparameter 73
Synchronisationsparameter . . . . . . . . . . . . . . . . . . . 74
auth_parms-Synchronisatonsparameter . . . . . . . . . . . . 76
auth_status-Parameter . . . . . . . . . . . . . . . . . . . . . . 77
auth_value-Synchronisationsparameter . . . . . . . . . . . . 79
download_only-Synchronisationsparameter . . . . . . . . . . 80
ignored_rows-Synchronisationsparameter . . . . . . . . . . . 81
new_password-Synchronisationsparameter . . . . . . . . . . 82
num_auth_parms-Synchronisationsparameter . . . . . . . . 83
observer-Synchronisationsparameter . . . . . . . . . . . . . . 84
password-Synchronisationsparameter . . . . . . . . . . . . . 85
ping-Synchronisationsparameter . . . . . . . . . . . . . . . . 86
publication-Synchronisationsparameter . . . . . . . . . . . . 87
security-Synchronisationsparameter . . . . . . . . . . . . . . 88
security_parms-Synchronisationsparameter . . . . . . . . . . 89
stream-Synchronisationsparameter . . . . . . . . . . . . . . . 91
stream_parms-Synchronisationsparameter . . . . . . . . . . 94
upload_ok-Synchronisationsparameter . . . . . . . . . . . . . 95
upload_only-Synchronisationsparameter . . . . . . . . . . . . 96
user_data-Synchronisationsparameter . . . . . . . . . . . . . 97
user_name-Synchronisationsparameter . . . . . . . . . . . . 98
version-Synchronisationsparameter . . . . . . . . . . . . . . 99
Index 101
iv

Über dieses Handbuch
Gegenstand Dieses Handbuch beschreibt die Static Java API-Schnittstelle von UltraLite.
Es stellt eine Ergänzung zum UltraLite Datenbankhandbuch dar.
Zielgruppe Dieses Handbuch richtet sich an alle Anwendungsentwickler, die
Java-Programme schreiben, in denen eine UltraLite-Datenbank verwendet
wird. Dabei wird die Kenntnis von Adaptive Server Anywhere und
relationalen Datenbanken vorausgesetzt.
v

Dokumentation zu SQL Anywhere Studio
Dokumentation zu
SQL Anywhere Studio
vi
Dieses Handbuch ist Teil der SQL Anywhere-Dokumentation. Dieser
Abschnitt enthält eine Liste der Handbücher und Hinweise zu ihrer
Verwendung.
Die Dokumentation zu SQL Anywhere Studio wird in unterschiedlichen
Formaten bereitgestellt: Eine Online-Version kombiniert alle Bücher in einer
großen Hilfedatei, eigene PDF-Dateien werden für jedes Buch angeboten,
und gedruckte Ausgaben können zusätzlich erworben werden. Die
Dokumentation besteht aus folgenden Handbüchern:
♦ SQL Anywhere Studio Erste Orientierung Dieses Handbuch enthält
einen Überblick über die Datenbankverwaltungs- und
Synchronisationstechnologien von SQL Anywhere Studio. Es bietet
praktische Einführungen zu einzelnen Bestandteilen von SQL Anywhere
Studio.
♦ Neues in SQL Anywhere Studio Dieses Handbuch richtet sich an
Benutzer früherer Versionen dieser Software. Es enthält eine Liste neuer
Funktionen in dieser und in früheren Versionen des Programms und eine
Beschreibung der Upgrade-Prozeduren.
♦ Adaptive Server Anywhere Datenbankadministration Dieses
Handbuch befasst sich mit der Ausführung, Verwaltung und
Konfiguration von Datenbanken und Datenbankservern.
♦ Adaptive Server Anywhere SQL-Benutzerhandbuch In diesem
Handbuch wird beschrieben, wie Datenbanken entworfen und
eingerichtet, Daten importiert, exportiert, geändert bzw. abgerufen und
gespeicherte Prozeduren und Trigger erstellt werden.
♦ Adaptive Server Anywhere SQL-Referenzhandbuch Dieses
Handbuch ist ein umfassendes Nachschlagwerk für die SQL-Sprache, die
von Adaptive Server Anywhere benutzt wird. Auch die Adaptive Server
Anywhere-Systemtabellen und Prozeduren werden darin beschrieben.
♦ Adaptive Server Anywhere Handbuch für Programmierer In diesem
Handbuch wird beschrieben, wie Datenbankanwendungen in den
Programmiersprachen C, C++ und Java aufgebaut und bereitgestellt
werden. Benutzer von Programmen wie Visual Basic und PowerBuilder
können deren Programmierschnittstellen einsetzen. In diesem Handbuch
wird auch der Adaptive Server Anywhere ADO.NET-Datenprovider
beschrieben.
♦ Adaptive Server Anywhere Handbuch zum
SNMP-Erweiterungsagenten In dieser Dokumentation wird

eschrieben, wie der Adaptive Server Anywhere
SNMP-Erweiterungsagent für den Einsatz mit
SNMP-Managementanwendungen in der Verwaltung von Adaptive
Server Anywhere-Datenbanken konfiguriert wird.
♦ Adaptive Server Anywhere Fehlermeldungen Dieses Handbuch
enthält eine vollständige Liste der Fehlermeldungen in Adaptive Server
Anywhere sowie Diagnosehinweise.
♦ SQL Anywhere Studio Sicherheitshandbuch Dieses Handbuch
enthält Hinweise zu den Sicherheitskomponenten in Adaptive Server
Anywhere-Datenbanken. Adaptive Server Anywhere 7.0 wurde die
Sicherheitseinstufung TCSEC (Trusted Computer System Evaluation
Criteria) C2 der US-Regierung verliehen. Dieses Handbuch kann für den
Personenkreis von Interesse sein, der die aktuelle Version von Adaptive
Server Anywhere in einer Umgebung ausführen möchte, die dem
C2-Zertifikat entspricht.
♦ MobiLink Administrationshandbuch In diesem Handbuch wird der
Einsatz des MobiLink-Datensynchronisationssystems für die mobile
Datenverarbeitung erläutert. Mit diesem System können Daten einer
Oracle-, Sybase-, Microsoft- oder IBM-Datenbank auf viele Adaptive
Server Anywhere- bzw. UltraLite-Datenbanken übertragen und flexibel
genutzt werden.
♦ MobiLink Clients In diesem Handbuch wird beschrieben, wie entfernte
Adaptive Server Anywhere- und UltraLite-Datenbanken synchronisiert
werden.
♦ MobiLink Handbuch zur serverinitiierten Synchronisation In diesem
Handbuch wird die vom MobiLink-Server initiierte Synchronisation
beschrieben, mit der Sie eine Synchronisation von der konsolidierten
Datenbank aus durchführen können.
♦ MobiLink Praktische Einführungen Dieses Handbuch enthält mehrere
praktische Einführungen für die Einrichtung und den Betrieb von
MobiLink-Anwendungen.
♦ QAnywhere Benutzerhandbuch Diese Dokumentation behandelt
MobiLink QAnywhere, eine Plattform für die Nachrichtenverarbeitung,
die die Entwicklung und das Deployment von Nachrichtenanwendungen
für mobile und drahtlose Clients ebenso wie für traditionelle Desktops
und Laptops ermöglicht.
♦ ODBC-Treiber für MobiLink und Ferndatenzugriff Dieses Buch
beschreibt, wie Sie ODBC-Treiber einrichten, um vom
vii

MobiLink-Synchronisationsserver und über den Fern-Datenzugriff von
Adaptive Server Anywhere auf konsolidierte Datenbanken zuzugreifen,
die keine Adaptive Server Anywhere-Datenbanken sind.
♦ SQL Remote Benutzerhandbuch In diesem Handbuch werden alle
Aspekte des SQL Remote-Datenreplikationssystems für mobile
Datenverarbeitung beschrieben, das die gemeinsame Datennutzung von
einer einzelnen Adaptive Server Anywhere- bzw. Adaptive Server
Enterprise-Datenbank und vielen Adaptive Server
Anywhere-Datenbanken über eine indirekte Verbindung wie etwa E-Mail
oder Datenübertragung ermöglicht.
♦ SQL Anywhere Studio-Hilfe Diese Dokumentation enthält die
kontextsensitive Hilfe für Sybase Central, Interactive SQL und andere
grafische Programme. Sie wird nicht als gedrucktes Handbuch geliefert.
♦ UltraLite Datenbankhandbuch Dieses Handbuch richtet sich an alle
UltraLite-Entwickler. Es stellt eine Einführung in das
UltraLite-Datenbanksystem dar und enthält Informationen, die für alle
UltraLite-Programmierschnittstellen gelten.
♦ Dokumentation der UltraLite-Programmierschnittstellen Für jede
UltraLite-Programmierschnittstelle wird ein eigenes Handbuch
mitgeliefert. Einige dieser Schnittstellen werden als
UltraLite-Komponenten für die rasche Entwicklung von Anwendungen
mitgeliefert, andere als statische Schnittstellen für die Entwicklung unter
C, C++ und Java.
Zusätzlich zu dieser Dokumentation werden PowerDesigner und InfoMaker
mit eigener Dokumentation geliefert.
Dokumentationsformate SQL Anywhere Studio umfasst Dokumentationen in folgenden Formaten:
viii
♦ Online-Dokumentation Die Online-Dokumentation enthält die
vollständige SQL Anywhere Studio-Dokumentation, einschließlich der
gedruckten Handbücher und der kontextsensitiven Hilfe für die
SQL Anywhere-Dienstprogramme. Die Online-Dokumentation wird mit
jeder Wartungsversion des Produkts aktualisiert. Dies ist die
vollständigste und aktuellste Informationsquelle.
Wenn Sie unter Windows-Betriebssystemen auf die
Online-Dokumentation zugreifen wollen, klicken Sie auf Start ➤
Programme ➤ Sybase SQL Anywhere 9 ➤ Online-Dokumentation. Der
Zugriff auf den Inhalt erfolgt über die HTML-Inhaltsangabe, den Index
und die Suchfunktion im linken Fensterausschnitt sowie über Links und
Menüs im rechten Fensterausschnitt.

Wenn Sie auf die Online-Dokumentation unter UNIX-Betriebssystemen
zugreifen wollen, nutzen Sie entsprechende Hinweise in der
HTML-Dokumentation in Ihrer SQL Anywhere-Installation.
♦ Handbücher im PDF-Format Die SQL Anywhere-Handbücher werden
in Form von PDF-Dateien geliefert, die mit dem Adobe Acrobat Reader
gelesen werden können.
Die Handbücher im PDF-Format können aus der Online-Dokumentation
oder über das Windows Startmenü aufgerufen werden.
♦ Gedruckte Handbücher Die komplette Handbuchreihe kann beim
Sybase-Vertrieb oder im eShop bezogen werden. eShop ist der Sybase
Online-Shop unter http://eshop.sybase.com/eshop/documentation.
ix

Konventionen in dieser Dokumentation
In diesem Abschnitt werden die Konventionen für die Schreibweise und der
grafische Aufbau beschrieben, der in dieser Dokumentation verwendet wird.
Syntaxkonventionen Folgende Konventionen werden bei SQL-Syntaxbeispielen verwendet:
x
♦ Schlüsselwörter Alle SQL-Schlüsselwörter werden wie die Wörter
ALTER TABLE im folgenden Beispiel in Großschreibung angezeigt:
ALTER TABLE [ Eigentümer.]Tabellenname
♦ Platzhalter Elemente, die durch entsprechende Bezeichner oder
Ausdrücke ersetzt werden müssen, werden wie die Wörter Eigentümer
und Tabellenname im folgenden Beispiel angezeigt:
ALTER TABLE [ Eigentümer.]Tabellenname
♦ Wiederholungen Listen mit sich wiederholenden Elementen werden
mit einem Element der Liste, gefolgt von drei Punkten gezeigt, wie
Spalten-Integritätsregel im folgenden Beispiel:
ADD Spaltendefinition [ Spalten-Integritätsregel, . . . ]
Ein oder mehrere Listenelemente sind zulässig. In diesem Beispiel gilt:
Wenn mehr als ein Element angegeben wird, muss eine Trennung der
Elemente durch Kommas erfolgen.
♦ Fakultative Bestandteile Fakultative Bestandteile einer Anweisung
werden in eckige Klammern gesetzt.
RELEASE SAVEPOINT [ Savepoint-Name ]
Diese eckigen Klammern zeigen an, dass der Savepoint-Name fakultativ
ist. Die eckigen Klammern werden nicht eingegeben.
♦ Optionen Wenn aus einer Liste kein oder nur ein Element ausgewählt
werden darf, werden die Elemente durch Senkrechtstriche voneinander
getrennt, und die komplette Liste wird in eckige Klammern gesetzt.
[ ASC | DESC ]
Sie können z.B. entweder ASC, DESC oder keines wählen. Die eckigen
Klammern werden nicht eingegeben.
♦ Alternativen Wenn nur eine der Optionen gewählt werden darf, werden
die Alternativen in geschweifte Klammern gesetzt und mit einem
Senkrechtstrich getrennt.
[ QUOTES { ON | OFF } ]

Wenn die Option QUOTES ausgewählt wird, muss entweder ON oder
OFF angegeben werden. Eckige und geschweifte Klammern sind nicht
einzugeben.
Grafische Symbole Die nachstehenden Symbole werden in dieser Dokumentation verwendet.
♦ Eine Clientanwendung
♦ Ein Datenbankserver, wie zum Beispiel Adaptive Server Anywhere.
♦ Eine Datenbank. In einigen abstrakten Diagrammen kann dieses Symbol
die Datenbank und gleichzeitig auch den Datenbankserver, der sie
steuert, repräsentieren.
♦ Replikations- oder Synchronisations-Middleware. Mithilfe derartiger
Software können Daten in mehreren Datenbanken gleichzeitig verwendet
werden. Beispiele sind der MobiLink-Synchronisationsserver und der
SQL Remote Nachrichtenagent.
♦ Eine Programmierschnittstelle
xi

Beispieldatenbank CustDB
xii
Viele der Beispiele in der MobiLink- und der UltraLite-Dokumentation
verwenden die UltraLite-Beispieldatenbank.
Die Referenzdatenbank für die UltraLite-Beispieldatenbank befindet sich in
einer Datei mit dem Namen custdb.db im Unterverzeichnis
Samples\UltraLite\CustDB des SQL Anywhere-Verzeichnisses. Zum
Lieferumfang gehört auch eine auf dieser Datenbank aufgebaute
vollständige Anwendung.
Die Beispieldatenbank ist eine Vertriebsanwendung für
Hardware-Produzenten. Sie enthält Kunden-, Produkt- und Vertriebsdaten
für das Unternehmen.
In der nachstehend abgebildeten Strukturdarstellung werden die Tabellen der
Datenbank “CustDB” und ihre Beziehungen zueinander erläutert.
ULCustomer
cust_id integer
cust_name varchar(30)
last_modified timestamp
cust_id = cust_id
ULOrder
order_id integer
cust_id integer
prod_id integer
emp_id integer
disc integer
quant integer
notes varchar(50)
status varchar(20)
last_modified timestamp
prod_id = prod_id
ULProduct
prod_id integer
price integer
prod_name varchar(30)
cust_id = cust_id
emp_id = emp_id
ULEmpCust
emp_id integer
cust_id integer
action char(1)
last_modified timestamp
emp_id = emp_id
ULEmployee
emp_id integer
emp_name varchar(30)
last_download timestamp
emp_id = pool_emp_id
ULOrderIDPool
pool_order_id integer
pool_emp_id integer
last_modified timestamp
ULIdentifyEmployee
emp_id integer
emp_id = pool_emp_id
ULCustomerIDPool
pool_cust_id integer
pool_emp_id integer
last_modified timestamp

Wenn Sie mehr wissen und uns Ihre Anregungen
mitteilen möchten
Weitere
Informationsquellen
Weitere Informationen und Ressourcen, darunter auch Austausch von
Programmcode, finden Sie im iAnywhere Developer Network unter
http://www.ianywhere.com/developer/.
Wenn Sie Fragen haben oder Hilfe brauchen, können Sie sich bei den
nachstehenden iAnywhere Solutions Newsgroups informieren.
Wenn Sie in diesen Newsgroups Fragen stellen, achten Sie darauf, Ihr
Problem so detailliert wie möglich darzustellen und vergessen Sie nicht die
Build-Nummer Ihrer Version von SQL Anywhere Studio. Diese
Informationen erhalten Sie, wenn Sie an einer Systemeingabeaufforderung
dbeng9 -v eingeben.
Die Newsgroups finden Sie auf dem News-Server forums.sybase.com.
Folgende Newsgroups wurden eingerichtet:
♦ sybase.public.sqlanywhere.general
♦ sybase.public.sqlanywhere.linux
♦ sybase.public.sqlanywhere.mobilink
♦ sybase.public.sqlanywhere.product_futures_discussion
♦ sybase.public.sqlanywhere.replication
♦ sybase.public.sqlanywhere.ultralite
♦ ianywhere.public.sqlanywhere.qanywhere
Newsgroup-Verpflichtungsausschluss
iAnywhere Solutions ist weder verpflichtet, Lösungen, Informationen
oder Ideen in seinen Newsgroups bereitzustellen, noch verpflichtet sich
iAnywhere Solutions, mehr bereitzustellen als einen Systemadministrator,
der den Service überwacht und seine Abwicklung sowie die Verfügbarkeit
gewährleistet.
Die technischen Mitarbeiter von iAnywhere Solutions stehen, ebenso wie
andere Mitarbeiter, für den Newsgroup-Service bereit, sofern sie Zeit dazu
haben. Sie stellen ihre Hilfe freiwillig zur Verfügung und sind möglicherweise
nicht regelmäßig verfügbar, um Lösungen und Informationen
bereitzustellen. Ihre Einsatzfähigkeit ist abhängig von ihrer aktuellen
Arbeitsauslastung.
xiii

Kommentare und
Anregungen
xiv
Wir würden gerne Ihre Meinung erfahren und sind an Ihren Vorschlägen und
Anregungen zu dieser Dokumentation interessiert.
Senden Sie bitte Ihre Kommentare und Anregungen per E-Mail an das SQL
Anywhere-Dokumentationsteam unter iasdoc@ianywhere.com. Auf die an
diese Adresse gesendeten e-Mails erfolgt zwar keine Antwort, aber alle
Anregungen werden mit Interesse gelesen.
Außerdem können Sie Ihre Kommentare und Anregungen zur
Dokumentation und zur Software über die oben angegebenen Newsgroups
vermitteln.

KAPITEL 1
Einführung in die Static Java-API
Schnittstelle
Über dieses Kapitel In diesem Kapitel wird die Static Java-API für UltraLite-Datenbanken
beschrieben. Dabei wird davon ausgegangen, dass Sie das
UltraLite-Datenbanksystem und die von ihm gebotenen
Entwicklungsmodelle kennen.
☞ Weitere Hinweise finden Sie unter “Willkommen bei UltraLite”
[UltraLite Datenbankhandbuch, Seite 3].
Inhalt Thema: Seite
Erforderliche Systemausstattung und unterstützte Plattformen 2
Static Java-Anwendungen entwickeln 3
Vorteile und Einschränkungen der Static Java-API 4
1

Erforderliche Systemausstattung und unterstützte
Plattformen
2
Die unterstützte Zielplattform ist Sun Personal Java 1.2.
Die Anwendungsentwicklung erfordert einen unterstützten JDK. Sie müssen
auch über eine Adaptive Server Anywhere-Referenzdatenbank verfügen.
☞ Weitere Hinweise finden Sie unter “UltraLite-Entwicklungsplattformen”
[SQL Anywhere Studio Erste Orientierung, Seite 107] und
“UltraLite-Zielplattformen” [SQL Anywhere Studio Erste Orientierung,
Seite 118].

Kapitel 1. Einführung in die Static Java-API Schnittstelle
Static Java-Anwendungen entwickeln
Wenn Sie Static Java UltraLite-Anwendungen entwickeln, benutzen Sie eine
JDBC-ähnliche Programmierschnittstelle. Um diese Anwendungen zu
entwickeln, müssen Sie die Programmiersprache Java kennen.
Der Entwicklungsprozess für Static Java UltraLite-Anwendungen sieht wie
folgt aus:
1. Planen Sie das Design Ihrer Datenbank.
Bereiten Sie eine Adaptive Server Anywhere-Referenzdatenbank vor, die
die Tabellen und Indizes enthält, die in Ihre UltraLite-Datenbank
integriert werden sollen.
2. Fügen Sie der Datenbank SQL-Anweisungen hinzu.
Die SQL-Anweisungen, die Sie in Ihrer Anwendung verwenden wollen,
müssen der Referenzdatenbank hinzugefügt werden.
3. Generieren Sie die Klassen für Ihre Anwendung.
Der UltraLite-Generator stellt die Klassen bereit, die Ihre Anwendung
benötigt.
4. Schreiben Sie Ihren Anwendungscode.
Datenzugriffsfunktionen in Ihrem Anwendungscode benutzen JDBC und
andere Funktionsaufrufe.
☞ Eine Anleitung für die Schnittstelle finden Sie unter “UltraLite Static
Java API-Referenz” auf Seite 61.
5. Kompilieren Sie Ihre .java-Dateien.
Sie können die generierten .java-Dateien genau so kompilieren wie
andere .java-Dateien.
☞ Eine vollständige Beschreibung des Entwicklungsprozesses finden Sie
unter “UltraLite Static Java-Anwendungen erstellen” auf Seite 58.
3

Vorteile und Einschränkungen der Static Java-API
4
UltraLite bietet mehrere Programmierschnittstellen, darunter Modelle für die
statische Entwicklung (z.B. die Static Java-Schnittstelle) und
UltraLite-Komponenten. Eine Java-basierte Komponente (Native UltraLite
für Java) steht unter Anderem zur Verfügung.
Die Static Java-API hat folgende Vorteile:
♦ Pure Java-Lösung Die UltraLite-Laufzeitbibliothek für die Static
Java-API ist eine Pure Java-Anwendung. Dies ist bei der Native UltraLite
für Java-Komponente anders, die dieselbe C++-basierte
UltraLite-Laufzeitbibliothek verwendet wie andere
UltraLite-Schnittstellen. In der Native UltraLite für Java-Komponente
erfolgt der Zugriff auf die UltraLite-Laufzeitbibliothek über
systemeigene Methoden.
♦ Erweiterte SQL-Unterstützung Mit der Static Java-API können Sie
einen breiteren Bereich von SQL in Ihren Anwendungen abdecken als
mit der auf den Komponenten basierten Schnittstelle.
Die Static Java-API hat folgende Nachteile:
♦ Komplexes Entwicklungsmodell Der Einsatz einer
Referenzdatenbank für die Speicherung des UltraLite-Datenbankschemas
und das Erfordernis, Klassen für Ihre spezifische Anwendung zu
generieren, führt dazu, dass der Entwicklungsprozess mit Static Java-API
komplex wird. Die UltraLite-Komponenten, einschließlich Native
UltraLite für Java, bieten einen viel einfacheren Entwicklungsprozess.
♦ SQL muss zum Designzeitpunkt angegeben werden Nur
SQL-Anweisungen, die zum Kompilierungszeitpunkt definiert wurden,
können in Ihre Anwendung eingebaut werden. Die
UltraLite-Komponenten ermöglichen die dynamische Verwendung von
SQL-Anweisungen.
Die Wahl des Entwicklungsmodells richtet sich nach den Anforderungen
Ihres Projekts, nach den verfügbaren Programmierkenntnissen und der
verfügbaren Erfahrung.

KAPITEL 2
Praktische Einführung: Anwendung mit
Java erstellen
Informationen zu diesem
Kapitel
Dieses Kapitel enthält eine praktische Einführung, die Sie durch den
Entwicklungsprozess einer UltraLite-Anwendung mithilfe der Static Java
API-Schnittstelle leitet. Im ersten Abschnitt wird beschrieben, wie Sie eine
einfache Anwendung erstellen. Im zweiten Abschnitt wird beschrieben, wie
Sie Ihrer Anwendung die Synchronisation hinzufügen.
☞ Einen Überblick über den Entwicklungsprozess und
Hintergrundinformationen zu der UltraLite-Datenbank finden Sie unter
“UltraLite Static Java-Anwendungen erstellen” auf Seite 58.
☞ Hinweise zum Entwickeln von UltraLite Static Java-Anwendungen
finden Sie unter “Datenzugriff über Static Java-API” auf Seite 23.
Inhalt Thema: Seite
Überblick 6
Lektion 1: SQL-Anweisungen zur Referenzdatenbank hinzufügen 8
Lektion 2: UltraLite-Generator ausführen 11
Lektion 3: Anwendungscode schreiben 12
Lektion 4: Anwendung erstellen und ausführen 16
Lektion 5: Synchronisation zur Anwendung hinzufügen 18
Lektion 6: Änderungen rückgängig machen 21
5

Überblick
Überblick
6
Diese praktische Einführung beschreibt, wie Sie eine einfache Anwendung
mithilfe von Java erstellen. Es handelt sich dabei um eine
Befehlszeilenanwendung, die mit Sun JDK entwickelt wurde und Daten in
der Tabelle ULProduct der UltraLite 9.0 Beispieldatenbank abfragt.
In dieser praktischen Einführung erstellen Sie eine Java-Quelldatei, ein
Projekt in einer Referenzdatenbank und verwenden diese Quellen, um Ihre
Anwendung zu erstellen und auszuführen. Die ersten Lektionen beschreiben
eine Version der Anwendung ohne Synchronisation. Die Synchronisation
wird in einer späteren Lektion hinzugefügt.
Für die Ausführung der Anweisungen in der praktische Einführung muss
außerdem ein Java Development Kit installiert sein.
In der ersten Lektion schreiben und erstellen Sie eine Anwendung, die
folgende Aufgaben ausführt:
1. Verbindung zu einer UltraLite-Datenbank herstellen, die eine einzige
Tabelle umfasst. Die Tabelle ist eine Teilmenge der Tabelle ULProduct
der UltraLite-Beispieldatenbank.
2. Zeilen in die Tabelle einfügen. Ausgangsdaten werden in eine
UltraLite-Anwendung gewöhnlich durch die Synchronisation mit einer
konsolidierten Datenbank eingefügt. Die Synchronisation wird später in
diesem Kapitel hinzugefügt.
3. Die Zeilen der Tabelle auf die Standardausgabe schreiben
Um die Anwendung zu erstellen, müssen Sie folgende Schritte ausführen:
1. Eine Adaptive Server Anywhere-Referenzdatenbank erstellen.
Hier wird die UltraLite-Beispieldatenbank (CustDB) verwendet.
2. Die SQL-Anweisungen hinzufügen, die in Ihrer Anwendung für die
Referenzdatenbank verwendet werden sollen
3. Den UltraLite-Generator ausführen, um den Java-Code und eine
zusätzliche Quelldatei für diese UltraLite-Datenbank zu generieren.
Der Generator erzeugt eine .java-Datei, die die SQL-Anweisungen in
einer Form enthält, die Sie in Ihrer Anwendung verwenden können, und
eine .java-Datei mit dem Code, der die Abfragen ausführt.

Kapitel 2. Praktische Einführung: Anwendung mit Java erstellen
4. Quellcode schreiben, der die Logik der Anwendung implementiert.
Hier umfasst der Quellcode eine einzelne Datei namens Sample.java.
5. Die Anwendung kompilieren und ausführen.
Verzeichnis für Ihre Dateien erstellen
Im zweiten Abschnitt fügen Sie Ihrer Anwendung die Synchronisation
hinzu.
In dieser praktischen Einführung erstellen Sie eine Reihe von Dateien,
einschließlich der Quell- und Programmdateien. Sie sollten ein Verzeichnis
für diese Dateien erstellen. Außerdem sollten Sie eine Kopie der
UltraLite-Beispieldatenbank erstellen, sodass Sie sie verändern können,
ohne die Original-Beispieldatenbank für andere Projekte zu verlieren.
Kopien der in dieser Einführung benutzten Dateien finden Sie im
Unterverzeichnis Samples\UltraLite\JavaTutorial des
SQL Anywhere-Verzeichnisses.
❖ So bereiten Sie ein Verzeichnis für die praktische Einführung vor
1. Erstellen Sie ein Verzeichnis, in dem die zu erstellenden Dateien
gespeichert werden sollen. In den verbleibenden Teilen dieser praktischen
Einführung wird davon ausgegangen, dass dieses Verzeichnis
c:\JavaTutorial heißt.
2. Erstellen Sie im Verzeichnis der praktischen Einführung eine
Sicherungskopie der Beispieldatenbank von UltraLite 9.0. Die
Beispieldatenbank von UltraLite 9.0 ist die Datei custdb.db und befindet
sich im Unterverzeichnis Samples\UltraLite\CustDB Ihres
SQL Anywhere-Installationsverzeichnisses. In dieser praktischen
Einführung wird die Originalbeispieldatenbank von UltraLite 9.0
verwendet und am Ende der praktischen Einführung können Sie die
unveränderte Version aus dem Verzeichnis APITutorial zurück kopieren.
7

Lektion 1: SQL-Anweisungen zur
Referenzdatenbank hinzufügen
8
Die Referenzdatenbank für diese praktische Einführung ist die UltraLite
9.0-Beispieldatenbank. In einem späteren Schritt werden Sie diese
Datenbank als konsolidierte Datenbank für die Synchronisation verwenden.
Diese zwei Verwendungsmöglichkeiten sind voneinander getrennt und in der
Praxis werden Sie als Referenzdatenbank und konsolidierte Datenbank zwei
verschiedene Datenbanken verwenden.
Fügen Sie die SQL-Anweisungen der Referenzdatenbank mithilfe der
gespeicherten Prozedur ul_add_statement hinzu. In dieser einfachen
Anwendung verwenden Sie folgende Anweisungen:
♦ Einfügen Eine INSERT-Anweisung fügt in die Tabelle ULProduct eine
Erstkopie der Daten ein. Diese Anweisung wird nicht benötigt, wenn der
Anwendung die Synchronisation hinzugefügt wurde.
♦ Select (Auswählen) Eine SELECT-Anweisung fragt die Tabelle
ULProduct ab.
Wenn Sie eine SQL-Anweisung hinzufügen, müssen Sie sie einem
UltraLite-Projekt zuordnen. Hier verwenden wir den Projektnamen Product.
Sie müssen auch einen Namen für die Anweisung einfügen, der aus
Großbuchstaben bestehen muss.
❖ So fügen Sie der Referenzdatenbank die SQL-Anweisungen hinzu
1. Starten Sie Sybase Central und stellen Sie eine Verbindung zur UltraLite
9.0-Beispieldatenquelle her, indem Sie das Adaptive Server
Anywhere-Plugin benutzen.
a. Im Menü “Start” wählen Sie Programme ➤ SQL Anywhere 9 ➤
Sybase Central. Sybase Central erscheint.
b. Wählen Sie aus dem Menü “Datei” die Option Extras ➤ Verbinden.
Das Dialogfeld “Neue Verbindung” wird angezeigt.
c. Wählen Sie das Adaptive Server Anywhere-Plug-In und klicken Sie
auf OK. Das Dialogfeld “Verbinden” wird angezeigt.
d. Geben Sie im Register “Identifizierung” den
ODBC-Datenquellennamen und geben Sie UltraLite 9.0 Sample ein.
2. Fügen Sie der Datenbank ein Projekt hinzu:
a. In Sybase Central öffnen Sie die Datenbank custdb.

Kapitel 2. Praktische Einführung: Anwendung mit Java erstellen
b. Öffnen Sie den Ordner UltraLite-Projekt.
Der Ordner enthält bereits ein Projekt: Das Projekt custapi, das für die
Beispielanwendung benutzt wird. Erstellen Sie ein neues Projekt.
c. Wählen Sie Datei ➤ Neu ➤ UltraLite-Projekt.
d. Geben Sie den Projektnamen Product ein und klicken Sie auf “Fertig
stellen”.
3. Fügen Sie dem Projekt Product die INSERT-Anweisung hinzu.
a. Doppelklicken Sie auf Product, um das Projekt zu öffnen.
b. Wählen Sie Datei ➤ Neu ➤ UltraLite-Anweisung.
c. Geben Sie InsertProduct als Anweisungsnamen ein. Klicken Sie auf
“Weiter”.
d. Geben Sie den Anweisungstext ein:
INSERT INTO ULProduct ( prod_id, price, prod_name)
VALUES (?,?,?)
Die Fragezeichen in der SQL-Anweisung sind Platzhalter für Werte,
die Sie in die Tabelle ULProduct eingeben können. Diese Werte
werden während des Programmablaufs eingegeben.
e. Klicken Sie auf Fertig stellen, um den Vorgang abzuschließen.
Dieser Vorgang in Sybase Central entspricht der Ausführung der
folgenden gespeicherten Prozedur:
call ul_add_statement(’Product’,
’InsertProduct’,
’INSERT INTO ULProduct( prod_id, price, prod_name)
VALUES (?,?,?) ’ )
Das erste Argument für ul_add_statement ist der Projektname, das zweite
der Anweisungsname und das dritte ist die SQL-Anweisung.
4. Fügen Sie dem Projekt “Product” die SELECT-Anweisung hinzu.
a. Wählen Sie aus dem Projekt “Product” die Option Datei ➤ Neu ➤
UltraLite-Anweisung.
b. Geben Sie SelectProduct als Anweisungsnamen ein. Klicken Sie auf
“Weiter”.
c. Geben Sie den Anweisungstext ein:
SELECT prod_id, prod_name, price
FROM ULProduct
d. Klicken Sie auf Fertig stellen, um den Vorgang abzuschließen.
9

10
Dieser Vorgang in Sybase Central entspricht der Ausführung der
folgenden gespeicherten Prozedur:
call ul_add_statement(’Product’,
’SelectProduct’,
’SELECT prod_id, prod_name, price FROM ULProduct’)
5. Schließen Sie Sybase Central.
Sie haben damit die SQL-Anweisungen in die Datenbank eingefügt und
können nun die UltraLite-Datenbank generieren.
☞ Weitere Hinweise finden Sie unter “ul_add_project-Systemprozedur”
[UltraLite Datenbankhandbuch, Seite 229] und
“ul_add_statement-Systemprozedur” [UltraLite Datenbankhandbuch, Seite 228].

Kapitel 2. Praktische Einführung: Anwendung mit Java erstellen
Lektion 2: UltraLite-Generator ausführen
Der UltraLite-Generator erzeugt zwei Java-Dateien. Eine der Dateien enthält
die SQL-Anweisungen als Schnittstellendefinition, die hier
ISampleSQL.java heißt. Sie können diese Schnittstellendefinition im
Hauptanwendungscode verwenden. Die zweite Datei enthält den Code, der
die Abfragen und die Datenbank implementiert und heißt hier
SampleDB.java.
❖ So generieren Sie den UltraLite-Datenbankcode
1. Öffnen Sie eine Eingabeaufforderung und gehen Sie zu Ihrem
Verzeichnis JavaTutorial.
2. Starten Sie den UltraLite-Generator mit folgenden Argumenten (alle auf
einer Zeile):
ulgen -a -t java -c "dsn=UltraLite 9.0 Sample"
-j Product -s ISampleSQL -f SampleDB
Die Argumente haben folgende Bedeutung:
♦ -a SQL-Zeichenfolge in Großbuchstaben generieren. Die
Anweisungen InsertProduct und SelectProduct werden zu
INSERT_PRODUCT und SELECT_PRODUCT konvertiert.
♦ -t Die Sprache des generierten Codes. Es wird Java-Code an Stelle
von C-Code generiert.
♦ –c Die Verbindungszeichenfolge für die Verbindung zur Datenbank.
♦ -j Der UltraLite-Projektname. Dieser Name entspricht dem
Projektnamen, den Sie angegeben haben, als Sie die SQL-Anweisung
in die Datenbank eingefügt haben. Der Generator erzeugt nur für die
Anweisungen Code, die diesem Projekt zugeordnet sind.
♦ -s Der Name der Schnittstelle, die die SQL-Anweisungen als
Zeichenfolgen enthält.
♦ -f Der Name der Datei, die den generierten Datenbankcode und den
Code für die Ausführung der Abfrage enthält.
11

Lektion 3: Anwendungscode schreiben
12
Der folgendende Code enthält eine einfache UltraLite-Anwendung.
Sie können den Code in eine neue Datei kopieren und unter dem Namen
Sample.java im Verzeichnis c:\JavaTutorial speichern oder eine neue Datei
öffnen und den Inhalt eingeben.
// (1) Import required packages
import java.sql.*;
import ianywhere.ultralite.jdbc.*;
import ianywhere.ultralite.runtime.*;
// (2) Class implements the interface containing SQL statements
public class Sample implements ISampleSQL
{
public static void main( String[] args )
{
try{
// (3) Connect to the database
java.util.Properties p = new
java.util.Properties();
p.put( "persist", "file" );
SampleDB db = new SampleDB( p );
Connection conn = db.connect();
// (4) Initialize the database with data
PreparedStatement pstmt1 =
conn.prepareStatement( INSERT_PRODUCT );
pstmt1.setInt(1, 1);
pstmt1.setInt(2, 400);
pstmt1.setString(3, "4x8 Drywall x100");
int rows1=pstmt1.executeUpdate();
pstmt1.setInt(1, 2);
pstmt1.setInt(2, 3000);
pstmt1.setString(3, "8’ 2x4 Studs x1000");
int rows2=pstmt1.executeUpdate();
// (5) Query the data and write out the results
Statement stmt = conn.createStatement();
ResultSet result = stmt.executeQuery(
SELECT_PRODUCT );
while( result.next() ) {
int id = result.getInt( 1 );
String name = result.getString( 2 );
int price = result.getInt( 3 );
System.out.println ( name +
" \tId=" + id +
" \tPrice=" + price );
}
// (6) Close the connection to end
conn.close();
} catch (SQLException e) {
Support.printException( e );
}
}
}

Erläuterung des
Beispielprogramms
Kapitel 2. Praktische Einführung: Anwendung mit Java erstellen
Dieses Beispiel ist zwar zu einfach, um sinnvoll eingesetzt werden zu
können, es enthält aber dennoch Elemente, die in jeder für den
Datenbankzugriff verwendeten Java-Datei enthalten sein müssen. Im
Folgenden sind die wichtigsten Elemente des Beispielprogramms
beschrieben. Sie können diese Schritte als Richtlinie für die Erstellung Ihrer
eigenen UltraLite-Anwendung verwenden.
Die nummerierten Schritte beziehen sich jeweils auf die nummerierten
Kommentare im Quellcode.
1. Erforderliche Pakete importieren.
Das Beispielprogramm verwendet JDBC-Schnittstellen und -Klassen und
muss dieses Paket daher importieren. Außerdem werden die
UltraLite-Laufzeitklassen und die generierte Schnittstelle benötigt, die
die SQL-Anweisungszeichenfolgen enthält.
2. Klasse definieren
Die in der Anwendung eingesetzten SQL-Anweisungen werden in einer
separaten Datei als Schnittstelle gespeichert. Die Klasse muss
deklarieren, dass sie die Schnittstelle implementiert, damit sie die
SQL-Anweisungen für das Projekt verwenden kann. Die Klassennamen
basieren auf den Anweisungsnamen, die Sie bereitstellen, wenn Sie die
Anweisungen zur Datenbank hinzufügen.
3. Stellen Sie eine Verbindung zur Datenbank her.
Die Verbindung wird mithilfe einer Instanz der Datenbankklasse
hergestellt. Der Datenbankname muss mit dem Namen der generierten
Java-Klasse übereinstimmen (in diesem Fall SampleDB). Der Wert file
des Eigenschaftsobjekts persist gibt an, dass die Datenbank beständig
ist.
4. Beispieldaten eingeben.
In einer Produktionsanwendung fügen Sie gewöhnlich keine
Beispieldaten ein. Stattdessen erhalten Sie durch die Synchronisation
eine Erstkopie der Daten. In der ersten Phase der Entwicklung kann die
direkte Dateneingabe die Arbeit erleichtern.
♦ Objekt PreparedStatement mithilfe der Methode
prepareStatement() erstellen.
♦ Um SQL-Befehle auszuführen, müssen Sie ein Statement- oder
PreparedStatement-Objekt erstellen. Mit einem Statement-Objekt
können Sie einfache SQL-Befehle ohne Parameter ausführen und mit
einem PreparedStatement-Objekt SQL-Befehle mit Parametern. Das
Beispielprogramm erstellt zuerst ein PreparedStatement-Objekt, um
einen Einfügebefehl auszuführen:
13

14
PreparedStatement pstmt1 =
conn.prepareStatement( INSERT_PRODUCT );
Die Methode prepareStatement benötigt eine SQL-Zeichenfolge als
Argument. Diese SQL-Zeichenfolge wird über die generierte
Schnittstelle einbezogen.
5. Select-SQL-Befehl mithilfe eines Statement-Objekts ausführen
♦ Es wird ein Statement-Objekt mithilfe der Methode
createStatement() erstellt.
Im Unterschied zum Objekt PreparedStatement brauchen Sie bei der
Erstellung eines Statement-Objekts keine SQL-Anweisung
anzugeben. Aus diesem Grund kann ein einziges Statement-Objekt
verwendet werden, um mehrere SQL-Anweisungen auszuführen.
Statement stmt = conn.createStatement();
♦ SQL-Abfrage ausführen.
Mit der Methode executeQuery() wird eine Auswahlabfrage
ausgeführt. Eine Select-Anweisung gibt ein ResultSet-Objekt zurück.
♦ Eine Schleife implementieren, um sequenziell Abfrageergebnisse zu
erhalten.
Das Objekt ResultSet hat einen Cursor, der zunächst vor die erste
Zeile zeigt. Der Cursor wird jedesmal um eine Zeile erhöht, wenn die
Methode next() aufgerufen wird. Die Methode next() gibt den Wert
TRUE zurück, wenn sich der Cursor zu einer Zeile mit Daten bewegt,
und den Wert FALSE, wenn er hinter die letzte Zeile positioniert
wurde.
while(result.next()) {
...
}
♦ Abfrageergebnisse mit der Methode getxxx() abrufen.
Diese Methoden brauchen die Spaltennummer als Argument. Das
Beispielprogramm verwendet die Methode getInt(), um die
Produkt-ID (“id”) und den Preis (“price”) aus den ersten beiden
Spalten abzurufen, und die Methode getString(), um den
Produktnamen (“name”) aus der dritten Spalte abzurufen.
int id = result.getInt( 1 );
int price = result.getInt( 2 );
String name = result.getString( 3 );
6. Programm beenden.
♦ Verbindung zur Datenbank mit der Methode Connection.close()
schließen:

Kapitel 2. Praktische Einführung: Anwendung mit Java erstellen
conn.close();
15

Lektion 4: Anwendung erstellen und ausführen
16
Wenn Sie im vorigen Abschnitt mithilfe des Beispielcodes die Quelldatei
Sample.java erstellt haben, können Sie nun Ihre UltraLite-Anwendung
erstellen.
❖ So erstellen Sie Ihre Anwendung
1. Starten Sie den Personal Datenbankserver von Adaptive Server
Anywhere.
Wenn Sie den Datenbankserver starten, hat der UltraLite-Generator
Zugriff auf Ihre Referenzdatenbank. Starten Sie den Datenbankserver
über das die Menü “Start”:
Start ➤ Programme ➤ Sybase SQL Anywhere 9 ➤ UltraLite ➤ Personal
Server-Beispiel für Ultralite.
2. Kompilieren Sie Ihre Java-Quelldateien.
Beziehen Sie folgende Speicherpositionen in Ihren Klassenpfad ein:
♦ Das aktuelle Verzeichnis (verwenden Sie einen Punkt in Ihrem
Klassenpfad).
♦ Die Java-Laufzeitklassen. Für JDK 1.2 beziehen Sie die Datei
jre\lib\rt.jar in Ihren Klassenpfad ein. Für JDK 1.1 beziehen Sie die in
Ihrer Java-Installation enthaltene Datei classes.zip ein.
♦ Die UltraLite-Laufzeitklassen. Diese Klassen befinden sich an der
folgenden Position:
%ASANY9%\UltraLite\java\lib\ulrt.jar
Dabei gilt: %ASANY9% repräsentiert Ihr
SQL Anywhere-Verzeichnis.
Führen Sie den javac-Compiler wie folgt aus:
javac *.java
Nun können Sie Ihre Anwendung ausführen.
❖ So führen Sie Ihre Anwendung aus
1. Öffnen Sie eine Eingabeaufforderung und gehen Sie zu Ihrem
Verzeichnis Javatutorial.
2. Beziehen Sie dieselben Klassen in den Klassenpfad ein wie im
vorherigen Vorgang.

Kapitel 2. Praktische Einführung: Anwendung mit Java erstellen
3. Geben Sie folgenden Befehl ein, um die Anwendung zu starten:
java Sample
Die Liste der beiden Einträge wird angezeigt und die Anwendung wird
beendet.
Damit haben Sie Ihre erste UltraLite-Java-Anwendung erstellt und
ausgeführt. Im nächsten Schritt fügen Sie der Anwendung die
Synchronisation hinzu.
17

Lektion 5: Synchronisation zur Anwendung
hinzufügen
18
Wenn Sie getestet und sichergestellt haben, dass Ihr Programm korrekt
abläuft, können Sie die Codezeilen löschen, die Code manuell in die Tabelle
ULProduct einfügen. Ersetzen Sie diese Anweisungen durch einen Aufruf
der Funktion JdbcConnection.synchronize(), um die entfernte Datenbank
mit der konsolidierten Datenbank zu synchronisieren. Dieser Prozess füllt
die Tabellen mit Daten an, sodass Sie nachfolgend eine Auswahlabfrage
ausführen können.
Das Hinzufügen der Synchronisation vereinfacht den Code. Ihre
ursprüngliche Version von Sample.java enthält folgende Zeilen, die einige
Daten in Ihre UltraLite-Datenbank einfügen.
PreparedStatement pstmt1 = conn.prepareStatement( ADD_PRODUCT_1
);
pstmt1.setInt(1, 1);
pstmt1.setInt(2, 400);
pstmt1.setString(3, "4x8 Drywall x100");
int rows1=pstmt1.executeUpdate();
pstmt1.setInt(1, 2);
pstmt1.setInt(2, 3000);
pstmt1.setString(3, "8’ 2x4 Studs x1000");
int rows2=pstmt1.executeUpdate();
Dieser Code ist enthalten, damit Ihre Anwendung erste Daten enthält. In
einer Produktionsanwendung fügen Sie gewöhnlich keine Erstkopie Ihrer
Daten über den Quellcode ein, sondern führen ein Synchronisation aus.
❖ So fügen Sie Ihrer Anwendung die Synchronisationsfunktion hinzu
1. Löschen Sie die generierte Datenbank (udb file) aus der Lektion 4.
In dieser Lektion werden Daten durch Synchronisation hinzugefügt, und
daher ist eine saubere UltraLite-Datenbank erforderlich.
2. Ersetzen Sie die hartkodierten Einfügungen durch einen
Synchronisationsaufruf.
a. Löschen Sie die oben aufgeführten Anweisungen, die den Code
einfügen.
b. Fügen Sie an ihrer Stelle folgende Zeilen ein:

Kapitel 2. Praktische Einführung: Anwendung mit Java erstellen
UlSynchOptions synch_opts = new UlSynchOptions();
synch_opts.setUserName( "50" );
synch_opts.setPassword( "pwd50" );
synch_opts.setScriptVersion( "ul_default" );
synch_opts.setStream( new UlSocketStream() );
synch_opts.setStreamParms( "host=localhost" );
( (JdbcConnection)conn ).synchronize( synch_opts );
Das Argument ULSocketStream weist die Anwendung an, über
TCP/IP mit einem MobiLink-Synchronisationsserver auf dem lokalen
Rechner (localhost) mittels dem MobiLink-Benutzernamen 50 zu
synchronisieren.
3. Kompilieren und verknüpfen Sie Ihre Anwendung.
Geben Sie folgenden Befehl mit einem CLASSPATH ein, der das aktuelle
Verzeichnis, die UltraLite- und die Java-Laufzeitklassen einbezieht:
javac *.java
4. Starten Sie den MobiLink-Synchronisationsserver mit der
Beispieldatenbank .
In der Eingabeaufforderung in Ihrem JavaTutorial-Verzeichnis geben Sie
folgenden Befehl ein:
start dbmlsrv9 -c "dsn=UltraLite 9.0 Sample"
5. Führen Sie die Anwendung aus.
In der Eingabeaufforderung in Ihrem JavaTutorial-Verzeichnis geben Sie
folgenden Befehl ein:
java Sample
Die Anwendung stellt die Verbindung her, synchronisiert, um Daten zu
empfangen, und schreibt die Informationen in die Befehlszeile. Die
Ausgabe lautet wie folgt:
Connecting to server:port = localhost(a.b.c.d):2439
4x8 Drywall x100 Id=1 Price=400
8’ 2x4 Studs x1000 Id=2 Price=3000
Drywall Screws 10lb Id=3 Price=40
Joint Compound 100lb Id=4 Price=75
Joint Tape x25x500 Id=5 Price=100
Putty Knife x25 Id=6 Price=400
8’ 2x10 Supports x 200 Id=7 Price=3000
400 Grit Sandpaper Id=8 Price=75
Screwmaster Drill Id=9 Price=40
200 Grit Sandpaper Id=10 Price=100
In dieser Lektion haben Sie einer einfachen UltraLite-Anwendung die
Synchronisation hinzugefügt.
19

20
☞ Weitere Hinweise über die Funktion JdbcConnection.synchronize()
finden Sie im Abschnitt “synchronize-Methode” auf Seite 67.

Kapitel 2. Praktische Einführung: Anwendung mit Java erstellen
Lektion 6: Änderungen rückgängig machen
Um die praktische Einführung abzuschließen, fahren Sie den
MobiLink-Synchronisationsserver herunter und stellen die
Beispieldatenbank von UltraLite 9.0 wieder her.
❖ So beenden Sie die praktische Einführung
1. Fahren Sie den MobiLink-Synchronisationsserver herunter.
2. Stellen Sie die UltraLite 9.0-Beispieldatenbank wieder her.
♦ Löschen Sie die Dateien custdb.db und custdb.log im Unterverzeichnis
samples\UltraLite\custdb Ihres SQL Anywhere-Verzeichnisses.
♦ Kopieren Sie die Datei custdb.db aus dem Verzeichnis APITutorial in
das Verzeichnis samples\UltraLite\custdb.
3. Löschen Sie die UltraLite-Datenbank.
♦ Die UltraLite-Datenbank befindet sich im selben Verzeichnis wie die
JAR-Dateien und hat die Erweiterung .udb. Wenn die Anwendung das
nächste Mal gestartet wird, wird sie eine neue Datenbank initialisieren.
21

KAPITEL 3
Datenzugriff über Static Java-API
Informationen zu diesem
Kapitel
Dieses Kapitel beschreibt den spezifisch für die Static Java-API geltenden
UltraLite-Entwicklungsprozess im Detail. Es wird erklärt, wie Sie
UltraLite-Anwendungen mithilfe von Java schreiben und wie Sie eine
UltraLite-Anwendung bereitstellen.
Inhalt Thema: Seite
Überblick 24
UltraLite Static Java-Beispielanwendung 25
Mit der UltraLite-Datenbank verbinden und die Datenbank konfigurieren
SQL-Anweisungen in UltraLite Static Java-Anwendungen einbeziehen
Benutzerauthentifizierung zu Ihrer Anwendung hinzufügen 38
Datenbankspeicher konfigurieren und verwalten 41
Anwendungen eine Synchronisationsfunktion hinzufügen 46
Hinweise zur UltraLite Static Java-Entwicklung 57
UltraLite Static Java-Anwendungen erstellen 58
30
37
23

Überblick
24
UltraLite-Anwendungen können in der Programmiersprache Java mithilfe
von JDBC für den Datenbankzugriff geschrieben werden.
Der UltraLite-Entwicklungsprozess für Java ist dem für Static
C/C++-Anwendungen sehr ähnlich. Eine Beschreibung finden Sie unter
“Verwendung von statischen Schnittstellen in UltraLite” [UltraLite
Datenbankhandbuch, Seite 209].
Dieses Kapitel beschreibt nur die Aspekte der Anwendungsentwicklung, die
für UltraLite Static Java-Anwendungen spezifisch sind. Es wird davon
ausgegangen, dass Sie mit Java und JDBC vertraut sind.

Kapitel 3. Datenzugriff über Static Java-API
UltraLite Static Java-Beispielanwendung
Dieser Abschnitt beschreibt, wie Sie die UltraLite Static Java-Version der
Beispielanwendung “CustDB” kompilieren und ausführen.
Die Beispielanwendung befindet sich im Unterverzeichnis
Samples\UltraLite\CustDB\java Ihres SQL Anywhere-Verzeichnisses.
Die Applet-Version des Beispiels verwendet den Appletviewer von Sun, um
die Datei custdb.html anzuzeigen, die eine einfache -Marke
enthält.
Die Appletviewer-Sicherheitseinschränkungen erfordern, dass das Applet
von einem Webserver eingelesen und nicht über das Dateisystem gestartet
wird, damit die Socketverbindungen zugelassen werden und die
Synchronisation erfolgreich ist.
Die Anwendungsversion von “CustDB” schreibt ihre Daten in eine Datei,
während die Appletversion keine beständigen Daten verwendet.
☞ Hinweise zu der C/C++-Version der Anwendung, die ähnliche
Funktionen hat, finden Sie unter “Praktische Einführung: Die
UltraLite-Beispielanwendung CustDB” [UltraLite Datenbankhandbuch,
Seite 15].
Die UltraLite Static Java-Beispieldateien
Der Code für die UltraLite Static Java-Beispiele befindet sich im
Unterverzeichnis Samples\UltraLite\CustDB\java Ihres SQL
Anywhere-Verzeichnisses.
Das Verzeichnis enthält folgende Dateien:
♦ Datenzugriffscode Die Datei CustDB.java enthält die
UltraLite-spezifische Datenzugriffslogik. Die SQL-Anweisungen sind in
SQL.sql gespeichert.
♦ Code für die Benutzeroberflächen Die Dateien DialogDelOrder.java,
Dialogs.java, DialogNewOrder.java und DialogUserID.java enthalten alle
Funktionen für die Benutzeroberfläche.
♦ readme.txt Eine Textdatei, die detaillierte, versionsunabhängige
Informationen über die Beispielanwendung enthält.
♦ Unterverzeichnisse Es gibt zwei Unterverzeichnisse, in denen Sie die
Beispieldatei ausführen können. Dies sind die Verzeichnisse java11 (für
Java 1) und java13 (für Java 2). Wenn Sie eine 1.1.x-Version von JDK
verwenden, sollten Sie das erste der beiden genannten Verzeichnisse zu
25

Ihrem aktuellen Verzeichnis machen. Wenn Sie Version 1.2.x oder später
verwenden, sollten Sie das zweite Verzeichnis zum aktuellen Verzeichnis
deklarieren. Diese Unterverzeichnisse enthalten Batchdateien zur
Ausführung der Beispiele. In jedem Verzeichnis hängen die Batchdateien
jeweils von der Umgebunsgvariablen JAVA_HOME ab, die auf das
Verzeichnis gesetzt werden sollte, in dem sich JDK befindet. Zum
Beispiel:
SET JAVA_HOME=c:\jdk1.3.1
♦ Batchdateien zur Erstellung der Anwendung Die Dateien build.bat
und clean.bat kompilieren die Anwendung bzw. löschen alle Dateien
außer den Quelldateien.
♦ Dateien zum Ausführen der Beispielanwendung Die Datei
Application.java enthält die nötigen Anweisungen zum Ausführen des
Beispiels als Java-Anwendung, und run.bat startet die
Beispielanwendung.
♦ Dateien zum Ausführen des Beispiels als Applet Die Datei
Applet.java enthält die Anweisungen, die erforderlich sind, um das
Beispiel als Java-Applet auszuführen, avapplet.bat startet das Applet und
verwendet custdb.html als Webseite.
Um das Beispiel als Applet auszuführen, müssen Sie einen Webserver
installieren und starten. Das Applet kann mithilfe des
Appletviewer-Dienstprogramms oder eines Web-Browsers ausgeführt
werden. Weitere Hinweise finden Sie in der Datei
Samples\UltraLite\CustDB\Java\readme.txt.
UltraLite Static Java-Beispielanwendungen erstellen
26
Dieser Abschnitt beschreibt, wie Sie die UltraLite Static
Java-Beispielanwendung für die Umgebung von Sun Java 1 oder 2 erstellen.
❖ So erstellen Sie die UltraLite Static Java-Beispielanwendung
1. Stellen Sie sicher, dass die richtige JDK-Version installiert ist.
Sie müssen JDK 1.1 oder JDK 1.3 installiert haben, um die
Beispielanwendung zu erstellen, und die JDK-Tools müssen sich im Pfad
befinden.
2. Öffnen Sie eine Eingabeaufforderung.
3. Wechseln Sie in das Unterverzeichnis
Samples\UltraLite\CustDB\java\java13 Ihres

Kapitel 3. Datenzugriff über Static Java-API
SQL Anywhere-Verzeichnisses oder in das Verzeichnis java11, wenn Sie
Java 1 verwenden.
4. Erstellen Sie die Beispielanwendung:
♦ Setzen Sie die Umgebungsvariable JAVA_HOME. Zum Beispiel:
SET JAVA_HOME=c:\jdk1.3.1
♦ An der Eingabeaufforderung geben Sie folgenden Befehl ein:
build
Die Erstellungsprozedur führt folgende Vorgänge aus:
♦ Sie lädt SQL-Anweisungen in die UltraLite-Beispieldatenbank.
Für diesen Schritt werden Interactive SQL, die Datei SQL.sql und die
Datenquellen der Beispieldatenbank von UltraLite 9.0 verwendet.
♦ Sie generiert die Java-Datenbankklasse custdb.Database.
Dieser Schritt verwendet den UltraLite-Generator und die Datenquelle
der Beispieldatenbank von UltraLite 9.0.
♦ Sie kompiliert die Java-Dateien.
Dieser Schritt verwendet den JDK-Compiler ( javac) und das
Dienstprogramm jar.
UltraLite Static Java-Beispielanwendung ausführen
Sie können die Beispielanwendung als Java-Anwendung oder als Applet
ausführen. In beiden Fällen müssen Sie vorab den
MobiLink-Synchronisationsserver starten, der auf demselben Rechner läuft
wie die Anwendung selbst.
❖ So bereiten Sie die Ausführung der Beispielanwendung vor
1. Starten Sie den MobiLink-Synchronisationsserver für die
UltraLite-Beispieldatenbank:
Im Menü “Start” wählen Sie Programme ➤ SQL Anywhere 9 ➤
MobiLink ➤ Synchronisationsserver-Beispiel.
❖ So starten Sie das Beispiel als Anwendung
1. Öffnen Sie im Verzeichnis Samples\UltraLite\CustDB\java\java13 (oder
im Verzeichnis java11, wenn Sie Java 1 verwenden) eine Befehlszeile.
2. Führen Sie die Beispielanwendung aus:
♦ Setzen Sie die Umgebungsvariable JAVA_HOME. Zum Beispiel:
SET JAVA_HOME=c:\jdk1.3.1
27

28
♦ Geben Sie folgenden Befehl ein:
run
Die Anwendung wird gestartet und das Dialogfeld Enter ID erscheint.
3. Geben Sie die Mitarbeiter-ID ein.
Geben Sie die Mitarbeiter-ID “50” ein und klicken Sie auf “OK”.
Das Fenster UltraLite Customer Demonstration wird angezeigt. Wenn Sie
das Beispiel zuvor als Anwendung oder als Applet ausgeführt haben,
enthält die Datenbank Daten.
4. Wenn keine Daten in der Datenbank enthalten sind, synchronisieren Sie
sie.
Im Menü “Actions” wählen Sie “Synchronize”. Die Anwendung wird
synchronisiert, und im Fenster wird eine Bestellung angezeigt.
Sie können nun die Daten in der Datenbank bearbeiten.
☞ Weitere Hinweise zur Beispieldatenbank und den damit durchführbaren
UltraLite-Funktionen finden Sie unter “Praktische Einführung: Die
UltraLite-Beispielanwendung CustDB” [UltraLite Datenbankhandbuch,
Seite 15].
❖ So starten Sie das Beispiel als Applet mit dem Appletviewer
1. Starten Sie einen Webserver und stellen Sie sicher, dass das richtige
Unterverzeichnis als Standardverzeichnis für den Server oder als eines
der virtuellen Verzeichnisse konfiguriert ist.
2. Öffnen Sie im Verzeichnis UltraLite\samples\CustDB\java\java13 (oder
im Verzeichnis java11, wenn Sie Java 1 verwenden) eine
Eingabeaufforderung.
3. Geben Sie folgenden Befehl ein:
avapplet
♦ Das Applet wird gestartet, und es erscheint ein Feld, in das Sie eine
Mitarbeiter-ID eingeben können.
4. Geben Sie die Mitarbeiter-ID ein.
Geben Sie die Mitarbeiter-ID “50” ein und klicken Sie auf “OK”.
Das Fenster UltraLite Customer Demonstration wird angezeigt. Wenn Sie
das Beispiel erstmals starten, enthält die Datenbank keine Daten. Wenn
Sie das Beispiel zuvor als Anwendung oder als Applet ausgeführt haben,
enthält die Datenbank Daten.

Beispielanwendung
zurücksetzen
5. Synchronisieren Sie die Anwendung:
Kapitel 3. Datenzugriff über Static Java-API
Im Menü “Actions” wählen Sie “Synchronize”. Die Anwendung wird
synchronisiert, und im Fenster wird eine Bestellung angezeigt.
Sie können nun die Daten in der Datenbank bearbeiten.
❖ So starten Sie das Beispiel als Applet mit einem Web-Browser
1. Starten Sie einen Webserver und stellen Sie sicher, dass das richtige
Unterverzeichnis als Standardverzeichnis für den Server oder als eines
der virtuellen Verzeichnisse konfiguriert ist.
2. Starten Sie einen Web-Browser und geben Sie den URL für die Datei
Samples\UltraLite\CustDB\java\custdb.htm in den Browser ein.
♦ Das Applet wird gestartet, und es erscheint ein Feld, in das Sie eine
Mitarbeiter-ID eingeben können.
3. Geben Sie die Mitarbeiter-ID ein.
Geben Sie die Mitarbeiter-ID “50” ein und klicken Sie auf “OK”.
Das Fenster UltraLite Customer Demonstration wird angezeigt. Wenn Sie
das Beispiel erstmals starten, enthält die Datenbank keine Daten. Wenn
Sie das Beispiel zuvor als Anwendung oder als Applet ausgeführt haben,
enthält die Datenbank Daten.
4. Synchronisieren Sie die Anwendung:
Im Menü “Actions” wählen Sie “Synchronize”. Die Anwendung wird
synchronisiert, und im Fenster wird eine Bestellung angezeigt.
☞ Weitere Hinweise zur Beispieldatenbank und den damit durchführbaren
UltraLite-Funktionen finden Sie unter “Praktische Einführung: Die
UltraLite-Beispielanwendung CustDB” [UltraLite Datenbankhandbuch,
Seite 15].
Sie können alle kompilierten Dateien, die Beispieldatenbank und den
generierten Code löschen, indem Sie die Datei clean.bat ausführen.
29

Mit der UltraLite-Datenbank verbinden und die
Datenbank konfigurieren
Dieser Abschnitt beschreibt, wie Sie sich mit einer UltraLite-Datenbank
verbinden. Er stellt die empfohlene UltraLite-Methode zur Verbindung mit
Ihrer Datenbank vor und bespricht, wie Sie das
JDBC-Standardverbindungsmodell für die Verbindung verwenden können.
Verbindungen zu UltraLite-Datenbanken haben keine Benutzer-IDs oder
Kennwörter. Weitere Hinweise finden Sie unter “Benutzerauthentifizierung
in UltraLite” [UltraLite Datenbankhandbuch, Seite 45].
UltraLite Static Java-Datenbanken können beständig (engl. persistent;
Speicherung in einer Datei, wenn die Anwendung geschlossen wird) oder
flüchtig (vorübergehend, engl. transient; die Datenbank verschwindet, wenn
die Anwendung geschlossen wird) sein. Standardmäßig sind sie flüchtig.
Sie konfigurieren die Beständigkeit Ihrer UltraLite-Datenbank, wenn Sie
sich mit ihr verbinden. Dieser Abschnitt beschreibt, wie Sie Ihre
UltraLite-Datenbank konfigurieren.
UltraLite-Methode “JdbcDatabase.connect” verwenden
30
Der generierte UltraLite-Datenbankcode hat die Form einer Klasse, die
JdbcDatabase erweitert. Diese wiederum hat eine connect-Methode, die
eine Verbindung einrichtet.
Folgendes Beispiel illustriert typischen Code für die generierte
Datenbankklasse SampleDB:
try {
SampleDB db = new SampleDB();
java.sql.Connection conn = db.connect();
} catch( SQLException e ){
// error processing here
}
Die generierte Datenbankklasse wird in der Befehlszeile des
UltraLite-Generators mit der Option -f angegeben.
Wenn Sie eine beständige Datenbank verwenden wollen, werden die
Merkmale für die Verbindung als Properties-Objekt festgelegt. Folgendes
Beispiel illustriert typischen Code:
java.util.Properties p = new java.utils.Properties();
p.put( "persist", "file" );
p.put( "persistfile", "c:\\dbdir\\database.udb" );
SampleDB db = new SampleDB( p );
java.sql.Connection conn = db.connect( );

JDBC-Treiber laden und registrieren
Kapitel 3. Datenzugriff über Static Java-API
Die Eigenschaften werden für den Datenbank-Konstruktor verwendet. Es ist
nicht möglich, das Beständigkeitsmodell der Datenbank zwischen
Verbindungen zu ändern.
Die zwei Eigenschaften legen fest, dass die Datenbank beständig ist und in
der Datei c:\dbdir\Datenbank.udb gespeichert wird.
☞ Weitere Informationen zu den Möglichkeiten der Einstellungen für
URLs finden Sie unter “JDBC-URLs in UltraLite” auf Seite 32.
☞ Weitere Hinweise finden Sie unter “UltraLite Static Java-Datenbank
konfigurieren” auf Seite 34 und “Die generierte Datenbankklasse” auf
Seite 71.
Die UltraLite-Methode JdbcDatabase.connect(), die im vorangehenden
Abschnitt beschrieben wurde, ist die einfachste Möglichkeit, sich mit einer
UltraLite-Datenbank zu verbinden. Sie können eine Verbindung jedoch auch
auf dem Standardweg mit JDBC herstellen. In diesem Abschnitt wird
beschrieben, wie Sie dabei vorgehen.
UltraLite-Anwendungen verbinden sich mit ihrer Datenbank über einen
JDBC-Treiber, der in den UltraLite-Laufzeitklassen enthalten ist (ulrt.jar).
Sie müssen den JDBC-Treiber in Ihre Anwendung laden und registrieren,
bevor Sie sich mit der Datenbank verbinden. Laden Sie den Treiber mit der
Methode Class.forName(). Diese Methode benötigt den Namen des
Treiberpakets als Argument.
Class.forName( "ianywhere.ultralite.jdbc.JdbcDriver");
Der JDBC-Treiber registriert sich selbständig, wenn er geladen wird.
Mehrere Treiber laden Gewöhnlich wird nur ein Treiber in einer Anwendung registriert. Es ist
jedoch möglich, mehrere Treiber für eine Anwendung zu laden. Laden Sie
jeden Treiber mit der oben angegebenen Methode. Der DriverManager
bestimmt, welcher Treiber für die Verbindung zu einer Datenbank verwendet
wird.
getDriver-Methode Die Methode DriverManager.getDriver gibt den Driver für die
angegebene URL zurück.
Fehlerbehandlung Wenn der Treiber nicht gefunden wird, führen Sie
ClassNotFoundException wie folgt aus:
31

Mit der Datenbank über JDBC verbinden
getConnection-
Prototypen
try{
Class.forName(
"ianywhere.ultralite.jdbc.JdbcDriver");
} catch(ClassNotFoundException e){
System.out.println( "Exception: " + e.getMessage() );
e.printStackTrace();
}
Wenn der Treiber deklariert wurde, können Sie sich mit der
JDBC-Standardmethode DriverManager.getConnection mit der Datenbank
verbinden.
Die JDBC-Methode DriverManager.getConnection verfügt über mehrere
Prototypen. Diese haben folgende Argumente:
DriverManager.getConnection( String url, Properties info )
DriverManager.getConnection( String url )
Der UltraLite-Treiber unterstützt alle diese Prototypen. Die Argumente
werden in den folgenden Abschnitten besprochen.
Treiber-Manager Die Treiber-Manager-Klasse DriverManager verwaltet eine Liste der
Driver-Klassen, die aktuell geladen sind. Sie fragt die einzelnen Treiber in
der Liste, ob sie die Verbindung zum URL herstellen können. Wenn ein
entsprechender Treiber gefunden wird, versucht der DriverManager, ihn
für die Verbindung mit der Datenbank einzusetzen.
Fehlerbehandlung Wenn keine Verbindung hergestellt werden kann, führen Sie SQLException
wie folgt aus:
JDBC-URLs in UltraLite
32
try{
Class.forName(
"ianywhere.ultralite.jdbc.JdbcDriver");
Connection conn = DriverManager.getConnection(
"jdbc:ultralite:asademo" );
} catch(SQLException e){
System.out.println( "Exception: " + e.getMessage() );
e.printStackTrace();
}
Der URL ist ein erforderliches Argument für die Methode
DriverManager.getConnection, die für die Verbindung mit
UltraLite-Datenbanken verwendet wird.
☞ Einen Überblick über Verbindungsmethoden finden Sie unter “Mit der

Datenbank über JDBC verbinden” auf Seite 32.
Kapitel 3. Datenzugriff über Static Java-API
Die Syntax für UltraLite-JDBC-URLs lautet wie folgt:
jdbc:ultralite:[database:persist:persistfile][;option=value...]
Alle Komponenten unterscheiden zwischen Klein- und Großschreibung und
haben folgende Bedeutung:
♦ jdbc Kennzeichnet den Treiber als JDBC-Treiber. Die Angabe ist
obligatorisch.
♦ ultralite Kennzeichnet den Treiber als den UltraLite-Treiber. Die
Angabe ist obligatorisch.
♦ database Der Klassenname für die Datenbank. Der Name muss
angegeben und vollständig qualifiziert werden. Wenn die
Datenbankklasse in einem Paket enthalten ist, müssen Sie den
Paketnamen ebenfalls angeben.
Beispiel: Der URL jdbc:ultralite:MeinProjekt bewirkt, dass der
Klassenname MeinProjekt geladen wird.
Da eine Java-Klasse ihren Namen mit der .java-Datei teilt, in der sie
definiert wird, stimmt diese Komponente mit dem Parameter der
Ausgabedatei des UltraLite-Generators überein.
☞ Weitere Hinweise finden Sie unter “Der UltraLite-Generator”
[UltraLite Datenbankhandbuch, Seite 99].
♦ persist Legt fest, ob die Datenbank beständig oder flüchtig ist.
Standardmäßig ist sie flüchtig (“transient”).
☞ Weitere Hinweise finden Sie unter “UltraLite Static Java-Datenbank
konfigurieren” auf Seite 34.
♦ persistfile Bei beständigen Datenbanken geben Sie hier den
Dateinamen an.
☞ Weitere Hinweise finden Sie unter “UltraLite Static Java-Datenbank
konfigurieren” auf Seite 34. Die UltraLite Static Java-Eigenschaften sind
denen für C/C++-Anwendungen sehr änlich. Ihre Namen unterscheiden
sich nur durch die Abwesenheit von Unterstrichen, außer dass persistfile
analog zu file_name ist. Siehe “UL_STORE_PARMS-Makro” [UltraLite
C/C++ Benutzerhandbuch, Seite 238].
♦ options Die folgenden Optionen sind verfügbar:
• uid Eine Benutzer-ID.
• pwd Ein Kennwort für die Benutzer-ID.
33

Sie können sich alternativ auch anhand eines Eigenschaftsobjekts verbinden.
Die folgenden Eigenschaften können angegeben werden: Jede hat die
gleiche Bedeutung wie in der expliziten obigen URL-Syntax:
♦ database
♦ persist
♦ persistfile
♦ user (Benutzer)
♦ password
Mit einem Properties-Objekt Verbindungsinformationen speichern
Sie können ein Properties-Objekt verwenden, um
Verbindungsinformationen zu speichern, und dieses Objekt zusammen mit
dem URL als Argument für getConnection angeben.
☞ Einen Überblick über Verbindungsmethoden finden Sie unter “Mit der
Datenbank über JDBC verbinden” auf Seite 32.
Eine Beschreibung der folgenden Komponenten des URL finden Sie unter
“JDBC-URLs in UltraLite” auf Seite 32. Sie können als Teil des URL oder
als Mitglied eines Properties-Objekts angegeben werden.
♦ persist
♦ persistfile
♦ Die jdbc:ultralite-Komponenten müssen im URL angegeben
werden.
Wenn Sie Ihre Datenbank verschlüsseln wollen, können Sie dazu eine
Schlüssel-Eigenschaft verwenden. Weitere Hinweise finden Sie unter
“UltraLite-Datenbanken verschlüsseln” auf Seite 41.
Mit mehreren Datenbanken verbinden
UltraLite Static Java-Anwendungen können mit mehr als einer Datenbank
eine Verbindung herstellen. Um Verbindungen zu mehreren Datenbanken
herzustellen, erstellen Sie einfach mehrere Verbindungsobjekte.
☞ Weitere Hinweise finden Sie unter “Mit der Datenbank über JDBC
verbinden” auf Seite 32.
UltraLite Static Java-Datenbank konfigurieren
34
Sie können die folgenden Aspekte einer UltraLite Static Java-Datenbank
konfigurieren:

Flüchtige und beständige
Datenbanken
Flüchtige Datenbanken
initialisieren
♦ Ob die Datenbank flüchtig oder beständig ist
Kapitel 3. Datenzugriff über Static Java-API
♦ Wenn die Datenbank beständig ist, können Sie einen Dateinamen
angeben.
♦ Wenn die Datenbank flüchtig ist, können Sie einen URL für eine
Initialisierungsdatenbank angeben.
♦ Sie können einen Chiffrierschlüssel festlegen.
Sie können diese Aspekte konfigurieren, indem Sie im Datenbank-URL
spezifische Wert angeben oder bei der Erstellung der Datenbank ein
Eigenschaftsobjekt verwenden. Sie können den Chiffrierschlüssel nicht auf
den URL setzen, sondern müssen ihn in einem Eigenschaftsobjekt
unterbringen.
☞ Weitere Hinweise finden Sie unter “UltraLite-Methode
“JdbcDatabase.connect” verwenden” auf Seite 30 und “Mit einem
Properties-Objekt Verbindungsinformationen speichern” auf Seite 34.
Standardmäßig sind UltraLite Static Java-Datenbanken flüchtig. Sie werden
initialisiert, wenn das Datenbankobjekt instanziert wird, und verschwinden,
wenn die Anwendung geschlossen wird. Wenn die Anwendung das nächste
Mal gestartet wird, muss sie die Datenbank neu initialisieren.
Sie können UltraLite Static Java-Datenbanken beständig machen, indem Sie
sie in einer Datei speichern. Dazu legen Sie die Elemente persist und
persistfile des JDBC-URL fest oder geben die Eigenschaften persist und
persistfile für die Datenbankmethode connect an.
Die Datenbank für die meisten UltraLite-Anwendungen wird beim ersten
Synchronisationsaufruf initialisiert. Für UltraLite Static Java-Anwendungen,
die eine flüchtige Datenbank verwenden, gibt es eine alternative Methode,
die Datenbank zu initialisieren. Sie geben den URL für eine
UltraLite-Datenbank, die als Ausgangsdatenbank verwendet wird, in der
Komponente persistfile des URLs an.
Datenbank konfigurieren Die Komponenten des URL für die Datenbankkonfiguration lauten wie folgt:
♦ persist Diese Komponente kann folgende Werte annehmen:
• none In diesem Fall ist die Datenbank flüchtig. Sie wird im Speicher
gehalten, während die Anwendung läuft, und verschwindet, wenn die
Anwendung beendet wird.
• Datei In diesem Fall wird die Datenbank in einer Datei gespeichert.
Der Standarddatenbankname ist Datenbank.udb, wobei Datenbank der
Name der Datenbankklasse ist.
Die Standardeinstellung ist none.
35

36
♦ persistfile Die Bedeutung dieser Komponente hängt von der
Einstellung von persist ab.
• Wenn die Komponente persist den Wert none hat, ist die Komponente
persistfile ein URL für eine UltraLite-Datenbankdatei, mit der die
Datenbank initialisiert wird.
Sowohl das Schema als auch die Daten aus dem URL werden dazu
verwendet, die Anwendungsdatenbank zu initialisieren, doch es gibt
keine weitere Verbindung zwischen den beiden. Alle Änderungen, die
von Ihrer Anwendung durchgeführt werden, gelten nur für die
flüchtige Datenbank und nicht für die Initialisierungsdatenbank.
Beispiel eines JDBC-URL:
jdbc:ultralite:transient:none:http://www.address.com/transient.u
db
Sie können die Initialisierungsdatenbank mit einer Anwendung vorbereiten,
die die beständige Form des URL verwendet, um die Datenbank zu erstellen,
zu synchronisieren und zu beenden.
♦ Wenn die Komponente persist den Wert file hat, ist die Komponente
persistfile ein Dateiname für die beständige UltraLite-Datenbank. Der
Dateiname muss alle Erweiterungen (wie z.B. .udb) einbeziehen, die Sie
verwenden wollen.

SQL-Anweisungen in UltraLite Static
Java-Anwendungen einbeziehen
SQL-Anweisungen für
Ihre Anwendung
definieren
Kapitel 3. Datenzugriff über Static Java-API
Dieser Abschnitt beschreibt, wie Sie Ihrer UltraLite-Anwendung
SQL-Anweisungen hinzufügen.
☞ Weitere Hinweise zu SQL-Funktionen, die in UltraLite-Anwendungen
verwendet werden können, finden Sie unter “Überblick der
SQL-Unterstützung in UltraLite” [UltraLite Datenbankhandbuch, Seite 154].
☞ Sie müssen die SQL-Anweisungen, die in Ihrer Anwendung für die
Referenzdatenbank verwendet werden sollen, zur Referenzdatenbank
hinzufügen. Der UltraLite-Generator erstellt eine Schnittstelle, die diese
SQL-Anweisungen als öffentliche statische endgültige Zeichenfolgen
definiert. Sie rufen die Anweisungen in Ihrer Anwendung auf, indem Sie die
Schnittstelle implementieren und die SQL-Anweisung durch ihren
Bezeichner referenzieren oder indem Sie sie direkt von der Schnittstelle aus
referenzieren.
Sie legen die SQL-Anweisungen, die in die UltraLite-Anwendung
einbezogen werden sollen, und die Struktur der UltraLite-Datenbank selbst
fest, indem Sie die SQL-Anweisungen in die Referenzdatenbank für Ihre
Anwendung einfügen.
☞ Weitere Hinweise zur Referenzdatenbank finden Sie unter
“Referenzdatenbank vorbereiten” [UltraLite Datenbankhandbuch, Seite 214].
Projekte festlegen Jede in der Referenzdatenbank gespeicherte SQL-Anweisung ist einem
Projekt zugeordnet. Bei einem Projekt handelt es sich um einen in der
Referenzdatenbank festgelegten Namen, der die SQL-Anweisungen für eine
Anwendung gruppiert. Sie können SQL-Anweisungen für mehrere
Anwendungen in einer Referenzdatenbank speichern, indem Sie mehrere
Projekte definieren.
Dem Projekt
Anweisungen hinzufügen
☞ Weitere Hinweise zum Erstellen von Projekten finden Sie unter
“UltraLite-Projekt erstellen” [UltraLite Datenbankhandbuch, Seite 219].
Sie müssen Ihrem Projekt die Datenzugriffsanweisungen hinzufügen, die Sie
in Ihrer UltraLite-Anwendung verwenden wollen.
☞ Weitere Hinweise zum Hinzufügen von SQL-Anweisungen zu einer
Datenbank finden Sie unter “Einem UltraLite-Projekt SQL-Anweisungen
hinzufügen” [UltraLite Datenbankhandbuch, Seite 220].
37

Benutzerauthentifizierung zu Ihrer Anwendung
hinzufügen
Benutzerauthentifizierung aktivieren
38
☞ Eine allgemeine Beschreibung der UltraLite-Benutzerauthentifizierung
finden Sie unter “Benutzerauthentifizierung in UltraLite” [UltraLite
Datenbankhandbuch, Seite 45].
☞ Wenn Sie eine UltraLite-Datenbank mit aktivierter Authentifizierung
erstellen, wird ein authentifizierter Benutzer erstellt, der die ID DBA und das
Kennwort SQL erhält. UltraLite erlaubt es, dass bis zu vier Benutzer
gleichzeitig definiert sind, wobei sowohl Benutzer-ID als auch Kennwort
kürzer als 16 Zeichen sein müssen. Jeder Benutzer hat vollen Zugriff auf die
Datenbank, wenn er erfolgreich authentifiziert wurde.
☞ Die Berücksichtigung der Groß- und Kleinschreibung der UltraLite
Benutzer-ID und des Kennworts wird durch die Referenzdatenbank
bestimmt. Wenn die Referenzdatenbank die Groß- und Kleinschreibung
berücksichtigt (Standard), berücksichtigt auch die UltraLite-Datenbank die
Groß- und Kleinschreibung, einschließlich der Benutzerauthentifizierung.
Zum Aktivieren der Benutzerauthentifizierung muss die Anwendung bei der
Verbindung zur UltraLite-Datenbank eine gültige UltraLite Benutzer-ID und
ein Kennwort liefern. Wenn Sie die Benutzerauthentifizierung nicht
ausdrücklich aktivieren, authentifiziert UltraLite die Benutzer nicht.

Kapitel 3. Datenzugriff über Static Java-API
❖ So aktivieren Sie die Benutzerauthentifizierung
1. Rufen Sie die Methode JdbcSupport.enableUserAuthentication auf,
bevor Sie ein neues Datenbankobjekt erstellen: Zum Beispiel:
JdbcSupport.enableUserAuthentication();
java.util.Properties p = new java.util.Properties();
p.put( "persist", "file" );
SampleDB db = new SampleDB( p );
☞ Sobald Sie die Benutzerauthentifizierung aktiviert haben, müssen Sie
Ihrer Anwendung Code für die Benutzerverwaltung hinzufügen. Weitere
Hinweise finden Sie unter “Benutzer-IDs und Kennwörter verwalten” auf
Seite 39.
Benutzer-IDs und Kennwörter verwalten
Beispiel für eine Benutzerauthentifizierung
Das folgende Codefragment führt Benutzerverwaltung und
-authentifizierung für eine UltraLite Java-Anwendung durch.
Ein komplettes Beispiel finden Sie im Unterverzeichnis
Samples\UltraLite\javaauth des SQL Anywhere-Verzeichnisses. Das
Codebeispiel basiert auf dem Programmcode in
Samples\UltraLite\javaauth\Sample.java.
39

40
JdbcSupport.enableUserAuthentication();
// Create database environment
java.util.Properties p = new java.util.Properties();
p.put( "persist", "file" );
SampleDB db = new SampleDB( p );
// Get new user ID and password
try{
conn = db.connect( "dba", "sql" );
// Set user ID and password
// a real application would prompt the user.
uid = "50";
pwd = "pwd50";
db.grant( uid, pwd );
db.revoke( "dba" );
conn.close();
}
catch( SQLException e ){
// dba connection failed - prompt for user ID and password
uid = "50";
pwd = "pwd50";
}
// Connect
conn = db.connect( uid, pwd );
Der Code führt die folgenden Aufgaben aus:
1. Er öffnet das Datenbankobjekt.
2. Er versucht, mit der Standardbenutzer-ID und dem Standardkennwort
eine Verbindung herzustellen.
3. Er fügt einen neuen Benutzer hinzu, wenn der Verbindungsversuch
erfolgreich ist.
4. Er löscht den Standardbenutzer aus der UltraLite-Datenbank.
5. Er trennt die Verbindung. Nun werden der Datenbank eine aktualisierte
Benutzer-ID und ein aktualisiertes Kennwort hinzugefügt.
6. Mit der aktualisierten Benutzer-ID und dem aktualisierten Kennwort wird
eine Verbindung hergestellt.

Kapitel 3. Datenzugriff über Static Java-API
Datenbankspeicher konfigurieren und verwalten
Sie können die folgenden Aspekte einer beständigen Speicherung in
UltraLite konfigurieren:
♦ Die Speichermenge, die von der UltraLite-Datenbankengine als
Cachespeicher verwendet wird
♦ Datenbankverschlüsselung
♦ Vorabzuweisung von Dateisystemspeicher
♦ Dateiname der Datenbank
♦ Datenbank-Seitengröße
UltraLite-Datenbanken verschlüsseln
Standardmäßig befinden sich UltraLite-Datenbanken unverschlüsselt auf der
Festplatte und im beständigen Speicher. Text- und Binärspalten können
normal gelesen werden, wenn Sie ein Ansichtstool, wie z.B. einen
Hex-Editor, verwenden. Um größere Sicherheit zu bieten, werden zwei
Optionen bereitgestellt:
♦ Verschleierung Das Verschleiern von Datenbanken bietet Sicherheit
vor einfachen Versuchen, Daten in der Datenbank direkt mithilfe eines
Ansichtstools einzusehen. Dies ist kein Schutz vor geschickten und
zielgerichteten Versuchen, Zugriff auf die Daten zu erhalten. Die
Verschleierung hat geringe oder gar keine Auswirkungen auf die
Performance.
☞ Weitere Hinweise finden Sie unter “Eine UltraLite-Datenbank
verschleiern” auf Seite 42.
♦ Starke Verschlüsselung UltraLite-Datenbankdateien können mit dem
AES 128-Bit-Algorithmus stark verschlüsselt werden, demselben
Algorithmus, mit dem Adaptive Server Anywhere-Datenbanken
verschlüsselt werden. Die Verwendung der starken Verschlüsselung bietet
Sicherheit vor geschickten und zielgerichteten Versuchen, Zugriff auf die
Daten zu gewinnen, doch sie hat deutliche Auswirkungen auf die
Performance.
Achtung
Wenn der Chiffrierschlüssel für eine stark verschlüsselte Datenbank
verloren geht oder vergessen wird, gibt es keine Möglichkeit, auf die
Datenbank zuzugreifen. In diesem Fall kann auch der technische Kundendienst
nicht mehr auf die Datenbank zugreifen. Sie muss verworfen
und eine neue Datenbank muss erstellt werden.
41

Eine UltraLite-Datenbank verschleiern
UltraLite-Datenbanken verschlüsseln
42
☞ Weitere Hinweise finden Sie unter “UltraLite-Datenbanken
verschlüsseln” auf Seite 42 und “Chiffrierschlüssel einer Datenbank
ändern” auf Seite 43.
❖ So verschleiern Sie eine UltraLite-Datenbank
1. Fügen Sie Ihrem Code folgende Zeile hinzu, bevor Sie die Datenbank
erstellen (d.h. bevor Sie sich erstmals mit der Datenbank verbinden):
UlDatabase.setDefaultObfuscation( true );
UltraLite-Datenbanken werden beim ersten Verbindungsversuch erstellt. Um
eine UltraLite-Datenbank zu verschlüsseln, stellen Sie vor diesem
Verbindungsversuch einen Chiffrierschlüssel bereit. Beim ersten Versuch
wird der bereitgestellte Schlüssel verwendet, um die Datenbank zu
verschlüsseln. Bei nachfolgenden Versuchen wird der bereitgestellte
Schlüssel mit dem Chiffrierschlüssel verglichen und die Verbindung schlägt
fehl, wenn die Schlüssel nicht übereinstimmen.
❖ So verschlüsseln Sie eine UltraLite-Datenbank stark
1. Legen Sie die mit “key” benannte Eigenschaft fest, bevor Sie ein erstes
Datenbankobjekt erstellen.
Mit dem folgenden Code wird der Chiffrierschlüssel aus der Befehlszeile
ausgelesen.
InputStreamReader isr = new InputStreamReader( System.in );
BufferedReader br = new BufferedReader( isr );
String key = null ;
System.out.print( "Enter encryption key:" );
key = br.readLine() ;
System.out.println( "The key is: " + key );
// Connect to the database
java.util.Properties p = new java.util.Properties();
p.setProperty( "persist", "file" );
p.setProperty( "key", key );
SampleDB db = new SampleDB( p );
Hier ist “SampleDB” der Datenbankdateiname, so wie er in der
Befehlszeilenoption -f des UltraLite-Generators angegeben wurde.
☞ Weitere Hinweise finden Sie unter “Der UltraLite-Generator”
[UltraLite Datenbankhandbuch, Seite 99] und “Mit einem Properties-Objekt
Verbindungsinformationen speichern” auf Seite 34.

Kapitel 3. Datenzugriff über Static Java-API
2. Erstellen Sie das Datenbankobjekt mit den Eigenschaften.
Zum Beispiel:
Chiffrierschlüssel einer Datenbank ändern
Connection conn = db.connect();
Nach dem ersten Verbindungsversuch führen nachfolgende Versuche, mit
einem falschen Schlüssel auf die Datenbank zuzugreifen, zur
SQLException Fehlerhafter oder fehlender
Chiffrierschlüssel.
Im Verzeichnis \Samples\UltraLite\JavaSecurity finden Sie eine
Java-Beispielanwendung mit Verschlüsselung. Der Verschlüsselungscode
befindet sich in \Samples\UltraLite\JavaSecurity\Sample.java.
Im Folgenden sehen Sie einen Codeausschnitt aus dem Beispiel:
// Obtain the encryption key
InputStreamReader isr = new InputStreamReader( System.in );
BufferedReader br = new BufferedReader( isr );
String key = null ;
System.out.print( "Enter encryption key:" );
key = br.readLine() ;
System.out.println( "The key is: " + key );
java.util.Properties p = new java.util.Properties();
p.setProperty( "persist", "file" );
p.setProperty( "key", key );
SampleDB db = new SampleDB( p );
Connection conn = db.connect();
Sie können den Chiffrierschlüssel einer Datenbank ändern. Die Anwendung
muss bereits mit dem alten Chiffrierschlüssel mit der Datenbank verbunden
sein, bevor diese Änderung durchgeführt wird.
Achtung
Wenn der Schlüssel geändert wird, wird jede Zeile in der Datenbank
mit dem alten Schlüssel entschlüsselt und mit dem neuen Schlüssel neu
verschlüsselt. Dieser Vorgang kann nicht rückgängig gemacht werden.
Wenn die Anwendung während des Vorgangs unterbrochen wird, ist die
Datenbank beschädigt und es kann nicht mehr auf sie zugegriffen werden.
Es muss nun eine neue Datenbank erstellt werden.
❖ So ändern Sie die Verschlüsselung für eine UltraLite-Datenbank
1. Rufen Sie die Funktion changeEncryptionKey für das Datenbankobjekt
auf und geben Sie den neuen Schlüssel als Argument an.
db.changeEncryptionKey( "new key" );
43

UltraLite-Datenbanken defragmentieren
44
☞ Weitere Hinweise finden Sie unter “changeEncryptionKey-Methode”
auf Seite 69.
Der UltraLite-Speicher ist so angelegt, dass er freien Speicherplatz effizient
wiederverwendet, sodass unter normalen Umständen keine explizite
Defragmentierung erforderlich ist. Dieser Abschnitt beschreibt ein
Verfahren, mit dem UltraLite-Datenbanken explizit defragmentiert werden
können, um sie für Anwendungen mit besonders strengen
Speicherplatzanforderungen zu verwenden.
UltraLite verfügt über eine schrittweise Defragmentierungsfunktion, die
einen kleinen Teil der Datenbank defragmentiert. Um die gesamte
Datenbank gleichzeitig zu defragmentieren, rufen Sie die schrittweise
Defragmentierungsfunktion in einer Schleife auf, bis sie ul_true zurückgibt.
Dies kann ein kostenträchtiger Vorgang sein. SQLCODE muss überprüft
werden, um mögliche Fehler festzustellen (ein Fehler hier weist gewöhnlich
auf einen Datei-I/O-Fehler hin).
Die explizite Defragmentierung wird während der Leerlaufzeit schrittweise
und unter der Steuerung der Anwendung ausgeführt. Jeder Schritt ist ein
kleiner Vorgang.
☞ Weitere Hinweise finden Sie unter “JdbcDefragIterator-Klasse” auf
Seite 71.
❖ So defragmentieren Sie eine UltraLite-Datenbank
1. Verwandeln Sie eine Verbindung (Connection) in ein
JdbcConnection-Objekt. Beispiel:
...
Connection conn = db.connect();
JdbcConnection jconn = (JdbcConnection)conn ;
UltraLite verfügt über eine schrittweise Defragmentierungsfunktion, die
einen kleinen Teil der Datenbank defragmentiert. Um die gesamte
Datenbank gleichzeitig zu defragmentieren, rufen Sie die schrittweise
Defragmentierungsfunktion in einer Schleife auf, bis sie ul_true
zurückgibt. Dies kann ein kostenträchtiger Vorgang sein. SQLCODE
muss überprüft werden, um mögliche Fehler festzustellen (ein Fehler hier
weist gewöhnlich auf einen Datei-I/O-Fehler hin).
2. Rufen Sie getDefragIterator() auf, um ein JdbcDefragIterator-Objekt
zu erhalten. Beispiel:
JdbcDefragIterator defrag = jconn.getDefragIterator();

Kapitel 3. Datenzugriff über Static Java-API
3. Während der Leerlaufzeit rufen Sie ulStoreDefragStep() auf, um einen
Teil der Datenbank zu defragmentieren.
defrag.ulStoreDefragStep();
45

Anwendungen eine Synchronisationsfunktion
hinzufügen
Bei der Synchronisation handelt es sich um eine der wichtigsten Funktionen
vieler UltraLite-Anwendungen. Dieser Abschnitt beschreibt, wie Sie Ihrer
Anwendung eine Synchronisationsfunktion hinzufügen.
Die Synchronisationslogik, die UltraLite-Anwendungen mit der
konsolidierten Datenbank abstimmt, ist nicht in der Anwendung selbst
gespeichert. Synchronisationsskripten in der konsolidierten Datenbank
steuern zusammen mit dem MobiLink-Synchronisationsserver und der
UltraLite-Laufzeitbibliothek, wie Änderungen beim Senden verarbeitet
werden und welche Änderungen eingelesen werden.
Überblick Die Details der einzelnen Synchronisationen werden von einer Reihe von
Synchronisationsparametern gesteuert. Diese Parameter werden in einem
Objekt zusammengefasst, das als Argument im Aufruf einer
Synchronisationsfunktion bereitgestellt wird. Die Methode ist bei allen
Entwicklungsmodellen gleich.
Synchronisationsparameter
46
❖ So fügen Sie Ihrer Anwendung die Synchronisationsfunktion hinzu
1. Initialisieren Sie das Objekt, das die Synchronisationsparameter enthält.
☞ Weitere Hinweise finden Sie unter “Synchronisationsparameter
initialisieren” auf Seite 47.
2. Weisen Sie die Parameterwerte für Ihre Anwendung zu.
☞ Hinweise dazu finden Sie unter “Netzwerkprotokolloptionen für
UltraLite-Synchronisationsclients” [MobiLink Clients, Seite 371].
3. Rufen Sie die Synchronisationsfunktion auf und geben Sie die Struktur
bzw. das Objekt als Argument an.
☞ Weitere Hinweise finden Sie unter “Synchronisation aufrufen” auf
Seite 48.
Sie müssen sicherstellen, dass keine noch nicht festgeschriebenen
Änderungen vorhanden sind, wenn Sie synchronisieren. Weitere Hinweise
finden Sie unter “Alle Änderungen vor der Synchronisation festschreiben”
auf Seite 50.
Die Einzelheiten der Synchronisation werden durch eine Reihe von
Synchronisationsparametern gesteuert. Weitere Hinweise zu diesen
Parametern finden Sie unter “Netzwerkprotokolloptionen für
UltraLite-Synchronisationsclients” [MobiLink Clients, Seite 371].

Synchronisationsparameter initialisieren
Kapitel 3. Datenzugriff über Static Java-API
Die Synchronisationsparameter werden in einem Java-Objekt gespeichert.
Die Details einer Synchronisation, einschließlich des URLs und des
MobiLink-Synchronisationsservers, der zu verwendenden Skriptversion, des
MobiLink-Benutzernamens usw., werden in einem UlSynchOptions-Objekt
gespeichert.
☞ Eine komplette Liste der Synchronisationsparameter finden Sie unter
“Synchronisationsparameter” auf Seite 74.
❖ So initialisieren Sie die Synchronisationsparameter
1. Erstellen Sie ein UlSynchOptions-Objekt. Zum Beispiel:
UlSynchOptions opts = new UlSynchOptions();
2. Definieren Sie die erforderlichen Parameter.
Synchronisationsparameter festlegen
Das Objekt UlSynchOptions() verfügt über eine Gruppe von Methoden
zum Festsetzen und Abfragen von Feldern: Eine Liste finden Sie unter
“Synchronisationsparameter” [MobiLink Clients, Seite 344]. Verwenden Sie
diese Methoden, um die erforderlichen Synchronisationsparameter vor
der Synchronisation festzulegen. Zum Beispiel:
opts.setUserName( "50" );
opts.setScriptVersion( "default" );
opts.setStream( new UlSocketStream() );
Die Synchronisationsdatenströme für UltraLite-Java-Anwendungen sind
Objekte und werden von ihren Konstruktoren festgesetzt. Folgende
Datenströme sind verfügbar:
♦ UlSocketStream TCP/IP-Synchronisation
♦ UlSecureSocketStream TCP/IP-Synchronisation mit Certicom
Ellipsenkurven-Transportschichtsicherheit.
♦ UlSecureRSASocketStream TCP/IP-Synchronisation mit Certicom
RSA-Transportschichtsicherheit.
♦ UlHTTPStream HTTP-Synchronisation.
♦ UlHTTPSStream HTTPS-Synchronisation.
47

Synchronisation aufrufen
48
Folgende Zeile setzt den Datenstrom auf TCP/IP:
synch_opts.setStream( new UlSocketStream() );
☞ Weitere Hinweise finden Sie unter “Synchronisationsparameter”
[MobiLink Clients, Seite 344].
Getrennt lizenzierbare Option erforderlich
Die Nutzung von UlHTTPSStream, UlSecureSocketStream und UlSecureRSASocketStream
erfordert die Certicom-Technologie, die wiederum
voraussetzt, dass Sie die getrennt lizenzierbare SQL Anywhere Studio-
Sicherheitsoption erwerben, und ist außerdem Exportbeschränkungen unterworfen.
Weitere Hinweise zu dieser Option finden Sie unter “Willkommen
bei SQL Anywhere Studio” [SQL Anywhere Studio Erste Orientierung,
Seite 4].
☞ Weitere Hinweise zu den einzelnen Parametern finden Sie unter
“Netzwerkprotokolloptionen für UltraLite-Synchronisationsclients”
[MobiLink Clients, Seite 371].
Wenn Sie die Synchronisationsparameter initialisiert haben und sie auf die
für Ihre Anwendung zutreffenden Werte setzen, können Sie die
Synchronisation mithilfe der Methode JdbcConnection.synchronize()
einleiten.
Die Methode hat das Objekt UlSynchOptions als Argument. Die Aufrufe
für die Synchronisation lauten wie folgt:
UlSynchOptions opts = new UlSynchOptions();
opts.setUserName( "50" );
opts.setScriptVersion( "default" );
opts.setStream( new UlSocketStream() );
opts.setStreamParms( "host=123.45.678.90" );
conn.synchronize( opts );
Wie die Synchronisation im Einzelnen aufgerufen wird, hängt von der
Zielplattform und vom Synchronisationsdatenstrom ab.
Der Synchronisationsprozess kann nur korrekt ablaufen, wenn das Gerät, auf
dem die UltraLite-Anwendung ausgeführt wird, mit dem
Synchronisationsserver kommunizieren kann. Auf einigen Plattformen
bedeutet das, dass Sie das Gerät physisch verbinden müssen, indem Sie es in
seine Dockingstation setzen oder mit einem Kabel an einen Server
anschließen. Sie müssen in Ihrer Anwendung für den Fall, dass die
Synchronisation nicht ausgeführt werden kann, einen

Fehlerbehandlungscode einfügen.
Kapitel 3. Datenzugriff über Static Java-API
❖ So rufen Sie die Synchronisation auf (TCP/IP-, HTTP- oder
HTTPS-Datenströme)
1. Konstruieren Sie ein neues ULSynchInfo-Objekt, um die
Synchronisationsparameter zu initialisieren, und
JdbcConnection.synchronize(), um zu synchronisieren. Siehe
“Anwendungen eine Synchronisationsfunktion hinzufügen” auf Seite 46.
Der Synchronisationsaufruf setzt eine Struktur voraus, die eine Gruppe von
Parametern enthalten kann, die die Details der Synchronisation beschreiben.
Die einzelnen Parameter sind vom jeweiligen Datenstrom abhängig.
Transportschichtsicherheit verwenden
Um zusätzliche Sicherheit während der Synchronisation zu erhalten, können
Sie die Verschlüsselungsnachrichten der Transportschichtsicherheit nutzen,
wenn sie zwischen der UltraLite-Anwendung und der konsolidierten
Datenbank ausgetauscht werden.
☞ Weitere Hinweise zur Verschlüsselungstechnik finden Sie unter
“MobiLink-Transportschichtsicherheit” [MobiLink Administrationshandbuch,
Seite 183].
☞ Die Transportschichtsicherheit von UltraLite-Java-Clientanwendungen
verwendet einen separaten Synchronisationsdatenstrom. Sie müssen Ihren
MobiLink-Synchronisationsserver ebenso wie Ihren UltraLite-Client
einrichten, um diesen Synchronisationsdatenstrom zu verwenden.
Clientänderungen ☞ Auf dem Client wählen Sie den Synchronisationsdatenstrom
UlSecureSocketStream oder UlSecureRSASocketStream und geben eine
Gruppe von Datenstromparametern an. Die Datenstromparameter umfassen
Parameter, die die Sicherheit steuern.
Legen Sie den Parameter wie folgt fest:
UlSynchOptions opts = new UlSynchOptions();
opts.setStream(new UlSecureSocketStream() );
opts.setStreamParms( "host=myserver;"
+ "port=2439;"
+ "certificate_company=Sybase Inc.;"
+ "certificate_unit="MEC;"
+ "certificate_name=Mobilink");
// set other options here
conn.synchronize( opts );
☞ Weitere Hinweise zu den Datenstromparametern finden Sie unter
“UlSecureSocketStream-Synchronisationsparameter” [MobiLink Clients,
49

MobiLink-Server
einrichten
Seite 380].
Da die sicheren Synchronisationsdatenströme für Java-Anwendungen
separate Datenströme sind, müssen Sie sicherstellen, dass der
MobiLink-Synchronisationsserver sie erkennt. Um dies zu erreichen,
müssen Sie die Synchronisationsdatenströme java_certicom_tls oder
java_rsa_tls angeben, je nach der Wahl des Clients.
Folgende Befehlszeile ist ein Beispiel hierfür:
dbmlsrv9 -x java_certicom_
tls(certificate=mycertificate.crt;port=1234)
Die Sicherheitsparameter für die java_certicom_tls- und
java_rsa_tls-Datenströme lauten wie folgt:
♦ certificate Der Name der Zertifikatsdatei, die die Serveridentität
enthält. Die Datei muss neben dem Zertifikat des Servers die Zertifikate
aller Zetrifikatsautoritäten in der Zertifikatssignaturkette und den privaten
Schlüssel des Servers enthalten.
Der Zertifikatsparameter ist standardmäßig sample.crt für
java_certicom_tls und rsaserver.crt für java_rsa_tls, welche die
Standardidentität für MobiLink ist. Diese Dateien sind mit
SQL Anywhere Studio in demselben Verzeichnis wie der
MobiLink-Server verfügbar.
♦ certificate_password Das Kennwort, das für die Verschlüsselung des
privaten Schlüssels in der Zertifikatsdatei verwendet wird.
Der Standardwert ist das Kennwort für den privaten Schlüssel in
sample.crt und rsaserver.crt, und zwar ist es test.
Alle Änderungen vor der Synchronisation festschreiben
Eine UltraLite-Datenbank darf keine noch nicht festgeschriebenen
Änderungen enthalten, wenn sie synchronisiert wird. Wenn Sie versuchen,
eine UltraLite-Datenbank zu synchronisieren, wenn eine Verbindung eine
noch nicht festgeschriebene Transaktion enthält, schlägt die Synchronisation
fehl. Außerdem wird eine Ausnahmebedingung erzeugt und der Fehler
SQLE_UNCOMMITTED_TRANSACTIONS protokolliert. Dieser
Fehlercode erscheint im MobiLink-Serverlog für die Synchronisation.
☞ Hinweise zur Synchronisation mit reinem Download finden Sie unter
“Synchronisationsparameter “Download only”” [MobiLink Clients, Seite 348].
Ausgangsdaten in die Anwendung einfügen
50
Viele UltraLite-Anwendungen benötigen Daten, um damit arbeiten zu

Kapitel 3. Datenzugriff über Static Java-API
können. Sie können Daten in Ihre Anwendung einlesen, indem Sie sie
synchronisieren. Sie sollten in Ihre Anwendung eine entsprechende Logik
aufnehmen, um sicherzustellen, dass bei ihrem ersten Aufruf und vor allen
anderen Aktionen alle erforderlichen Daten eingelesen werden.
Entwicklungstipp
Es ist einfacher, Fehler zu finden, wenn Sie eine Anwendung in verschiedenen
Stufen entwickeln. Bei der Entwicklung eines Prototyps sollten Sie
vorübergehend INSERT-Anweisungen in Ihre Anwendung einfügen, um
Daten für Test- und Vorführzwecke bereitzustellen. Wenn Ihr Prototyp
einwandfrei arbeitet, aktivieren Sie die Synchronisation und entfernen die
temporären INSERT-Anweisungen.
Erweiterte Hinweise zur Entwicklung von Synchronisationen finden Sie
unter “Entwicklungstipps” [MobiLink Administrationshandbuch, Seite 51].
Synchronisation überwachen und abbrechen
Synchronisation
überwachen
Dieser Abschnitt beschreibt, wie Sie die Synchronisation von
UltraLite-Anwendungen aus überwachen und abbrechen können.
♦ Eine API-Schnittstelle zur Überwachung des Synchronisationsfortschritts
und zum Abbruch der Synchronisation.
♦ Eine Komponente zur Anzeige des Fortschritts, die die Schnittstelle
implementiert und die Sie zu Ihrer Anwendung hinzufügen können.
Um die Synchronisation zu überwachen, schreiben Sie eine Klasse, die die
UlSynchObserver-Schnittstelle implementiert. Diese Schnittstelle enthält
eine einzige Methode:
void updateSynchronizationStatus( UlSynchStatus status )
♦ Registrieren Sie Ihr UlSynchObserver-Objekt mithilfe der
UlSynchOptions-Klasse.
♦ Rufen Sie die Methode synchronize() auf, um zu synchronisieren.
♦ UltraLite ruft die Methode updateSynchronizationStatus Ihrer
Beobachtungsklasse auf, wenn sich der Synchronisationsstatus ändert. Im
folgenden Abschnitt wird der Synchronisationsstatus beschrieben.
Nachstehend wird eine typische Sequenz von Anweisungen zur
Synchronisation gezeigt. In diesem Beispiel implementiert die Klasse
MyObserver die UlSynchObserver-Schnittstelle:
51

UlSynchObserver observer = new MyObserver ();
UlSynchOptions opts = new UlSynchOptions();
// set options
opts.setUserName( "mluser" );
opts.setPassword( "mlpwd" );
opts.setStream( new UlSocketStream() );
opts.setStreamParms( "localhost" );
opts.setObserver( observer );
opts.setUserData( myDataObject );
// synchronize
conn.synchronize( opts );
Informationen über den Synchronisationsstatus verarbeiten
52
In der Klasse, die UlSynchObserver implementiert, enthält das
UlSynchStatus-Objekt Informationen zum Synchronisationsstatus. Dieses
Objekt wird von UltraLite jedesmal mit Informationen über den
Synchronisationsstatus gefüllt, wenn die Methode
updateSynchronizationStatus aufgerufen wird.
Das Objekt UlSynchStatus enthält folgende Methoden:
int getState()
int getTableCount()
int getTableIndex()
Object getUserData()
UlSynchOptions getSynchOptions()
UlSqlStmt getStatement()
int getErrorCode()
boolean isOKToContinue()
void cancelSynchronization()
♦ getState Einer der folgenden Statuswerte:
• STARTING Es wurden noch keine Synchronisationsaktionen
unternommen.
• CONNECTING Der Synchronisationsdatenstrom wurde erstellt, aber
noch nicht geöffnet.
• SENDING_HEADER Der Synchronisationsdatenstrom wurde
geöffnet und der Header wird demnächst gesendet.
• SENDING_TABLE Es wird gerade eine Tabelle gesendet.
• SENDING_DATA Schemainformationen oder Daten werden
gesendet.
• FINISHING_UPLOAD Die Upload-Phase ist beendet und eine
Festschreibung wird ausgeführt.
• RECEIVING_UPLOAD_ACK Es wird gerade eine Bestätigung
darüber empfangen, dass der Sendevorgang abgeschlossen wurde.

Kapitel 3. Datenzugriff über Static Java-API
• RECEIVING_TABLE Es wird gerade eine Tabelle empfangen.
• SENDING_DATA Schemainformationen oder Daten werden
empfangen.
• COMMITTING_DOWNLOAD Die Download-Phase ist beendet und
eine Festschreibung wird ausgeführt.
• SENDING_DOWNLOAD_ACK Es wird gerade eine Bestätigung
gesendet, dass der Empfangsvorgang abgeschlossen wurde.
• DISCONNECTING Der Synchronisationsdatenstrom wird demnächst
geschlossen.
• DONE Die Synchronisation wurde erfolgreich abgeschlossen.
• ERROR Die Synchronisation wurde abgeschlossen, jedoch mit
einem Fehler.
☞ Eine Beschreibung des Synchronisationsprozesses finden Sie unter
“Der Synchronisationsprozess” [MobiLink Administrationshandbuch,
Seite 15].
♦ getTableCount Gibt die Anzahl der Tabellen an, die synchronisiert
werden. Für jede Tabelle gibt es eine Sende- und Empfangsphase, daher
kann diese Zahl höher sein als die Anzahl der synchronisierten Tabellen.
♦ getTableIndex Die Tabelle, für die gerade ein Upload oder Download
läuft, beginnend bei 0. Diese Zahl kann Werte überspringen, wenn nicht
alle Tabellen synchronisiert werden.
♦ getSynchOptions Gibt das UlSynchOptions-Objekt zurück
♦ sent.inserts Die Anzahl der bisher eingefügten heraufgeladenen
Zeilen.
♦ sent.updates Die Anzahl der bisher aktualisierten heraufgeladenen
Zeilen.
♦ sent.deletes Die Anzahl der bisher gelöschten heraufgeladenen Zeilen.
♦ sent.bytes Die Anzahl der Byte, die bisher heraufgeladen wurden.
♦ received.inserts Die Anzahl der bisher eingefügten heruntergeladenen
Zeilen.
♦ received.updates Die Anzahl der bisher aktualisierten
heruntergeladenen Zeilen.
♦ received.deletes Die Anzahl der bis dahin gelöschten
heruntergeladenen Zeilen.
53

♦ received.bytes Die Anzahl der Bytes, die bisher heruntergeladen
wurden.
♦ cancelSynchronization Setzen Sie dieses Mitglied auf TRUE, um die
Synchronisation zu unterbrechen. Die SQL-Ausnahmebedingung
SQLE_INTERRUPTED wird gesetzt, und die Synchronisation wird
gestoppt, als ob ein Kommunikationsfehler aufgetreten wäre. Der
Beobachter wird immer entweder mit dem Zustand DONE oder ERROR
aufgerufen, sodass er richtig aufräumen kann.
♦ getUserData Gibt das Benutzerdatenobjekt zurück
♦ getStatement Gibt die Anweisung zurück, die die Synchronisation
aufgerufen hat. Die Anweisung ist eine interne UltraLite-Anweisung, und
es ist unwahrscheinlich, dass diese Methode von praktischem Nutzen ist.
Sie wurde nur der Vollständigkeit halber eingeschlossen.
♦ getErrorCode Wenn der Synchronisationstatus auf ERROR gesetzt ist,
gibt diese Methode einen Diagnosefehlercode zurück.
♦ isOKToContinue Wird auf false gesetzt, wenn cancelSynchronization
aufgerufen ist. Andernfalls erscheint true.
Beispiel Der folgende Codeausschnitt zeigt eine sehr einfache Beobachtungsfunktion:
void updateSynchronizationStatus( UlSynchStatus status )
{
int state = status.getState();
System.out.println( "Sync status: " + state );
if( state == UlSynchStatus.SENDING_TABLE ||
state == UlSynchStatus.RECEIVING_TABLE ){
System.out.println( "send/receive table " +
( status.getTableIndex() + 1 ) +
" of " + status.getTableCount() );
}
}
CustDB-Beispiel Die Beispielanwendung “CustDB” enthält ein Beispiel einer
Beobachtungsfunktion. Die Implementierung in “CustDB” umfasst ein
Dialogfeld, das den Verarbeitungsfortschritt der Synchronisation anzeigt und
dem Benutzer gestattet, die Synchronisation abzubrechen. Durch die
Komponente für die Benutzeroberfläche wird die Beobachtungsfunktion
plattformspezifisch.
54
Der Beispielcode von “CustDB” befindet sich im Unterverzeichnis
Samples\UltraLite\CustDB Ihres SQL Anywhere-Verzeichnisses. Die
Beobachtungsfunktion befindet sich in den plattformspezifischen
Unterverzeichnissen des CustDB-Verzeichnisses.

Die Fortschrittsanzeige verwenden
Kapitel 3. Datenzugriff über Static Java-API
Die UltraLite Laufzeit-Bibliothek umfasst zwei Fortschrittsanzeigeklassen,
die die Implementierung des Monitorings der Synchronisation
gewährleisten, sowie dem Endanwender die Möglichkeit einräumen, die
Synchronisation zu unterbrechen. Es gibt folgende
Fortschrittsanzeigeklassen:
♦ ianywhere.ultralite.ui.SynchProgressViewer Eine umfassende
AWT-Version
♦ ianywhere.ultralite.ui.JSynchProgressViewer Eine Swing-Version
des Beobachters, die das Swing Threading-Model berücksichtigt
Die beiden Klassen werden gleich verwendet. Der Betrachter zeigt ein
modales oder modusfreies Dialogfeld an, das eine Reihe von Meldungen
und einen Balken zu Fortschrittsanzeige beinhaltet. Sowohl die Meldungen
als auch die Fortschrittsanzeige werden während der Synchronisation
aktualisiert. Der Betrachter verfügt auch über eine Schaltfläche
“Abbrechen”. Wenn der Benutzer die Schaltfläche “Abbrechen” drückt, wird
die Synchronisation angehalten und die SQL-Ausnahme
SQLE_INTERRUPTED ausgelöst.
Thread-Themen Bei einer Java-Anwendung geschehen alle Ereignisse auf einem einzigen
Thread, dem Event Thread. Auch alle Objekte der Benutzeroberfläche
werden auf dem Event Thread erstellt, selbst wenn die Anwendung zu dieser
Zeit auf einem anderen Thread arbeitet. Es gibt nur einen Event Thread je
Anwendung.
Modalbetrachter
anzeigen
Der Event Thread darf nie blockieren. Daher sollten Sie keine zu langen
Vorgänge auf dem Event Thread ausführen, da dies zu Painter-Fehlern führt.
Selbst das Aufrufen der show()-Methode in einem modalen Dialogfeld hält
die Ausführung des Event Threads an. Sie sollten daher auf jeden Fall
vermeiden, die synchronize()-Methode auf dem Event Thread aufzurufen.
Der folgende Codeausschnitt illustriert, wie eine Modalinstanz des
Betrachters aufgerufen wird. Die import-Anweisung verwendet folgende
AWT-Version:
55

Modusfreien Betrachter
anzeigen
import ianywhere.ultralite.ui.SynchProgressViewer;
// create a frame to display a dialog
java.awt.Frame frame = ...;
// get UltraLite connection
Connection conn = ...;
// set synchronization options
UlSynchOptions options = new UlSynchOptions();
options.setUserName( "my_user" );
...
// create the viewer
SynchProgressViewer viewer = new SynchProgressViewer( frame );
viewer.synchronize( frame, options );
// execution stops here until synchronization is complete
Wenn der Betrachter auf diese Weise aufgerufen wurde, führt er folgende
Vorgänge aus:
1. Er registriert sich selbst als Synchronisationsbeobachter.
2. Er stößt einen Thread zur Synchronisation an.
3. Er zeigt sich an und blockiert den aktuellen Thread.
4. Wenn die Synchronisation zu Ende ist, beseitigt der Beobachter das
Dialogfeld, sodass der Thread fortgesetzt werden kann.
Der folgende Codeausschnitt veranschaulicht, wie eine modusfreie Instanz
des Betrachters aufgerufen wird.
SynchProgressViewer viewer = new SynchProgressViewer( frame,
false );
options.setObserver( viewer );
conn.synchronize( options );
In diesem Fall müssen Sie sicherstellen, dass die Synchronisation auf einem
anderen als dem Event Thread erfolgt, sodass der Betrachter nicht blockiert
wird.
Hinweise ♦ Alle Meldungen stammen aus dem SynchProgressViewerResources
Ressourcenpaket.
56
♦ Der Betrachter implementiert die UlSynchObserver-Schnittstelle, sodass
er in den Synchronisationsprozess einsteigen kann.
♦ Die CustDB-Beispielanwendung beinhaltet eine Fortschrittsanzeige. Der
Beispielcode von “CustDB” befindet sich im Unterverzeichnis
UltraLite\samples\CustDB\java Ihres SQL Anywhere-Verzeichnisses.

Kapitel 3. Datenzugriff über Static Java-API
Hinweise zur UltraLite Static Java-Entwicklung
Dieser Abschnitt enthält Hinweise zur Entwicklung von UltraLite Static
Java-Anwendungen.
UltraLite Static Java-Applets erstellen
Applet in eine
HTML-Seite einbeziehen
Wenn Sie Ihr JDBC-Programm als Applet erstellen, kann Ihre Anwendung
nur mit dem Rechner synchronisieren, von dem das Applet geladen wird.
Dabei handelt es sich gewöhnlich um den HTML-Rechner selbst.
Im Folgenden finden Sie ein Beispiel einer HTML-Seite, mit der ein
UltraLite-Applet erstellt wird:
Die Applet-Marke legt Folgendes fest:
♦ Die Klasse, die das Applet startet:
code="CustDbApplet.class"
♦ Die Größe des Fensters im Webbrowser, in dem das Applet angezeigt
wird.
width=440 height=188
♦ Die Zip-Dateien, die erforderlich sind, um das Applet auszuführen.
archive="custdb.zip,ulrt.jar"
In diesem Fall sind die Datei custdb.zip und die Zip-Datei der
UltraLite-Laufzeitdatenbank nötig, um die UltraLite-Beispielanwendung
“CustDB” auszuführen.
57

UltraLite Static Java-Anwendungen erstellen
Dieser Abschnitt behandelt folgende Themen:
♦ “UltraLite Static Java-Klassen generieren” auf Seite 58
♦ “UltraLite Static Java-Anwendungen kompilieren” auf Seite 59
UltraLite Static Java-Klassen generieren
Wenn Sie eine Referenzdatenbank vorbereitet, ein UltraLite-Projekt für Ihre
Anwendung festgelegt und SQL-Anweisungen hinzugefügt haben, um Ihre
Datenzugriffsfunktionen festzulegen, enthält Ihre Referenzdatenbank alle
Informationen, die der Generator braucht.
☞ Weitere Hinweise zum UltraLite-Generator finden Sie unter
“UltraLite-Datenzugriffscode generieren” [UltraLite Datenbankhandbuch,
Seite 224]. Befehlszeilenoptionen finden Sie unter “Der UltraLite-Generator”
[UltraLite Datenbankhandbuch, Seite 99].
Die Ausgabe des Generators ist eine Java-Quelldatei mit einem von Ihnen
gewählten Dateinamen. Abhängig von der Struktur Ihrer Datenbank und der
Komplexität der Datenbankfunktionalität, die Ihre Anwendung erfordert,
kann diese Datei in Größe und Inhalt sehr unterschiedlich sein.
Abhängig von der Art Ihrer Anwendung gibt es mehrere Möglichkeiten, die
Ausgabe des UltraLite-Generators anzupassen.
Überblick Sie generieren die Klassen, indem Sie den UltraLite-Generator mit der
Referenzdatenbank starten.
Häufige Befehlszeilenkombinationen
58
❖ So starten Sie den UltraLite-Generator
1. Geben Sie folgenden Befehl an einer Eingabeaufforderung ein:
ulgen -c "connection-string" options
Dabei gilt: Die Optionen sind von den Projektgegebenheiten abhängig.
Wenn Sie Java-Code generieren, können Sie eine Reihe von Optionen
angeben:
♦ -t java Java-Code generieren. Der Generator ist dasselbe Tool, das für
die C/C++-Entwicklung verwendet wird. Diese Option wird daher bei der
Verwendung von Java immer eingesetzt.
♦ -i Einige Java-Compiler unterstützen interne Klassen nicht korrekt. Das
Standardverhalten des Generators ist, keinen Java-Code zu generieren,
der innere Klassen einbezieht. Wenn Sie einen Compiler verwenden
wollen, der interne Klassen unterstützt, verwenden Sie diese Option.

Kapitel 3. Datenzugriff über Static Java-API
♦ -p Die generierten Klassen werden gewöhnlich in ein Paket einbezogen,
das andere Klassen Ihrer Anwendung enthalten kann. Mit dieser Option
können Sie den Generator anweisen, einen Paketnamen für die Klassen in
den generierten Dateien einzubeziehen.
♦ -s Zusätzlich zum Code für die Ausführung der SQL-Anweisungen
generieren Sie mit dieser Option die SQL-Anweisungen selbst als
Schnittstelle. Ohne diese Option werden die Zeichenfolgen als Mitglied
der Datenbankklasse erstellt.
♦ -a Mit dieser Option werden die Namen der SQL-Zeichenfolgen in
Großbuchstaben gesetzt. Wenn Sie die Option -a wählen, wird der
Bezeichner in der generierten Datei, der die einzelnen SQL-Anweisungen
repräsentiert, von dem Namen abgeleitet, den Sie der Anweisung
gegeben haben, als Sie sie der Datenbank hinzugefügten. In Java gibt es
die Konvention, Konstante in Großbuchstaben zu schreiben. Da die
SQL-Zeichenfolgen in Ihrem Java-Code Konstante sind, diese Option
verwenden, um Bezeichner für Zeichenfolgen zu generieren, die der
allgemeinen Konvention entsprechen.
Beispiel: ♦ Folgender Befehl (der auf einer einzigen Zeile stehen muss) generiert
z.B. den Code, der die SQL-Anweisung im Projekt CustDemo
repräsentiert, sowie das erforderliche Datenbankschema. Die Ausgabe
wird in die Datei uldemo.java geschrieben.
ulgen -c "dsn=Ultralite 9.0 Sample;uid=DBA;pwd=SQL"
-a -t java -s IStatements CustDemo uldemo.java
UltraLite Static Java-Anwendungen kompilieren
❖ So kompilieren Sie die generierte Datei
1. Setzen Sie Ihren Klassenpfad:
Wenn Sie Ihre UltraLite Static Java-Anwendung kompilieren, muss der
Java-Compiler Zugriff auf folgende Klassen haben:
♦ Die Java-Laufzeitklassen.
♦ Die UltraLite-Laufzeitklassen
♦ Die Zielklassen (gewöhnlich im aktuellen Verzeichnis)
Folgender Klassenpfad liefert Zugriff auf diese Klassen:
%JAVA_HOME%\jre\lib\rt.jar;%ASANY9%\ultralite\java\lib\
ulrt.jar;.
Dabei gilt: JAVA_HOME repräsentiert Ihr Java-Installationsverzeichnis
und ASANY9 Ihr SQL Anywhere-Installationsverzeichnis.
59

Bei der JDK 1.1-Entwicklung befindet sich ulrt.jar im Unterverzeichnis
jdk11\lib des Verzeichnisses UltraLite\java.
2. Kompilieren Sie die Klassen:
Wenn der Klassenpfad wie in Schritt 1 angegeben gesetzt ist, verwenden
Sie javac und geben folgenden Befehl ein (in einer einzigen Zeile):
javac file.java
Java-Anwendungen bereitstellen
60
Der Compiler erstellt die Klassendateien für file.java.
Der Kompilierungsschritt erstellt eine Reihe von Klassendateien. Sie müssen
alle generierten .class-Dateien beim Bereitstellen Ihrer Anwendung
einbeziehen.
Ihre UltraLite-Anwendung besteht aus folgenden Elementen:
♦ Von Ihnen erstellte Klassendateien zum Implementieren Ihrer
Anwendung
♦ Generierte Klassendateien
♦ Java-Kernklassen (rt.jar)
♦ JAR-Datei der UltraLite-Laufzeitdatenbank (ulrt.jar)
Sie können Ihre UltraLite-Anwendung auf eine beliebige angemessene
Weise bereitstellen. Sie können diese Klassendateien z.B. in einer JAR-Datei
zusammenpacken, um die Systemeinführung zu vereinfachen.
Ihre UltraLite-Anwendung initialisiert automatisch ihre eigene Datenbank,
wenn sie zum ersten Mal aufgerufen wird. Zunächst enthält die Datenbank
keine Daten. Sie können Ihrer Anwendung Daten explizit mit
INSERT-Anweisungen hinzufügen oder Daten aus einer konsolidierten
Datenbank durch Synchronisation importieren. Explizite
INSERT-Anweisungen sind besonders nützlich beim Entwickeln von
Prototypen.

KAPITEL 4
UltraLite Static Java API-Referenz
Informationen zu diesem
Kapitel
In diesem Kapitel wird die Static Java API-Schittstelle für UltraLite
beschrieben.
Es werden nur die Bestandteile explizit genannt, die vom JDBC abweichen.
Inhalt Thema: Seite
UltraLite-API-Referenz 62
61

UltraLite-API-Referenz
JDBC-Funktionen in UltraLite
62
Dieser Abschnitt beschreibt Erweiterungen der von UltraLite bereitgestellten
JDBC-Schnittstelle sowie die JDBC-Funktionen, die von UltraLite nicht
unterstützt werden.
Folgende Funktionen und Einschränkungen sind spezifisch für die
Entwicklung von JDBC-UltraLite-Anwendungen.
Die UltraLite Static Java API-Schnittstelle ist auf JDBC 1.2 modelliert und
verfügt zusätzlich über zwei ResultSet-Methoden aus JDBC 2.0:
♦ absolute( ),
♦ afterLast( ),
♦ beforeFirst( ),
♦ first( ),
♦ isAfterLast( ),
♦ isBeforeFirst( ),
♦ isFirst( ),
♦ isLast( ),
♦ last( ),
♦ previous( ),
♦ relative( )
Folgende Funktionen sind mit dem UltraLite-Entwicklungsmodell nicht
kompatibel und werden von UltraLite nicht unterstützt:
♦ Der Metadatenzugriff wird nur begrenzt unterstützt
(Systemtabellenzugriff). Aus diesem Grund kann die
DatabaseMetaData-Schnittstelle nicht verwendet werden. Der
Metadatenzugriff ist auf die Anzahl und den Typ der Spalten begrenzt.
♦ Java-Objekte können nicht in der Datenbank gespeichert werden.
♦ Gespeicherte Prozeduren oder Funktionen werden nicht unterstützt.
♦ Es werden nur statische SQL-Anweisungen unterstützt. Sie müssen der
Datenbank hinzugefügt werden, damit der UltraLite-Generator sie
generieren kann.

Nicht unterstützte JDBC-Methoden
Verbindungsschnittstelle ♦ getCatalog
Kapitel 4. UltraLite Static Java API-Referenz
UltraLite unterstützt die folgenden JDBC 1.2-Methoden nicht. Wenn Sie
versuchen, eines der folgenden Methodenergebnisse zu verwenden, wird
eine SQLException mit einem Herstellercode ausgegeben, der anzeigt, dass
die Funktion in UltraLite nicht unterstützt wird.
♦ getMetaData
♦ getTransactionIsolation
♦ setCatalog
♦ setTransactionIsolation
Ergebnismengen- ♦ getMetaData
Schnittstelle
Anweisungsschnittstelle ♦ cancel
Klasse JdbcConnection
♦ getMaxFieldSize
♦ getMaxRows
♦ setMaxFieldSize
♦ setMaxRows
Paket ianywhere.ultralite.jdbc
Beschreibung Repräsentiert eine UltraLite-Datenbank. Die meisten Methoden werden von
der JDBC-Klasse Connection geerbt. Nicht unterstützte Methoden lösen die
Ausnahmebedingung unsupported feature aus.
countUploadRows-Methode
Prototyp long countUploadRows( int mask, long threshold )
Beschreibung Gibt die Anzahl der Zeilen zurück, die gesendet werden müssen, wenn die
nächste Synchronisation ausgeführt wird.
Mit dieser Funktion können Sie feststellen, ob eine Synchronisation
erforderlich ist.
Parameter mask Eine Gruppe von zu überprüfenden Publikationen. Der Wert 0
entspricht der gesamten Datenbank. Die Gruppe wird als Maske angegeben.
Folgende Maske entspricht z.B. den Publikationen PUB1 und PUB2:
63

UL_PUB_PUB1 | UL_PUB_PUB2
☞ Weitere Hinweise zu Publikationsmasken finden Sie unter
“publication-Synchronisationsparameter” auf Seite 87.
Schwellenwert Ein Wert, der die maximale Anzahl der zu zählenden
Zeilen festlegt und auch die Zeitdauer begrenzt, die dem Aufruf zur
Verfügung steht. Mit dem Wert 0 wird keine Zeitbegrenzung festgelegt. Der
Wert 1 legt fest, ob Zeilen synchronisiert werden müssen.
Rückgabe Die Anzahl der Zeilen für den Upload.
Fehlermeldung java.sql.SQLException
getDatabaseID-Methode
Prototyp public int getDatabaseID( ) throws SQLException
Beschreibung getDatabaseID() gibt die aktuelle Datenbank-ID zurück, die für Global
Autoincrement verwendet wird. Es wird der beim letzten Aufruf von
setDatabaseID festgelegte Wert zurückgegeben oder -1, wenn die ID zuvor
nicht festgelegt wurde.
getDefragIterator-Methode
Prototyp JdbcDefragIterator getDefragIterator( )
Beschreibung Initialisiert einen Defragmentierungs-Wiederholer und gibt ihn zurück
Parameter user_name Der MobiLink-Benutzername. Siehe
“user_name-Synchronisationsparameter” auf Seite 98.
password Das Kennwort für den betreffenden Benutzernamen. Siehe
“password-Synchronisationsparameter” auf Seite 85.
script_version Die Skriptversion. Siehe
“version-Synchronisationsparameter” auf Seite 99.
Stream_defn Der Datenstrom, der für die Synchronisation verwendet
werden soll. Siehe “stream-Synchronisationsparameter” auf Seite 91.
Parms Alle vom Benutzer angegebenen Parameter, die für die
Synchronisation verwendet werden.
☞ Siehe “stream_parms-Synchronisationsparameter” auf Seite 94.
Rückgabe Der Defragmentierungs-Wiederholer
Fehlermeldung java.sql.SQLException
64

Kapitel 4. UltraLite Static Java API-Referenz
Siehe auch “UltraLite-Datenbanken defragmentieren” auf Seite 44
getLastDownloadTimeDate-Methode
Prototyp java.util.Date getLastDownloadTimeDate( int mask )
Beschreibung Gibt den Zeitpunkt an, zu dem die letzten Änderungen in der Ergebnismenge
einer bestimmten Anweisung in einem Download eingelesen wurden.
Parameter mask Eine Gruppe von Publikationen, deren letzter Download-Zeitpunkt
abgefragt wird. Der Wert 0 entspricht der gesamten Datenbank. Die Gruppe
wird als Maske angegeben. Folgende Maske entspricht z.B. den
Publikationen PUB1 und PUB2:
Rückgabe
getLastDownloadTimeLong-Methode
UL_PUB_PUB1 | UL_PUB_PUB2
☞ Weitere Hinweise zu Publikationsmasken finden Sie unter
“publication-Synchronisationsparameter” auf Seite 87.
♦ Der Zeitpunkt, zu dem die Anweisung zum letzten Mal per Download
eingelesen wurde.
Prototyp long getLastDownloadTimeLong( int mask )
Beschreibung Gibt den Zeitpunkt an, zu dem die letzten Änderungen in der Ergebnismenge
einer bestimmten Anweisung in einem Download eingelesen wurden.
Parameter mask Eine Gruppe von Publikationen, deren letzter Download-Zeitpunkt
abgefragt wird. Der Wert 0 entspricht der gesamten Datenbank. Die Gruppe
wird als Maske angegeben. Folgende Maske entspricht z.B. den
Publikationen PUB1 und PUB2:
Rückgabe
getLastIdentity-Methode
UL_PUB_PUB1 | UL_PUB_PUB2
Prototyp long getLastIdentity( )
☞ Weitere Hinweise zu Publikationsmasken finden Sie unter
“publication-Synchronisationsparameter” auf Seite 87.
♦ Der Zeitpunkt, zu dem die Anweisung zum letzten Mal per Download
eingelesen wurde.
Beschreibung Gibt den zuletzt verwendeten Identity-Wert zurück. Diese Funktion
entspricht folgender SQL-Anweisung:
SELECT @@identity
65

Rückgabe Der letzte Identity-Wert
Die Funktion ist im Kontext der globalen automatischen Erhöhung von
Spaltenwerten besonders nützlich.
Siehe auch “Zuletzt zugewiesenen Wert feststellen” [MobiLink Clients, Seite 321]
globalAutoincUsage-Methode
“Globalen Datenbankbezeichner festlegen” [MobiLink Clients, Seite 318]
Prototyp short globalAutoincUsage( )
Beschreibung Gibt den maximalen Zählerprozentwert von Global Autoincrement für alle
Tabellen in der Datenbank zurück. Dieser Wert ist nützlich, um zu
bestimmen, ob eine Datenbank-ID festgelegt werden soll.
Rückgabe Der Prozentwert der globalen Werte für Autoincrement, die verwendet
wurden.
Fehlermeldung java.sql.SQLException
Siehe auch “Spalten mit dem Standardwert GLOBAL AUTOINCREMENT
deklarieren” [MobiLink Clients, Seite 317]
grant-Methode
“setDatabaseID-Methode” auf Seite 67
Prototyp void grant( String user, String password )
Beschreibung Erteilt einem Benutzernamen und seinem Kennwort die Berechtigung, sich
mit einer UltraLite-Datenbank zu verbinden. Damit diese Methode gültig
wird, muss die Benutzerauthentifizierung mit
JdbcSupport.enableUserAuthentication aktiviert sein.
Diese Methode der Zuteilung wird bei JdbcConnection für Anwendungen
eingesetzt, die kein explizites JdbcDatabase-Objekt haben.
Parameter user Eine Zeichenfolge, die bei der Verbindungsaufnahme als
Benutzername eingegeben werden muss.
Rückgabe void
Fehlermeldung java.sql.SQLException
66
password Eine Zeichenfolge, die bei der Verbindungsaufnahme als
Kennwort eingegeben werden muss.

evoke-Methode
Prototyp void revoke( String user )
Kapitel 4. UltraLite Static Java API-Referenz
Beschreibung Entzieht einem Benutzernamen die Berechtigung, sich mit einer
UltraLite-Datenbank zu verbinden. Damit diese Methode gültig wird, muss
die Benutzerauthentifizierung mit JdbcSupport.enableUserAuthentication
aktiviert sein.
Diese Methode der Zuteilung wird bei JdbcConnection für Anwendungen
eingesetzt, die kein explizites JdbcDatabase-Objekt haben.
Parameter user Der Name eines Benutzers, der sich mit der Datenbank nicht mehr
verbinden darf.
Rückgabe void
Fehlermeldung java.sql.SQLException
setDatabaseID-Methode
Prototyp void setDatabaseID( int value )
Beschreibung Legt die Datenbank-ID fest.
Parameter value Der Ganzzahlwert, der als globaler Datenbankbezeichner verwendet
werden soll.
Fehlermeldung java.sql.SQLException
Siehe auch “globalAutoincUsage-Methode” auf Seite 66
synchronize-Methode
Prototyp void synchronize(
java.lang.String user_name,
java.lang.String password,
java.lang.String script_version,
UlStream stream_defn,
java.lang.String parms )
void synchronize(
ianywhere.ultralite.runtime UlSynchOptions opts
)
Beschreibung Synchronisiert Daten mit einem MobiLink-Synchronisationsserver.
Parameter user_name Der MobiLink-Benutzername. Siehe
“user_name-Synchronisationsparameter” auf Seite 98.
67

Fehlermeldung java.sql.SQLException
startSynchronizationDelete-Methode
password Das Kennwort für den betreffenden Benutzernamen. Siehe
“password-Synchronisationsparameter” auf Seite 85.
script_version Die Skriptversion. Siehe
“version-Synchronisationsparameter” auf Seite 99.
stream_defn Der Datenstrom, der für die Synchronisation verwendet
werden soll. Siehe “stream-Synchronisationsparameter” auf Seite 91.
parms Alle vom Benutzer angegebenen Parameter, die für die
Synchronisation verwendet werden.
☞ Siehe “stream_parms-Synchronisationsparameter” auf Seite 94.
opts Ein ULSynchOptions-Objekt. Siehe “Synchronisationsparameter”
auf Seite 74.
Prototyp void startSynchronizationDelete( )
Beschreibung Erneuter Start der Protokollierung der Löschvorgänge für die
MobiLink-Synchronisation.
Fehlermeldung java.sql.SQLException
Siehe auch “START SYNCHRONIZATION DELETE-Anweisung [MobiLink]” [ASA
SQL-Referenzhandbuch, Seite 676]
stopSynchronizationDelete-Methode
Prototyp void stopSynchronizationDelete( )
Beschreibung Verhindert die Protokollierung der Löschvorgänge für die
MobiLink-Synchronisation.
Fehlermeldung java.sql.SQLException
Siehe auch “STOP SYNCHRONIZATION DELETE-Anweisung [MobiLink]” [ASA
SQL-Referenzhandbuch, Seite 683]
JdbcDatabase-Klasse
Paket ianywhere.ultralite.jdbc
Beschreibung Die Klasse JdbcDatabase wird direkt nur für das Verschleiern von
Datenbanken verwendet. Die generierte Datenbankklasse erweitert
JdbcDatabase und stellt ein Objekt bereit, das die UltraLite-Datenbank
68

changeEncryptionKey-Methode
Kapitel 4. UltraLite Static Java API-Referenz
repräsentiert. Die meisten JdbcDatabase-Methoden werden aus der
generierten Datenbankklasse bezogen.
☞ Weitere Hinweise finden Sie unter “Die generierte Datenbankklasse” auf
Seite 71.
Prototyp Connection changeEncryptionKey( )
Beschreibung Ändert die Verschlüsselung für eine UltraLite-Datenbank.
Rückgabe Ein JDBC-Verbindungsobjekt.
Fehlermeldung java.sql.SQLException
Siehe auch “UltraLite-Datenbanken verschlüsseln” auf Seite 41
close-Methode
Prototyp void close( )
Beschreibung Trennt alle Verbindungen zu einer UltraLite-Datenbank. Diese Methode
muss ausgeführt werden, bevor Sie eine UltraLite-Datenbank löschen
können.
Rückgabe void
Fehlermeldung java.sql.SQLException
connect-Methode
Prototyp Connection connect( )
Connection connect( String user, String password )
Connection connect( String user, String password, Properties info )
Beschreibung Stellt eine Verbindung zu einer UltraLite-Datenbank her. Der Benutzername
und sein Kennwort werden nur geprüft, wenn die Benutzerauthentifizierung
mit JdbcSupport.enableUserAuthentication aktiviert wurde.
Parameter user Der Name eines Benutzers, der sich mit der Datenbank verbinden
darf.
password Eine Zeichenfolge, die bei der Verbindungsaufnahme als
Kennwort eingegeben werden muss.
Info Ein Properties-Objekt, das den Benutzernamen und sein Kennwort
enthält.
69

Rückgabe Ein JDBC-Verbindungsobjekt.
Fehlermeldung java.sql.SQLException
drop-Methode
Prototyp void drop( )
Beschreibung Löscht eine UltraLite-Datenbankdatei. Diese Methode mit großer Vorsicht
verwenden. Sie kann nur ausgeführt werden, nachdem die Methode
JdbcDatabase.close() aufgerufen wurde.
Rückgabe void
Fehlermeldung java.sql.SQLException
Siehe auch “close-Methode” auf Seite 69
grant-Methode
Prototyp void grant( String user, String password )
Beschreibung Erteilt einem Benutzernamen und seinem Kennwort die Berechtigung, sich
mit einer UltraLite-Datenbank zu verbinden. Damit diese Methode gültig
wird, muss die Benutzerauthentifizierung mit
JdbcSupport.enableUserAuthentication aktiviert sein.
Parameter user Eine Zeichenfolge, die bei der Verbindungsaufnahme als
Benutzername eingegeben werden muss.
Rückgabe void
Fehlermeldung java.sql.SQLException
revoke-Methode
Prototyp void revoke( String user )
password Eine Zeichenfolge, die bei der Verbindungsaufnahme als
Kennwort eingegeben werden muss.
Beschreibung Entzieht einem Benutzernamen die Berechtigung, sich mit einer
UltraLite-Datenbank zu verbinden. Damit diese Methode gültig wird, muss
die Benutzerauthentifizierung mit JdbcSupport.enableUserAuthentication
aktiviert sein.
Parameter user Der Name eines Benutzers, der sich mit der Datenbank nicht mehr
verbinden darf.
Rückgabe void
70

Fehlermeldung java.sql.SQLException
setDefaultObfuscation-Methode
Prototyp setDefaultObfuscation ( true | false )
Beschreibung Verschleiert die Datenbank
Kapitel 4. UltraLite Static Java API-Referenz
Siehe auch “Eine UltraLite-Datenbank verschleiern” auf Seite 42
Die generierte Datenbankklasse
Beschreibung Die generierte Datenbankklasse erweitert JdbcDatabase. Sie stellt ein
Objekt bereit, das die UltraLite-Datenbank repräsentiert.
JdbcDatabase-Methoden werden in der Regel für die generierte
Datenbankklasse benutzt.
Konstruktor new Datenbankname( Properties Eigenschaften )
Dabei gilt: Datenbankname ist der Name der generierten Datenbankklasse.
Sie können den Klassennamen mithilfe der Befehlszeilenoption -f des
UltraLite-Generators festlegen.
☞ Weitere Hinweise finden Sie unter “Der UltraLite-Generator” [UltraLite
Datenbankhandbuch, Seite 99].
Parameter Eigenschaften Ein Eigenschaftsobjekt, das einige oder alle der folgenden
Elemente enthält:
♦ persist
♦ persistfile
♦ key
JdbcDefragIterator-Klasse
Paket ianywhere.ultralite.jdbc
☞ Weitere Hinweise finden Sie unter “Mit einem Properties-Objekt
Verbindungsinformationen speichern” auf Seite 34.
Beschreibung Stellt ein Objekt bereit, das für die explizite Defragmentierung des
Datenbankspeichers verwendet wird.
ulStoreDefragStep-Methode
Prototyp boolean ulStoreDefragStep( UlConnection conn )
Beschreibung Defragmentiert einen Teil einer UltraLite-Datenbank
71

Parameter conn Die aktuelle Verbindung als JdbcConnection-Objekt.
Rückgabe true , wenn erfolgreich
false , wenn nicht erfolgreich
Fehlermeldung java.sql.SQLException
Siehe auch “STOP SYNCHRONIZATION DELETE-Anweisung [MobiLink]” [ASA
SQL-Referenzhandbuch, Seite 683]
JdbcSupport-Klasse
Paket ianywhere.ultralite.jdbc
Beschreibung Eine statische Klasse, die Methoden bereitstellt, mit denen
UltraLite-Funktionen aktiviert werden können.
enableUserAuthentication-Methode
Prototyp void enableUserAuthentication( )
Beschreibung Richtet die UltraLite-Datenbank so ein, dass die Benutzerauthentifizierung
erforderlich ist, um sich mit ihr zu verbinden. Muss aufgerufen werden,
bevor das Datenbankobjekt erstellt wird.
Parameter Keine.
Rückgabe void
Fehlermeldung java.sql.SQLException
Siehe auch “Beispiel für eine Benutzerauthentifizierung” auf Seite 39
disableUserAuthentication-Methode
Prototyp void disableUserAuthentication( )
Beschreibung Richtet die UltraLite-Datenbank so ein, dass die Benutzerauthentifizierung
nicht erforderlich ist, um sich mit ihr zu verbinden. Muss aufgerufen
werden, bevor das Datenbankobjekt erstellt wird.
Parameter Keine.
Rückgabe void
Fehlermeldung java.sql.SQLException
Siehe auch “enableUserAuthentication-Methode” auf Seite 72
72

KAPITEL 5
Referenz der Synchronisationsparameter
Über dieses Kapitel In diesem Kapitel finden Sie Referenzinformationen zu
Synchronisationsparametern.
Inhalt Thema: Seite
Synchronisationsparameter 74
auth_parms-Synchronisatonsparameter 76
auth_status-Parameter 77
auth_value-Synchronisationsparameter 79
download_only-Synchronisationsparameter 80
ignored_rows-Synchronisationsparameter 81
new_password-Synchronisationsparameter 82
num_auth_parms-Synchronisationsparameter 83
observer-Synchronisationsparameter 84
password-Synchronisationsparameter 85
ping-Synchronisationsparameter 86
publication-Synchronisationsparameter 87
security-Synchronisationsparameter 88
security_parms-Synchronisationsparameter 89
stream-Synchronisationsparameter 91
stream_parms-Synchronisationsparameter 94
upload_ok-Synchronisationsparameter 95
upload_only-Synchronisationsparameter 96
user_data-Synchronisationsparameter 97
user_name-Synchronisationsparameter 98
version-Synchronisationsparameter 99
73

Synchronisationsparameter
74
Die Synchronisationsparameter sind Felder des Objekts
ianywhere.ultralite.runtime.UlSynchOptions. Die Felder sind privat und
Methoden werden bereitgestellt, um ihre Werte abzurufen und zu setzen.
Das Objekt UlSynchOptions wird als Argument im Aufruf an
ianywhere.ultralite.jdbc.JdbcConnection.synchronize übergeben.
Feld Zugriffsmethoden Siehe
auth_status getAuthStatus
setAuthStatus
auth_value getAuthValue
setAuthValue
download_only getDownloadOnly
setDownloadOnly
ignored_rows getIgnoredRows
setIgnoredRows
new_password getNewPassword
setNewPassword
observer getObserver
setObserver
password getPassword
setPassword
ping getPing
setPing
publications getSynchPublication
stream getStream
setSynchPublication
setStream
“auth_status-Parameter” auf Seite
77
“auth_value-
Synchronisationsparameter”
auf Seite 79
“download_only-
Synchronisationsparameter” auf
Seite 80
“ignored_rows-
Synchronisationsparameter”
auf Seite 81
“new_password-
Synchronisationsparameter” auf
Seite 82
“observer-
Synchronisationsparameter”
auf Seite 84
“password-
Synchronisationsparameter”
auf Seite 85
“ping-Synchronisationsparameter”
auf Seite 86
“publication-
Synchronisationsparameter”
auf Seite 87
“stream-
Synchronisationsparameter”
auf Seite 91

Kapitel 5. Referenz der Synchronisationsparameter
Feld Zugriffsmethoden Siehe
stream_parms getStreamParms
setStreamParms
upload_ok getUploadOK
setUploadOK
upload_only getUploadOnly
setUploadOnly
user_data getUserData
setUserData
user_name getUserName
setUserName
version getScriptVersion
setScriptVersion
“stream_parms-
Synchronisationsparameter”
auf Seite 94
“upload_ok-
Synchronisationsparameter”
auf Seite 95
“upload_only-
Synchronisationsparameter”
auf Seite 96
“user_data-
Synchronisationsparameter”
auf Seite 97
“user_name-
Synchronisationsparameter”
auf Seite 98
“version-
Synchronisationsparameter”
auf Seite 99
☞ Eine Beschreibung der Rolle der einzelnen Synchronisationsparameter
finden Sie unter “Synchronisationsparameter” [MobiLink Clients, Seite 344].
75

auth_parms-Synchronisatonsparameter
Funktion Stellt Parameter für ein benutzerdefiniertes Benutzerauthentifizierungsskript
bereit.
Zugriffsmethode String[ ] getAuthParms( )
void setAuthParms( String[ ] AuthParameter )
Anwendung Legen Sie den Parameter wie folgt fest:
ul_char * Params[ 3 ] = { UL_TEXT( "parm1" ),
UL_TEXT( "parm2" ),
UL_TEXT( "parm3" ) };
// ...
info.num_auth_parms = 3;
info.auth_parms = Params;
params = new String[ num_params ];
// set params values
UlSynchOptions opts = new UlSynchOptions;
opts.setAuthParms( params );
opts.setAuthParmsNumber( num_params );
Siehe auch ♦ “Synchronisationsparameter “Authentication Parameters”” [MobiLink
Clients, Seite 344]
♦ “num_auth_parms-Synchronisationsparameter” auf Seite 83
♦ “authenticate_parameters (Verbindungsereignis)” [MobiLink
Administrationshandbuch, Seite 370]
♦ “authenticate_user (Verbindungsereignis)” [MobiLink
Administrationshandbuch, Seite 372]
76

auth_status-Parameter
Kapitel 5. Referenz der Synchronisationsparameter
Funktion Gibt Auskunft über den Status der MobiLink-Benutzerauthentifizierung.
Zugriffsmethode short getAuthStatus( )
void setAuthStatus( short AuthStatus )
Anwendung Greifen Sie wie folgt auf den Parameter zu:
UlSynchOptions opts = new UlSynchOptions;
// set options here
conn.synchronize( opts );
returncode = opts.getAuthStatus();
Zulässige Werte Nach der Synchronisation muss der Parameter einen der folgenden Werte
enthalten: Wenn ein benutzerdefiniertes
authenticate_user-Synchronisationsskript in der konsolidierten Datenbank
einen anderen Wert zurückgibt, wird der Wert gemäß den Regeln
interpretiert, die in “authenticate_user (Verbindungsereignis)” [MobiLink
Administrationshandbuch, Seite 372] enthalten sind.
Konstante Wert Beschreibung
UlDefnUL_AUTH_STATUS_-
UNKNOWN
UlDefnUL_AUTH_STATUS_-
VALID
UlDefnUL_AUTH_STATUS_-
VALID_BUT_EXPIRES_SOON
UlDefnUL_AUTH_STATUS_-
EXPIRED
UlDefnUL_AUTH_STATUS_-
INVALID
UlDefnUL_AUTH_STATUS_-
IN_USE
0 Berechtigungsstatus ist unbekannt,
möglicherweise weil
die Verbindung noch nicht
synchronisiert wurde.
1000 Benutzer-ID und Kennwort
waren zur Zeit der Synchronisation
gültig.
2000 Benutzer-ID und Kennwort
waren zur Zeit der Synchronisation
gültig, laufen aber bald
ab.
3000 Autorisierung fehlgeschlagen:
Benutzer-ID oder Kennwort
sind abgelaufen.
4000 Autorisierung fehlgeschlagen:
Ungültige Benutzer-ID bzw.
ungültiges Kennwort.
5000 Autorisierung fehlgeschlagen:
Benutzer-ID wird bereits verwendet.
77

Siehe auch ♦ “Synchronisationsparameter “Authentication Status”” [MobiLink Clients,
Seite 345]
♦ “MobiLink-Benutzer authentifizieren” [MobiLink Clients, Seite 9].
78

Kapitel 5. Referenz der Synchronisationsparameter
auth_value-Synchronisationsparameter
Funktion Gibt Rückgabewerte aus benutzerdefinierten
Benutzerauthentifizierungsskripten aus.
Zugriffsmethoden long getAuthValue( )
void setAuthValue( long AuthWert )
Standardwert Eine Beschreibung der Werte, die von dem Standardmechanismus der
MobiLink-Benutzerauthentifizierung gesetzt werden, finden Sie unter
“authenticate_user (Verbindungsereignis)” [MobiLink
Administrationshandbuch, Seite 372].
Anwendung Der Parameter ist schreibgeschützt.
Greifen Sie wie folgt auf den Parameter zu:
UlSynchOptions opts = new UlSynchOptions;
// set other options here
conn.synchronize( opts );
returncode = opts.getAuthValue();
Siehe auch ♦ “Synchronisationsparameter “Authentication Value”” [MobiLink Clients,
Seite 346]
♦ “authenticate_user (Verbindungsereignis)” [MobiLink
Administrationshandbuch, Seite 372]
♦ “authenticate_user_hashed (Verbindungsereignis)” [MobiLink
Administrationshandbuch, Seite 376]
♦ “auth_status-Parameter” auf Seite 77
79

download_only-Synchronisationsparameter
Funktion Laden Sie während dieser Synchronisation keine Änderungen aus der
UltraLite-Datenbank.
Zugriffsmethoden boolean getDownloadOnly( )
void setDownloadOnly( boolean Nur_Download )
Standardwert Der Parameter ist ein fakultativer boolescher Wert, der standardmäßig
FALSE ist.
Anwendung Legen Sie den Parameter wie folgt fest:
UlSynchOptions opts = new UlSynchOptions;
opts.setDownloadOnly( true );
// set other options here
conn.synchronize( opts );
Siehe auch ♦ “Synchronisationsparameter “Download only”” [MobiLink Clients,
Seite 348]
♦ “Schreibgeschützte Tabellen in eine UltraLite-Datenbank aufnehmen”
[MobiLink Clients, Seite 310].
♦ “upload_only-Synchronisationsparameter” auf Seite 96
80

Kapitel 5. Referenz der Synchronisationsparameter
ignored_rows-Synchronisationsparameter
Funktion Gibt eine Meldung aus, wenn Zeilen vom MobiLink-Synchronisationsserver
während der Synchronisation aufgrund fehlender Skripten ignoriert wurden.
Der Parameter ist schreibgeschützt.
Zugriffsmethoden boolean getIgnoredRows( )
void setIgnoredRows( boolean IgnorierteZeilen )
81

new_password-Synchronisationsparameter
Funktion Legt ein neues MobiLink-Kennwort fest, das mit dem Benutzernamen
verbunden ist.
Zugriffsmethoden java.lang.String getNewPassword( )
void setNewPassword( java.lang.String NeuesKennwort )
Standardwert Es gibt keine Standardeinstellung.
Anwendung Legen Sie den Parameter wie folgt fest:
UlSynchOptions opts = new UlSynchOptions;
opts.setUserName( "50" );
opts.setPassword( "mypassword" );
opts.setNewPassword( "mynewpassword" );
// set other options here
conn.synchronize( opts );
Siehe auch ♦ “Synchronisationsparameter “New Password”” [MobiLink Clients,
Seite 350]
♦ “MobiLink-Benutzer authentifizieren” [MobiLink Clients, Seite 9].
82

Kapitel 5. Referenz der Synchronisationsparameter
num_auth_parms-Synchronisationsparameter
Funktion Die Anzahl der Authentifizierungsparameter-Zeichenfolgen, die an ein
benutzerdefiniertes Authentifizierungsskript weitergegeben wurden.
Zugriffsmethoden byte getAuthParmsNumber( )
void setAuthParmsNumber( byte Wert )
Standardwert Keine Parameter an ein benutzerdefiniertes Authentifizierungsskript
übergeben.
Anwendung Der Parameter wird gemeinsam mit auth_parms verwendet, um
Informationen an benutzerdefinierten Authentifizierungsskripten zu
übergeben.
☞ Weitere Hinweise finden Sie unter
“auth_parms-Synchronisatonsparameter” auf Seite 76.
Siehe auch ♦ “Parameter “Number of Authentication Parameters”” [MobiLink Clients,
Seite 351]
♦ “auth_parms-Synchronisatonsparameter” auf Seite 76
♦ “authenticate_parameters (Verbindungsereignis)” [MobiLink
Administrationshandbuch, Seite 370]
♦ “authenticate_user (Verbindungsereignis)” [MobiLink
Administrationshandbuch, Seite 372]
83

observer-Synchronisationsparameter
Funktion Ein Zeiger auf eine Callback-Funktion, die die Synchronisation überwacht.
Zugriffsmethoden ianywhere.ultralite.runtime.UlSynchObserver getObserver( )
void setObserver( ianywhere.ultralite.runtime.UlSynchObserver Überwachung
)
Siehe auch ♦ “Synchronisationsparameter “Observer”” [MobiLink Clients, Seite 352]
♦ “Synchronisation überwachen und abbrechen” auf Seite 51
♦ “user_data-Synchronisationsparameter” auf Seite 97
84

Kapitel 5. Referenz der Synchronisationsparameter
password-Synchronisationsparameter
Funktion Eine Zeichenfolge, die das MobiLink-Kennwort festlegt, das user_name
zugeordnet ist. Der Benutzername und das Kennwort unterscheiden sich von
der ID und dem Kennwort des Datenbankbenutzers und dienen der
Kennzeichnung und Authentifizierung der Anwendung beim
MobiLink-Synchronisationsserver.
Zugriffsmethoden java.lang.String getPassword( )
void setPassword( java.lang.String Kennwort )
Standardwert Es gibt keine Standardeinstellung.
Anwendung Legen Sie den Parameter wie folgt fest:
UlSynchOptions opts = new UlSynchOptions;
opts.setUserName( "50" );
opts.setPassword( "mypassword" );
// set other options here
conn.synchronize( opts );
Siehe auch ♦ “Synchronisationsparameter “Password”” [MobiLink Clients, Seite 353]
♦ “MobiLink-Benutzer authentifizieren” [MobiLink Clients, Seite 9].
85

ping-Synchronisationsparameter
Funktion Bestätigung von Kommunikationen zwischen dem UltraLite-Client und dem
MobiLink-Synchronisationsserver. Wenn dieser Parameter auf “true” gesetzt
wird, findet keine Synchronisation statt.
Wenn der MobiLink-Synchronisationsserver eine ping-Anfrage erhält,
verbindet er sich mit der konsolidierten Datenbank, authentifiziert den
Benutzer und sendet dann den Benutzerauthentifizierungs-Status und –Wert
an den Client zurück.
Wenn der Ping-Vorgang erfolgreich ist, gibt der MobiLink-Server eine
informative Meldung aus. Ist der Ping-Vorgang nicht erfolgreich, wird eine
Fehlermeldung ausgegeben.
Wenn der MobiLink-Benutzername in der Systemtabelle “ml_user” nicht
gefunden wird und der MobiLink-Server mit der Befehlszeilenoption -zu+
abläuft, fügt der MobiLink-Server den Benutzer zu “ml_user” hinzu.
Der MobiLink-Synchronisationsserver kann die folgenden Skripten für eine
ping-Anfrage verwenden, sofern sie vorhanden sind:
♦ begin_connection
♦ authenticate_user
♦ authenticate_user_hashed
♦ end_connection
Zugriffsmethoden boolean getPing( )
void setPing( boolean ping )
Standardwert Der Parameter ist ein fakultativer boolescher Wert, der standardmäßig
FALSE ist.
Anwendung Legen Sie den Parameter wie folgt fest:
UlSynchOptions opts = new UlSynchOptions;
opts.setUserName( "50" );
opts.setPing( true );
// set other options here
conn.synchronize( opts );
Siehe auch ♦ “Synchronisationsparameter “Ping”” [MobiLink Clients, Seite 354]
♦ “Option -pi” [MobiLink Clients, Seite 162]
86

Kapitel 5. Referenz der Synchronisationsparameter
publication-Synchronisationsparameter
Funktion Legt die zu synchronisierenden Publikationen fest
Zugriffsmethoden int getSynchPublication( )
void setSynchPublication( int Publikation )
Standardwert Wenn Sie keine Publikation angeben, werden alle Daten synchronisiert.
Anwendung Der UltraLite-Generator kennzeichnet die Publikationen, die mit dem
Befehlszeilenparameter ulgen -v als großgeschriebene Konstante mit dem
Namen UL_PUB_pubname angegeben wurde, wobei pubname der Name
ist, der der Option -v gegeben wurde.
Folgende Befehlszeile generiert z.B. eine Publikation, die von der
Konstanten sales:UL_PUB_SALES gekennzeichnet wird:
ulgen -v sales ...
Bei der Synchronisation setzen Sie den Publikationsparameter auf
publication mask: Dies ist eine sortierte Liste von Publikationskonstanten.
Zum Beispiel:
UlSynchOptions opts = new UlSynchOptions;
opts.setSynchPublication(
projectname.UL_PUB_MYPUB1 |
projectname.UL_PUB_MYPUB2 );
// set other options here
conn.synchronize( opts );
Dabei gilt: projectname ist der Name der Hauptobjektklasse, die vom
UltraLite-Generator generiert wird.
Die spezielle Publikationsmaske UL_SYNC_ALL beschreibt alle Tabellen
in der Datenbank, und zwar unabhängig davon, ob sie in einer Publikation
sind. Die Maske UL_SYNC_ALL_PUBS beschreibt alle Tabellen in
Publikationen in der Datenbank.
Siehe auch ♦ “Synchronisationsparameter “Publication”” [MobiLink Clients, Seite 355]
♦ “Der UltraLite-Generator” [UltraLite Datenbankhandbuch, Seite 99]
♦ “Datenmengen zum separaten Synchronisieren planen” [MobiLink Clients,
Seite 306]
87

security-Synchronisationsparameter
Funktion Stellen Sie den UltraLite-Client so ein, dass er die
Certicom-Verschlüsselungstechnik verwendet, um Nachrichten mit dem
MobiLink-Synchronisationsserver auszutauschen.
Getrennt lizenzierbare Option erforderlich
Die Nutzung der Certicom-Technologie setzt voraus, dass Sie die getrennt
lizenzierbare SQL Anywhere Studio-Sicherheitsoption erwerben, und ist
außerdem Exportbeschränkungen unterworfen. Weitere Hinweise zu dieser
Option finden Sie unter “Willkommen bei SQL Anywhere Studio” [SQL
Anywhere Studio Erste Orientierung, Seite 4].
Zugriffsmethoden Dieser Parameter wird in Java nicht verwendet.
Um die sichere Synchronisation von UltraLite-Java-Anwendungen zu
verwenden, wählen Sie einen separaten Datenstrom. Weitere Hinweise
finden Sie unter “Synchronisationsparameter initialisieren” auf Seite 47.
Siehe auch ♦ “Synchronisationsparameter “Security”” [MobiLink Clients, Seite 357]
♦ “MobiLink-Transportschichtsicherheit” [MobiLink
Administrationshandbuch, Seite 183].
88

Kapitel 5. Referenz der Synchronisationsparameter
security_parms-Synchronisationsparameter
Funktion Legt die Parameter fest, die für die Transportschichtsicherheit erforderlich
sind. Dieser Parameter muss in Verbindung mit dem Parameter security
verwendet werden.
☞ Weitere Hinweise finden Sie unter
“security-Synchronisationsparameter” auf Seite 88.
Zugriffsmethoden Dieser Parameter wird in Java nicht verwendet.
Um die sichere Synchronisation von UltraLite-Java-Anwendungen zu
verwenden, wählen Sie einen separaten Datenstrom. Weitere Hinweise
finden Sie unter “Synchronisationsparameter initialisieren” auf Seite 47.
Anwendung Die Sicherheitsparameter ULSecureCerticomTLSStream() und
ULSecureRSATLSStream() verfügen über eine Zeichenfolge, die aus
folgenden fakultativen Parametern besteht, die in einer durch Strichpunkte
getrennten Zeichenfolge bereitgestellt werden:
♦ certificate_company Die UltraLite-Anwendung akzeptiert
Serverzertifikate nur, wenn das Unternehmensfeld des Zertifikats mit
diesem Wert übereinstimmt. Standardmäßig ist dieses Feld nicht
markiert.
♦ certificate_unit Die UltraLite-Anwendung akzeptiert Serverzertifikate
nur, wenn das Unternehmensfeld des Zertifikats mit diesem Wert
übereinstimmt. Standardmäßig ist dieses Feld nicht markiert.
♦ certificate_name Die UltraLite-Anwendung akzeptiert nur
Serverzertifikate, wenn das Feld für den gemeinsamen Namen auf dem
Zertifikat mit diesem Wert übereinstimmt. Standardmäßig ist dieses Feld
nicht markiert.
Zum Beispiel:
ul_synch_info info;
...
info.stream = ULSocketStream();
info.security = ULSecureCerticomTLSStream();
info.security_parms =
UL_TEXT( "certificate_company=Sybase" )
UL_TEXT( ";" )
UL_TEXT( "certificate_unit=Sales" );
Der security_parms-Parameter ist eine Zeichenfolge und hat standardmäßig
den Wert Null.
Wenn Sie die sichere Synchronisation verwenden, müssen Sie im
UltraLite-Generator auch die Befehlszeilenoption -r verwenden. Weitere
89

Hinweise finden Sie unter “Der UltraLite-Generator” [UltraLite
Datenbankhandbuch, Seite 99].
Siehe auch ♦ “Synchronisationsparameter “Security Parameters”” [MobiLink Clients,
Seite 358]
90

stream-Synchronisationsparameter
Kapitel 5. Referenz der Synchronisationsparameter
Funktion Setzt den MobiLink-Synchronisationsdatenstrom für die Verwendung bei
der Synchronisation fest.
☞ Weitere Hinweise finden Sie unter
“stream_parms-Synchronisationsparameter” auf Seite 94.
Zugriffsmethoden ianywhere.ultralite.runtime.UlStream getStream( )
void setStream( ianywhere.ultralite.runtime.UlStream Datenstrom )
Standardwert Der Parameter hat keinen Standardwert und muss explizit festgelegt werden.
Anwendung
UlSynchOptions opts = new UlSynchOptions;
opts.setStream(new UlSocketStream() );
opts.setStreamParms( "host=myserver;port=2439" );
// set other options here
conn.synchronize( opts );
Wenn der Datenstromtyp einen Parameter erfordert, müssen Sie diesen mit
dem Parameter stream_parms übergeben. Anderenfalls setzen Sie den
Parameter stream_parms auf Null.
Die folgenden Datenstromfunktionen sind verfügbar, allerdings sind nicht
alle auf allen Zielplattformen verfügbar:
Datenstrom Beschreibung
ActiveSync (für Static
Java nicht verfügbar)
ActiveSync-Synchronisation (nur Windows CE)
☞ Eine Liste der Datenstromparameter finden
Sie unter “ActiveSync-Protokolloptionen”
[MobiLink Clients, Seite 371].
UlHTTPStream() Synchronisieren über HTTP
Der HTTP-Datenstrom verwendet TCP/IP als
zu Grunde liegendes Transportmittel. UltraLite-
Anwendungen agieren als Webbrowser und der
MobiLink-Synchronisationsserver als Webserver.
UltraLite-Anwendungen senden POST-
Anforderungen, um Daten an den Server zu
senden, und GET-Anforderungen, um Daten
vom Server zu lesen.
☞ Eine Liste der Datenstromparameter finden
Sie unter “HTTP-Protokolloptionen” [MobiLink
Clients, Seite 376].
91

92
Datenstrom Beschreibung
UlHTTPSStream() Synchronisieren über den HTTPS-Synchronisationsdatenstrom.
Der HTTPS-Datenstrom verwendet SSL oder
TLS als zu Grunde liegendes Protokoll. Er
arbeitet über Internetprotokolle (HTTP und
TCP/IP).
Der HTTPS-Datenstrom benötigt die Anwendung
der von Certicom bereitgestellten Technologie.
Die Nutzung der Certicom-Technologie
setzt voraus, dass Sie die getrennt lizenzierbare
SQL Anywhere Studio-Sicherheitsoption erwerben,
und ist außerdem Exportbeschränkungen
unterworfen. Weitere Hinweise zu dieser Option
finden Sie unter “Willkommen bei SQL
Anywhere Studio” [SQL Anywhere Studio Erste
Orientierung, Seite 4].
☞ Eine Liste der Datenstromparameter finden
Sie unter “HTTPS-Protokolloptionen” [Mobi-
Link Clients, Seite 377].
ULSocketStream() Synchronisieren über TCP/IP.
☞ Eine Liste der Datenstromparameter finden
Sie unter “TCP/IP-Protokolloptionen” [Mobi-
Link Clients, Seite 375].
UlSecureSocketStream() TCP/IP oder HTTP-Synchronisation mit
Transportschichtsicherheit, die Ellipsenkurven-
Verschlüsselung verwendet.
☞ Eine Liste der Datenstromparameter
finden Sie unter “UlSecureSocketStream-
Synchronisationsparameter” [MobiLink Clients,
Seite 380].
UlSecureRSASocket-
Stream()
TCP/IP oder HTTP-Synchronisation mit
Transportschichtsicherheit, die RSA-
Verschlüsselung verwendet.
☞ Eine Liste der Datenstromparameter finden
Sie unter “UlSecureRSASocketStream-
Synchronisationsparameter” [MobiLink Clients,
Seite 379].
☞ Weitere Hinweise zu Datenströmen der Java-Synchronisation finden Sie
unter “Synchronisationsparameter initialisieren” auf Seite 47.

Kapitel 5. Referenz der Synchronisationsparameter
Siehe auch ♦ “Synchronisationsparameter “Stream Type”” [MobiLink Clients, Seite 362]
93

stream_parms-Synchronisationsparameter
Funktion Legt Netzwerkprotokolloptionen zur Konfiguration des
Synchronisationsdatenstroms fest.
Eine Zeichenfolge, die aus einer durch Strichpunkte getrennten Liste von
Optionszuweisungen besteht. Jeder Auftrag hat die Form
Schlüsselwort=Wert, wobei die zulässige Gruppe der Schlüsselwörter vom
Synchronisationsdatenstrom abhängt.
Eine Liste der verfügbaren Optionen für den jeweiligen Datenstrom finden
Sie in den folgenden Abschnitten:
♦ “HTTP-Protokolloptionen” [MobiLink Clients, Seite 376]
♦ “HTTPS-Protokolloptionen” [MobiLink Clients, Seite 377]
♦ “TCP/IP-Protokolloptionen” [MobiLink Clients, Seite 375]
♦ “UlSecureRSASocketStream-Synchronisationsparameter” [MobiLink
Clients, Seite 379]
Zugriffsmethoden java.lang.String getStreamParms( )
void setStreamParms( java.lang.String DatenstromParam )
Standardwert Der Parameter ist fakultativ, eine Zeichenfolge und hat standardmäßig den
Wert Null.
Anwendung Legen Sie den Parameter wie folgt fest:
UlSynchOptions synch_options = new UlSynchOptions();
synch_opts.setStream( new UlSocketStream() );
synch_opts.setStreamParms( "host=myserver;port=2439" );
Siehe auch ♦ “Synchronisationsparameter “Stream Parameters”” [MobiLink Clients,
Seite 364]
♦ “Netzwerkprotokolloptionen für UltraLite-Synchronisationsclients”
[MobiLink Clients, Seite 371].
94

Kapitel 5. Referenz der Synchronisationsparameter
upload_ok-Synchronisationsparameter
Funktion Gibt Auskunft über den Status von MobiLink-Uploads. Der
MobiLink-Synchronisationsserver gibt diese Information an den Client
weiter.
Der Parameter ist schreibgeschützt.
Zugriffsmethoden boolean getUploadOK( )
void setUploadOK( boolean upload_ok )
Anwendung Nach der Synchronisation enthält der Parameter upload_ok den Wert true,
wenn der Upload erfolgreich war. Anderenfalls enthält er false.
Greifen Sie wie folgt auf den Parameter zu:
UlSynchOptions opts = new UlSynchOptions;
// set options here
conn.synchronize( opts );
returncode = opts.getUploadOK();
Siehe auch ♦ “Synchronisationsparameter “Upload OK”” [MobiLink Clients, Seite 367]
95

upload_only-Synchronisationsparameter
Funktion Weist darauf hin, dass bei der aktuellen Synchronisation keine Daten
eingelesen werden sollen. Dies kann Verbindungszeit sparen, vor allem bei
langsamen Kommunikationsverbindungen. Wenn dieser Parameter den Wert
TRUE hat, wartet der Client auf die Sendebestätigung vom
MobiLink-Synchronisationsserver. Danach beendet er die
Synchronisationssitzung erfolgreich.
Zugriffsmethoden boolean getUploadOnly( )
void setUploadOnly( boolean upload_only )
Standardwert Der Parameter ist ein fakultativer boolescher Wert, der standardmäßig
FALSE ist.
Anwendung Setzen Sie den Parameter wie folgt auf “true”:
UlSynchOptions opts = new UlSynchOptions;
opts.setUploadOnly( true );
Siehe auch ♦ “Synchronisationsparameter “Upload Only”” [MobiLink Clients, Seite 367]
♦ “Änderungen hoher Priorität synchronisieren” [MobiLink Clients, Seite 308]
♦ “download_only-Synchronisationsparameter” auf Seite 80
96

Kapitel 5. Referenz der Synchronisationsparameter
user_data-Synchronisationsparameter
Funktion Übergabe von anwendungsspezifischen Informationen an die
Synchronisations-Beobachtungsfunktion.
Zugriffsmethoden java.lang.Object getUserData( )
void setUserData( java.lang.Object user_data )
Anwendung Wenn Sie die Schnittstelle des Synchronisationsbeobachters
UlSynchObserver implementieren, können Sie anwendungsspezifische
Informationen für die Synchronisationsbeobachterklasse bereitstellen, indem
Sie ein Objekt in der Methode setUserData übergeben.
Siehe auch ♦ “Synchronisationsparameter “User Data”” [MobiLink Clients, Seite 368]
♦ “observer-Synchronisationsparameter” auf Seite 84
97

user_name-Synchronisationsparameter
Funktion Eine Zeichenfolge, die den Benutzernamen festlegt, der den
MobiLink-Client für den MobiLink-Synchronisationsserver eindeutig
kennzeichnet. MobiLink verwendet diesen Wert, um den einzulesenden
Inhalt zu bestimmen, den Synchronisationsstatus aufzuzeichnen und nach
Unterbrechungen während der Synchronisation neu aufzusetzen.
Zugriffsmethoden java.lang.String getUserName( )
void setUserName( java.lang.String Benutzername )
Standardwert Der Parameter muss angegeben werden und ist eine Zeichenfolge.
Anwendung Legen Sie den Parameter wie folgt fest:
UlSynchOptions synch_options = new UlSynchOptions();
synch_opts.setUserName( "mluser" );
Siehe auch ♦ “Synchronisationsparameter “User Name”” [MobiLink Clients, Seite 369]
♦ “MobiLink-Benutzer authentifizieren” [MobiLink Clients, Seite 9].
♦ “MobiLink-Benutzer” [MobiLink Clients, Seite 7].
98

version-Synchronisationsparameter
Kapitel 5. Referenz der Synchronisationsparameter
Funktion Jedes Synchronisationsskript in der konsolidierten Datenbank wird mit einer
Versionszeichenfolge markiert. Es können z.B. zwei verschiedene
download_cursor-Skripten vorhanden sein, die durch unterschiedliche
Versionszeichenfolgen gekennzeichnet werden. Die Versionszeichenfolge
gestattet es einer UltraLite-Anwendung, zwischen einer Reihe von
Synchronisationsskripten zu wählen.
Zugriffsmethoden java.lang.String getScriptVersion( )
void setScriptVersion( java.lang.String version )
Standardwert Der Parameter ist eine Zeichenfolge. Standardmäßig handelt es sich dabei
um die MobiLink-Standardversionszeichenfolge.
Anwendung Legen Sie den Parameter wie folgt fest:
UlSynchOptions synch_options = new UlSynchOptions();
synch_opts.setVersion( "default" );
Siehe auch ♦ “Synchronisationsparameter “Version”” [MobiLink Clients, Seite 370]
♦ “Skriptversionen” [MobiLink Administrationshandbuch, Seite 265].
99

100

Index
A
absolute, Methode
UltraLite Static Java JDBC-Unterstützung 62
AES, Verschlüsselungsalgorithmus
UltraLite Static Java-Datenbanken 41
afterLast, Methode
UltraLite Static Java JDBC-Unterstützung 62
Anregungen
Dokumentation xiii
geben xiii
Anwendungen
Deployment in der UltraLite Static Java-API 60
in UltraLite Static Java erstellen 16
schreiben in Java 24
Anwendungen in Java schreiben 24
Applets
UltraLite Static Java 57
UltraLite Static Java-Beispiel ausführen 25
Assistenten
UltraLite-Anweisung erstellen 8
UltraLite-Projekt erstellen 8
Ausführen
Beispielanwendung 27
B
beforeFirst, Methode
UltraLite Static Java JDBC-Unterstützung 62
Beispielanwendung
UltraLite Static Java 25–27
UltraLite Static Java ausführen 27
UltraLite Static Java erstellen 26
Benutzerauthentifizierung
getAuthStatus-Methode (Static Java-API) 77
getAuthValue-Methode (Static Java-API) 79
getPassword-Methode (Static Java-API) 85
getUserName-Methode (Static Java-API) 98
setNewPassword-Methode in UltraLite Static
Java 82
setPassword-Methode (Static Java-API) 85
setUserName-Methode (Static Java-API) 98
UltraLite Static Java, Gros- und Kleinschreibung
38
UltraLite Static Java-Datenbanken 38, 39
Benutzer-IDs
UltraLite Static Java 33
UltraLite Static Java, Gros- und Kleinschreibung
38
UltraLite Static Java-Datenbanken 38, 39
Beständig speichern
UltraLite-Datenbanken 30, 34
Beständige Speicherung
Parameter inUltraLite Static Java 41
C
cache_size, beständige Speicherung, Parameter
UltraLite Static Java 41
ChangeEncryptionKey, Methode
JdbcDatabase-Klasse 43, 69
changeEncryptionKey, Methode
UltraLite Static Java 43
Chiffrierschlüssel
Richtlinien in UltraLite Static Java 42
Class.forName, Methode 31
ClassNotFoundException 31
close, Methode
JdbcDatabase-Klasse 69
Connect, Methode
JdbcDatabase-Klasse 69
connect, Methode
JdbcConnection-Klasse 63
D
Datenbankdateien
Chiffrierschlüssel in UltraLite Static Java ändern
43
Dateinamen in UltraLite Static Java einstellen 41
Defragmentierung in UltraLite Static Java 44
Verschleierung in UltraLite Static Java 41
Verschlüsselung in UltraLite Static Java 42
Datenbanken
in UltraLite Static Java erstellen 58
mehrere UltraLite Static Java-Datenbanken 34
UltraLite Static Java-Datenbanken 34
Verbindungen von UltraLite Static Java 30
101

Index
Defragmentierung
UltraLite Static Java-Datenbanken 44
Deployment
UltraLite Static Java-Anwendungen 60
disableUserAuthentication, Methode
JdbcSupport-Klasse 72
Dokumentation
Konventionen ix
zu SQL Anywhere Studio vi
download-only, Synchronisation
getNewPassword-Method in UltraLite Static Java
82
DriverManager, Klasse 31
DriverManager.getConnection(), Methode 31
drop, Methode
JdbcDatabase-Klasse 70
E
Eigenschaftsobjekt
UltraLite Static Java-Verbindungen 34
Einschränkungen
JDBC UltraLite 63
enableUserAuthentication, Methode
Einsatz 38
JdbcSupport-Klasse 72
Entwicklungsprozess
UltraLite Static Java 3
Erstellen
Beispielanwendung 26
UltraLite Static Java-Anwendungen 16
UltraLite Static Java-Datenbanken 58, 71
F
Fehlerbehandlung
Änderungen in UltraLite Static Java vor der
Synchronisation festschreiben 50
getUploadOK-Methode (Static Java-API) 95
setPing-Methode (Static Java-API) 86
UltraLite JDBC 31
UltraLite-Anwendungen 30
Fehlersuche
UltraLite Static Java, Entwicklung 50
file_name, beständige Speicherung, Parameter
UltraLite Static Java 41
first, Methode
UltraLite Static Java JDBC-Unterstützung 62
Fortschrittsanzeige
102
G
Synchronisation in UltraLite Static Java 55
Generator
UltraLite Static Java-API 58
Generierte Datenbankklasse
UltraLite Static Java-Datenbanken 71
getAuthParms, Methode
Info (Static Java-API) 76
getAuthParmsNumber, Methode
Info (Static Java-API) 83
getAuthValue, Methode
Info (Static Java-API) 79
getDatabaseID, Methode
JdbcConnection-Klasse 64
getDefragIterator, Methode
JdbcConnection-Klasse 64
getDownloadOnly, Methode
Info (Static Java-API) 80
getDriver-Methode 31
getLastDownloadTimeDate, Methode
JdbcConnection-Klasse 65
getLastDownloadTimeLong, Methode
JdbcConnection-Klasse 65
getLastIdentity, Methode
JdbcConnection-Klasse 65
getNewPassword, Methode
UltraLite Static Java 82
getPassword, Methode
Info (Static Java-API) 85
getScriptVersion, Methode
Info (Static Java-API) 99
getUploadOK, Methode
Info (Static Java-API) 95
getUploadOnly, Methode
Info (Static Java-API) 96
getUserName, Methode
Info (Static Java-API) 98
Global Autoincrement
getLastIdentity-Methode für UltraLite Static Java
65
globalAutoincUsage-Methode für UltraLite Static
Java 66
UltraLite Static Java setDatabaseID-Methode 67
globalAutoincUsage, Methode
JdbcConnection-Klasse 66
Globaler Datenbankbezeichner

UltraLite Static Java 67
grant, Methode
JdbcConnection-Klasse 66
JdbcDatabase-Klasse 70
I
ignored_rows, Synchronisationsparameter
UltraLite Static Java 81
isAfterLast, Methode
UltraLite Static Java JDBC-Unterstützung 62
isBeforeFirst, Methode
UltraLite Static Java JDBC-Unterstützung 62
isFirst, Methode
UltraLite Static Java JDBC-Unterstützung 62
isLast, Methode
UltraLite Static Java JDBC-Unterstützung 62
J
Java
UltraLite, praktische Einführung 6
UltraLite-Beispielprogramm 6
UltraLite-Einschränkungen 62
Java API
Vorteile von UltraLite 4
java_certicom_tls, Strom
MobiLink-Synchronisationsserver 50
java_rsa_tls, Datenstrom
MobiLink-Synchronisatiosnserver 50
Java-Applets
UltraLite Static Java 57
JDBC
Datenbankparameter in UltraLite-URL 33
Info zu UltraLite 6
Treiber laden 31
Treiber registrieren 31
UltraLite Static Java SQL-Anweisungen 37
UltraLite-Einschränkungen 62
URLs 32
JDBC, Treiber
mehrere Treiber laden 31
UltraLite 31
UltraLite laden 31
UltraLite registrieren 31
JdbcConnection, Klasse
connect-Methode 63
getDatabaseID-Methode 64
getDefragIterator-Methode 64
Index
getLastIdentity-Methode 65
globalAutoincUsage-Methode 66
grant-Methode 66
Info 63
revoke-Methode 67
setDatabaseID-Methode 67
startSynchronizationDelete-Methode 68
stopSynchronizationDelete-Methode 68
synchronize-Methode 67
JdbcConnection.synchronize, Methode
Info 18, 49
JdbcDatabase, Klasse
close-Methode 69
connect-Methode 30, 69
drop-Methode 70
grant-Methode 70
Info 30, 68, 71
revoke-Methode 70
JdbcDefragIterator, Klasse
Info 71
ulStoreDefragStep-Methode 71
JdbcSupport, Klasse
disableUserAuthentication-Methode 72
enableUserAuthentication-Methode 72
Info 72
JSynchProgressViewer, Klasse
UltraLite Static Java-API 55
K
Kennwort
UltraLite Static Java-Synchronisation 82
Kennwörter
UltraLite Static Java 33
UltraLite Static Java, Gros- und Kleinschreibung
38
UltraLite Static Java-Datenbanken 38, 39
Kompilieren
UltraLite Static Java-Anwendungen 59
Konventionen
Dokumentation ix
L
Laden
JDBC-Treiber 31
last, Methode
UltraLite Static Java JDBC-Unterstützung 62
103

Index
N
Netzwerkprotokolloptionen
UltraLite Static Java-API 94
new_password, Synchronisationsparameter
UltraLite Static Java 82
Newsgroups
technische Unterstützung xiii
Nicht-unterstützte Funktionen
UltraLite-Einschränkungen 62
Nicht-unterstützte JDBC-Methoden
UltraLite-Einschränkungen 63
O
observer, Synchronisationsparameter
UltraLite Static Java-Beispiel 54
P
persist, Eigenschaft
UltraLite Static Java-Datenbanken 34
persistfile, Eigenschaft
UltraLite Static Java-Datenbanken 34
Praktische Einführung
UltraLite Java 6
previous, Methode
UltraLite Static Java JDBC-Unterstützung 62
Projekte
UltraLite Static Java-API 58
Publikationen
setSynchPublication-Methode (Static Java-API)
87
R
Registrieren
JDBC-Treiber 31
relative, Methode
UltraLite Static Java JDBC-Unterstützung 62
revoke, Methode
JdbcConnection-Klasse 67
JdbcDatabase-Klasse 70
S
Schlüsseleigenschaft
UltraLite Static Java-Datenbanken 34
setAuthParms, Methode
Info (Static Java-API) 76
104
setAuthParmsNumber, Methode
Info (Static Java-API) 83
setAuthStatus, Methode
Info (Static Java-API) 77
setDatabaseID, Methode
JdbcConnection-Klasse 67
setDefaultObfuscation, Methode
JdbcDatabase-Klasse 71
UlDatabase-Klasse 42
setDownloadOnly, Methode
Info (Static Java-API) 80
setNewPassword, Methode
UltraLite Static Java 82
setObserver, Methode
Info (Static Java-API) 84
setPassword, Methode
Info (Static Java-API) 85
setPing, Methode
Info (Static Java-API) 86
setScriptVersion, Methode
Info (Static Java-bAPI) 99
setStream, Methode
Info (Static Java-API) 91
setStreamParms, Methode
Info (Static Java-API) 94
setSynchPublication, Methode
Info (Static Java-API) 87
setUploadOnly, Methode
Info (Static Java-API) 96
setUserData, Methode
Info (Static Java-API) 97
setUserName, Methode
Info (Static Java-API) 98
Sicherheit
Chiffrierschlüssel in UltraLite Static Java ändern
43
UltraLite Static Java-Datenbanken,
Verschlüsselung 42
UltraLite Static Java-Transportschichtsicherheit
49
Verschleierung in UltraLite Static Java 41
Skriptversionen
getScriptVersion-Methode (Static Java-API) 99
setScriptVersion-Methode (Static Java-API) 99
Speicherparameter
UltraLite Static Java 41
SQL Anywhere Studio

Dokumentation vi
SQL, Anweisungen
UltraLite Static Java 37
SQLException
UltraLite-Anwendungen 30
Starke Verschlüsselung
UltraLite Static Java 41
StartSynchronizationDelete, Methode
JdbcConnection-Klasse 68
Static Java-API
UltraLite, Vorteile 4
StopSynchronizationDelete, Methode
JdbcConnection-Klasse 68
Sybase Central
UltraLite-Projekt SQL-Anweisungen hinzufügen
8
Symbole
in Handbüchern xi
Synchronisationsdatenstrom
UlHTTPStream 47
UlSecureSocketStream 49
UlSocketStream 47
Synchronisationsdatenströme
getStream-Methode (Static Java-API) 91
setStream-Methode (Static Java-API) 91
setStreamParms-Methode (Static Java-API) 94
UlHTTPSStream 47
UlHTTPSStream (Static Java-API) 91
UlHTTPStream (Static Java-API) 91
UlSecureRSASocketStream 47
UlSecureSocketStream 47, 49
UlSecureSocketStream (Static Java-API) 91
UlSocketStream (Static Java-API) 91
Synchronisationsparameter
getAuthParms-Methode (Static Java-API) 76
getAuthParmsNumber-Methode (Static Java-API)
83
getAuthStatus-Methode (Static Java-API) 77
getAuthValue-Methode (Static Java-API) 79
getDownloadOnly-Methode (Static Java-API) 80
getNewPassword-Methode in UltraLite Static
Java 82
getPassword-Methode (Static Java-API) 85
getScriptVersion-Methode (Static Java-API) 99
getStream-Methode (Static Java-API) 91
getUploadOK-Methode (Static Java-API) 95
getUploadOnly-Methode (Static Java-API) 96
Index
getUserName-Methode (UltraLite C/C++) 98
new_password in UltraLite Static Java 82
setAuthParmsNumber-Methode (Static Java-API)
83
setDownloadOnly-Methode (Static Java-API) 80
setNewPassword-Methode in UltraLite Static
Java 82
setObserver-Methode (Static Java-API) 84
setPassword-Methode (Static Java-API) 85
setPing-Methode (Static Java-API) 86
setScriptVersion-Methode (Static Java-API) 99
setStream-Methode (Static Java-API) 91
setStreamParms-Methode (Static Java-API) 94
setSynchPublication-Methode (Static Java-API)
87
setUploadOnly-Methode (Static Java-API) 96
setUserData-Methode (Static Java-API) 97
setUserName-Methode (Static Java-API) 98
SynchProgressViewer, Klasse
UltraLite Static Java-API 55
Synchronisation
Änderungen in UltraLite Static Java festschreiben
50
Applets 57
Fortschrittsanzeige in UltraLite Static Java 55
ignored_ rows, Parameter in UltraLite Static Java
81
in UltraLite Static Java abbrechen 51
in UltraLite Static Java aufrufen 48–50
in UltraLite Static Java überwachen 51
Java-Anwendung 18
JdbcConnection.synchronize-Methode in
UltraLite Static Java 18, 49
praktische Einführung in UltraLite Static Java 18
UltraLite Static Java 46
UltraLite Static Java hinzufügen 46
Synchronisation durch reinen Download
getDownloadOnly, Methode (Static Java-API) 80
setDownloadOnly, Methode (Static Java-API) 80
Synchronisation mit reinem Upload
getUploadOnly-Methode (Static Java-API) 96
setUploadOnly-Methode (Static Java-API) 96
Synchronize, Methode
JdbcConnection-Klasse 67
synchronize, Methode
JdbcConnection-Objekt 49
105

Index
T
Technische Unterstützung
Newsgroups xiii
Threads
Synchronisationsüberwachung in UltraLite static
Java 55
UltraLite Static Java-Synchronisation 55
Tipps
UltraLite Static Java, Entwicklung 50
Transportschichtsicherheit
java_certicom_tls-Strom 50
java_rsa_tls-Datenstrom 50
UltraLite Java-Clients 47
UltraLite Static Java-Anwendungen 49
Treiberklasse 31
U
Überwachung der Synchronisation
setObserver-Methode (Static Java-API) 84
UL_SYNC_ALL, Makro
Publikationsmaske 87
UL_SYNC_ALL_PUBS, Makro
Publikationsmaske 87
ULChangeEncryptionKey, Funktion
Verwendung in UltraLite Static Java 43
UlDatabase, Klasse
UltraLite-Datenbanken verschleiern 42
UlDefnUL_AUTH_STATUS_EXPIRED
auth_status-Wert
Info 77
UlDefnUL_AUTH_STATUS_IN_USE
auth_status-Wert
Info 77
UlDefnUL_AUTH_STATUS_INVALID
auth_status-Wert
Info 77
UlDefnUL_AUTH_STATUS_UNKNOWN
auth_status-Wert
Info 77
UlDefnUL_AUTH_STATUS_VALID
auth_status-Wert
Info 77
UlDefnUL_AUTH_STATUS_VALID_BUT_-
EXPIRES_SOON
auth_status-Wert
Info 77
106
ulgen, Dienstprogramm
Static Java-API 58
UlHTTPSStream, Objekt
Java-Synchronisationsdatenstrom 47
Java-Synchronisationsdatenstrom (Static
Java-API) 91
UlHTTPStream, Objekt
Java-Synchronisationsdatenstrom 47
Java-Synchronisationsdatenstrom (Static
Java-API) 91
ULSecureCerticomTLSStream, Funktion
Sicherheit (Static Java-API) 89
UlSecureRSASocketStream, Objekt
Java-Synchronisationsdatenstrom 47
ULSecureRSATLSStream, Funktion
Sicherheit (Static Java-API) 89
UlSecureSocketStream, Objekt
Info 49
Java-Synchronisationsdatenstrom 47
Java-Synchronisationsdatenstrom (Static
Java-API) 91
UlSocketStream, Objekt
Java- Synchronisationsdatenstrom (Static
Java-API) 91
Java-Synchronisationsdatenstrom 47
UlStoreDefragStep, Methode
JdbcDefragIterator-Klasse 71
UlSynchObserver, Schnittstelle
implementieren in UltraLite Static Java 52
UlSynchOptions, Objekt
Mitglieder (Static Java-API) 74
UltraLite
JDBC-Treiber 31
UltraLite Static Java
Info 1
Synchronisation 46
UltraLite, Datenbanken
mehrere Java-Datenbanken 34
UltraLite-Anweisung erstellen, Assistent
verwenden 8
UltraLite-Benutzer-IDs
Static Java-API 38
UltraLite-Datenbanken
Benutzer-IDs in der Static Java-API 38
Benutzer-IDs in Static Java 39
Verschlüsselung in Static Java 41
UltraLite-Kennwörter

Static Java-API 38
UltraLite-Projekte erstellen, Assistent
verwenden 8
Unterstützung
Newsgroups xiii
URL
UltraLite Static Java-Datenbank 31, 33
V
Verbinden
Eigenschaftsobjekt und UltraLite Static Java 34
mehrere UltraLite StaticJava-Datenbanken 34
UltraLite Static Java-Datenbanken 30, 31, 38
Verbindungsobjekt 31
Verschleiern
UltraLite Static Java-Datenbanken 41, 71
Verschleierung
UltraLite Static Java-Datenbanken 41
Verschlüsselung
Schlüssel in UltraLite Static Java ändern 43
UltraLite Static Java-Datenbanken 41, 42
Vorteile
UltraLite, Static Java-API 4
Vorübergehend speichern
UltraLite-Datenbanken 30, 34
Index
107