io.github.dinamo541.corefx.navigation

Controller

An optional base class for your FXML controllers. Extend it and FlowController starts wiring your controller automatically: it injects the Stage the view is showing on, records the viewName it was loaded from, and — the important part — calls initialize() again every time a cached view is shown, so screens can refresh themselves without any manual plumbing. Una clase base opcional para tus controladores FXML. Extiéndela y FlowController empieza a conectar tu controlador automáticamente: inyecta el Stage en el que se muestra la vista, registra el viewName desde el que se cargó y — lo importante — llama a initialize() otra vez cada vez que se muestra una vista cacheada, para que las pantallas puedan refrescarse solas sin ningún cableado manual.

The problem it solvesEl problema que resuelve

FlowController caches one FXMLLoader per view, which is what makes navigation fast and keeps controllers reachable. But caching has a catch: JavaFX only calls a controller's initialize() once, when the FXML is first loaded. Navigate away and come back, and the screen still shows whatever it held before — stale totals, an old selection, a form that was never cleared. FlowController cachea un FXMLLoader por vista, que es lo que hace la navegación rápida y mantiene los controladores accesibles. Pero el caché tiene una trampa: JavaFX solo llama al initialize() de un controlador una vez, cuando el FXML se carga por primera vez. Navegas a otro lado y vuelves, y la pantalla sigue mostrando lo que tenía antes — totales obsoletos, una selección vieja, un formulario que nunca se limpió.

Extending Controller closes that gap. CoreFx detects the base class with a pattern match and re-invokes initialize() on every reuse, so "runs when the view is shown" becomes the contract — not "runs once, ever". Extender Controller cierra esa brecha. CoreFx detecta la clase base con un pattern match y vuelve a invocar initialize() en cada reutilización, así que "se ejecuta cuando la vista se muestra" pasa a ser el contrato — no "se ejecuta una sola vez, para siempre".

Quick startInicio rápido

public class DashboardController extends Controller {

    @FXML private Label totalLabel;
    @FXML private TableView<Order> table;

    // Called by JavaFX on first load, and by CoreFx on every
    // navigation back to this cached view.
    @Override
    public void initialize() {
        totalLabel.setText(orderService.currentTotal());
        TableUtils.setItems(table, orderService.findAll());
    }

    @FXML
    private void onClose() {
        getStage().close();          // injected by FlowController
    }
}

API referenceReferencia de API

toString(), equals and hashCode are overridden over the three fields (stage, action, viewName).toString(), equals y hashCode están sobrescritos sobre los tres campos (stage, action, viewName).

What FlowController injects, and whereQué inyecta FlowController, y dónde

Every one of these methods checks whether the loaded controller extends Controller and, if so, injects the stage it is navigating to. Controllers that don't extend it are simply left alone — the base class is entirely opt-in.Cada uno de estos métodos comprueba si el controlador cargado extiende Controller y, en tal caso, le inyecta el stage al que está navegando. Los controladores que no la extienden simplemente se dejan intactos — la clase base es totalmente opcional.

HookPunto de enganche	What CoreFx setsQué asigna CoreFx
createLoaderInstance(name)	viewName, once, as the loader is built.viewName, una vez, al construir el loader.
getLoader(viewName)	Calls initialize() when a cached loader is reused.Llama a initialize() cuando se reutiliza un loader cacheado.
goViewMain · changeViewInMain	stage ← the main stage.stage ← el stage principal.
goViewInWindow	stage ← the new window.stage ← la ventana nueva.
goViewInModal · goViewInModalAndWait	stage ← the modal stage.stage ← el stage del modal.
changeViewInStage · changeViewInScene	stage ← the target stage.stage ← el stage de destino.
changeViewInBorderPane	stage ← the stage owning the pane.stage ← el stage dueño del panel.

RecommendationsRecomendaciones