> Inhalt: Einführung in das Programmieren mit Java > Inhalt: Einführung in das Programmieren von Enterprise Java Beans 

* Bitte beachten Sie die Hinweise und Bestimmungen bezüglich Urheberrecht, Haftungsausschluß und geschützte Marken oder Warenzeichen die für dieses Web-Dokument und möglicherweise auch für 'verlinkte' Dokumente gelten.

• Der Betreiber dieser Web-Site (www.javascout.biz) ist nicht verantwortlich für den Inhalt von Web-Sites, die innerhalb dieses Web-Dokumentes oder anderer Dokumente von www.javascout.biz verlinkt sind.

• Wenn dieses Web-Dokument oder andere Dokumente dieser Web-Site (www.javascout.biz) Rechte von Ihnen verletzen, oder sie glauben, dass Rechte Anderer (Dritter Personen) dadurch verletzt werden, informieren Sie bitte den Betreiber dieser Web-Site.
  Eine E-Mail können Sie ganz einfach durch anklicken des Symbols oder Textes im Frame rechts oben senden.

Dieses Dokument drucken.

 Letzte Bearbeitung dieses  Dokuments:
2009-02-20

Voraussetzungen für das Verständnis dieses Dokuments:

Grundkenntnisse in der Programmierung von Java (Klassen, Methoden, Schleifen) oder anderer Objekt-Orientierter Programmiersprachen (z.B. C++, Modula-2, Pascal).

Kenntnisse im Umgang mit Eclipse; empfohlen ist das Durcharbeiten der Einführungsbeispiele für das Programmieren mit Java.

Ungefährer Zeitbedarf zum Durcharbeiten dieses Dokuments:

Arbeitszeit:
Ca. 20 bis 40 Minuten, je nach Routine im Umgang mit Eclipse.

Obwohl Eclipse in 'deutscher Version' installiert werden kann, sind die Abbildungen in diesem Tutorial mit der 'english Version' erstellt.
Grund ist, dass zum Zeitpunkt der Erstellung dieses Dokumentes (Februar 2009) die Eclipse-Texte nur sehr unvollständig ins Deutsche übersetzt sind.
Damit ist (meiner Meinung nach)
1.) Eclipse in deutscher Version wesentlich schwerer verständlich als in englischer Version und
2.) wenn Eclipse weiter übersetzt wird, ist dieses Dokument stark abweichend von den dann vorhandenen deutschen Texten.

Um ein neues Project zu beginnen wird >File>New>Project ausgewählt.

Im anschließenden Fenster (New Project) wird Java Project ausgewählt und durch Anklicken der Schaltfläche [ Next > ] fortgesetzt.

Im Fenster (New Java Project) wird

• Der 'Project name' (Java_EJB_05) festgelegt.

• Das verwendete 'JRE' (Java-Runtime-Environment) gewählt
  (Use default JRE belassen).

• Das 'Project layout' festgelegt.
  (Create separate folders for source and class files) wird gewählt weil es zweckmäßig ist, nur den Source-Code alleine in einem Verzeichnis zu haben und nicht auch noch pre-compiled Java-Klassen.

Durch Anklicken der Schaltfläche [Next > ] wird das nächste Fenster mit weiteren Einstellungsmöglichkeiten aufgerufen.

Im geänderten Fenster (New Java Project) wird

• Zuerst der 'Default output folder' geändert (Java_EJB_05/gen/classes).
  
  Das Verzeichnis gen enthält dann alle Dateien, die generiert werden:
  neben dem Verzeichnis für die kompilierten Java-Klassen werden später auch noch Verzeichnisse für 'Steuer'-Dateien des Enterprise Java Beans festgelegt.

• Dann durch anklicken des Textes Create new source folder ein weiteres Fenster (zum Festlegen eines Verzeichnisses für den Quell-Code der Java-Klassen) geöffnet.

Im erscheinenden Fenster (New Source Folder) wird

• Der 'Folder Name' (im Beispiel auf src/java) festgelegt.
  
  Im Verzeichnis src/java werden dann von Eclipse die Java-Packages (als weitere Verzeichnisse) und Java-Klassen mit dem Quell-Code (als Dateien) angelegt wenn eine neue Java-Klasse (Class) eröffnet wird.
  
  Da vorher (automatisch) src als Verzeichnis für die Dateien mit dem Quell-Code definiert war, wird eine Nachricht angezeigt, dass dieses Verzeichnis nicht weiter verwendet wird.

Durch Anklicken der Schaltfläche [ Finish ] wird das neue Verzeichnis erstellt und das Fenster geschlossen.

Es wird auch noch eine Schaltfläche [ Next > ] als aktiv angezeigt.
Damit würden verfeinerte Definitionen ermöglicht, welche Dateien automatisch innerhalb des Verzeichnisses angelegt würden.
Diese Verfeinerung ist für dieses Tutorial aber nicht notwendig.

Im noch immer offenen Fenster (New Java Project) wird jetzt das neu erstellte Verzeichnis angezeigt.

Um den Konflikt von zwei Verzeichnissen für den Java Source-Code zu beseitigen wird – als Standard vorgegebene – Verzeichnis src mit der rechten Maustaste angeklickt und aus dem Kontext-Menu 'Remove from Build Path' ausgewählt.

Durch Anklicken der Schaltfläche [ Finish ] wird das neue Project erstellt und das Fenster geschlossen.

Um die Properties ansehen und ändern zu können, wird das Project mit der rechten Maustaste angeklickt, dann Properties ausgewählt und mit der linken Maustaste angeklickt.

Im anschließend geöffneten Fenster wird im linken Teil Java Build Path ausgewählt und dann der Reiter Source angeklickt.

Unter den gelisteten Verzeichnissen wird vom Java-Compiler der Quell-Code erwartet.
Mit anderen Worten: Quell-Code in anderen Verzeichnissen wird vom Java-Compiler nicht gefunden und damit auch nicht kompiliert.

Weiters wird das Verzeichnis für den Quell-Code bei der Eröffnung von Java-Klassen oder -Interfaces vorgeschlagen bzw. die Eingabe gegen hier definierte Verzeichnisse geprüft.

Um eine spätere irrtümliche Verwendung eines unerwünschten Verzeichnis zu vermeiden, ist es empfehlenswert hier nur ein Verzeichnis (nämlich Java_EJB_05/src/java) zu erlauben.

Wenn Sie nur das eine Verzeichnis in der Liste sehen ist das korrekt und Sie können mit dem Abschnitt Einbindung der Libraries (Programm-Bibliotheken in den Java Build Path fortfahren.

Das folgende Beispiel für den Fehler ist von einem früheren Tutorial weil ich inzwischen Eclipse Version 3.4 installiert habe und der Fehler nicht mehr auftritt.
Lassen Sie sich bitte durch die andere Bezeichnung des 'Project' nicht verwirren.

Sollte noch das nicht gewünschte Verzeichnis (im Beispiel: Java_EJB_01/src) aufscheinen, so wird es mit der linken Maustaste markiert und dann die Schaltfläche [ Remove ] angeklickt.

Anschließend wird im Fenster nur mehr das gewünschte Verzeichnis angezeigt.

Durch Anklicken der Schaltfläche [ OK ] wird die neue Einstellung gesichert und das Fenster geschlossen.

Generell sollten alle benötigten Bibliotheken (Dateien im JAR-Format mit enthaltenen Java-Packages) für den EJB3-Standard in der installierten J2EE-Version von Java ab Version 1.6 enthalten sein.
Bei meiner Java-Installation (1.6.0_03-b05) und auch bei früheren Versionen fehlt aber scheinbar die passende Bibliothek für EJB3.

Bei fehlender oder falscher Bibliothek mit dem (Java-) Package 'javax.ejb' tritt ein Fehler auf wenn eine 'Injection'-Anweisung innerhalb des Codes verwendet wird.
Das ist erstmals im Abschnitt Tutorial: Einfache Session Bean, EJB3-Standard (Java_EJB_05) – Codieren > Interface ShowTimeDateBeanLocal mit den Methoden, für die ein Zugriff innerhalb des JAS erlaubt ist, erstellen der Fall.

In dem betroffenen Abschnitt wird auch auf die Möglichkeit des Fehlers aufmerksam gemacht und auf diesen Abschnitt verwiesen.
Es ist sinnvoll, die notwendige JAR-Datei erst in den Build Path aufzunehmen wenn der Fehler auch bei Ihrer Java-Version auftritt.

Die folgenden Anweisungen gehen davon aus, dass auf dem gleichen Computer ein JBoss Java Application Server (JAS) installiert ist.
Bei anderen JAS wird vermutlich ebenfalls eine passende JAR-Datei (Bibliothek) mitgeliefert sein.

Falls Sie noch keinen JAS installiert haben können Sie die Datei 'jboss-ejb3x.jar' herunterladen wenn Sie diesem Link folgen.

Der Java Build Path ist in den 'Properties' (Eigenschaften) des Project definiert.

Um die Properties ansehen und ändern zu können, wird das Project mit der rechten Maustaste angeklickt, dann 'Properties' ausgewählt und mit der linken Maustaste angeklickt.

Im anschließend geöffneten Fenster wird im linken Teil Java Build Path ausgewählt und dann der Reiter Libraries angeklickt.

Ein Weg, um JAR-Dateien, die in einem Verzeichnis außerhalb von Eclipse liegen einbinden zu können ist, wird die Schaltfläche [ Add External JARs... ] angeklickt.

Im Beispiel, von dem der Screenshot stammt ist der JBoss Java Application Server im Verzeichnis '/opt/jboss' installiert.
Wenn bei Ihrer Installation ein anderes Verzeichnis verwendet wird oder Sie die einzelne Datei heruntergeladen haben, adaptieren Sie bitte den Verzeichnis-Namen in den folgenden Anleitungen.

Navigieren Sie bis zum Verzeichnis '/opt/jboss/server/default/lib' und wählen Sie die Datei 'jboss-ejb3x.jar'.

Durch Anklicken der Schaltfläche [ OK ] wird die gewählte Datei in den Java Build Path aufgenommen.

Überprüfen Sie bitte, dass die in den Java Build Path aufgenommene Datei in der Liste aufscheint.

Nach dem Anklicken der Schaltfläche [ OK ] wird die Auswahl gespeichert.

Dokument

Inhalt

Tutorial: Einfache Session Bean, EJB3-Standard (Java_EJB_05) – Codieren  

Im nächsten Schritt des Tutorial wird der Code für das EJB vorgestellt.