Avanzado
Hilos y ciclo de vida
En qué hilo se ejecuta cada llamada de la API de sofyCore, cómo terminan los futuros y cómo sobrevivir a recargas y apagados.
Futuros
- Todos los métodos
…AsyncdevuelvenCompletableFuturey hacen su I/O en workers acotados. - Los futuros no trasladan las continuaciones al hilo de Bukkit. Usa
Bukkit.getScheduler().runTask(plugin, …)antes de tocar Bukkit. - La validación de argumentos puede lanzar una excepción directamente, antes de encolar el trabajo; la saturación y los fallos de I/O completan el futuro con error (por ejemplo
RejectedExecutionException). - Las variantes síncronas de los métodos de almacenamiento bloquean a quien llama mientras el I/O se ejecuta en los workers.
Lecturas de memoria
Los métodos documentados como lecturas de memoria (online, vanished, frozen, cachedBalance, maySpeak, placeholders) nunca hacen I/O y son seguros en el hilo del servidor.
Ciclo de vida
- Los módulos se pueden recargar por separado. Su servicio se retira y se vuelve a registrar, así que busca los servicios cuando los necesites.
- En un apagado normal, el trabajo aceptado se vacía antes de cerrar el almacenamiento. Un cierre forzoso no puede guardar trabajo que solo estaba en memoria.
- Los módulos que se activan tarde deben recorrer
OnlineUsers.readySessions()en lugar de esperar a una entrada.