Saltar al contenido

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 …Async devuelven CompletableFuture y 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.