Package com.nnamo.controllers

Class MapController

java.lang.Object

com.nnamo.controllers.MapController

public class MapController
extends Object

Controller responsible for managing map-related functionalities, including waypoint interactions, route rendering, and vehicle position updates. It interacts with the DatabaseService, MainFrame, and RealtimeGtfsService to provide a seamless user experience on the map interface.

Author:

Samuele Lombardi, Riccardo Finocchiaro

See Also:

• DatabaseService
• MainFrame
• RealtimeGtfsService

Constructor Summary

Constructors

Constructor	Description
MapController(DatabaseService db, MainFrame mainFrame, RealtimeGtfsService realtimeService)	Creates a MapController with the specified DatabaseService, MainFrame, and RealtimeGtfsService.

Method Summary

Modifier and Type	Method	Description
static org.jxmapviewer.viewer.GeoPosition	calculateBarycenter(List<StopModel> stopList)	Calculate the geographical barycenter of a list of stops.
static int	calculateZoomLevel(List<StopModel> stopList)	Calculate an appropriate zoom level based on the geographical spread of a list of stops.
static void	renderRoutesVehicles(List<StopModel> stopModels, RealtimeGtfsService realtimeService, MainFrame mainFrame, DatabaseService db, String routeId, Direction direction)
void	run()
void	setSessionUser(UserModel sessionUser)
void	setupWaypointBehavior()
static void	updateVehiclePositions(String routeId, MainFrame mainFrame, RealtimeGtfsService realtimeService, DatabaseService db)

Methods inherited from class java.lang.Object

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

Constructor Details

MapController

public MapController(DatabaseService db,
 MainFrame mainFrame,
 RealtimeGtfsService realtimeService)

Creates a MapController with the specified DatabaseService, MainFrame, and RealtimeGtfsService.

Parameters:

db - the database service for data access

mainFrame - the main application frame for UI interactions

realtimeService - the real-time GTFS service for fetching live data

See Also:

• DatabaseService
• MainFrame
• RealtimeGtfsService

Method Details

run

public void run()

setSessionUser

public void setSessionUser(UserModel sessionUser)

setupWaypointBehavior

public void setupWaypointBehavior()

calculateBarycenter

public static org.jxmapviewer.viewer.GeoPosition calculateBarycenter(List<StopModel> stopList)

Calculate the geographical barycenter of a list of stops.

Parameters:

stopList - List of StopModel objects representing the stops.

Returns:

GeoPosition representing the calculated barycenter.

Throws:

ArithmeticException - if the stopList is empty.

calculateZoomLevel

public static int calculateZoomLevel(List<StopModel> stopList)

Calculate an appropriate zoom level based on the geographical spread of a list of stops.

Parameters:

stopList - List of StopModel objects representing the stops.

Returns:

An integer representing the calculated zoom level.

renderRoutesVehicles

public static void renderRoutesVehicles(List<StopModel> stopModels,
 RealtimeGtfsService realtimeService,
 MainFrame mainFrame,
 DatabaseService db,
 String routeId,
 Direction direction)
                                 throws SQLException

Throws:

SQLException

updateVehiclePositions

public static void updateVehiclePositions(String routeId,
 MainFrame mainFrame,
 RealtimeGtfsService realtimeService,
 DatabaseService db)
                                   throws SQLException

Throws:

SQLException