dk.dma.ais.tracker

Interface Tracker

All Known Subinterfaces:

EventEmittingTracker

All Known Implementing Classes:

EventEmittingTrackerImpl, ScenarioTracker, TargetTracker

public interface Tracker

A tracking service receives AisPackets and based on these it maintains a collection of all known tracks, including their position, speed, course, etc.

The AisPackets are assumed to arrive in timely order; i.e. by ever-increasing values of timestamp.

TODO: Identify further methods which can be shared between tracker implementations.

Method Summary

Modifier and Type	Method and Description
Target	get(int mmsi) Returns the latest target info for the specified MMSI number.
int	size() Returns the number of targets that is being tracked.
default void	subscribeToPacketReader(AisPacketReader packetReader) Start to track targets based on AisPackets received from an AisPacketReader.
default AisPacketStream.Subscription	subscribeToPacketStream(AisPacketStream stream) Start to track targets based on AisPackets received from an AisPacketStream.
void	update(AisPacket aisPacket) Update the tracker with a single AisPacket.

Method Detail

subscribeToPacketStream

default AisPacketStream.Subscription subscribeToPacketStream(AisPacketStream stream)

Start to track targets based on AisPackets received from an AisPacketStream.

Parameters:

stream - the AisPacketStream to track.

Returns:

the Subscription.

subscribeToPacketReader

default void subscribeToPacketReader(AisPacketReader packetReader)
                              throws IOException

Start to track targets based on AisPackets received from an AisPacketReader.

Parameters:

packetReader - the AisPacketReader to receive packets from.

Throws:

IOException - the io exception

update

void update(AisPacket aisPacket)

Update the tracker with a single AisPacket.

Parameters:

aisPacket - the AIS packet.

get

Target get(int mmsi)

Returns the latest target info for the specified MMSI number.

Parameters:

mmsi - the MMSI number

Returns:

the latest target info for the specified MMSI number

size

int size()

Returns the number of targets that is being tracked.

Returns:

the number of targets that is being tracked