From 146a0fb8b0e90f9196e569152f649baf60d6cc8f Mon Sep 17 00:00:00 2001
From: Joaquín Reñé <jrene@curisit.net>
Date: Tue, 07 Oct 2025 14:52:57 +0000
Subject: [PATCH] #4410 - Comments on classes

---
 securis/src/main/java/net/curisit/securis/ioc/EntityManagerProvider.java |   29 +++++++++++++++++++++++++++--
 1 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/securis/src/main/java/net/curisit/securis/ioc/EntityManagerProvider.java b/securis/src/main/java/net/curisit/securis/ioc/EntityManagerProvider.java
index be020f5..f702c97 100644
--- a/securis/src/main/java/net/curisit/securis/ioc/EntityManagerProvider.java
+++ b/securis/src/main/java/net/curisit/securis/ioc/EntityManagerProvider.java
@@ -1,3 +1,6 @@
+/*
+* Copyright @ 2013 CurisTEC, S.A.S. All Rights Reserved.
+*/
 package net.curisit.securis.ioc;
 
 import jakarta.enterprise.context.ApplicationScoped;
@@ -8,16 +11,38 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 
+/**
+* EntityManagerProvider
+* <p>
+* Simple provider for JPA {@link EntityManager} instances using the
+* persistence unit "localdb". Creates an {@link EntityManagerFactory}
+* once per application and returns a fresh {@link EntityManager} per call.
+*
+* Note:
+* - Callers are responsible for closing the obtained EntityManager.
+* 
+* @author JRA
+* Last reviewed by JRA on Oct 5, 2025.
+*/
 @ApplicationScoped
 public class EntityManagerProvider {
 
     @SuppressWarnings("unused")
-	private static final Logger log = LogManager.getLogger(EntityManagerProvider.class);
+    private static final Logger log = LogManager.getLogger(EntityManagerProvider.class);
 
+    /** 
+     * entityManagerFactory<p>
+     * Application-wide EMF built from persistence.xml PU "localdb". 
+     */
     private final EntityManagerFactory entityManagerFactory = Persistence.createEntityManagerFactory("localdb");
 
+    /**
+    * getEntityManager<p>
+    * Create a new {@link EntityManager}.
+    *
+    * @return a new EntityManager; caller must close it
+    */
     public EntityManager getEntityManager() {
         return entityManagerFactory.createEntityManager();
     }
-
 }

--
Gitblit v1.3.2