Benutzung von Eclipse zur Entwicklung von Java EE 5 Anwendungen mit dem JBoss Application Server

Transkript

1 Benutzung von Eclipse zur Entwicklung von Java EE 5 Anwendungen mit dem JBoss Application Server Starten und Auswahl des Workspaces Starten Sie Eclipse als die Entwicklungsumgebung. Wählen Sie als Workspace ein Verzeichnis, in dem Sie Schreibberechtigung haben. Nennen Sie ihn z.b. workspaceconverter. Konfigurieren Sie JBoss als den Application Server Wählen Sie einmal zu Anfang Window Preferences und dort Server und dann Installed Runtimes. Fügen Sie mit Add JBoss or with EJB3 RC8 or RC9 hinzu. Geben Sie das zugehörige Installationsverzeichnis an - 1 -

2 (s. auch Anleitung von Herrn Knauf unter allgemein/index.html. ) - 2 -

3 Erzeugen eines neuen EJB-Projektes Wählen Sie im Menü File New Project... und in dem Wizzard dann unter J2EE ein Enterprise Application Project: - 3 -

4 Geben Sie dem Projekt den Namen Converter. Achten Sie darauf, dass die richtige Target Runtime definiert ist. Drücken Sie zweimal Next >

5 Anschließend fügen wir weitere Module zum dem EAR Projekt hinzu: - 5 -

6 und wählen die folgenden 3 Module: Auf Anforderung wechseln Sie in die J2EE-Perspektive. Sonst Defaults lassen

7 Es ergibt sich das folgende Bild: Anpassen der Deployment- Deskriptoren an Java EE 5 Leider sind die Eclipse Plugins teilweise noch auf dem alten Stand J2EE. Deshalb müssen alle generierten Deployment-Deskriptoren modifiziert werden (Auszug aus Herrn Knaufs Web-Seite): application.xml Den Deployment-Deskriptor der Enterprise Application öffnen. Er liegt im Pfad "Converter\Earcontent\META-INF\application.xml". Die Datei sieht so aus: <?xml version="1.0" encoding="utf-8"?> <application id="application_id" version="1.4" xmlns=" xmlns:xsi=" xsi:schemalocation=" </application> - 7 -

8 Wir ändern die Datei so ab (fett und rot sind die Änderungen): <?xml version="1.0" encoding="utf-8"?> <application id="application_id" version="5" xmlns=" xmlns:xsi=" xsi:schemalocation=" </application> ejb-jar.xml Den Deployment-Deskriptor des EJB-Projekts öffnen. Er liegt im Pfad "ConverterEJB\ejbModule\META-INF\ejb-jar.xml". Die Datei sieht so aus: <?xml version="1.0" encoding="utf-8"?> <ejb-jar id="ejb-jar_id" version="2.1" xmlns=" xmlns:xsi=" xsi:schemalocation=" </ejb-jar> Wir ändern die Datei so ab: <?xml version="1.0" encoding="utf-8"?> <ejb-jar id="ejb-jar_id" version="3.0" xmlns=" xmlns:xsi=" xsi:schemalocation=" </ejb-jar> application-client.xml Den Deployment-Deskriptor des Application-Client-Projekts öffnen. Er liegt im Pfad "ConverterClient\appClientModule\META-INF\application-client.xml". Die Datei sieht so aus: <?xml version="1.0" encoding="utf-8"?> <application-client id="application-client_id" version="1.4" xmlns=" xmlns:xsi=" xsi:schemalocation=" </application-client> Wir ändern die Datei so ab: <?xml version="1.0" encoding="utf-8"?> <application-client id="application-client_id" version="5" xmlns=" xmlns:xsi=" xsi:schemalocation=" </application-client> - 8 -

9 web.xml Den Deployment-Deskriptor des Web-Projekts öffnen. Er liegt im Pfad "ConverterWeb\WebContent\WEB-INF\web.xml". Die Datei sieht so aus: <?xml version="1.0" encoding="utf-8"?> <web-app id="webapp_id" version="2.4" xmlns=" xmlns:xsi=" xsi:schemalocation=" </web-app> Wir ändern die Datei so ab: <?xml version="1.0" encoding="utf-8"?> <web-app id="webapp_id" version="2.5" xmlns=" xmlns:xsi=" xsi:schemalocation=" </web-app> - 9 -

10 Erzeugen der Session Bean Converter Da die Wizzards noch nicht dem EJB 3.0 Standard entsprechen, erzeugen wir die Session Bean von Hand. Markieren Sie in dem ConverterEJB Projekt das Verzeichnis ejbmodule. Dort im Kontext-Menü wählen Sie New Interface Geben Sie dem Interface dem Namen ConverterRemote und wählen Sie als Package converter. Sonst lassen Sie die Defaults: Es öffnet sich der Editor für dieses Interface. Wir ergänzen es wie folgt: package converter; import java.math.bigdecimal; import public interface ConverterRemote {

11 } public BigDecimal dollartoyen(bigdecimal dollars); public BigDecimal yentoeuro(bigdecimal yen); Wichtig sind die um das Interface als Remote Interface zu kennzeichnen. Weiterhin definieren wir die beiden Business-Methoden für die Session Bean. Eclipse hilft uns mit den nötigen Imports

12 Als nächstes erzeugen wir die eigentliche Bean Klasse der Session Bean. Starten Sie wieder in dem ConverterEJB Projekt und dort im Verzeichnis ejbmodule. Im Kontext-Menü wählen Sie nun New Class Geben Sie der Klasse dem Namen ConverterBean und wählen Sie als Package wieder converter. Wählen Sie als zu implementierendes Interface converter.converterremote. Sonst lassen Sie die Defaults: Die aufgrund des Interfaces zu implementierenden Methoden werden automatisch als leere Methodenrümpfe erzeugt. Ergänzen Sie die Klasse wie folgt: package converter;

13 import java.math.bigdecimal; import public class ConverterBean implements ConverterRemote { private BigDecimal yenrate = new BigDecimal(" "); private BigDecimal eurorate = new BigDecimal("0.0067"); public BigDecimal dollartoyen(bigdecimal dollars) { BigDecimal result = dollars.multiply(yenrate); return result.setscale(2, BigDecimal.ROUND_UP); } } public BigDecimal yentoeuro(bigdecimal yen) { BigDecimal result = yen.multiply(eurorate); return result.setscale(2, BigDecimal.ROUND_UP); } Wichtig ist hier wieder die um die Klasse als stateless Session Bean zu kennzeichnen

14 Client Application erstellen Application Client Projekt Wurde bereits zu Anfang erzeugt. Wählen Sie das Application Client Project ConverterClient. Unter appclientmodule gibt es im Default-Package eine Klasse Main mit einer statischen main()-methode. Ändern Sie diese Methode wie folgt ab: main()-methode In die main()-methode den folgenden Code einfügen. Sie erhalten Fehlermeldungen, die Sie mit entsprechendem Exception-Handling (NamingException) begegnen müssen: Properties props = new Properties(); props.setproperty(context.initial_context_factory, "org.jnp.interfaces.namingcontextfactory"); props.setproperty(context.url_pkg_prefixes, "org.jboss.naming.client"); props.setproperty(context.provider_url, "jnp://localhost:1099"); props.setproperty("j2ee.clientname", "ConverterClient"); Context ctx = new InitialContext(props); Object ref = ctx.lookup("java:comp/env/ejb/converterremote"); ConverterRemote conv = (ConverterRemote) PortableRemoteObject.narrow(ref, ConverterRemote.class); BigDecimal param = new BigDecimal("100.00"); BigDecimal amount = conv.dollartoyen(param); System.out.println(param + " dollars are " + amount + " yen."); amount = conv.yentoeuro(param); System.out.println(param + " yen are " + amount + " Euros.");... System.exit(0); Wichtig ist hier, dass wir die Property j2ee.clientname (scheint JBossspezifisch zu sein) auf den Namen des Projekts (bzw. auf den Wert des Elements display-name in "application-client.xml") setzen!

15 Weiterhin müssen etliche Importe durchgeführt werden. Immer java- oder javax-packages importieren (nicht von com.ibm... oder org.omg.corba..). Da der Klient die Interfaces unserer Session Bean verwenden muss, müssen die auch projektmäßig bekannt sein. Erst dann lassen sich diese Import- Anweisungen automatisch erzeugen! Ändern Sie in den Properties des ConverterClient-Projektes die Dependencies:

16 Referenzen des Klienten spezifizieren Damit der Client mit einer Referenz auf unsere Session Bean arbeiten kann, müssen wir das in dem Deployment-Deskriptor der Client Application vereinbaren: Das geht zur Zeit nur per Hand, indem man den Deployment-Descriptor application-client.xml mit dem Text-editor öffnet und die Zeilen <ejb-ref> <ejb-ref-name>ejb/converterremote</ejb-ref-name> <ejb-ref-type>session</ejb-ref-type> <home>java.lang.object</home> <remote>converter.converterremote</remote> </ejb-ref> nach den schließenden </display-name> Tag hinzufügt. jboss-client.xml Damit alles funktioniert, benötigen wir zusätzlich an derselben Stelle wie application-client.xml einen JBoss-spezifischen Deployment-Deskriptor mir dem Namen jboss-client.xml. Wählen Sie den Knoten META-INF, dann New File Und erzeugen die Datei. Ihr Inhalt muss sein: <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE jboss-client PUBLIC "-//JBoss//DTD Application Client 4.0//EN" " > <jboss-client> <jndi-name>converterclient</jndi-name> <!-- Connect the declared EJB reference to the JNDI-Name of the EJB: --> <ejb-ref> <ejb-ref-name>ejb/converterremote</ejb-ref-name> <jndi-name>converter/converterbean/remote</jndi-name> </ejb-ref> </jboss-client>

17 Starten des JBoss Application Servers Wählen Sie in dem unteren Fenster den Tab Servers. Wenn es noch keinen Server gibt, erzeugen Sie einen aus dem Kontext-Menü mit New Server. Wählen Sie den schon zu Anfang definierten Server JBoss or with EJB3 RC8 or RC9. Lassen Sie sonstige Defaults. Starten Sie den Server durch Auswahl von Run im Kontext-Menü des Servers. Fügen Sie über dasselbe Kontext-Menü über Add and Remove Projects das Converter-Projekt hinzu. Daraufhin wird es im Application Server deployed. Beobachten Sie den Console-Output

18 Starten der Anwendung Wählen Sie nun das ConverterClient Projekt und wählen im Kontext-Menü Run As Run... und erzeugen Sie eine neue Launch-Konfiguration as Java Application. Nennen Sie die Konfiguration ConverterClient. Wählen Sie die Klasse, die die main()-methode enthält (in unserem Fall Main): Drücken Sie Run und beobachten die Konsole. Viel Erfolg!

19 Hinzufügen eines Web-Clients Wählen Sie das ConverterWeb Projekt aus. Mit Hilfe des Context-Menüs fügen Sie eine JSP-Seite hinzu: Sie wird in den Ordner WebContent eingefügt. Nennen Sie die Java Server Page (JSP): ConverterTest.jsp

20 Drücken Sie Next : Lassen Sie die Default-Einstellung. Drücken Sie Finish. Öffnen Sie mit dem Text-Editor die neue JSP-Datei. Fügen Sie innerhalb des <head>-tags nach dem <title> den folgenden Code ein: <%@ page import="converter.converterremote, javax.naming.*, javax.rmi.portableremoteobject, java.math.*" %> <%! private ConverterRemote converter = null; public void jspinit() { try { InitialContext ctx = new InitialContext(); Object ref = ctx.lookup("java:comp/env/ejb/converterremote"); converter = (ConverterRemote) PortableRemoteObject.narrow(ref, ConverterRemote.class);

21 %> } } catch (NamingException ex) { System.out.println("Got naming exception"); } Als Body fügen Sie ein: <body> <center> <h1><b>converter</b></h1> </center> <hr> <p>enter an amount to convert:</p> <form method="get"> <input type="text" name="amount" size="25"> <br> <p> <input type="submit" value="submit"> <input type="reset" value="reset"> </p> </form> <% String amount = request.getparameter("amount"); if (amount!= null && amount.length() > 0) { BigDecimal d = new BigDecimal(amount); %> <p> <%= amount %> dollars are <%= converter.dollartoyen(d) %> Yen. <p> <%= amount %> Yen are <%= converter.yentoeuro(d) %> Euros. <% } %> </body>

22 JAR Dependencies In den Properties des Web-Projektes die J2EE Module Dependencies setzen:. Auflösen der Referenzen der JSP In der lookup Methode, bezieht sich der Web Client auf die Remote- Schnittstelle der Enterprise Bean: Object ref = ctx.lookup("java:comp/env/ejb/converterremote"); Dies müssen wir bekannt geben:

23 Öffnen Sie die Datei web.xml im Verzeichnis WEB-INF. Ergänzen Sie dort hinter dem Eintrag </welcome-file-list>: <ejb-ref> <ejb-ref-name>ejb/converterremote</ejb-ref-name> <ejb-ref-type>session</ejb-ref-type> <home>java.lang.object</home> <remote>converter.converterremote</remote> </ejb-ref> Jetzt müssen Sie noch den JBoss-spezifischen Teil der EJB-Referenz erzeugen (nämlich eine Verbindung zur tatsächlichen Bean im Container- JNDI). Dazu legen wir in "ConverterWeb\WEB-INF\" eine Datei jbossweb.xml an mit diesem Inhalt: <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE jboss-web PUBLIC "-//JBoss//DTD Web Application 2.4//EN" " <jboss-web> <context-root>converterweb</context-root> <ejb-ref> <ejb-ref-name>ejb/converterremote</ejb-ref-name> <jndi-name>converter/converterbean/remote</jndi-name> </ejb-ref> </jboss-web> Der Eintrag <context-root> bestimmt einen Teil des URL, unter dem die Anwendung auf dem Webserver zu finden ist. Änderungen deployen Deployen Sie die Änderungen in den Application-Server, indem Sie im Kontext-Menü des Servers Publish wählen

24 Web-Client ausführen Um den Web-Client auszuführen rufen Sie im Kontext-Menü des Web- Projektes Run as... Run on Server auf. Ggf. müssen Sie hier noch den Server einrichten. Der Server wird gestartet und ein Webbrowser öffnet sich. Als URL ist bereits eingetragen: Da wir noch keine Verknüpfung mit unserer JSP-Seite vereinbart haben, müssen wir ConverterTest.jsp von Hand wählen: Geben Sie einen Wert an (hier war es 1000) und drücken dann Submit :

25 Sie haben es geschafft!