Enterprise JavaBeans Überblick

Transkript

1 Enterprise JavaBeans Überblick 1. Überblick Java EE 5 und Komponententechnologien 2. Einführung Java EE 5 Plattform 3. Enterprise JavaBeans Architektur 4. Ressourcen Management und Primäre Services 6. Objekt-Relationales Mapping 7. Entity Bean Beziehungen 8. Find- und Select Methoden 9. Value Objects 10. Session Facade 11. Ergänzungen zu Entity Beans Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 194 Enterprise JavaBeans 5.1 Entities sind POJOs Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 195

2 5.1 Entities sind POJOs EJB 2.1 und davor Entity Beans unterlagen einer server-seitigen Persistierung innerhalb des EJB Komponentenmodells EJB 3.0 Entities sind POJOs Werden gemäß der Java Persistence Specification persistent gemacht Losgelöst von Java EE Spezifikation Wesentlich einfacheres Architekturmodell Enthält zusätzlich eine Object-Relational-Mapping (ORM) Engine Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans Entities sind POJOs EJB 3.0 Entity import public class Customer implement java.io.serializable { private int id; private public int getid(() { return id; public void setid(int id) { this.id = id; public String getname() { return name; public void setname(string name) { this.name = name; Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 197

3 5.1 Entities sind POJOs EJB 3.0 Entity Erzeugen einer neuen Instanz Einfach mit new() Operator Customer cust = new Customer(); cust.setname("bill"); Bleibt eine POJO, bis der EntityManager das Objekt in der relationalen Datenban persistiert Entity Beans sind managed, auch: zu einem EntityManager attached EntityManager synchronisiert Zustandsänderungen mit der Datenbank oder unmanaged, auch detached VerhaltensichwiePOJOs Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 198 Enterprise JavaBeans 5.1 Client als normale Anwendung Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 199

4 Persistence Context Menge aller managed Entity Bean Instanzen Wird von EntityManager verwaltet Synchronisiert Entity Beans mit Datenbank Sobald ein Persistence Context geschlossen wird, sind alle Entity Beans des Contextes unmanaged (detached) Zwei Varianten Transaction-scoped Persistence Context Extended Persistence Context Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 200 Transaction-scoped Persistence Context Normalfall innerhalb eines Application Servers Lebt nur solange, wie die Transaktion Wird automatisch geschlossen, wenn die Transaktion abgeschlossen wird Alle managed Entity Beans werden private EntityManager public Customer findcustomerno1() { Customer cust = entitymanager.find(customer.class, 1); cust.setname("neuer Name"); return cust;... Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 201

5 Extended Persistence Context Lebt länger als eine Transaktion Entity Beans bleiben auch über Transaktionsgrenzen hinweg managed Anwendung Mehrere kurze Datenbank-Transaktionen mit Gedächtnis Anwendbar nur in Stateful session Beans oder Java Anwendungen außerhalb des Application Servers Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 202 Persistence Unit Menge aller Klassen, die einer bestimmten Datenbank zur Persistenz übergeben werden Definiert in Deployment Deskriptor persistence.xml Innerhalb des META-INF Verzeichnisses eines EJB-Projektes d.h. innerhalb der EJB-JAR Datei <?xml version="1.0" encoding="utf-8"?> <persistence> <persistence-unit name="titan"> <jta-data-source>java:/defaultds</jta-data-source>  <properties> <property name="hibernate.hbm2ddl.auto" value="create-drop"/> </properties> </persistence-unit> </persistence> Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 203

6 Persistence Unit Klassen, die persistiert werden sollen: Normalerweise alle annotierte Klassen Werden automatisch im JAR File, der persistence.xml enthält, gesucht Weitere Möglichkeiten existieren Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 204 Zugriff auf Persistence Context Wie zuvor private EntityManager public Customer findcustomerno1() { Customer cust = entitymanager.find(customer.class, 1); cust.setname("neuer Name"); return cust;... Liefert Referenz auf zugehörigen Entity Manager Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 205

7 Enterprise JavaBeans 5.1 Client als normale Anwendung Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 206 Entity Beans persistent machen Customer cust = new Customer(); cust.setname("hans"); entitymanager.persist(cust); Entity Bean wird attached/managed Wann der Satz tatsächlich in die Datenbank geschrieben wird, ist nicht sicher Innerhalb einer Transaktion wahrscheinlich am Ende dieser Durch Aufruf von flush() erzwingbar Hat die Entity Bean Beziehungen zu anderen Entity Beans, so können diese auch automatisch in die Datenbank übernommen werden Abhängig von den Cascade Einstellungen Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 207

8 Entity Beans persistent machen (fortgesetzt) Customer cust = new Customer(); cust.setname("hans"); entitymanager.persist(cust); Mit der Persistierung kann automatisch der Primärschlüssel public int getid(() { return id; public void setid(int id) { this.id = id;... Mögliche Exceptions IllegalArgumentException TransactionRequiredException Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 208 Entity Beans persistent machen (fortgesetzt) Mögliche Exceptions IllegalArgumentException Argument ist keine Entity Bean TransactionRequiredException Persistence Context ist transaction-scoped und Aufruf nicht aus einer Transaktion Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 209

9 Entity Beans finden Zwei Methoden find() getreference() Customer cust = entitymanager.find(customer.class, 2); Entity Bean nicht gefunden: Ergebnis null Customer cust = null; try { cust = entitymanager.getreference(customer.class, 2); catch (EntityNotFoundException ex { // Behandle Fehler Entity Bean nicht gefunden: Exception Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 210 Entity Beans finden (fortgesetzt) IllegalArgumentException, falls Argument keine Entity Bean Beide Methoden können außerhalb eines Transaktionskontextes aufgerufen werden Entity Beans sind dann bei einem transaction-scoped persistence context sofort detached Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 211

10 Queries Anders als bei EJB 2.1 gibt es keine finder-methoden Stattdessen EJB QL Abfragen: Query query = entitymanager.createquery( "SELECT c FROM Customer c WHERE id=2"); Cutomer cust = (Customer) query.getsingleresult(); Auch nach der Abfrage bleiben die Ergebnis Entity Beans managed, so lange der persistence context existiert Eine weitere Abfrage würde dasselbe Ergebnis liefern Mehr zu EJB QL später Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 212 Updates Im selben persistence context bleibt gefundene Entity Bean managed Änderungen werden automatisch mit der Datenbank EntityManager public void updatebedcount(int id, int newcount) { Cabin cabin = entitymanager.find(cabin.class, id); cabin.setbedcount(newcount); Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 213

11 Merge Änderung an einer detached Entity Bean in die Datenbank übernehmen Finde bestimmte EntityManager public Cabin findcabin(int id) { return entitymanager.find(cabin.class, id); Ändere Eigenschaften in normalem Java Programm Cabin cabin = travelagent.findcabin(1); cabin.setbedcount(4); travelagent.updatecabin(cabin); cabin ist ein POJO Aufruf Session Bean zum Update Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 214 Merge (fortgesetzt) Ändere Entity Bean in EntityManager public void updatecabin(cabin cabin) { Cabin copy = entitymanager.merge(cabin); Übergebene cabin ist detached Zustand der merged Cabin Bean wird in die managed Entity Bean mit gleichem Primärschlüssel kopiert Änderungen daran werden in die Datenbank übernommen Das Argument (cabin) bleibt detached und unmanaged copy ist dann Referenz auf die managed Bean Vorhandenes Version-Attribut muss vom Entity Manager beachtet werden Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 215

12 Löschen Zeitpunkt auch wieder abhängig von flush EntityManager public void removecabin(int id) { Cabin cabin = entitymanager.find(cabin.class, id); entitymanager.remove(cabin); Nach remove() ist Entity Bean detached und unmanaged Undo nur durch neue Erzeugung der Entity Bean Entsprechend der cascading Regeln werden eventuell auch verknüpfte Entity Beans gelöscht Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 216 Löschen (fortgesetzt) Mögliche Exceptions IllegalArgumentException Argument ist keine Entity Bean TransactionRequiredException Persistence Context ist transaction-scoped und Aufruf nicht aus einer Transaktion Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 217

13 Weitere Methoden refresh() Refresh von der Datenbank contains() True, wenn Entity Instanz zur Zeit managed ist flush() Erzwingt Schreiben in die Datenbank Default flushing Vor der Ausführung einer korrelierten Query Diese wird immer in der Datenbank ausgeführt! Am Ende einer Transaktion bei Commit Ausnahme: Vor find() oder getreference() Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 218 Weitere Methoden setflushmode() Setzt FlushModeType AUTO Default Wie zuvor beschrieben COMMIT Nur wenn Transaktion mit Commit beendet wird Nicht vor irgend einer Query Nur für besondere Situationen geeignet (Performanz) lock() Unterstützung von read und write locks Wird im Rahmen von Transaktionen besprochen Prof. Dr. Björn Dreher Liste V Enterprise JavaBeans 219