El funcionamiento general de la gestión de sesiones se explica en esta guía: Gestión de sesiones web
Instalación
Para el backend hemos creado una librería, pero da problemas para parametrizar el nombre del esquema en el que se encuentra la tabla de sesiones, por lo que de momento la solución es incluir las clases directamente en el proyecto. Por lo tanto, los pasos a seguir serán:
- Descargamos las clases y las añadimos al proyecto: es.um.atica.fundewebjs.session.rar. Vienen directamente con la estructura de carpetas para que se encuentren en el paquete es.um.atica.fundewebjs, y debemos incluirlo así en nuestro proyecto.
Como estarán en el paquete es.um.atica.fundewebjs, debemos tener esa ruta en la anotación @SpringBootApplication de la clase inicial de nuestro proyecto (es.um.atica.---- será el paquete por defecto de nuestro proyecto):
@SpringBootApplication( scanBasePackages = { "es.um.atica.----", "es.um.atica.fundewebjs", } )Añadir a la entidad SessionStorage.java el esquema en la anotación @Table, así:
@Table( schema = "MIESQUEMA", name = "SESSION_STORAGE" )
Uso
Una vez hecho esto ya podremos usarla, sólo tendremos que utilizar la clase sessionService, incluyéndola con @Autowired:
@Autowired private SessionService sessionService;
Para poder explotar el ID de sesión en LAGAR, es necesario añadir la dependencia fundewebjs-lagar en el pom.xml y configurar las siguientes properties en el application.properties de HelmChart:
# FundeWebJS Habilitar filtro para cabeceras en logs MDC de lagarfdwjs.api.lagar.enable=truefdwjs.api.lagar.headers=UMU-User-UUID,UMU-Client-APP,UMU-User-SessionID
Guardar sesión
Para guardar una sesión, tanto si es nueva como si es para sobrescribir una ya existente, utilizaremos el método guardarSesion, al que le pasaremos el id de sesión, el id del usuario, y el contenido de la sesión, ya sea como String o como array de bytes:
// Definición de la función public void guardarSesion( String id, String identificadorUsuario, byte[] contenidoSesion ) // Llamada sessionService.guardarSesion(idSesion, idUsuario, contenido);
Cada vez que guardamos una sesión, ya sea nueva o sobrescrita, se pone la duración de la misma a media hora, es decir, si pasa media hora desde el momento que la guardamos, caduca.
Obtener sesión
Para obtener una sesión, utilizamos getSesion o getSesionStr, pasándoles el id de sesión y el id de usuario. La única diferencia es que la primera devuelve un array de bytes, la segunda un String:
// Definición de las funciones public byte[] getSesion( String id, String identificadorUsuario ) public String getSesionStr( String id, String identificadorUsuario ) // Llamada byte[] sesion = sessionService.getSesion(idSesion, idUsuario); String sesion = sessionService.getSesionStr(idSesion, idUsuario);
Borrar sesión
Si queremos borrar una sesión explícitamente, llamaraemos a borrarSesion pasándole id de sesión e id de usuario. La operación de borrado se ejecutará de forma asíncrona, por lo que la ejecución seguirá y se evitará el tiempo de espera a que se produzca el borrado.
// Definición de la función public void borrarSesion( String id, String identificadorUsuario ) // Llamada sessionService.borrarSesion(idSesion, idUsuario);