org.opentripplanner.transit.raptor.util.paretoset.ParetoSetEventListener Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of otp Show documentation

The OpenTripPlanner multimodal journey planning system

There is a newer version: 2.5.0

package org.opentripplanner.transit.raptor.util.paretoset;


/**
 * You may subscribe/listen to the {@link ParetoSet} for events by implementing this
 * interface and register it with the ParetoSet.
 * 
 * When an element is accepted(added), other elements might get dropped. An element is dropped if it
 * is dominated by the new element.
 * 

 * When an element is NOT accepted into the pareto set; it is rejected. The rejected element is
 * dominated by one or more existing elements.
 * 

 * One {@link ParetoSet#add(Object)} operation may result in one accept event and zero to many dropped events.
 * 
 * To subscribe to these events, implement this interface and register it with the {@link ParetoSet}.
 *
 * @param  Pareto Set element type
 */
public interface ParetoSetEventListener {

    /**
     * This is the callback called when an element is dropped.
     */
    default void notifyElementAccepted(T newElement) { }

    /**
     * This is the callback called when an element is dropped.
     */
    default void notifyElementDropped(T element, T droppedByElement) { }

    /**
     * This is the callback called when an element is dropped.
     *
     * @param element           The new element that is rejected.
     * @param rejectedByElement One of the existing elements in the set which dominates the new rejected element.
     */
    default void notifyElementRejected(T element, T rejectedByElement) { }
}