Module ai.tutor.cab302exceptionalhandlers

Package ai.tutor.cab302exceptionalhandlers

Class SceneManager

java.lang.Object

ai.tutor.cab302exceptionalhandlers.SceneManager

public class SceneManager
extends Object

Manages scene navigation and controller instantiation for the application.

Scene Manager is a singleton providing a centralized point for switching between different views in the JavaFX application. It uses a ControllerFactory to create controllers for each view.

Usage Example:

 SceneManager.getInstance().applicationInitialize(primaryStage);
 SceneManager.getInstance().navigateToAuth(AuthType.LOGIN);
 

Author:

Justin.

See Also:

• ControllerFactory

Method Summary

Modifier and Type	Method	Description
void	applicationInitialize(javafx.stage.Stage stage)	Initializes the SceneManager with the primary stage.
static SceneManager	getInstance()	Gets the singleton instance of SceneManager.
void	navigateToAuth(AuthType type)	Navigates to the authentication view (Login or Sign Up).
void	navigateToChat(User user)	Navigates to the main chat view.
void	navigateToChatSetup(User user, ChatSetupType type, Chat chat)	Navigates to the chat setup view for creating or updating a chat.
void	navigateToQuiz(Quiz quiz, User user)	Navigates to the quiz view.
void	navigateToUserSettings(User user)	Navigates to the user settings view.

Methods inherited from class java.lang.Object

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

Method Details

getInstance

public static SceneManager getInstance()
                                throws SQLException

Gets the singleton instance of SceneManager.

Returns:

The singleton instance.

Throws:

SQLException - if a database connection error occurs.

applicationInitialize

public void applicationInitialize(javafx.stage.Stage stage)

Initializes the SceneManager with the primary stage. This method must be called once before application startup.

Parameters:

stage - The primary Stage of the application.

navigateToAuth

public void navigateToAuth(AuthType type)
                    throws IllegalStateException,
RuntimeException,
SQLException,
IOException

Navigates to the authentication view (Login or Sign Up).

Parameters:

type - The AuthType specifying whether to show the Login or Sign Up view.

Throws:

IllegalStateException - if the authentication type is not set.

RuntimeException - if a database connection error occurs during controller construction.

SQLException - if a database access error occurs during controller construction.

IOException - if the authentication view cannot be loaded.

navigateToChat

public void navigateToChat(User user)
                    throws IllegalStateException,
RuntimeException,
SQLException,
IOException

Navigates to the main chat view.

Parameters:

user - The currently authenticated User.

Throws:

IllegalStateException - if the user is not set.

RuntimeException - if a database connection error occurs during controller construction.

SQLException - if a database access error occurs during controller construction.

IOException - if the chat view cannot be loaded.

navigateToChatSetup

public void navigateToChatSetup(User user,
 ChatSetupType type,
 Chat chat)
                         throws IllegalStateException,
RuntimeException,
SQLException,
IOException

Navigates to the chat setup view for creating or updating a chat.

Parameters:

user - The currently authenticated User.

type - The ChatSetupType (CREATE or UPDATE).

chat - The Chat to be updated, or null if creating a new chat.

Throws:

IllegalStateException - if the user or chat (for update) is not set.

RuntimeException - if a database connection error occurs during controller construction.

SQLException - if a database access error occurs during controller construction.

IOException - if the chat setup view cannot be loaded.

navigateToUserSettings

public void navigateToUserSettings(User user)
                            throws IllegalStateException,
RuntimeException,
SQLException,
IOException

Navigates to the user settings view.

Parameters:

user - The currently authenticated User.

Throws:

IllegalStateException - if the user is not set.

RuntimeException - if a database connection error occurs during controller construction.

SQLException - if a database access error occurs during controller construction.

IOException - if the user settings view cannot be loaded.

navigateToQuiz

public void navigateToQuiz(Quiz quiz,
 User user)
                    throws IllegalStateException,
RuntimeException,
SQLException,
IOException

Navigates to the quiz view.

Parameters:

quiz - The Quiz to be displayed.

user - The currently authenticated User.

Throws:

IllegalStateException - if the user or quiz is not set.

RuntimeException - if a database connection error occurs during controller construction.

SQLException - if a database access error occurs during controller construction.

IOException - if the quiz view cannot be loaded.