Class MapRouteEntry

java.lang.Object

org.deltava.beans.DatabaseBean

org.deltava.beans.acars.ACARSMapEntry

org.deltava.beans.acars.RouteEntry

org.deltava.beans.acars.ACARSRouteEntry

org.deltava.beans.acars.MapRouteEntry

All Implemented Interfaces:

Serializable, Comparable<Object>, FuelChecker, CalendarEntry, GeoLocation, GeospaceLocation, IDBean, MapEntry, MarkerMapEntry, TabbedMapEntry, Cacheable

public class MapRouteEntry
extends ACARSRouteEntry
implements TabbedMapEntry

A bean to store a snapshot of an ACARS-logged flight.

Since:

1.0

Version:

12.3

Author:

Luke

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class ACARSMapEntry

ACARSMapEntry.EntryType

Modifier and Type	Class	Description
static enum	ACARSMapEntry.EntryType	Map entry types.

Field Summary

Fields inherited from class ACARSMapEntry

_betaBuild, _busy, _clientBuild, _pos, _usr

Modifier and Type	Field	Description
protected int	_betaBuild
protected boolean	_busy
protected int	_clientBuild
protected GeoLocation	_pos
protected Pilot	_usr

Fields inherited from interface GeoLocation

ALL, DEGREE_FEET, DEGREE_MILES, FEET_MILES, LAT_DIRECTIONS, LATITUDE, LON_DIRECTIONS, LONGITUDE, RADIAN_MILES

Modifier and Type	Field	Description
static final int	ALL	Format the Longitude and Latitude.
static final double	DEGREE_FEET	Size of a degree in feet.
static final double	DEGREE_MILES	Size of a degree in miles.
static final int	FEET_MILES	Size of a mile in feet.
static final String[]	LAT_DIRECTIONS	Latitude directions.
static final int	LATITUDE	Format the Latitude only.
static final String[]	LON_DIRECTIONS	Longitude directions.
static final int	LONGITUDE	Format the Longitude only.
static final int	RADIAN_MILES	Radius of the Earth in miles.

Fields inherited from interface MapEntry

BLUE, BROWN, COLORS, GREEN, GREY, ORANGE, PURPLE, RED, WHITE, YELLOW

Modifier and Type	Field	Description
static final String	BLUE	Blue Google Maps icon, displayed as $static/img/maps/point_blue.png
static final String	BROWN	Brown Google Maps icon, displayed as $static/img/maps/point_brown.png
static final String[]	COLORS	All Google Maps icon colors.
static final String	GREEN	Green Google Maps icon, displayed as $static/img/maps/point_green.png
static final String	GREY	Grey Google Maps icon, displayed as $static/img/maps/point_grey.png
static final String	ORANGE	Orange Google Maps icon, displayed as $static/img/maps/point_orange.png
static final String	PURPLE	Purple Google Maps icon, displayed as $static/img/maps/point_purple.png
static final String	RED	Red Google Maps icon, displayed as $static/img/maps/point_red.png
static final String	WHITE	White Google Maps icon, displayed as $static/img/maps/point_white.png
static final String	YELLOW	Yellow Google Maps icon, displayed as $static/img/maps/point_yellow.png

Constructor Summary

Constructors

Constructor	Description
MapRouteEntry(Instant dt, GeoLocation gl, Pilot usr, String eqType)	Creates the bean.

Method Summary

Modifier and Type	Method	Description
String	getExternalID()	Returns the external flight ID, used by clients such as simFDR.
final String	getIconColor()	Returns the icon color for this entry if displayed in a Google Map.
final String	getInfoBox()	Returns the text to display in this marker's infobox if displayed in a Google Map.
final LinkedHashMap<String,String>	getTabs()	Returns the tab names.
void	setAirportA(Airport a)	Updates the arrival Airport.
void	setAirportD(Airport a)	Updates the departure Airport.
void	setCheckRide(boolean isCR)	Updates whether the pilot is flying a check ride.
void	setCountry(Country c)	Updates what Country's airspace this entry is in.
void	setDispatcher(DispatchType dsp)	Updates whether the pilot is flying using a Dispatch-generated flight route.
void	setExternalID(String id)	Sets the external flight ID, for use by third-party clients such as simFDR.
void	setFlightNumber(String flightNumber)	Updates the flight code.
void	setLoadFactor(double lf)	Updates the load factor for this flight.
void	setNetwork(OnlineNetwork network)	Updates the online network used for this flight.
void	setPassengers(int pax)	Updates the passenger count for this flight.
void	setPhaseName(String phase)	Updates the flight's flight phase.
void	setRecorder(Recorder fdr)	Updates the Flight Data Recorder used to generate this entry.
void	setSimulator(Simulator s)	Updates the Simulator used on this flight.
void	setTailCode(String tailCode)	Updates the aircraft's tail code.

Methods inherited from class ACARSRouteEntry

getACARSConnected, getADF1, getAltimeter, getAOA, getATC1, getATC2, getBank, getCG, getCOM1, getCOM2, getEngineCount, getFlaps, getFrameRate, getFuelFlow, getG, getGroundOperations, getN1, getN1, getN2, getN2, getNAV1, getNAV2, getNetworkConnected, getPitch, getPressure, getRadarAltitude, getRestoreCount, getSimRate, getSimUTC, getTemperature, getVASFree, getVisibility, getWarnings, getWeight, isEngineOut, setACARSConnected, setADF1, setAltimeter, setAOA, setATC1, setATC2, setAutopilotType, setBank, setCG, setCOM1, setCOM2, setDisplayPerEngineNX, setEngineCount, setFlaps, setFrameRate, setFuelFlow, setG, setGroundOperations, setN1, setN1, setN2, setN2, setNAV1, setNAV2, setNetworkConnected, setPitch, setPressure, setRadarAltitude, setRestoreCount, setSimRate, setSimUTC, setTemperature, setVASFree, setVisibility, setWeight

Modifier and Type	Method	Description
boolean	getACARSConnected()	Returns if the client is connected to the ACARS server.
String	getADF1()	Returns the ADF1 frequency.
int	getAltimeter()	Returns the value reported by the aircraft's altimeter.
double	getAOA()	Returns the aircraft's Angle of Attack.
Controller	getATC1()	Returns the Controller on COM1.
Controller	getATC2()	Returns the Controller on COM2.
double	getBank()	Returns the aircraft's bank angle.
double	getCG()	Returns the center of gravity of the aircraft.
String	getCOM1()	Returns the COM1 frequency.
String	getCOM2()	Returns the COM2 frequency.
int	getEngineCount()	Returns the number of engines.
int	getFlaps()	Returns the flap detent position.
int	getFrameRate()	Returns the Flight Simulator frame rate.
int	getFuelFlow()	Returns the aircraft's fuel flow for all engines.
double	getG()	Returns the G forces acting on the aircraft.
int	getGroundOperations()	Returns the ground operations flag(s).
double	getN1()	Returns the average N1 speed (propellor RPM for piston engines) of all engines.
double	getN1(int eng)	Returns an individual engine's N1 speed (propellor RPM for piston engines).
double	getN2()	Returns the average N2 speed (throttle position for piston enginers) of all engines.
double	getN2(int eng)	Returns an individual engine's N2 speed (throttle position for piston enginers).
String	getNAV1()	Returns the NAV1 frequency.
String	getNAV2()	Returns the NAV2 frequency.
boolean	getNetworkConnected()	Returns if the client is connected to an Online Network.
double	getPitch()	Returns the aircraft's pitch angle.
int	getPressure()	Returns the ambient air pressure.
int	getRadarAltitude()	Returns the aircraft's altitude above ground level, if implemented.
int	getRestoreCount()	Rerturns the number of times an ACARS flight restore had been performed thus far.
int	getSimRate()	Returns the simulator time acceleration rate.
Instant	getSimUTC()	Returns the UTC time in the simulator.
int	getTemperature()	Returns the ambient air temperature.
int	getVASFree()	Returns the amount of simulator free memory.
double	getVisibility()	Returns the visibility.
Collection<Warning>	getWarnings()	Returns the warning message.
int	getWeight()	Returns the aircraft weight.
boolean	isEngineOut()	Returns whether an engine is not running.
void	setACARSConnected(boolean isConnected)	Updates whether the user is connected to the ACARS server.
void	setADF1(String freq)	Sets the ADF1 radio frequency.
void	setAltimeter(int alt)	Updates the altitude reported on the aircraft's altimeter.
void	setAOA(double aoa)	Updates the aircraft's Angle of Attack.
void	setATC1(Controller atc)	Sets the controller on COM1.
void	setATC2(Controller atc)	Sets the controller on COM2.
void	setAutopilotType(AutopilotType ap)	Updates the aircraft autopilot type.
void	setBank(double b)	Updates the aircraft's bank angle.
void	setCG(double cg)	Sets the aircraft's center of gravity.
void	setCOM1(String freq)	Sets the COM1 radio frequency.
void	setCOM2(String freq)	Sets the COM2 radio frequency.
void	setDisplayPerEngineNX(boolean isDisplay)	Sets whether to display per-engine N1/N2 values in the info box.
void	setEngineCount(int cnt)	Updates the number of engines.
void	setFlaps(int flapDetent)	Updates the aircraft's flap detent position.
void	setFrameRate(int rate)	Updates the Flight Simulator frame rate.
void	setFuelFlow(int flow)	Updates the aircraft's total fuel flow.
void	setG(double gForce)	Updates the G forces acting on the aircraft.
void	setGroundOperations(int ops)	Updates the Ground Operations flag(s).
void	setN1(double nn1)	Updates the aircraft's average N1 speed.
void	setN1(int eng, double nn1)	Updates an aircraft's individual engine N1 speed.
void	setN2(double nn2)	Updates the aircraft's average N2 speed.
void	setN2(int eng, double nn2)	Updates an aircraft's individual engine N2 speed.
void	setNAV1(String freq)	Sets the NAV1 radio frequency.
void	setNAV2(String freq)	Sets the NAV2 radio frequency.
void	setNetworkConnected(boolean isConnected)	Updates whether the user is connected to an Online Network.
void	setPitch(double p)	Updates the aircraft's pitch angle.
void	setPressure(int p)	Sets the ambient air pressure.
void	setRadarAltitude(int alt)	Updates the aircraft's altitude above ground level.
void	setRestoreCount(int cnt)	Updates the number of times ACARS has restored the flight thus far.
void	setSimRate(int rate)	Updates the simulator time acceleration rate.
void	setSimUTC(Instant i)	Updates the UTC time in the simulator
void	setTemperature(int t)	Sets the ambient temperature.
void	setVASFree(int kb)	Updates the amount of simulator free memory.
void	setVisibility(double viz)	Sets the visibility.
void	setWeight(int w)	Updates the aircraft weight.

Methods inherited from class RouteEntry

compareTo, getAirspace, getAirSpeed, getAltitude, getDate, getFlags, getFuelRemaining, getGroundSpeed, getHeading, getMach, getPhase, getType, getVerticalSpeed, getWindHeading, getWindSpeed, hasDataError, isFlagSet, isWarning, setAirspace, setAirSpeed, setAltitude, setFlag, setFlags, setFuelRemaining, setGroundSpeed, setHeading, setMach, setPhase, setVerticalSpeed, setWindHeading, setWindSpeed

Modifier and Type	Method	Description
int	compareTo(Object o2)
AirspaceType	getAirspace()	Returns the type of Airspace covering the current position.
int	getAirSpeed()	Returns the aircraft's airspeed.
int	getAltitude()	Returns the aircraft's atltiude above sea level.
Instant	getDate()	Returns the date/time of this entry.
int	getFlags()	Returns the ACARS flags for this entry.
int	getFuelRemaining()	Returns the amount of fuel remaining on the aircraft.
int	getGroundSpeed()	Returns the aircraft's ground speed.
int	getHeading()	Returns the aircraft's heading.
double	getMach()	Returns the aircraft's Mach number.
FlightPhase	getPhase()	Returns the flight phase.
final ACARSMapEntry.EntryType	getType()	Returns the map entry type.
int	getVerticalSpeed()	Returns the vertical speed.
int	getWindHeading()	Returns the ambient wind heading.
int	getWindSpeed()	Returns the ambient wind speed.
boolean	hasDataError()	Returns if a data field contains an inalid value.
boolean	isFlagSet(ACARSFlags flag)	Returns if an ACARS flag was set.
boolean	isWarning()	Marks this route entry as having a notable flight parameter.
void	setAirspace(AirspaceType at)	Sets the Airspace type covering the current position.
void	setAirSpeed(int speed)	Updates the aircraft's airspeed.
void	setAltitude(int alt)	Updates the aircraft's altitude above sea level.
void	setFlag(ACARSFlags flag, boolean isSet)	Sets or clears an ACARS flag.
void	setFlags(int flags)	Sets all ACARS flags for this entry.
void	setFuelRemaining(int fuel)	Updates the amount of fuel remaining on the aircraft.
void	setGroundSpeed(int speed)	Updates the aircraft's ground speed.
void	setHeading(int hdg)	Updates the aircraft's heading.
void	setMach(double mach)	Updates the aircraft's Mach number.
void	setPhase(FlightPhase phase)	Updates the flight phase.
void	setVerticalSpeed(int s)	Sets the vertical speed.
void	setWindHeading(int hdg)	Sets the ambient wind heading.
void	setWindSpeed(int speed)	Sets the ambient wind speed.

Methods inherited from class ACARSMapEntry

getLatitude, getLocation, getLongitude, getPilot, isBusy, setBusy, setClientBuild

Modifier and Type	Method	Description
final double	getLatitude()	Returns the latitude of this location.
GeoLocation	getLocation()	Returns the entry's position.
final double	getLongitude()	Returns the longitude of this location.
Pilot	getPilot()	Returns the Pilot.
boolean	isBusy()	Returns whether the user is marked Busy.
void	setBusy(boolean isBusy)	Marks the user as Busy.
void	setClientBuild(int buildNumber, int beta)	Sets the ACARS client version used.

Methods inherited from class DatabaseBean

cacheKey, equals, getHexID, getID, hashCode, setID, validateID, validateID

Modifier and Type	Method	Description
Object	cacheKey()	Returns the cache key for this object.
boolean	equals(Object o)
String	getHexID()	Returns the hexadecimal database ID of this object.
int	getID()	Returns the database ID of this object.
int	hashCode()
void	setID(int id)	Update the database row ID of this bean.
static void	validateID(int oldID, int newID)	Validates a database ID.
static void	validateID(int oldID, int newID, boolean allowZero)	Validates a database ID.

Methods inherited from class Object

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

Methods inherited from interface GeoLocation

distanceFeet, distanceTo

Modifier and Type	Method	Description
default int	distanceFeet(GeoLocation l2)	Calculates the distance between two points in feet.
default int	distanceTo(GeoLocation l2)	Calculates the distance between two GeoLocations.

Constructor Details

MapRouteEntry

public MapRouteEntry(Instant dt,
 GeoLocation gl,
 Pilot usr,
 String eqType)

Creates the bean.

Parameters:

dt - the date/time

gl - the aircraft location

usr - the Pilot

eqType - the aircraft type

Method Details

getExternalID

public String getExternalID()

Returns the external flight ID, used by clients such as simFDR.

Returns:

the ID

setCheckRide

public void setCheckRide(boolean isCR)

Updates whether the pilot is flying a check ride.

Parameters:

isCR - TRUE if a check ride, otherwise FALSE

setDispatcher

public void setDispatcher(DispatchType dsp)

Updates whether the pilot is flying using a Dispatch-generated flight route.

Parameters:

dsp - the DispatchType

setFlightNumber

public void setFlightNumber(String flightNumber)

Updates the flight code.

Parameters:

flightNumber - the flight code

setAirportD

public void setAirportD(Airport a)

Updates the departure Airport.

Parameters:

a - the Airport

setAirportA

public void setAirportA(Airport a)

Updates the arrival Airport.

Parameters:

a - the Airport

setNetwork

public void setNetwork(OnlineNetwork network)

Updates the online network used for this flight.

Parameters:

network - the OnlineNetwork

setPhaseName

public void setPhaseName(String phase)

Updates the flight's flight phase.

Parameters:

phase - the phase name

setRecorder

public void setRecorder(Recorder fdr)

Updates the Flight Data Recorder used to generate this entry.

Parameters:

fdr - a Recorder

setLoadFactor

public void setLoadFactor(double lf)

Updates the load factor for this flight.

Parameters:

lf - the load factor

setPassengers

public void setPassengers(int pax)

Updates the passenger count for this flight.

Parameters:

pax - the passenger count

setSimulator

public void setSimulator(Simulator s)

Updates the Simulator used on this flight.

Parameters:

s - the Simulator

setCountry

public void setCountry(Country c)

Updates what Country's airspace this entry is in.

Parameters:

c - a Country

setTailCode

public void setTailCode(String tailCode)

Updates the aircraft's tail code.

Parameters:

tailCode - the tail code

setExternalID

public void setExternalID(String id)

Sets the external flight ID, for use by third-party clients such as simFDR.

Parameters:

id - the ID

getIconColor

public final String getIconColor()

Description copied from interface: MarkerMapEntry

Returns the icon color for this entry if displayed in a Google Map.

Specified by:

getIconColor in interface MarkerMapEntry

Overrides:

getIconColor in class ACARSRouteEntry

Returns:

the icon color

getInfoBox

public final String getInfoBox()

Description copied from interface: MapEntry

Returns the text to display in this marker's infobox if displayed in a Google Map.

Specified by:

getInfoBox in interface MapEntry

Overrides:

getInfoBox in class ACARSRouteEntry

Returns:

the infobox HTML text, or null if no infobox to be displayed

getTabs

public final LinkedHashMap<String,String> getTabs()

Description copied from interface: TabbedMapEntry

Returns the tab names.

Specified by:

getTabs in interface TabbedMapEntry

Returns:

a List of tab names