This is an automated email from the ASF dual-hosted git repository. dds pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/tomee.git
The following commit(s) were added to refs/heads/master by this push: new 42b4916 Translate to Spanish: example/simple-singlento new 8004754 Merge pull request #667 from gacsnic/TOMEE-2858 42b4916 is described below commit 42b4916b299be3e04ce898ad8062d2588b48650c Author: GACS <gacsni...@gmail.com> AuthorDate: Sat Jul 4 23:02:17 2020 -0600 Translate to Spanish: example/simple-singlento --- examples/simple-singleton/README_es.adoc | 364 +++++++++++++++++++++++++++++++ 1 file changed, 364 insertions(+) diff --git a/examples/simple-singleton/README_es.adoc b/examples/simple-singleton/README_es.adoc new file mode 100644 index 0000000..fc13a8a --- /dev/null +++ b/examples/simple-singleton/README_es.adoc @@ -0,0 +1,364 @@ +:index-group: Session Beans +:jbake-type: page +:jbake-status: status=published += Simple Singleton + +Como su nombre lo indica, un `javax.ejb.Singleton`, es un bean de sesión con la garantía de que existe como máximo una instancia en la aplicación. + +Lo que falta por completo en EJB 3.0 y versiones anteriores, es la capacidad de tener un EJB que se notifique cuando la aplicación se inicia y cuando se detiene. Por lo tanto, puede hacer todo tipo de cosas que anteriormente solo podía hacer con un servlet de carga al inicio. También le brinda un lugar para almacenar datos que pertenecen a toda la aplicación y a todos los usuarios que la utilizan, sin la necesidad de un estático. Además, los beans Singleton pueden ser invocados por múlti [...] +al mismo tiempo similar a un servlet. + +Vea link:../../singleton-beans.html[Singleton Beans] para obtener una página completa de la descripción de la API javax.ejb.Singleton. + +#El codigo + +== Concurrencia Bean-Managed de PropertyRegistry +Aquí vemos un bean que usa la opción de concurrencia Bean-Managed, así como la anotación @Startup que hace que el bean sea confirmado por el contenedor cuando se inicia la aplicación. +Los beans Singleton con @ConcurrencyManagement(BEAN) son responsables de su propia seguridad de subprocesos. El bean que se muestra es un simple ``registry'' de propiedad y proporciona un lugar donde todos los beans de aplicación podrían establecer y recuperar opciones. + +.... +package org.superbiz.registry; + +import javax.annotation.PostConstruct; +import javax.annotation.PreDestroy; +import javax.ejb.ConcurrencyManagement; +import javax.ejb.Singleton; +import javax.ejb.Startup; +import java.util.Properties; + +import static javax.ejb.ConcurrencyManagementType.BEAN; + +@Singleton +@Startup +@ConcurrencyManagement(BEAN) +public class PropertyRegistry { + + +// Tenga en cuenta que el objeto java.util.Properties es una +// colección segura para subprocesos que utiliza sincronización. Si no fuera así, +// tendría que usar alguna forma de sincronización para asegurarse +// de que PropertyRegistryBean sea seguro para subprocesos. + private final Properties properties = new Properties(); + +// La anotación @Startup garantiza que se +// llame a este método cuando se inicia la aplicación. + @PostConstruct + public void applicationStartup() { + properties.putAll(System.getProperties()); + } + + @PreDestroy + public void applicationShutdown() { + properties.clear(); + } + + public String getProperty(final String key) { + return properties.getProperty(key); + } + + public String setProperty(final String key, final String value) { + return (String) properties.setProperty(key, value); + } + + public String removeProperty(final String key) { + return (String) properties.remove(key); + } +} +.... + +== ComponentRegistry Container-Managed Concurrency + +Aquí vemos un bean que usa la opción de concurrencia 'Container-Managed', el valor predeterminado. Con `@ConcurrencyManagement(CONTAINER)` el contenedor controla si se debe permitir el acceso multiproceso al bean +(`@Lock(READ)`) o si se debe forzar el acceso de un solo subproceso +(`@Lock(WRITE)`). + +.... +package org.superbiz.registry; + +import javax.ejb.Lock; +import javax.ejb.Singleton; +import java.util.ArrayList; +import java.util.Collection; +import java.util.HashMap; +import java.util.Map; + +import static javax.ejb.LockType.READ; +import static javax.ejb.LockType.WRITE; + +@Singleton +@Lock(READ) +public class ComponentRegistry { + + private final Map<Class, Object> components = new HashMap<Class, Object>(); + + public <T> T getComponent(final Class<T> type) { + return (T) components.get(type); + } + + public Collection<?> getComponents() { + return new ArrayList(components.values()); + } + + @Lock(WRITE) + public <T> T setComponent(final Class<T> type, final T value) { + return (T) components.put(type, value); + } + + @Lock(WRITE) + public <T> T removeComponent(final Class<T> type) { + return (T) components.remove(type); + } +} +.... + +A menos que se especifique explícitamente en la clase de bean o un método, el valor predeterminado `@Lock` es `@Lock(WRITE)`. El código anterior utiliza la anotación `@Lock(READ)` en la clase bean para cambiar el valor predeterminado, de modo que se otorgue el acceso multiproceso por defecto. Entonces solo necesitamos aplicar la anotación `@Lock(WRITE)` a los métodos que modifican el estado del bean. + +Esencialmente, `@Lock(READ)` permite el acceso multiproceso a la instancia del bean Singleton, a menos que alguien invoque un método `@Lock(WRITE)`. Con `@Lock(WRITE)`, se garantizará que el subproceso que invoca el bean tendrá acceso exclusivo a la instancia del bean Singleton mientras dure su invocación. Esta combinación permite que la instancia de bean use tipos de datos que normalmente no son seguros para subprocesos. Se debe tener mucho cuidado. + +En el ejemplo vemos `ComponentRegistryBean` usando un +`java.util.HashMap` que no está sincronizado. Para hacer esto bien, hacemos +tres cosas: + +[arabic] +. Encapsulación. No exponemos la instancia de HashMap directamente; incluidos sus iteradores, conjunto de claves, conjunto de valores o conjunto de entradas. +. Usamos `@Lock(WRITE)` en los métodos que mutan el mapa, como los métodos `put()` y `remove()`. +. Utilizamos `@Lock(READ)` en los métodos `get()` y `values()` ya que no cambian el estado del mapa y se garantiza que no se invocarán al mismo tiempo que cualquiera de los `@Lock(WRITE)`, por lo que sabemos que el estado de HashMap no está siendo mutado y, por lo tanto, es seguro para la lectura. + + +El resultado final, el modelo de subprocesos para este bean cambiará de acceso, de subprocesos múltiples a acceso de subprocesos dinámicos, según sea necesario, dependiendo del método que se invoque. Esto le da a los singleton, una ventaja sobre los Servlets, para procesar solicitudes de subprocesos múltiples. + +Vea link:../../singleton-beans.html[Singleton Beans] página para obtener detalles más avanzados sobre la concurrencia Container-Managed. + +== Testing + +=== ComponentRegistryTest + +.... +package org.superbiz.registry; + +import org.junit.AfterClass; +import org.junit.Assert; +import org.junit.Test; + +import javax.ejb.embeddable.EJBContainer; +import javax.naming.Context; +import java.net.URI; +import java.util.Collection; +import java.util.Date; + +public class ComponentRegistryTest { + + private final static EJBContainer ejbContainer = EJBContainer.createEJBContainer(); + + @Test + public void oneInstancePerMultipleReferences() throws Exception { + + final Context context = ejbContainer.getContext(); + + // Las dos referencias a continuación apuntan a la misma instancia exacta + final ComponentRegistry one = (ComponentRegistry) context.lookup("java:global/simple-singleton/ComponentRegistry"); + final ComponentRegistry two = (ComponentRegistry) context.lookup("java:global/simple-singleton/ComponentRegistry"); + + final URI expectedUri = new URI("foo://bar/baz"); + one.setComponent(URI.class, expectedUri); + final URI actualUri = two.getComponent(URI.class); + Assert.assertSame(expectedUri, actualUri); + + two.removeComponent(URI.class); + URI uri = one.getComponent(URI.class); + Assert.assertNull(uri); + + one.removeComponent(URI.class); + uri = two.getComponent(URI.class); + Assert.assertNull(uri); + + final Date expectedDate = new Date(); + two.setComponent(Date.class, expectedDate); + final Date actualDate = one.getComponent(Date.class); + Assert.assertSame(expectedDate, actualDate); + + Collection<?> collection = one.getComponents(); + System.out.println(collection); + Assert.assertEquals("Reference 'one' - ComponentRegistry contains one record", collection.size(), 1); + + collection = two.getComponents(); + Assert.assertEquals("Reference 'two' - ComponentRegistry contains one record", collection.size(), 1); + } + + @AfterClass + public static void closeEjbContainer() { + ejbContainer.close(); + } +} +.... + +=== PropertiesRegistryTest + +.... +package org.superbiz.registry; + +import org.junit.AfterClass; +import org.junit.Assert; +import org.junit.Test; + +import javax.ejb.embeddable.EJBContainer; +import javax.naming.Context; + +public class PropertiesRegistryTest { + + private final static EJBContainer ejbContainer = EJBContainer.createEJBContainer(); + + @Test + public void oneInstancePerMultipleReferences() throws Exception { + + final Context context = ejbContainer.getContext(); + + final PropertyRegistry one = (PropertyRegistry) context.lookup("java:global/simple-singleton/PropertyRegistry"); + final PropertyRegistry two = (PropertyRegistry) context.lookup("java:global/simple-singleton/PropertyRegistry"); + + one.setProperty("url", "http://superbiz.org"); + String url = two.getProperty("url"); + Assert.assertSame("http://superbiz.org", url); + + two.removeProperty("url"); + url = one.getProperty("url"); + Assert.assertNull(url); + + two.setProperty("version", "1.0.5"); + String version = one.getProperty("version"); + Assert.assertSame("1.0.5", version); + + one.removeProperty("version"); + version = two.getProperty("version"); + Assert.assertNull(version); + } + + @AfterClass + public static void closeEjbContainer() { + ejbContainer.close(); + } +} +.... + +#Ejecutar + +Ejecutar el ejemplo es bastante simple. En el directorio `simple-singleton` + ejecutar: + +.... +$ mvn clean install +.... + +Lo que debería crear resultados como los siguientes. + +.... +------------------------------------------------------- + T E S T S +------------------------------------------------------- +Running org.superbiz.registry.ComponentRegistryTest +INFO - ******************************************************************************** +INFO - OpenEJB http://tomee.apache.org/ +INFO - Startup: Sun Jun 09 03:46:51 IDT 2013 +INFO - Copyright 1999-2013 (C) Apache OpenEJB Project, All Rights Reserved. +INFO - Version: 7.0.0-SNAPSHOT +INFO - Build date: 20130608 +INFO - Build time: 04:07 +INFO - ******************************************************************************** +INFO - openejb.home = C:\Users\Oz\Desktop\ee-examples\simple-singleton +INFO - openejb.base = C:\Users\Oz\Desktop\ee-examples\simple-singleton +INFO - Created new singletonService org.apache.openejb.cdi.ThreadSingletonServiceImpl@448ad367 +INFO - Succeeded in installing singleton service +INFO - Using 'javax.ejb.embeddable.EJBContainer=true' +INFO - Cannot find the configuration file [conf/openejb.xml]. Will attempt to create one for the beans deployed. +INFO - Configuring Service(id=Default Security Service, type=SecurityService, provider-id=Default Security Service) +INFO - Configuring Service(id=Default Transaction Manager, type=TransactionManager, provider-id=Default Transaction Manager) +INFO - Creating TransactionManager(id=Default Transaction Manager) +INFO - Creating SecurityService(id=Default Security Service) +INFO - Found EjbModule in classpath: c:\users\oz\desktop\ee-examples\simple-singleton\target\classes +INFO - Beginning load: c:\users\oz\desktop\ee-examples\simple-singleton\target\classes +INFO - Configuring enterprise application: C:\Users\Oz\Desktop\ee-examples\simple-singleton +INFO - Auto-deploying ejb PropertyRegistry: EjbDeployment(deployment-id=PropertyRegistry) +INFO - Auto-deploying ejb ComponentRegistry: EjbDeployment(deployment-id=ComponentRegistry) +INFO - Configuring Service(id=Default Singleton Container, type=Container, provider-id=Default Singleton Container) +INFO - Auto-creating a container for bean PropertyRegistry: Container(type=SINGLETON, id=Default Singleton Container) +INFO - Creating Container(id=Default Singleton Container) +INFO - Configuring Service(id=Default Managed Container, type=Container, provider-id=Default Managed Container) +INFO - Auto-creating a container for bean org.superbiz.registry.ComponentRegistryTest: Container(type=MANAGED, id=Default Managed Container) +INFO - Creating Container(id=Default Managed Container) +INFO - Using directory C:\Users\Oz\AppData\Local\Temp for stateful session passivation +INFO - Enterprise application "C:\Users\Oz\Desktop\ee-examples\simple-singleton" loaded. +INFO - Assembling app: C:\Users\Oz\Desktop\ee-examples\simple-singleton +INFO - Jndi(name="java:global/simple-singleton/PropertyRegistry!org.superbiz.registry.PropertyRegistry") +INFO - Jndi(name="java:global/simple-singleton/PropertyRegistry") +INFO - Jndi(name="java:global/simple-singleton/ComponentRegistry!org.superbiz.registry.ComponentRegistry") +INFO - Jndi(name="java:global/simple-singleton/ComponentRegistry") +INFO - Existing thread singleton service in SystemInstance(): org.apache.openejb.cdi.ThreadSingletonServiceImpl@448ad367 +INFO - OpenWebBeans Container is starting... +INFO - Adding OpenWebBeansPlugin : [CdiPlugin] +INFO - All injection points were validated successfully. +INFO - OpenWebBeans Container has started, it took 68 ms. +INFO - Created Ejb(deployment-id=PropertyRegistry, ejb-name=PropertyRegistry, container=Default Singleton Container) +INFO - Created Ejb(deployment-id=ComponentRegistry, ejb-name=ComponentRegistry, container=Default Singleton Container) +INFO - Started Ejb(deployment-id=PropertyRegistry, ejb-name=PropertyRegistry, container=Default Singleton Container) +INFO - Started Ejb(deployment-id=ComponentRegistry, ejb-name=ComponentRegistry, container=Default Singleton Container) +INFO - Deployed Application(path=C:\Users\Oz\Desktop\ee-examples\simple-singleton) +[Sun Jun 09 03:46:52 IDT 2013] +INFO - Undeploying app: C:\Users\Oz\Desktop\ee-examples\simple-singleton +INFO - Destroying OpenEJB container +Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.431 sec +Running org.superbiz.registry.PropertiesRegistryTest +INFO - ******************************************************************************** +INFO - OpenEJB http://tomee.apache.org/ +INFO - Startup: Sun Jun 09 03:46:52 IDT 2013 +INFO - Copyright 1999-2013 (C) Apache OpenEJB Project, All Rights Reserved. +INFO - Version: 7.0.0-SNAPSHOT +INFO - Build date: 20130608 +INFO - Build time: 04:07 +INFO - ******************************************************************************** +INFO - openejb.home = C:\Users\Oz\Desktop\ee-examples\simple-singleton +INFO - openejb.base = C:\Users\Oz\Desktop\ee-examples\simple-singleton +INFO - Created new singletonService org.apache.openejb.cdi.ThreadSingletonServiceImpl@448ad367 +INFO - Succeeded in installing singleton service +INFO - Using 'javax.ejb.embeddable.EJBContainer=true' +INFO - Cannot find the configuration file [conf/openejb.xml]. Will attempt to create one for the beans deployed. +INFO - Configuring Service(id=Default Security Service, type=SecurityService, provider-id=Default Security Service) +INFO - Configuring Service(id=Default Transaction Manager, type=TransactionManager, provider-id=Default Transaction Manager) +INFO - Creating TransactionManager(id=Default Transaction Manager) +INFO - Creating SecurityService(id=Default Security Service) +INFO - Using 'java.security.auth.login.config=jar:file:/C:/Users/Oz/.m2/repository/org/apache/openejb/openejb-core/7.0.0-SNAPSHOT/openejb-core-7.0.0-SNAPSHOT.jar!/login.config' +INFO - Found EjbModule in classpath: c:\users\oz\desktop\ee-examples\simple-singleton\target\classes +INFO - Beginning load: c:\users\oz\desktop\ee-examples\simple-singleton\target\classes +INFO - Configuring enterprise application: C:\Users\Oz\Desktop\ee-examples\simple-singleton +INFO - Auto-deploying ejb ComponentRegistry: EjbDeployment(deployment-id=ComponentRegistry) +INFO - Auto-deploying ejb PropertyRegistry: EjbDeployment(deployment-id=PropertyRegistry) +INFO - Configuring Service(id=Default Singleton Container, type=Container, provider-id=Default Singleton Container) +INFO - Auto-creating a container for bean ComponentRegistry: Container(type=SINGLETON, id=Default Singleton Container) +INFO - Creating Container(id=Default Singleton Container) +INFO - Configuring Service(id=Default Managed Container, type=Container, provider-id=Default Managed Container) +INFO - Auto-creating a container for bean org.superbiz.registry.PropertiesRegistryTest: Container(type=MANAGED, id=Default Managed Container) +INFO - Creating Container(id=Default Managed Container) +INFO - Using directory C:\Users\Oz\AppData\Local\Temp for stateful session passivation +INFO - Enterprise application "C:\Users\Oz\Desktop\ee-examples\simple-singleton" loaded. +INFO - Assembling app: C:\Users\Oz\Desktop\ee-examples\simple-singleton +INFO - Jndi(name="java:global/simple-singleton/ComponentRegistry!org.superbiz.registry.ComponentRegistry") +INFO - Jndi(name="java:global/simple-singleton/ComponentRegistry") +INFO - Jndi(name="java:global/simple-singleton/PropertyRegistry!org.superbiz.registry.PropertyRegistry") +INFO - Jndi(name="java:global/simple-singleton/PropertyRegistry") +INFO - Existing thread singleton service in SystemInstance(): org.apache.openejb.cdi.ThreadSingletonServiceImpl@448ad367 +INFO - OpenWebBeans Container is starting... +INFO - Adding OpenWebBeansPlugin : [CdiPlugin] +INFO - All injection points were validated successfully. +INFO - OpenWebBeans Container has started, it took 4 ms. +INFO - Created Ejb(deployment-id=PropertyRegistry, ejb-name=PropertyRegistry, container=Default Singleton Container) +INFO - Created Ejb(deployment-id=ComponentRegistry, ejb-name=ComponentRegistry, container=Default Singleton Container) +INFO - Started Ejb(deployment-id=PropertyRegistry, ejb-name=PropertyRegistry, container=Default Singleton Container) +INFO - Started Ejb(deployment-id=ComponentRegistry, ejb-name=ComponentRegistry, container=Default Singleton Container) +INFO - Deployed Application(path=C:\Users\Oz\Desktop\ee-examples\simple-singleton) +INFO - Undeploying app: C:\Users\Oz\Desktop\ee-examples\simple-singleton +INFO - Destroying OpenEJB container +Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.171 sec + +Results : + +Tests run: 2, Failures: 0, Errors: 0, Skipped: 0 +....