Download - P2C2 Introducción a JEE5
Enalteciendo Los Temas
1 Entidades
2Beans de Sesión
3Delegados
AGENDA API de Persistencia de JavaEntidadesBeans de SesiónDelegadosResumen
Clase 02
1
2 CONTENIDO
API d
e Pe
rsis
tenc
ia d
e Ja
vaEl API de Persistencia de Java
brinda facilidad al momento de interactuar con la base de datos y hacer el mapeo de objeto/relación respecto a un modelo de datos relacional en sus aplicaciones.
JPA consiste en 3 áresEl API de Persistencia de Java.Mapeo de Objetos/Relaciones.El lenguaje Consultas.
Una entidad es un objeto del dominio de persistencia, pero mucho mas ligero. Típicamente una entidad representa una tabla de un modelo de datos relacional, en donde cada instancia de la entidad es una fila en dicha tabla.
Formalmente y eventualmente llamados “Entity Beans”.
Clases listadas en el elemento “<class>” en el archivo “persistence.xml”.
No son persistentes hasta que están asociadas a un EntityManager.em.persist(author);
ENTIDADES
Entid
ades
Instanciado y usado como
cualquier otro POJO
•Bike bike = new Bike(1);
•bike.setMake("trek");
•bike.setModel("2200");
•bike.setSize(26);
Interactúa con
el Entity Manage
r
•para realizar operaciones sobre la base de datos. •em.persist(b
ike);
Debe
•Tener un constructor que no recibe parámetros
•Ser anotada con la anotación @Entity y @Table
•Tener por lo menos 1 campo/propiedad anotada con @Id
•Implementar la interfaz Serializable
•Implementar los métodos hashCode(), equals() y toString().
Ejem
plo
de E
ntida
d An
otad
a :
Bike
.java
package java.examples.orm.core.annotated;
import javax.persistence.*;
@Entitypublic class Bike { private long id; private String make; private String model; private int size; public Bike() {} public Bike(long id) { this.id = id; }
@Id public long getId() { return id; }
private void setId(long id) { this.id = id; } public String getMake() { return make; } public void setMake(String make) { this.make = make; }
...}
Ejem
plo
de E
ntida
d N
o-An
otad
a: B
ike.
java
package java.examples.orm.core.mapped;
public class Bike { private long id; private String make; private String model; private int size;
public Bike() {} public Bike(long id) { this.id = id; }
public long getId() { return id; } private void setId(long id) { this.id = id; } public String getMake() { return make; } public void setMake(String make) { this.make = make; }
...}
Nom
bre
de la
Enti
dad
Usado para determinar el nombre de la tabla automáticamente
Bike class Bike tableEl nombre de la Tabla puede ser especificado sin tener relación con el nombre de la entidad
@Table(name=”table_name”)
Usado para referenciar a una clase a través de EJB-QL
Estr
uctu
ra e
lem
enta
l de
map
eoMapeo
imprescindible•@Table.name – asigna el nombre de la tabla•@Column.name – asigna el nombre de la columna
Atributos de mayor detalle
•Necesario para generar el esquema de la base de datos•@Column•unique – la columna será definida como “unique”•nullable – la columna será definida como “nullable”•insertable – la columna será incluida en los sentencias insert•updatable – la columna será incluida en los sentencias update•table – mapea a una columna a una tabla•length – longitud de VARCHAR() cuando usamos String•scale – define # dígitos en los tipos NUMERIC•precision – defines # posiciones decimales en tipos NUMERIC
Ejem
plo
de u
n es
quem
a de
BD
a
map
ear
create table CAR (CAR_ID bigint not null, CAR_YEAR integer not null, CAR_MODEL varchar(20) not null, CAR_MAKE varchar(20) not null, CAR_COST double, primary key (CAR_ID)
)
Map
eo a
BD
usa
ndo
Anot
acio
nes
package java.examples.orm.core.annotated;
import javax.persistence.*;
@Entity@Table(name="CAR")public class Car { private long id; private String make; private String model; private int year; private double cost;
public Car() {} public Car(long id) { this.id = id; } @Id @Column(name="CAR_ID", nullable=false) public long getId() { return id; }
private void setId(long id) { this.id = id; }
…
Map
eo a
BD
usa
ndo
Anot
acio
nes
@Column(name="CAR_MAKE", unique=false, nullable=false, insertable=true,updatable=true,table="", //nota: podemos apuntar a otra tabla para obtener la propiedadlength=20)
public String getMake() { return make; } public void setMake(String make) { this.make = make; } @Column(name="CAR_MODEL", nullable=false, length=20) public String getModel() { return model; } public void setModel(String model) { this.model = model; }
…
Map
eo a
BD
usa
ndo
Anot
acio
nes
@Column(name="CAR_YEAR", nullable=false) public int getYear() { return year; } public void setYear(int year) { this.year = year; } @Column(name="CAR_COST", scale=7, precision=2) public double getCost() { return cost; } public void setCost(double cost) { this.cost = cost; }
...}
Toda entidad debe tener una llave primaria
Llaves primarias deben ser únicas
Puede mapearse a una (llave primaria simple) o más (llave primaria compuesta) propiedades
Las propiedades deben ser de tipo- tipos primitivos Java (incluido: Integer, Long, etc.)- java.lang.String- Clases de tipo llave primaria (compuesta de tipos de propiedades adecuados)
LAVES PRIMARIAS SIMPLES
Llav
es P
rimar
ias
gene
rada
s
public interface javax.persistence.GeneratedValue { javax.persistence.GenerationType strategy(); String generator();}
public final class javax.persistence.GenerationType extends java.lang.Enum{ public static final GenerationType TABLE; public static final GenerationType SEQUENCE; public static final GenerationType IDENTITY; public static final GenerationType AUTO;}
Tipo
de
Gen
erac
ión
IDEN
TITY
Permite que la
base de datos
genere la llave
primaria
•create table GADGET (•id bigint generado
por defecto como identidad (empezando en 1),
•make varchar(255), •primary key (id)
•)
Usando Anotaci
ones
•@Id•@GeneratedValue(str
ategy=GenerationType.IDENTITY)
•public long getId() {•return id;
•}
Transient- Le dice al proveedor de persistencia que ignore este campo/propiedadFetchType- Le dice a la persistencia el modo de carga de las relaciones de una objetoTemporal- Especifica detalle para el mapeo de propiedades tipo Date y CalendarLob- Mapea tipos BLOB y CLOBEnumerated- Mapea tipo Enumerado Java SE 5
REFINAMIENTO DE MAPEO
Uso
de
Tran
sien
t
Esquema de
base de
datos
•create table TANK (•id bigint not null, •make varchar(255),
•model varchar(255),
•primary key (id)•)
Usando
Transient
•package java.examples.orm.core.annotated;•import java.io.Serializable;•import javax.persistence.*;
•@Entity•@Table(name="TANK")•public class Tank implements Serializable {•private static final long serialVersionUID = 1L;•private long id; private String make; private String model;
•public Tank() {}•public Tank(long id) { this.id = id; }•@Id•public long getId() { return id; }•private void setId(long id) { this.id = id; }•@Transient •public String getMakeModel() { return make + " " + model; }
•//not there is no setMakeModel(String)•...
•}
Ejem
plo
de L
ob
Definición
•El tipo String es almacenado como CLOB (Character Large Object) o BLOB (Binary Large Object).
•Preferentemente etiquetar con FetchType.LAZY si no se va a necesitar de primera instancia.
Esquema de
base de
datos
•create table UMBRELLA (•id bigint not
null, •make
longvarchar, •model
varchar(255), •primary key
(id)•)
Ejem
plo
de L
obpackage java.examples.orm.core.annotated;
import java.io.Serializable;import javax.persistence.*;@Entity@Table(name=“UMBRELLA")public class Umbrella implements Serializable { private static final long serialVersionUID = 1L; private long id; private String make; private String model;
public Umbrella() { } public Umbrella(long id) { this.id = id; } @Id public long getId() { return id; } private void setId(long id) { this.id = id; } @Lob @Basic(fetch=FetchType.LAZY) public char[] getMake() { return make.toCharArray(); } public void setMake(char[] make) { this.make = new String(make); }
Tipo
Tem
pora
l y E
num
Temporal
•Date•Time•Timesta
mp
Enum
•Valor ordinal
•Valor String
Ejemplo de
esquema
•create table VASE (•id bigint not null, •ADate date, •ATime time, •ATimestamp timestamp, •colorId integer, •colorName
varchar(255), •primary key (id)
•)
Ejem
plo
con
tipo
Tem
pora
l y
Enumpackage java.examples.orm.core.annotated;
import java.io.Serializable;import java.util.Date;import javax.persistence.*;Import java.examples.orm.core.ColorType;
@Entity@Table(name="VASE")public class Vase implements Serializable { private static final long serialVersionUID = 1L; private long id; private Date aDate; private Date aTime; private Date aTimestamp; private ColorType colorId; private ColorType colorName;
public Vase() {} public Vase(long id) { this.id = id; }
…
Usa
ndo
Tem
pora
l Met
adat
a @Temporal(TemporalType.DATE)public Date getADate() {
return aDate;}public void setADate(Date date) {
aDate = date;} @Temporal(TemporalType.TIME)public Date getATime() {
return aTime;}public void setATime(Date time) {
aTime = time;} @Temporal(TemporalType.TIMESTAMP)public Date getATimestamp() {
return aTimestamp;}public void setATimestamp(Date timestamp) {
aTimestamp = timestamp;}...
Usa
ndo
Tem
pora
l Met
adat
a @Enumerated(EnumType.ORDINAL)public ColorType getColorId() {
return colorId;}public void setColorId(ColorType colorId) {
this.colorId = colorId;}@Enumerated(EnumType.STRING)public ColorType getColorName() {
return colorName;}public void setColorName(ColorType colorName) {
this.colorName = colorName;} @Idpublic long getId() {
return id;}private void setId(long id) {
this.id = id;}
//final of class}
Maneja el mapeo de O/R de las entidades a la base de datos.
Provee API’s- Insertando objetos en la base de datos- Obteniendo objetos de la base de datos- Sincronizando objetos con la base de datos- Consultando de la base de datos
Provee acceso en caché
Se coordina con servicios transaccionales del servidor (JTA)
javax.persistence.EntityManager
Es un juego de instancias de entidades administradas por un Entity Manager
Todas las entidades se vuelven “detached” una vez que han sido cerradas o eliminadas
Existen 2 tipos- Contextos de Persistencia de alcance-transaccional
>> inicio/fin en los limites de la transacción- Contextos de Persistencia extendidos
>> vive mas que una transacción simple>> permite interacciones más duraderas con la base de datos
CONTEXTO DE PERSISTENCIA
Ejem
plo
de C
onte
xto
de
Pers
iste
ncia
Alcance
transaccional
(dentro de un
servidor)
•@PersistenceContext(unitName=”jpaDemo”)
•private EntityManager em;
•public void update(long authorId, String type) {•Author author =
em.find(Author.class, authorId);
•author.setType(type);
•em.merge(author);
•}
Extendido (dentro o fuera de un
servidor)
•EntityManager em = Persistence.
•createEntityManagerFactory(“jpaDemo”).createEntityManager();
•tx.begin(); //tx 1 begins•Author author =
em.find(Author.class, authorId);•tx.commit(); //tx 1 ends, but
author remains managed•...•tx.begin(); //tx 2 begins•author.setType(type);•tx.commit(); //tx 2 ends, and
author is still managed until close
Es un juego de clases que están mapeadas a la base de datos
Definido en META-INF/persistence.xml
Debe tener un identificador (name=“”)
Las Clases - Pueden ser nombradas en el archivo “persistence.xml”- Pueden ser automáticamente escaneadas del proyecto
UNIDAD DE PERSISTENCIA
Son componentes que permiten interactuar con la base de datos y que residen en el servidor.
A través del entity manager estos componentes pueden realizar operaciones de actualización sobre la base de datos.
Debe tenerse en cuenta el tipo de transacción que está usando el contexto de presistencia para asegurar la coherencia de los datos.
BEANS DE SESIÓN
pers
ist(
)
Ejemplo
•Author author = new Author();
•author.setFirstName("dr");
•author.setLastName("seuss");
•author.setSubject("children");
•author.setPublishDate(new Date());
•em.persist(author);
Contextos de persistencia
extendidos
•Encola la escritura hasta ser asociado con una transacción
Contextos de persistencia
de alcanc
e-transaccional
•Imposible de llamar fuera de un servidor
find(
)
Ejemplo
•Author author2 = null;•author2 =
em.find(Author.class, id);
•log.info("got author author:" + author2);
•got author author:id=51, fn=thing, ln=one, subject=children, pdate=Fri Sep 15 11:54:15 EDT 2006
Definiciones
•Retorna una instancia de la clase asociada con el valor de la llave primaria especificada.•Las relaciones son
instanciadas de acuerdo a las políticas de carga de enlaces (Fetch).
•Retorna nulo si la llave primaria no se ha encontrado.
•Usa genéricos, de tal modo que no necesita casting.
•Será “atached” al contexto de persistencia abierto.•ejecutar find() por
segunda vez, retornará el mismo objeto
getR
efer
ence
()
Ejemplo
•Author author2=null;•author2 =
em.getReference(Author.class, id);
•log_.info("got author author:" + author2);
Similar a
find()
•Retorna una instancia de la clase asociada con el valor de la llave primaria especificada.•No garantiza que
el estado del objeto se haya inicializado.
•Lanza EntityNotFoundException si la llave primaria no se ha encontrado.
crea
teQ
uery
()
5 métodos
•Todos devuelven una instancia de java.persistence.Query•Query
createQuery(String ejbqlString);
•Query createNamedQuery(String name);
•Query createNativeQuery(String sqlString);
•Query createNativeQuery(String sqlString, Class resultClass);
•Query createNativeQuery(String sqlString, String resultSetMap);
Ejemplo
•Query query = em.createQuery("from jpaAuthor where id=" + id);
•Author author = (Author) query.getSingleResult();
Definicion
es
•Usa EJB-QL y consultas con lenguaje nativo.
•Similar a find()/getReference().•Retorna
objetos “atached” a un contexto de persistencia abierto.
mer
ge()
Ejemplo
•public Author updateByMerge(Author author) {
• Author managedAuthor = em.merge(author);
• return managedAuthor;
•}
Definicion
es
•Unifica los cambios de estado de la entidad en el almacén de persistencia.
•El original permanece “detached”.
•El objeto retornado (editado) es administrado.
rem
ove(
)
Ejemplo
•public void remove(Author author) {
• em.remove(author);
•}
Definicion
es
•Elimina objetos de la base de datos•Físicamente
ejecutado en la base de datos de acuerdo con la política flush
•Ejecución en cascada a objetos relacionado de acuerdo a la política cascade
•El objeto se vuelve “detached”
refr
esh(
) y c
onta
ins(
) Ejemplo
•Author author = em.find(Author.class, id);
•em.refresh(author);
•if (em.contains(author)) {•...
•}
Definiciones
•Usado para asegurar que la entidad esté sincronizada con la base de datos.
•Ejecución en cascada a objetos relacionados dependiendo de la política cascade.
•La entidad debe estar actualmente administrada por el entity manager.
•Usado para verificar que la instancia de la entidad esté siendo administrada por el entity manager.
clea
r() y
flus
h()
clear()
•Desconecta todas las entidad, volviéndolas detached.
•No confirma los cambios encolados.•Debe llamarse
a flush() antes de clear().
flush()
•Cambios no se sincronizan con la base de datos hasta que el entity manager ejecute flush().•persist(), merge(),
remove().•Ocurre automáticamente
antes de ejecutar.•Consultas relacionadas.•Confirmar una
transacción (commit).•FlushMode
•AUTO – por defecto y lo más saludable.
•COMMIT – una optimización para sincronizar y finalizar una transacción manualmente.
Son componentes que actúan como proxies aplicando las reglas del negocio al delegar las tareas a los beans de sesión correspondientes.
Es necesario realizar una serie de pasos para garantizar una conexión segura entre este componente y los beans de sesión.
DELEGADOS
Paso 1
Crear una clase con un nombre que cumpla con la siguiente nomenclatura:
“NombreEntidad”+Delegate
Crear una propiedad del tipo de bean de sesión que nos permita trabajar con la entidad correspondiente.
Paso 2
Hacer clic derecho sobre cualquier parte de la clase y seleccionar la opción “Insert Code…”.
De preferencia, hacerlo dentro del cuerpo de la clase.
Paso 3
En el menú emergente que aparece, seleccionar la opción “Call Enterprise Bean”.
Paso 4
Aparecerá una ventana como la siguiente, en la cual buscaremos el bean de sesión con el cual queremos que nuestro Delegado tenga conexión.
Luego de eso, sin modificar el campo “Reference Name”, hacemos clic en “OK”.
Paso 5
Luego de cumplir el paso 4, automáticamente aparecerá este segmento de código.
La función de este método es crear una conexión limpia entre el delegado y el servidor para obtener una instancia del bean de sesión.
Es importante que este método se genere cumpliendo estos pasos. Sin embargo, esta tarea sólo se realiza una vez por proyecto web. Sí y solo si ya se ha generado por primera vez, se puede copiar de una clase a otra.
Paso 6
Ahora debemos crear un constructor que no reciba parámetros, pero que en el cuerpo se inicialice la variable “local” haciendo un llamado al método que se generó en el paso anterior. Tal como su muestra en la siguiente imagen.
Es imprescindible que se realice este paso, ya que de no hacerlo la variable “local” siempre será null.
Paso 7
El paso 5 tiene repercusión en el archivo web.xml. Como sabemos, este archivo describe los parámetros de despliegue y la configuración de la aplicación en el servidor.
Por tal motivo, en la pestaña “Referencias” encontraremos nuestra referencia hacia el bean de sesión seleccionado.
Paso 8
Podemos revisar el archivo web.xml en formato XML para darnos cuenta que los valores coinciden con nuestro método lookupPersonaFacade().
Paso 9Sólo para demostrar un ejemplo de lo que puede hacer un Delegado, crearemos un método público crear que reciba como un parámetro a una persona.
Este método es susceptible a lanzar excepciones cuando hay un error en la comunicación con la base de datos o cuando incumple la regla: “DNI es único por persona”.
Nótese que toda interacción con la base de datos el método delega la tarea al bean de sesión correspondiente.
3 Resumen
» Esta es la arquitectura de desarrollo que debemos respetar desde el inicio de la implementación hasta el despliegue de una aplicación empresarial.
» Esta clase sólo ha tocado 3 capas de las 5 propuestas. ¿Cuales son estas 3 capas?
RESUMEN
Session Beans Seguridad
Entidades del Negocio
EJB
Controladores Delegados
Archivos de Configuración
WAR
WAR
Interfaces de Usuario
Componentes GUI Personalizados
Richfaces 3.x
My F
aces 1.7
Java Mail
utilitarios
EAR
GRACIAS
O también puedes encontrarla
en .
Saludos!
AULA VIRTUALEncuentra esta presentación en el