Module no.ntnu.principes

Package no.ntnu.principes.service

Class NavigationService

java.lang.Object

no.ntnu.principes.service.NavigationService

public class NavigationService
extends Object

Provides application-wide navigation capabilities using an event-based approach. Centralizes screen transitions, modal dialogs, and navigation history management without requiring direct references to UI controllers.

Method Summary

Modifier and Type	Method	Description
static void	back()	Navigates back to the previous screen.
static void	clear(UUID stageId)	Clears the entire navigation stack for a stage.
static void	closeModal(String modalId, ModalResult result)	Closes a modal dialog with a result.
static void	closeScreen(String route)	Closes a specific screen by its route name.
static void	navigate(String route)	Navigates to a specified route.
static void	navigate(String route, Map<String,Object> params)	Navigates to a route with additional parameters.
static void	navigate(NavigateEvent.NavigationPayload payload)	Performs navigation using a pre-configured navigation payload.
static void	openModal(String route, String callBackId)	Opens a modal dialog over the current screen.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

navigate

public static void navigate(String route)

Navigates to a specified route. Adds the route to the navigation stack.

Parameters:

route - The destination route name

navigate

public static void navigate(String route,
 Map<String,Object> params)

Navigates to a route with additional parameters. Adds the route to the navigation stack and passes the parameters to the destination screen.

Parameters:

route - The destination route name

params - Map of parameters to pass to the destination

navigate

public static void navigate(NavigateEvent.NavigationPayload payload)

Performs navigation using a pre-configured navigation payload. Allows for complete control over navigation type and parameters.

Parameters:

payload - The pre-configured navigation payload

closeScreen

public static void closeScreen(String route)

Closes a specific screen by its route name. Removes the screen from the navigation stack.

Parameters:

route - The route name of the screen to close

openModal

public static void openModal(String route,
 String callBackId)

Opens a modal dialog over the current screen.

Parameters:

route - The route name of the modal to open

callBackId - An identifier to associate with modal results

closeModal

public static void closeModal(String modalId,
 ModalResult result)

Closes a modal dialog with a result. The result can be processed by screens that are waiting for modal feedback.

Parameters:

modalId - The ID of the modal to close

result - The result to return from the modal

clear

public static void clear(UUID stageId)

Clears the entire navigation stack for a stage. Removes all screens and returns to the initial state.

Parameters:

stageId - The ID of the stage to clear

back

public static void back()

Navigates back to the previous screen. Removes the current screen from the navigation stack.