Tutorial: Session Bean mit
Datenbank-Zugriff, EJB3-Standard (Java_EJB_07) – Benutzen der
Hypersonic Datenbank von 'JBoss'
Voraussetzungen
für das Verständnis dieses Dokuments:
Grundverständnis
der Software-Entwicklung und des Datenbank-Entwurfes.
Dieses Dokument ist
ein Teil des Tutorials Session
Bean mit Datenbank-Zugriff , EJB3-Standarf(Java_EJB_07) –
Einrichten des Projects und
folgenden Dokumenten – kann aber auch alleine als Referenz
für die Benutzeroberfläche des in JBoss
integrierten Hypersonic Datenbanksystems verwendet werden.
|
Ungefährer
Zeitbedarf zum Durcharbeiten dieses Dokuments:
Arbeitszeit:
Ca.
15 bis 30 Minuten, abhängig von Ihrer Routine im Umgang mit
JBoss.
|
Die
Anleitung in diesem Dokument beschreibt die Erstellung einer
Datenbank-Tabelle im Datenbanksystem Hypersonic.
Das
im Java-Application-Server (JAS) JBoss integrierte Hypersonic ist ein
einfach zu bedienendes Datenbanksystem.
Weiters sind in JBoss als
Standard Parameterisierungen enthalten, die ermöglichen, sofort
eine Datenbank unter dem Namen 'DefaultDS' zu verwenden.
Aus
diesem Grund eignet sich Hypersonic für die schnelle Erstellung
von Datenbank-Tabellen während der Entwicklung von Enterprise
Java Beans (EJB).
Inhaltsverzeichnis:
Vorigerer
Schritt: Packen der Dateien in
Java-Archive (JAR) und 'deploy'
Vorbemerkung
Vorbedingungen
Web-Interface
für JBoss und Benutzeroberfläche für Hypersonic
aufrufen
Datenbank-Tabelle
erstellen
Test und Fehlersuche (erst
nach Fertigstellung des Client-Programms möglich)
Packaging
Configuration für das Enterprise Archive (EAR-Datei)
erstellen
Weitere
Schritte und verwandte Dokumentation
Nächste
Schritte:
Maßnahmen für
den Zugriff auf eine MySQL-Datenbank (nicht unbedingt
notwendig – aber interessant)
Tutorial:
Client-Programm für Session Bean mit Datenbank-Zugriff,
EJB-Standard (Java_EJB_08)
Dank für
Vorarbeiten
Eine
Anleitung mit zahlreichen Abbildungen unter
http://www.tusc.com.au/tutorial/html/chap1.html.
war Vorbild für dieses Dokument.
Ein großer Dank an die
Autoren
Vorbemerkung
|
Zum
Zeitpunkt des Schreibens dieses Dokumentes habe ich für JBoss
(und das integrierte Hypersonic Datenbanksystem) keine Version in
deutscher Sprache gefunden.
Aus diesem Grund sind die Texte der
Abbildungen in englischer Sprache.
|
Vorbedingungen:
▲ zum
Inhaltsverzeichnis
Web-Interface
für JBoss und Benutzeroberfläche für Hypersonic
aufrufen
Voraussetzung
damit JBoss über die Web-Interface gesteuert werden kann, ist
daß JBoss gestartet ist.
Eine Anleitung zum Starten von
JBoss unter Linux finden Sie unter JBoss
Java-Application-Server installieren>Test auf korrekte
Installation.
Um
nicht durch eventuell vorhandene Sicherheitsmechanismen behindert zu
werden, wird für dieses Tutorial vorausgesetzt, dass der
Web-Browser auf dem gleichen Computer läuft wie JBoss.
|
Die
Web-Interface von JBoss wird durch Eingabe der URL
http://localhost:8080/jmx-console
gestartet.
|
|
|
Im
oberen Bereich des Browser-Fensters finden Sie unter dem Abschnitt
jboss den
Eintrag
database=localDB,service=Hypersonic.
Klicken
Sie diese Zeile mit der linken Maustaste an.
|
|
|
Im
Web-Browser wird ein Fenster mit den Attributen und Methoden des
'Bean's angezeigt.
Im
unteren Bereich finden Sie die
Methode
startDatabaseManager.
Rechts daneben finden
Sie die Schaltfläche [ Invoke ] - klicken
Sie mit der linken Maustaste darauf.
Darauf
öffnet sich ein eigenes Fenster für die Verwaltung des
Datenbanksystems Hypersonic.
Eine genauere Beschreibung folgt
im nächsten Abschnitt.
|
|
▲ zum
Inhaltsverzeichnis
Datenbank-Tabelle
erstellen
|
Durch
die Aktion im vorigen Abschnitt wird eine selbständige
Anwendung gestartet und deren Benutzeroberfläche (Fenster
'HSQL Database Manager') angezeigt.
|
|
|
Im
Eingabebereich (rechts oben) wird das SQL-Kommando zum Erstellen
der Datenbanktabelle 'Chat' eingegeben:
create
table Chat (Erstellt_TS timestamp not null primary key,
Erstellt_TCPIP_Adresse char(15), Message_Text varchar(2040))
Beachten
Sie bitte:
Das
SQL-Kommando ist in einer Zeile – ohne 'Neue Zeile' zu
erfassen.
Das obige Beispiel wurde mit Zeilenumbrüchen
geschrieben damit auch das komplette SQL-Kommando dokumentiert
werden kann.
Durch
Anklicken der Schaltfläche [ Execute SQL ] wird
das Kommando ausgeführt.
Das Ausführen kann einige
Sekunden dauern.
|
|
|
Im
linken Bereich des Fensters ist dann die Tabelle 'CHAT' zu
sehen.
Durch Anklicken des kleinen Dreicks (links neben dem
Ordner-Symbol) können die Attribute der Tabelle angezeigt
bzw. verborgen werden.
Anmerkung:
Das
Hypersonic Datenbanksystem kennt keinen Unterschied zwischen Groß-
und Kleinschreibung bei Tabellen- und Attributsnamen.
Aus
diesem Grund werden diese auch in Großbuchstaben angezeigt
obwohl sie im SQL-Kommando in gemischter Schreibweise eingegeben
wurden.
|
|
▲ zum
Inhaltsverzeichnis
Test
und Fehlersuche (erst nach Fertigstellung des Client-Programms
möglich)
Ein
Test und eine eventuelle Suche nach Fehlern ist erst nach
Fertigstellung des Client-Programms (Tutorial:
Client-Programm für Session Bean mit Datenbank-Zugirff,
EJB3-Standard (Java_EJB_08))
möglich.
In diesem Dokument finden Sie im Abschnitt >
Test die
Anleitung für den Test.
Sollte der Test nicht das gewünschte
Ergebnis liefern finden Sie unter >
Hinweise zur Fehlersuche
eventuelle
Ursachen dafür.
▲ zum
Inhaltsverzeichnis
Packaging
Configuration für das Enterprise Archive (EAR-Datei) erstellen
Für
das Testen des erstellten EJB reicht das 'deploy' der JAR-Datei
aus.
Das Erstellen einer EAR-Datei unterscheidet sich nur in den
gewählten Dateinamen von der Vorgangsweise die unter
Tutorial:Einfache
Session Bean, EJB3-Standard (Java_EJB_05) - Packen in EAR-Datei und
Ändern des JNDI-Namens > Packen in eine EAR-Datei
beschrieben ist.
▲ zum
Inhaltsverzeichnis
Weitere
Schritte und verwandte Dokumentation
▲ zum
Inhaltsverzeichnis