Class FlightReport

java.lang.Object

org.deltava.beans.DatabaseBean

org.deltava.beans.Flight

org.deltava.beans.flight.FlightReport

All Implemented Interfaces:

Serializable, Comparable<Object>, AuthoredBean, CalendarEntry, FlightData, FlightNumber, IDBean, RoutePair, ViewEntry, Cacheable

Direct Known Subclasses:

DraftFlightReport, FDRFlightReport

public class FlightReport
extends Flight
implements FlightData, AuthoredBean, CalendarEntry, ViewEntry

A class for dealing with PIREP data.

Since:

1.0

Version:

12.2

Author:

Luke

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface RoutePair

RoutePair.RoutePairImpl

Field Summary

Fields

Modifier and Type	Field	Description
static final int	ATTR_WARN_MASK	Deprecated.

Constructor Summary

Constructors

Constructor	Description
FlightReport(Flight f)	Creates a new Flight Report from an existing Flight entry (like an Assignment or ScheduleEntry).
FlightReport(Airline a, int flightNumber, int leg)	Creates a new Flight Report object with a given flight.

Method Summary

Modifier and Type	Method	Description
void	addStatusUpdate(int authorID, HistoryType type, String msg)	Creates a new status update and adds it to the Flight Report.
void	addStatusUpdate(FlightHistoryEntry upd)	Adds a status update to this Flight Report.
int	compareTo(Object o)
int	getAttributes()	Returns the attributes for this Flight Report.
int	getAuthorID()	Returns the Author of this bean.
Collection<String>	getCaptEQType()	Returns if this flight counts towards promotion in a particular equipment type program.
String	getComments()	Returns the disposition comments for this Flight Report.
int	getDatabaseID(DatabaseID idType)	Sets the database row ID of a relatied database row.
Instant	getDate()	Returns the date of the flight.
Instant	getDisposedOn()	The date/time this Flight Report was disposed on.
Duration	getDuration()	A method to return the exact length of the flight.
Recorder	getFDR()	Returns the Flight Data recorder used for this flight.
int	getLength()	Returns the length of the fllight in hours multiplied by ten.
double	getLoadFactor()	Returns the load factor for this flight.
OnlineNetwork	getNetwork()	Returns the OnlineNetwork the flight is operated on.
int	getPassengers()	Returns the number of passengers carried on this flight.
Rank	getRank()	Returns the Pilot's rank at the time of the Flight.
String	getRemarks()	Returns the remarks for this Flight Report.
String	getRoute()	Returns the filed Flight Route.
String	getRowClassName()	Returns the CSS class for this object if rendered in a view table.
Simulator	getSimulator()	Returns the Simulator used for this flight.
FlightStatus	getStatus()	Returns the status of this Flight Report.
Collection<FlightHistoryEntry>	getStatusUpdates()	Returns the flight status history.
Instant	getSubmittedOn()	The date/time this Flight Report was submitted for approval.
boolean	hasAttribute(Attribute a)	Returns the presence of a particular flight Attribute.
boolean	hasDatabaseID(DatabaseID idType)	Returns whether this Flight has a related database row ID.
void	setAttribute(Attribute a, boolean isSet)	Set/Clear a particular Attribute for this Flight Report.
void	setAttributes(int attrs)	Sets the attributes for this Flight Report.
void	setAuthorID(int id)	Updates the author of this bean.
void	setCaptEQType(String eqType)	Sets if this Flight counts towards promotion in a particular equipment program.
void	setCaptEQType(Collection<String> eqTypes)	Sets if this Flight counts towards promotion in a particular equipment program.
void	setComments(String comments)	Sets the disposition comments for this Flight Report.
void	setDatabaseID(DatabaseID idType, int id)	Sets the database row ID of a relatied database row.
void	setDate(Instant dt)	Updates the date that this Flight was flown on.
void	setDisposedOn(Instant dd)	Updates the date/time this Flight Report was approved or rejected on.
void	setID(int id)	Updates the database ID, and the database ID of any associated status updates.
final void	setLeg(int leg)	Sets the Flight Leg.
void	setLength(int length)	Sets the length of this Flight, in hours multiplied by 10.
void	setLoadFactor(double lf)	Updates the load factor for this flight.
void	setNetwork(OnlineNetwork network)	Updates the Online Network used on this Flight.
void	setPassengers(int ps)	Updates the number of passengers carried on this flight.
void	setRank(Rank rank)	Updates the rank of the Pilot filing this report.
void	setRemarks(String remarks)	Sets the remarks for this Flight Report.
void	setRoute(String rt)	Updates the filed Flight Route.
void	setSimulator(Simulator sim)	Updates the Simulator used for this flight.
void	setStatus(FlightStatus status)	Sets the status of this Flight Report.
void	setSubmittedOn(Instant sd)	Updates the date/time this Flight Report was submitted on.

Methods inherited from class Flight

equals, getAirline, getAirportA, getAirportD, getCallsign, getDistance, getEquipmentType, getFlightCode, getFlightNumber, getLeg, getLegCode, getShortCode, hashCode, setAirline, setAirportA, setAirportD, setEquipmentType, setFlightNumber, toString

Methods inherited from class DatabaseBean

cacheKey, getHexID, getID, validateID, validateID

Methods inherited from class Object

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

Methods inherited from interface FlightData

getEquipmentType

Methods inherited from interface FlightNumber

getAirline, getFlightNumber, getLeg

Methods inherited from interface RoutePair

createKey, getAirportA, getAirportD, getAirports, getDistance, getFlightType, includes, isPopulated, matches, midPoint

Field Details

ATTR_WARN_MASK

@Deprecated
public static final int ATTR_WARN_MASK

Deprecated.

Attribute mask for all warnings.

See Also:

• Constant Field Values

Constructor Details

FlightReport

public FlightReport(Airline a,
 int flightNumber,
 int leg)

Creates a new Flight Report object with a given flight.

Parameters:

a - the Airline

flightNumber - the Flight Number

leg - the Leg Number

Throws:

NullPointerException - if the Airline Code is null

IllegalArgumentException - if the Flight Report is zero or negative

IllegalArgumentException - if the Leg is less than 1 or greater than 5

See Also:

• Flight.setAirline(Airline)
• Flight.setFlightNumber(int)
• Flight.setLeg(int)

FlightReport

public FlightReport(Flight f)

Creates a new Flight Report from an existing Flight entry (like an Assignment or ScheduleEntry).

Parameters:

f - the existing Flight

Method Details

getRank

public Rank getRank()

Returns the Pilot's rank at the time of the Flight.

Returns:

the Pilot's rank

See Also:

• setRank(Rank)

getLength

public int getLength()

Returns the length of the fllight in hours multiplied by ten. This is done to avoid rounding errors when using a floating point number.

Specified by:

getLength in class Flight

Returns:

the length of the flight in hours multiplied by ten

See Also:

• setLength(int)
• ACARSFlightReport.getLength()

getDuration

public Duration getDuration()

Description copied from class: Flight

A method to return the exact length of the flight.

Specified by:

getDuration in class Flight

Returns:

a Duration

getFDR

public Recorder getFDR()

Description copied from interface: FlightData

Returns the Flight Data recorder used for this flight.

Specified by:

getFDR in interface FlightData

Returns:

a Recorder enum or null if none/unknown

getRemarks

public String getRemarks()

Returns the remarks for this Flight Report.

Returns:

the remarks

See Also:

• setRemarks(String)
• getComments()

getRoute

public String getRoute()

Returns the filed Flight Route.

Returns:

the route

See Also:

• setRoute(String)

getComments

public String getComments()

Returns the disposition comments for this Flight Report.

Returns:

the disposition comments

See Also:

• setComments(String)
• getRemarks()

getCaptEQType

public Collection<String> getCaptEQType()

Returns if this flight counts towards promotion in a particular equipment type program.

Returns:

the equipment type program name(s), or an empty Collection if this flight does not count

getStatusUpdates

public Collection<FlightHistoryEntry> getStatusUpdates()

Returns the flight status history.

Returns:

a Collection of FlightHistoryEntry beans

getDate

public Instant getDate()

Description copied from interface: FlightData

Returns the date of the flight.

Specified by:

getDate in interface CalendarEntry

Specified by:

getDate in interface FlightData

Returns:

the date/time

getSubmittedOn

public Instant getSubmittedOn()

The date/time this Flight Report was submitted for approval.

Returns:

the submission date/time of this PIREP, null if never submitted.

See Also:

• setSubmittedOn(Instant)

getDisposedOn

public Instant getDisposedOn()

The date/time this Flight Report was disposed on. (approved or rejected)

Returns:

the approval/rejected date/time of this PIREP, null if not disposed of

See Also:

• setDisposedOn(Instant)

getDatabaseID

public int getDatabaseID(DatabaseID idType)

Sets the database row ID of a relatied database row. This row may be present in the PILOTS, ASSIGNMENTS, ACARS_PIREPS or EVENTS table. This is typically used by a DAO

Parameters:

idType - the datbase row ID type

Returns:

the database row ID, or 0 if not found

Throws:

NullPointerException - if idType is null

See Also:

• setDatabaseID(DatabaseID, int)

hasDatabaseID

public boolean hasDatabaseID(DatabaseID idType)

Returns whether this Flight has a related database row ID.

Parameters:

idType - the database row ID type

Returns:

TRUE if the database row ID is not zero, otherwise FALSE

Throws:

NullPointerException - if idType is null

See Also:

• setDatabaseID(DatabaseID, int)

getAuthorID

public int getAuthorID()

Description copied from interface: AuthoredBean

Returns the Author of this bean.

Specified by:

getAuthorID in interface AuthoredBean

Returns:

the author's database ID

See Also:

• AuthoredBean.setAuthorID(int)

getSimulator

public Simulator getSimulator()

Description copied from interface: FlightData

Returns the Simulator used for this flight.

Specified by:

getSimulator in interface FlightData

Returns:

a Simulator

getAttributes

public int getAttributes()

Returns the attributes for this Flight Report.

Returns:

a bit-mask containing this Flight Report's attributes

See Also:

• setAttributes(int)
• setAttribute(Attribute, boolean)

getStatus

public FlightStatus getStatus()

Returns the status of this Flight Report.

Returns:

the status of this PIREP

See Also:

• setStatus(FlightStatus)

getNetwork

public OnlineNetwork getNetwork()

Description copied from interface: FlightData

Returns the OnlineNetwork the flight is operated on.

Specified by:

getNetwork in interface FlightData

Returns:

an OnlineNetwork or null if offline

getPassengers

public int getPassengers()

Returns the number of passengers carried on this flight.

Returns:

the number of passengers

See Also:

• setPassengers(int)

getLoadFactor

public double getLoadFactor()

Returns the load factor for this flight.

Returns:

the load factor from 0 to 1

See Also:

• setLoadFactor(double)

hasAttribute

public boolean hasAttribute(Attribute a)

Returns the presence of a particular flight Attribute.

Parameters:

a - the Attribute

Returns:

TRUE if the Attribute is present

See Also:

• getAttributes()
• setAttributes(int)
• setAttribute(Attribute, boolean)

setNetwork

public void setNetwork(OnlineNetwork network)

Updates the Online Network used on this Flight.

Parameters:

network - an OnlineNetwork enum

See Also:

• getNetwork()

setRank

public void setRank(Rank rank)

Updates the rank of the Pilot filing this report.

Parameters:

rank - the rank

See Also:

• getRank()
• Person.getRank()

setRemarks

public void setRemarks(String remarks)

Sets the remarks for this Flight Report.

Parameters:

remarks - the remarks

See Also:

• getRemarks()
• setComments(String)

setRoute

public void setRoute(String rt)

Updates the filed Flight Route.

Parameters:

rt - the route

See Also:

• getRoute()

setComments

public void setComments(String comments)

Sets the disposition comments for this Flight Report.

Parameters:

comments - the disposition comments

See Also:

• getComments()
• setRemarks(String)

setCaptEQType

public void setCaptEQType(Collection<String> eqTypes)

Sets if this Flight counts towards promotion in a particular equipment program.

Parameters:

eqTypes - a Collection of equipment program names

See Also:

• setCaptEQType(String)

setCaptEQType

public void setCaptEQType(String eqType)

Sets if this Flight counts towards promotion in a particular equipment program.

Parameters:

eqType - an equipment program names

See Also:

• setCaptEQType(Collection)

addStatusUpdate

public void addStatusUpdate(FlightHistoryEntry upd)

Adds a status update to this Flight Report.

Parameters:

upd - a FlightHistoryEntry

addStatusUpdate

public void addStatusUpdate(int authorID,
 HistoryType type,
 String msg)

Creates a new status update and adds it to the Flight Report.

Parameters:

authorID - the Author's database ID

type - the HistoryType

msg - the status message

setID

public void setID(int id)

Updates the database ID, and the database ID of any associated status updates.

Overrides:

setID in class DatabaseBean

Parameters:

id - The primary key of the entry in the database that corresponds to this object.

See Also:

• DatabaseBean.validateID(int, int)

setLeg

public final void setLeg(int leg)

Sets the Flight Leg. Overrides the superclass implementation to check for zero values.

Overrides:

setLeg in class Flight

Parameters:

leg - the Flight Leg

See Also:

• Flight.getLeg()

setLength

public void setLength(int length)

Sets the length of this Flight, in hours multiplied by 10.

Parameters:

length - the length of the flight, in hours multiplied by 10.

setStatus

public void setStatus(FlightStatus status)

Sets the status of this Flight Report.

Parameters:

status - the new FlightStatus for this Flight Report

See Also:

• getStatus()

setAttributes

public void setAttributes(int attrs)

Sets the attributes for this Flight Report.

Parameters:

attrs - the new attributes

See Also:

• setAttribute(Attribute, boolean)
• getAttributes()

setAttribute

public void setAttribute(Attribute a,
 boolean isSet)

Set/Clear a particular Attribute for this Flight Report.

Parameters:

a - the Attribute to set or clear

isSet - TRUE if attribute should be set, FALSE if attribute should be cleared

See Also:

• setAttributes(int)
• getAttributes()

setSimulator

public void setSimulator(Simulator sim)

Updates the Simulator used for this flight.

Parameters:

sim - the Simulator

See Also:

• getSimulator()

setDate

public void setDate(Instant dt)

Updates the date that this Flight was flown on.

Parameters:

dt - when this flight was flown. The time component is undefined.

See Also:

• getDate()

setSubmittedOn

public void setSubmittedOn(Instant sd)

Updates the date/time this Flight Report was submitted on.

Parameters:

sd - this Flight Report was submitted for approval.

See Also:

• getSubmittedOn()

setDisposedOn

public void setDisposedOn(Instant dd)

Updates the date/time this Flight Report was approved or rejected on.

Parameters:

dd - when this Flight Report was approved or rejected.

See Also:

• getDisposedOn()

setPassengers

public void setPassengers(int ps)

Updates the number of passengers carried on this flight.

Parameters:

ps - the number of passengers

See Also:

• getPassengers()

setLoadFactor

public void setLoadFactor(double lf)

Updates the load factor for this flight.

Parameters:

lf - the load factor

See Also:

• getLoadFactor()

setDatabaseID

public void setDatabaseID(DatabaseID idType,
 int id)

Sets the database row ID of a relatied database row. This row may be present in the PILOTS , ASSIGNMENTS , ACARS_PIREPS or EVENTS table. This is typically used by a DAO.

Parameters:

idType - the row ID type

id - the database row ID

Throws:

IllegalArgumentException - if the id is negative

See Also:

• getDatabaseID(DatabaseID)

setAuthorID

public void setAuthorID(int id)

Description copied from interface: AuthoredBean

Updates the author of this bean.

Specified by:

setAuthorID in interface AuthoredBean

Parameters:

id - the author's database ID.

See Also:

• AuthoredBean.getAuthorID()

compareTo

public int compareTo(Object o)

Specified by:

compareTo in interface Comparable<Object>

Overrides:

compareTo in class Flight

getRowClassName

public String getRowClassName()

Description copied from interface: ViewEntry

Returns the CSS class for this object if rendered in a view table.

Specified by:

getRowClassName in interface ViewEntry

Returns:

the CSS class name, or NULL if none