La Java Persistence API (JPA) es un estándar para mapeo objeto-relacional y persistencia de datos que proporciona un API estándar basado en Plain Old Java Objects (POJOs) con uso extensivo de anotaciones. JPA permite relacionar objetos de dominio con tablas de una base de datos relacional mediante un mecanismo de mapeo declarativo y proporciona servicios de persistencia para almacenar y recuperar objetos desde la base de datos.

1. Java Persistence API (JPA)
Diego Armando Gómez Mosquera.
dgomez@vortexbird.com
2017

2. Java Persistence API (JPA)
• Estándar para mapeo objeto relacional y persistencia
de datos.
• Provee un API estándar.
• Se basa en Plain Old Java Object (POJO).
• Uso extensivo de anotaciones.
• JSR 220: JavaTM Persistence 1.0
• JSR 317: JavaTM Persistence 2.0
• JSR 338: JavaTM Persistence 2.1

3. Java Persistence API (JPA)
• POJO
– Clase que no debe implementar una interfaz o
heredar de una clase mas especializada.
class MyServlet extends HttpServlet {}
class MyRemote implements SessionBean {}
No son POJO

4. Anotaciones JPA
• @Entity
• @Id
• @Embeddable
• @OneToOne
• @OneToMany
• @ManyToOne
• @ManyToMany

5. Mapeador Objeto Relacional
Capa de persistencia
Modelo de Objetos
SQL
Base de Datos Relacional (RDB)Mapeador Objeto Relacional (ORM)
HQL
JPQL
OQL
SQL Nativo

6. Relación unidireccional

7. Relación unidireccional
@Entity
public class User {
@Id
private String userId;
private String email;
@OneToOne
private BillingInfo billingInfo;
}
@Entity
public class BillingInfo {
@Id
private Long billingId;
private String creditCardType;
private String creditCardNumber;
private String nameOnCreditCard;
private Date creditCardExpiration;
private String bankAccountNumber;
private String bankName;
private String routingNumber;
}

8. Relación bidirecional

9. Relación bidirecional
@Entity
public class Usuario{
@Id
private String userId;
private String email;
@OneToOne
private Facturacion factura;
}
@Entity
public class Facturacion{
@Id
private Long facturacionId;
private String tipoTarjetaDeCredito;
private String numeroTarjetaDeCredito;
private String nombreDeTarjetaDeCredito;
private Date fechaDeVencimientoTarjeta;
private String numeroDeCuentaDeBanco;
private String nombreBanco;
@OneToOne (mappedBy=“Facturacion”)
private Usuario usuario;
}

10. Relación uno a muchos

11. Relación uno a muchos
@Entity
public class Item {
@Id
protected Long itemId;
protected String nombre;
protected String descripcion;
protected Date fecha;
...
@OneToMany(mappedBy="item")
protected Set<Oferta> ofertas;
...
}
@Entity
public class Oferta{
@Id
protected Long ofertaId;
protected Double valor;
protected Date fecha;
...
@ManyToOne
protected Item item;
...
}

12. EntityManager
Object EntityManager Base de datos
Grabar SQL
Obtener Resultado

13. EntityManager
• El administrador de entidades permite relacionar
la diferentes operaciones asociadas al motor de
base de datos.
– Crear
– Modificar
– Borrar
– Buscar por diferentes criterios.
– Cache
– Proxy
– Carga tardia (Lazy load)

14. EntityManager
Metodo Desccripcion
public void persist(Object entity); Saves (persists) an Entity into the database.
public void remove(Object entity); Removes an Entity from the database.
public <T> T find(Class<T>
entityClass, Object primaryKey); Find an entity instance by its primary key.
public void flush();
Synchronize the state of Entities in the EntityManager’s persistence
context with database.
public void
setFlushMode(FlushModeType
flushMode);
Change the flush mode of the EntityManager’s persistent context. The
flush mode may either be AUTO or COMMIT.
public FlushModeType
getFlushMode(); Retrieve the current flush mode.
public void refresh(Object entity); Refresh (reset) the Entity from the database.
public Query createQuery(String
jpqlString); Create a dynamic query using a JPQL statement.
public Query
createNamedQuery(String name);
Create a query instance based on a named query on the Entity
instance.

15. EntityManager
Metodo Descripcion
public Query createNativeQuery(String sqlString);
public Query createNativeQuery(String sqlString, Classresult Class);
public Query createNativeQuery(String sqlString, String
resultSetMapping); Create a dynamic query using a native SQL statement.
public void close(); Close an EntityManager.
public boolean isOpen(); Check whether an EntityManager is open.
public EntityTransaction getTransaction();
Retrieve a transaction object that can be used to manually
start or end a transaction..
public void joinTransaction(); Ask an EntityManager to join an existing JTA transaction.

16. Persistence Units
• Define un conjunto de entidades que son
manejadas por un EntityManager.
• Las unidades de persistencia son
definidas en un documento XML llamado
persistence.xml
• El persistence.xml se encuentra en la
carpeta META-INF.

17. Persistence.xml
<persistence>
<persistence-unit name="OrderManagement">
<description>This unit manages orders and customers.
It does not rely on any vendor-specific features and can
therefore be deployed to any persistence provider.
</description>
<jta-data-source>jdbc/MyOrderDB</jta-data-source>
<jar-file>MyOrderApp.jar</jarfile>
<class>com.widgets.Order</class>
<class>com.widgets.Customer</class>
</persistence-unit>
</persistence>

18. Usando un EntityManager
public class ItemManagerBean implements ItemManager {
@PersistenceContext(unitName="actionBazaar")
private EntityManager entityManager;
public Item addItem(String title, String description,byte[] picture, double
initialPrice, long sellerId) {
Item item = new Item();
item.setTitle(title);
item.setDescription(description);
item.setPicture(picture);
item.setInitialPrice(initialPrice);
Seller seller = entityManager.find(Seller.class, sellerId);
item.setSeller(seller);
entityManager.persist(item);
return item;
}

19. Laboratorio

20. Laboratorio
• Instalar HibernateTool
– http://tools.jboss.org/downloads/jbosstools/neon
/4.4.3.Final.html
• Creación de proyecto habilitado para usar JPA
con Hibernate ORM.
• Ingeniería inversa.
• Activación de logs de SQL
• Escenario CRUD

21. Estructura Proyecto Java Maven

22. Java Persistence Query
Language (JPQL)

23. Java Persistence Query Language
(JPQL)
• Lenguaje de consulta orientado a objetos
• Independiente del motor de base de datos.
• Basado en dialectos
• Similar a SQL y mas parecido a OQL.

24. Sentencia SELECT
• JPQL es sensible a las mayúsculas y minúsculas
para las entidades u objetos Java.
• Las palabras reservadas no son sensibles a las
mayúsculas y minúsculas.
• Ejemplo de Select basico:
SELECT c FROM Clientes c
SELECT c.propiedad.subPropiedad.subSubPropiedad FROM Clase c

25. Sentencia SELECT
• JPQL es sensible a las mayúsculas y minúsculas
para las entidades u objetos Java.
• Las palabras reservadas no son sensibles a las
mayúsculas y minúsculas.
• Ejemplo de Select basico:
SELECT c FROM Clientes c
SELECT c.propiedad.subPropiedad.subSubPropiedad FROM Clase c
select cli from Clientes as cli where cli.tiposDocumentos.tdocCodigo=:codigoTipoDocumento

26. Sentencia SELECT
• from Cat as cat
• from Cat as cat inner join cat.mate as mate left outer
join cat.kittens as kitten
• from Cat as cat where cat.mate.name like '%s%’
• select avg(cat.weight), sum(cat.weight),
max(cat.weight), count(cat) from Cat cat
• select foo from Foo foo, Bar bar where foo.startDate
= bar.date

27. Sentencia JOIN
SELECT c FROM Clientes c
SELECT c.propiedad.subPropiedad.subSubPropiedad FROM Clase c
select cli from Clientes as cli where cli.tiposDocumentos.tdocCodigo=:codigoTipoDocumento

28. Funciones aritmeticas
• Similares a las de SQL
SELECT COUNT(e) FROM Empleado e
SELECT AVG(cue.cueSaldo), SUM(cue.cueSaldo), cue FROM Cuentas as cue
SELECT cue FROM Cuentas cue WHERE MOD(cue.cueSaldo,2)=0

29. Sentencia UPDATE
• JPQL puede realizar operaciones de
actualización en la base de datos mediante la
sentencia UPDATE:
UPDATE Cuentas c SET c. cueSaldo = 1000 WHERE c.clientes.cliId = ‘101234’

30. Sentencia DELETE
• JPQL puede realizar operaciones de
actualización en la base de datos mediante la
sentencia DELETE:
DELETE FROM Movimiento m WHERE m. decMoviimporte < 5000

31. JPQL y Query
• JPQL es integrado a través de
implementaciones de la interface Query.
• La implementación de Query se obtiene
mediante el EntityManager.
• Los tres mas usados son:
– createQuery(String jpql)
– createNamedQuery(String name)
– createNativeQuery(String sql)

32. Resumen
• Hibernate el mapeador con mas
características del mercado.
• Es software libre
• Jboss ahora Red Hat
• JPA es una especificación de referencia
• Implementación de patrones de diseño
sofisticados para mejorar rendimiento de
acceso a datos.

33. Bibliografía
• EJB 3.0 In Action
• EJB 3.1 In Action
• Mastering Enterprise JavaBeans 3.0
• Java persistence with hibernate
• Beginning Java™ EE 7 Platform with
GlassFish™ 4: From Novice to Professional

34. Enlaces
• http://www.eclipse.org/eclipselink/
• http://www.hibernate.org/
• http://www.oracle.com/technetwork/articles/javaee/jp
a-137156.html
• http://www.javabeat.net/javabeat/ejb3/articles/2007/
04/introduction_to_java_persistence_api_jpa_ejb_3
_0_1
• http://www.oracle.com/technetwork/middleware/topli
nk/overview/index.html

35. Información de contacto
• Sitio Web: www.vortexbird.com
• Blog: http://blog.vortexbird.com
• Contacto vía mail: dgomez@vortexbird.com
• Direccion: Calle 18 # 118-241 Oficina 21
• Teléfonos: +57 - (316 482 4629)