|
| 1 | +.. _orm-pattern: |
| 2 | + |
| 3 | +Estrategias de diseño |
| 4 | +===================== |
| 5 | +Cuando analizamos :ref:`conectores <conn>`, ya expusimos que uno de los patrones |
| 6 | +de diseño más socorridos es el patrón |DAO|. Al usar un |ORM| podríamos seguir |
| 7 | +esa misma estrategia y definir una interfaz |CRUD| para crear clases |DAO| para |
| 8 | +todas las entidades del modelo. En este caso, la única salvedad es que las |
| 9 | +implementaciones de los métodos de la interfaz no se basarían en |JDBC| sino en |
| 10 | +|JPA|. Ahora bien, muy comúnmente y a menos que nuestra intención sea |
| 11 | +reaprovechar una interfaz antigua implementada con |JDBC|, obrar de esta manera |
| 12 | +es un poco redundante, ya que el propio |JPA| tiene una orientación semejante a |
| 13 | +|DAO|. |
| 14 | + |
| 15 | +Lo que sí es muy conveniente es intentar liberar al resto del código de las |
| 16 | +particularidades del acceso, así que conviene encerrarlas en una clase auxiliar. |
| 17 | +Podríamos proponer esta: |
| 18 | + |
| 19 | +.. literalinclude:: files/JpaBackend.java |
| 20 | + :class: toggle |
| 21 | + :caption: JpaBackend.java |
| 22 | + :language: java |
| 23 | + :start-at: public class |
| 24 | + |
| 25 | +Esta clase implementa un `patrón Singleton`_ ampliado que posibilita la creación |
| 26 | +de una única fábrica por entidad de persistencia. Cada una de estas fábricas se |
| 27 | +asocia a un índice a partir del **1** para que podamos recuperarlas |
| 28 | +posteriormente cuando nos sean necesarias: |
| 29 | + |
| 30 | +.. code-block:: java |
| 31 | +
|
| 32 | + public static main(String[] args) throws Exception {} |
| 33 | + // Propiedades configuradas en tiempo de ejecución. |
| 34 | + Map<String, String> props = new HashMap<>(); |
| 35 | + props.put("jakarta.persistence.jdbc.url", "jdbc:sqlite:centro.db"); |
| 36 | + props.put("hibernate.show_sql", "true"); |
| 37 | +
|
| 38 | + int idx = JpaBackend.createEntityManagerFactory("MiUnidadP", props); |
| 39 | +
|
| 40 | + // ... |
| 41 | +
|
| 42 | + try(EntityManagerFactory emf = JpaBackend.getEntityManagerFactory(idx)) { |
| 43 | + operaciones(idx); // Aquí se crean y usan objetos EntityManager |
| 44 | + } |
| 45 | + } |
| 46 | +
|
| 47 | + private static void operaciones(int idx) { |
| 48 | + // ¡Ojo! No hay que cerrarlo. |
| 49 | + EntityManagerFactory emf = JpaEmFactory.getInstance(idx); // Devuelve el mismo objeto. |
| 50 | +
|
| 51 | + try(em EntityFactory = emf.createEntityManager()) { |
| 52 | + EntityTransaction tr = em.getTransaction(); |
| 53 | + try { |
| 54 | + tr.begin(); |
| 55 | + Centro centro = new Centro(11004866, "IES Castillo de Luna", Centro.Titularidad.PUBLICA); |
| 56 | + em.persist(centro); |
| 57 | + tr.commit(); |
| 58 | + } |
| 59 | + catch(Exception e) { |
| 60 | + if(tr != null && tr.isActive()) tr.rollback(); |
| 61 | + throw new RuntimeException("Error al almacenar el centro", err); |
| 62 | + } |
| 63 | + } |
| 64 | + } |
| 65 | +
|
| 66 | +.. tip:: Se ha permitido también que en caso de que sólo se haya creado una |
| 67 | + fábrica, ni siquiera sea necesario facilitar el índice: |
| 68 | + |
| 69 | + .. code-block:: java |
| 70 | +
|
| 71 | + try(EntityManagerFactory emf = JpaBackend.getEntityManagerFactory()) { |
| 72 | + operaciones(); |
| 73 | + } |
| 74 | +
|
| 75 | +Obtener la fábrica, sin embargo, nos obligaría a crear objetos |
| 76 | +:jakarta-persistence:`EntityManager` y a gestionar correctamente las |
| 77 | +transacciones con lo que no abstraería el código de las particularidades del |
| 78 | +almacenamiento. Por ese motivo la clase incluye algunos métodos para manejar |
| 79 | +automáticamente las transacciones: |
| 80 | + |
| 81 | +.. code-block:: java |
| 82 | +
|
| 83 | + // Usamos la fábrica 1 para hacer persistente un centro. |
| 84 | + // También podríamos obviar el índice, si sólo hubiera una fábrica |
| 85 | + JpaBackend.transaction(1, em -> { |
| 86 | + Centro centro = new Centro(11004866L, "IES Castillo de Luna", Centro.Titularidad.PUBLICA); |
| 87 | + em.persist(centro); |
| 88 | + }); |
| 89 | +
|
| 90 | +
|
| 91 | + // Este método es capaz de devolver lo que devuelve la función del argumento. |
| 92 | + // Como en el caso anterior, se puede obviar el índice 1. |
| 93 | + Centro otro = JpaBackend.transactionR(1, em -> em.get(Centro.class, 11004866L)); |
| 94 | +
|
| 95 | +
|
| 96 | +.. |DAO| replace:: :abbr:`DAO (Data Access Object)` |
| 97 | +.. |CRUD| replace:: :abbr:`CRUD (Create, Read, Update, Delete)` |
| 98 | +.. |JDBC| replace:: :abbr:`JDBC (Java DataBase Connectivity)` |
| 99 | +.. |ORM| replace:: :abbr:`ORM (Object-Relational Mapping)` |
| 100 | +.. |JPA| replace:: :abbr:`JPA (Java Persistence API)` |
| 101 | + |
| 102 | +.. _patrón Singleton: https://es.wikipedia.org/wiki/Singleton |
0 commit comments