Advanced Topics Persistente Domänenmodelle mit JPA 2.0 und Bean Validation

Advanced Topics

Persistente Domänenmodelle mit JPA 2.0 und Bean Validation

2

SQL Queries

EntityManager.createNativeQuery(String sql) EntityManager.createNativeQuery(String sql, Class

resultClass) Kann auch als NamedQuery definiert werden:

Ausführen des NamedQueries und Parameterübergabe:

@NamedNativeQuery( name = "employeeReporting", query = "SELECT * FROM emp WHERE id = ?", resultClass = Employee.class)

Query q = em.createNamedQuery("employeeReporting");q.setParameter(1, employeeId);q.getResultList()

3

Result Set Mapping (1)

Definition

Verwendung

@SqlResultSetMapping(name = "employeeResult",entities = @EntityResult(entityClass = Employee.class)

Query q = em.createNativeQuery( "SELECT * FROM EMPLOYEE", "employeeResult");

4

Result Set Mapping (2)

Mapping Foreign Keys Wenn die Foreign Keys im Resultat der Abfrage enthalten

sind, werden die einfachen Beziehungen ebenfalls mitgeführt

Multiple Result Mapping

SELECT e.*, a.* FROM emp e, address a WHERE e.adress_id = a.id@SqlResultSetMapping(name = "EmployeeWithAddress",entities = {@EntityResult(entityClass = Employee.class), @EntityResult(entityClass = Address.class)}

5

Result Set Mapping (3)

Mapping InheritanceSELECT id, name, start_date, daily_rate, term, vacation, hourly_rate, salary, pension, type FROM employee_stage

@SqlResultSetMapping( name="EmployeeStageMapping", entities= @EntityResult( entityClass=Employee.class, discriminatorColumn="TYPE", fields={ @FieldResult(name="startDate",column="START_DATE"), @FieldResult(name="dailyRate",column="DAILY_RATE"), @FieldResult(name="hourlyRate",column="HOURLY_RATE") } ) )

6

Lifecycle Callbacks

Callbacks sind eine gängige Methode, um Einfluss auf den Lade- oder Speichervorgang von Objekten zu nehmen.

Mögliche Events:PrePersist, PostPersist, PreRemove, PostRemove, PreUpdate, PostUpdate, PostLoad

@Entitypublic class ImageMessage extends Message { @PrePersist @PreUpdate protected void compress(){ ... } @PostLoad @PostUpdate protected void uncompress() { ... }

7

Entity Listeners

Wenn Sie dieselbe Funktionalität bei Callbacks von verschiedenen Entities verweden wollen, können Sie einen Entity Listener erstellen:

Entity Listener verwenden:

public class BaseEntityDebugListener { @PrePersist public void debugPrePersist(BaseEntity e) { log.debug("PrePresist: " + e); }}

@Entity@EntityListeners({BaseEntityDebugListener.class})public class Employee extends BaseEntity

8

Vererbung und Lifecycle Events

1. Prüfen ob Default Listeners existieren

2. Höchste Ebene der Vererbung auf @EntityListeners Annotations prüfen

3. Wiederhole Schritt 2 für die nächst tiefere Ebene

4. Höchste Ebene der Vererbung auf Methoden mit zum Event passender Annotation prüfen

5. Wiederhole Schritt 4 für die nächst tiefere Ebene

9

Sperrzeitpunkt

Daten werden in der Datenbank im Rahmen von SQL-Befehlen gesperrt.

Da Änderungen vorerst lokal durchgeführt und erst zum Commit-Zeitpunkt in die DB propagiert werden, findet das Sperren erst beim Commit statt.

Allfällige Wartesituationen, Deadlocks, Integritätsverletzungen treten effektiv erst zum Commit-Zeitpunkt auf.

10

Optimistic Locking / Versionierung

Die Versionierung im Rahmen von JPA ist als optimistsches Locking zu verstehen. Mit der Versionierung kann ein Concurrency Control über Transaktionen hinweg realisiert werden.

Mit einer @Version können Lost Updates detektiert und vermieden werden:Das Feld kann int, Integer, short, Short, long, Long oder java.sql.Timestamp sein@Entity public class Employee { @Version protected long version; ...

create table emp ( version bigint not null, ...

11

Weitere Locking Strategien

Soll REPEATABLE_READ zur Anwendung kommen, kann Read Locking verwendet werden:

em.lock(LockModeType.READ)

Um eine Entität zum Schreiben zu sperren, wird Write Locking verwendet

em.lock(LockModeType.WRITE)

Die Verwendung von anderen Isolationlevels, muss über die JDBC Connection erfolgen

Enhanced Locking (JPA 2.0)

JPA 2.0 führt neue Lockingstrategien ein: OPTIMISTIC ( = READ ) OPTIMISTIC_FORCE_INCREMENT ( = WRITE ) PESSIMISTIC_READ Repeatable Read PESSIMISTIC_WRITE Serialized PESSIMISTIC_FORCE_INCREMENT -> With version

field

Kombination Opitmistic/Pessimistic möglich!

12

13

Enhanced Locking (JPA 2.0)

Example in EntityManager.refresh()

public void applyCharges() { Account acct = em.find(Account.class, acctId); // calculate charges, etc. int charge = … ; if (charge > 0) { em.refresh(acct, PESSIMISTIC_WRITE); double balance = acct.getBalance(); acct.setBalance(balance - charge); }}

14

Schema Generation

Die Erzeugung von DDL kann, aber muss nicht durch eine Implementation der JPA Spezifikation angeboten werden.

In der JPA Spezifikation sind verschiedene Angaben (Annotations und Attribute davon) vorgesehen, welche die Erzeugung von DDL-Befehlen ermöglichenpublic class Message { @Column (unique = false, nullable=false, columnDefinition="varchar", lenghth=64 ) public BigDecimal sender;

15

Aufgabe: Advanced Topics

1. Erstellen Sie ein Result Set Mapping für ein SQL Query

2. Erweiteren Sie die BaseEntity um die Attribute createdAt und updatedAt und verwenden Sie Lifecycle Callbacks, um diese Attribute vor dem Insert und Update entsprechend abzufüllen

3. Erweitern Sie Ihre BaseEntity mit Optimistic Locking und testen Sie das Verhalten

4. Erweitern Sie ihr Mapping an beliebiger Stelle mit Angaben zur Schema Generierung (@Column)

16

XML Mapping

17

The Metadata Puzzle

Reihenfolge bei der Verarbeitung der Metadaten:1. Annotations verarbeiten2. Klassen aus XML Mapping hinzufügen3. Attribute aus XML Mapping hinzufügen4. Defaultwerte setzen

18

Das Mapping File

Rootelement is entity-mappings:

<?xml version="1.0" encoding="UTF-8"?><entity-mappings xmlns="http://java.sun.com/xml/ns/persistence/orm"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation= "http://java.sun.com/xml/ns/persistence/orm http://java.sun.com/xml/ns/persistence/orm_2_0.xsd"

version="2.0">

19

Defaults im Mapping File

Annotations ausschalten <xml-mapping-metadata-complete />

Persistence Unit Defaults schema catalog access cascade-persist entity-listeners

Diese können auch ausgeschaltet werden exclude-default-listeners @ExcludeDefaultListeners

20

Defaults im Mapping File

Mapping File Defaults package schema catalog access

21

Queries und Generators

sequence-generator

table-generator

named-query

named-native-query

sql-result-set-mapping

22

Entity Mapping mit XML

<entity class="examples.model.Employee"><attributes> <id name="id"> <generated-value strategy="SEQUENCE" /> </id> <many-to-one name="department" /> <many-to-one name="manager" /> <one-to-many name="phones" mapped-by="employee" /> <one-to-many name="directs" mapped-by="manager" /> <one-to-one name="address" /> <many-to-many name="projects" mapped-by="employees" /></attributes></entity>

23

Packaging and Deployment

24

Configuring Persistence Units

Persistence Unit Name<persistence-unit name="EmployeeService" />

Transaction TypeRESOURCE_LOCAL oder JTA

Persistence Provider<provider>org.hibernate.ejb.HibernatePersistence</provider>

Data Source nur bei JTA

Mapping Files<mapping-file>META-INF/queries.xml</mapping-file>

25

Managed Classes

Lokale Klassen Alle annotierten Klassen im Deployment Unit in welcher das persistence.xml gepackt ist

Klassen in Mapping FilesMit XML gemappte Klassen

Explicitly Listed ClassesIm persistence.xml eingetragene Klassen

Zusätzliche JARs mit Managed ClassesIm persistence.xml unter jar-file eingetragene JARs

26

Properites zur Laufzeit übergeben

Die properties im persistence.xml können ebenfalls zur Laufzeit beim Erstellen der EntityManagerFactory übergeben werden:Map props = new HashMap();props.put("toplink.jdbc.user", "emp");props.put("toplink.jdbc.password", "emp");EntityManagerFactory emf = Persistence .createEntityManagerFactory("EmployeeService", props);

27

Tools

28

IDE Integration

Eclipse Projekt DALI Oracle Enterprise Pack for Eclipse JBoss Tools

NetBeans IntelliJ IDEA