Package com.cta4j.train.arrival.query

Record Class MapArrivalQuery

java.lang.Object

java.lang.Record

com.cta4j.train.arrival.query.MapArrivalQuery

Record Components:

mapId - the ID of the map to retrieve arrival information for

line - the optional train line to filter arrival information by

maxResults - the optional maximum number of arrival information to return

@NullMarked
public record MapArrivalQuery(String mapId, @Nullable TrainLine line, @Nullable Integer maxResults)
extends Record

Represents a query for train arrival information for a specific map.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	MapArrivalQuery.Builder	A builder for MapArrivalQuery.

Constructor Summary

Constructors

Constructor	Description
MapArrivalQuery(String mapId, @Nullable TrainLine line, @Nullable Integer maxResults)	Constructs a MapArrivalQuery.

Method Summary

Modifier and Type	Method	Description
static MapArrivalQuery.Builder	builder(String mapId)	Creates a builder for MapArrivalQuery.
final boolean	equals(Object o)	Indicates whether some other object is "equal to" this one.
final int	hashCode()	Returns a hash code value for this object.
@Nullable TrainLine	line()	Returns the value of the line record component.
String	mapId()	Returns the value of the mapId record component.
@Nullable Integer	maxResults()	Returns the value of the maxResults record component.
final String	toString()	Returns a string representation of this record class.

Methods inherited from class java.lang.Object

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

Constructor Details

MapArrivalQuery

public MapArrivalQuery(String mapId,
 @Nullable TrainLine line,
 @Nullable Integer maxResults)

Constructs a MapArrivalQuery.

Parameters:

mapId - the ID of the map to retrieve arrival information for

line - the optional train line to filter arrival information by

maxResults - the optional maximum number of arrival information to return

Throws:

NullPointerException - if mapId is null

IllegalArgumentException - if maxResults is non-null and not positive

Method Details

builder

public static MapArrivalQuery.Builder builder(String mapId)

Creates a builder for MapArrivalQuery.

Parameters:

mapId - the ID of the map to retrieve arrival information for

Returns:

a new Builder instance

Throws:

NullPointerException - if mapId is null

toString

public final String toString()

Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.

Specified by:

toString in class Record

Returns:

a string representation of this object

hashCode

public final int hashCode()

Returns a hash code value for this object. The value is derived from the hash code of each of the record components.

Specified by:

hashCode in class Record

Returns:

a hash code value for this object

equals

public final boolean equals(Object o)

Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with Objects::equals(Object,Object).

Specified by:

equals in class Record

Parameters:

o - the object with which to compare

Returns:

true if this object is the same as the o argument; false otherwise.

mapId

public String mapId()

Returns the value of the mapId record component.

Returns:

the value of the mapId record component

line

public @Nullable TrainLine line()

Returns the value of the line record component.

Returns:

the value of the line record component

maxResults

public @Nullable Integer maxResults()

Returns the value of the maxResults record component.

Returns:

the value of the maxResults record component