6. Ámbitos de los datos
Una aplicación web atiende a muchos usuarios a la vez, y cada uno de ellos realiza numerosas solicitudes. Por lo tanto, los datos pueden compartirse en tres niveles, conocidos como su ámbito (scope):
- ámbito de aplicación (application): los datos son compartidos por todos los usuarios durante toda la vida del servidor (por ejemplo, la lista de médicos);
- ámbito de solicitud (request): los datos existen solo durante una solicitud (el modelo de una vista);
- ámbito de cliente (client): los datos son específicos de un usuario y deben persistir de una solicitud a la siguiente (el idioma seleccionado, el usuario conectado).
Las aplicaciones web han usado durante mucho tiempo las sesiones para este último ámbito: un espacio de memoria, mantenido por el servidor, específico de cada navegador y recuperado mediante una cookie de identificación ([JSESSIONID] en [Java]). [Spring MVC] todavía lo usa de forma predeterminada para los atributos Flash (ejemplo 20). Sin embargo, el caso de estudio no lo utiliza, ni tampoco los ejemplos de este documento (salvo los atributos Flash en algunos ejemplos, como los ejemplos 20 y 21): los datos del lado del cliente los almacena el navegador en cookies. El servidor no guarda nada entre dos solicitudes del mismo usuario: se dice que es sin estado ([stateless]). Esto es lo que permite, por ejemplo, ejecutar varios servidores idénticos detrás de un balanceador de carga. La contrapartida: una cookie está bajo el control del usuario, quien puede leerla y modificarla. Por lo tanto, solo se almacenan en ella datos no sensibles, o datos firmados o cifrados por el servidor, que de este modo puede detectar cualquier modificación: este es el caso del token de autenticación (capítulo 8).
Del lado del servidor, los ámbitos de aplicación y de solicitud corresponden a los ámbitos de los beans de [Spring] (véase el ejemplo 06). Un bean es creado y mantenido por [Spring]; su ámbito especifica cuántas instancias se crean y durante cuánto tiempo. Tres de ellos nos interesan:
Anotación | Ámbito | Una instancia... |
(ninguna) | singleton | durante toda la vida de la aplicación, compartida por todas las solicitudes. Este es el ámbito predeterminado |
[@RequestScope] | request | por solicitud HTTP, compartida por todos los que la requieran durante esa solicitud |
[@Scope("prototype")] | prototype | Cada vez que se solicita el bean a [Spring]: dos solicitudes, dos instancias |
Estos son los ciclos de vida [Singleton], [Scoped], y [Transient] de [ASP.NET Core]. También existe un ámbito de sesión ([@SessionScope]), que no usaremos.
6.1. Ejemplo 23: Tres ámbitos
Los archivos [pom.xml], [application.properties], [Example23Application.java], y [WebConfig.java] (que simplemente sirve los archivos de [Bootstrap]) son los de los ejemplos anteriores.
6.1.1. Los tres beans
El archivo [services/CounterService.java]:
- línea 9: un bean, sin ninguna otra especificación: es un singleton. Por lo tanto, su campo [total] tiene ámbito de aplicación;
- Líneas 14-18: un servidor web procesa varias solicitudes simultáneamente en varios hilos ([threads]). Si dos solicitudes ejecutan [total++] al mismo tiempo, ambas pueden leer el mismo valor y un incremento se pierde. Un [AtomicInteger] es un entero que el método [incrementAndGet] lee, incrementa y vuelve a escribir en una única operación indivisible. Un bean singleton siempre debe desconfiar de esos accesos concurrentes.
El archivo [services/RequestService.java]:
- línea 11: la anotación [@RequestScope] da al bean el ámbito "request";
- línea 15: un campo [static] pertenece a la clase, no a una instancia; es compartido por todas las instancias. Cuenta el número de instancias creadas;
- línea 17: a cada instancia se le asigna un número al crearse. Como el bean tiene ámbito de solicitud, el número cambia con cada solicitud.
El archivo [services/ToolService.java]:
El mismo contador de instancias, para un bean con ámbito [prototype] (línea 10).
6.1.2. Datos con ámbito de solicitud: los atributos de la solicitud
El archivo [config/StartFilter.java]:
- Líneas 17-18: un filtro de servlet (el próximo capítulo los describe en detalle). Procesa cada solicitud antes que [Spring MVC]. La clase [OncePerRequestFilter] de [Spring] garantiza que se ejecute una sola vez por solicitud; la anotación [@Component] basta para que [Spring Boot]lo agregue a la cadena de filtros;
- Línea 23: el filtro almacena la hora de recepción de la solicitud en un atributo de solicitud. El objeto [HttpServletRequest] contiene un diccionario de atributos, que se crea y se destruye junto con la solicitud: todo lo que la procesa (filtros, controlador, vista) puede leerlo y escribir en él. Es el equivalente de [HttpContext.Items] de [ASP.NET Core];
- línea 24: el filtro pasa el control al siguiente paso: los demás filtros y luego [Spring MVC].
6.1.3. El controlador
El archivo [controllers/ScopesController.java]:
Comentemos este código:
- Líneas 16-17: un controlador es en sí mismo un bean y, por lo tanto, un singleton: [Spring] lo crea una sola vez e inyecta sus dependencias en ese momento, de una vez por todas (líneas 29-35). Aquí es donde la cosa se pone interesante;
- línea 20: un singleton inyectado en un singleton, nada fuera de lo común;
- línea 23: un bean con ámbito de solicitud inyectado en un singleton. Al iniciar, no hay ninguna solicitud activa y, por lo tanto, ninguna instancia de [RequestService] que inyectar. En su lugar, [Spring] inyecta un proxy (un intermediario): un objeto que tiene los mismos métodos que [RequestService] y que reenvía cada llamada a la instancia de la solicitud actual, creada según sea necesario. Esto es lo que hace [@RequestScope];
- línea 25: un bean prototype inyectado en un singleton. [Spring] crea una instancia... una sola, durante la inyección. El controlador la conservará durante toda su vida: este campo nunca cambia. Esta es la trampa del ámbito prototype: crea una nueva instancia solo con cada solicitud al contenedor de [Spring], y un singleton solicita sus dependencias una sola vez;
- línea 27: para obtener una nueva instancia cada vez, el controlador recibe un [ObjectProvider<ToolService>], un objeto capaz de solicitar un [ToolService] a [Spring] siempre que sea necesario, mediante su método [getObject()] (línea 50);
- línea 37: el modelo de la vista, un record (véase el ejemplo 03);
- Línea 41: el ámbito de cliente, un contador almacenado en una cookie. La anotación [@CookieValue] vincula el parámetro a la cookie [myVisits] enviada por el navegador; [required = false]: el parámetro toma el valor [null] si falta la cookie (en la primera visita);
- línea 45: el contador del navegador, incrementado en 1. El método [toInteger] (líneas 55-61) convierte el texto de la cookie en un entero; [Integer.parseInt] lanza una [NumberFormatException] si el texto no es un entero o si es igual a [null]: el contador se reinicia entonces en 0;
- líneas 46-48: la cookie se vuelve a establecer con su nuevo valor. [ResponseCookie] es una clase de [Spring] que genera el valor de un encabezado [Set-Cookie]: los métodos que establecen sus características (ruta, [HttpOnly], [SameSite]) se llaman de forma secuencial y luego [build()] crea el objeto. El encabezado se agrega a la respuesta mediante [response.addHeader];
- líneas 49-50: se pasan valores a la vista: el contador de la aplicación, el número de instancia de [RequestService] para la solicitud actual, el número de instancia del prototype inyectado, el número de instancia de un prototype solicitado en ese momento y el contador del cliente.
6.1.4. La vista
El archivo [templates/scopes/scopes.html]:
- línea 9: [th:object] (véanse los ejemplos 18 y 19) hace referencia al objeto [model]; las expresiones [*{...}] de las etiquetas hijas hacen referencia a sus propiedades: [*{total}] equivale a [${model.total}];
- línea 14: [[[...]]] inserta el valor de una expresión en el texto, escapado, igual que lo haría [th:text] (véase el ejemplo 14);
- Líneas 15 y 18: la expresión [${@name}] hace referencia al bean con ese nombre (véase el ejemplo 16). A su vez, la vista solicita los beans [requestService] y [toolService] a [Spring] durante la misma solicitud que la acción: podremos comparar las instancias recibidas por el controlador y por la vista;
- línea 16: el atributo de solicitud establecido por el filtro. Para [Thymeleaf], los atributos de la solicitud son variables como cualquier otra.
6.1.5. Ejecución
Una página, en la URLhttp://localhost:5000/:

Simulemos dos navegadores con [curl] y dos archivos de cookies, [a.txt] y [b.txt]: la opción [-b] envía las cookies del archivo, mientras que la opción [-c] guarda en el archivo las cookies establecidas por el servidor. El navegador A realizó dos solicitudes, luego el navegador B realizó una y después A realizó una última solicitud (el servidor acaba de reiniciarse):
(solo se muestran los elementos de la lista). Observamos que:
- el contador de la aplicación cuenta todas las visitas: 1, 2, 3, 4;
- cada solicitud tiene su propia instancia de [RequestService]: 1, 2, 3, 4. Durante una solicitud, el controlador (a través de su proxy) y la vista acceden a la misma instancia;
- el prototype inyectado en el controlador es siempre el n.º 1: creado al iniciar junto con el controlador, nunca será reemplazado. Los prototypes solicitados son nuevos cada vez: el controlador y la vista reciben dos distintos, y cada solicitud crea dos nuevos;
- el contador del cliente es propio de cada navegador: A tiene 3 visitas, B tiene 1.
El archivo [a.txt], mantenido por [curl], contiene la cookie del navegador A:
Esta cookie está controlada por el cliente, que puede enviar el valor que desee:
Para un contador de visitas, esto es irrelevante. Para datos sensibles (la identidad del usuario, su rol), el servidor debe poder detectar la manipulación: el capítulo 8 muestra cómo.
De estos ámbitos se deriva una regla: un bean no debe retener un bean con un ámbito más corto. Un singleton que recibiera directamente una instancia con ámbito de solicitud la retendría indefinidamente, mucho más allá de la solicitud para la que se creó. [ASP.NET Core] verifica esta regla al iniciar, en modo de desarrollo, y se niega a arrancar si se infringe. [Spring] adopta un enfoque diferente: para el ámbito de solicitud, [@RequestScope] inyecta un proxy, lo que hace segura la inyección; para el ámbito prototype, no realiza ninguna verificación, y acabamos de ver el resultado: un "prototype" que se comporta como un singleton. Cuando realmente se necesita una nueva instancia, se solicita a [Spring] mediante un [ObjectProvider].
En el caso de estudio:
Ámbito | Datos | ¿Dónde? |
Aplicación | listas de médicos y de clientes, diccionarios, CAPTCHA pendientes, contadores de intentos | Beans singleton ([ApplicationModel], [Translator], [CaptchaService], [AttemptLimiterService]...); la capa de negocio y el acceso a datos también son singletons sin estado |
solicitud | modelo de la vista, usuario conectado | el modelo ([Model]), complementado por [CommonModel]; el contexto de seguridad de [Spring Security] |
cliente | token de autenticación, idioma, mensaje flash | cookies |