VehicleLifecycleObserver.java

/*   
    Copyright (C) 2011 ApPeAL Group, Politecnico di Torino

    This file is part of TraCI4J.

    TraCI4J is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    TraCI4J is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with TraCI4J.  If not, see <http://www.gnu.org/licenses/>.
*/

package it.polito.appeal.traci;

/**
 * Interface for a class that wants to be notified when a vehicle enters or
 * exits a simulation.
 * @author Enrico Gueli <enrico.gueli@polito.it>
 *
 */
public interface VehicleLifecycleObserver {

	/**
	 * Method called when a vehicle has entered the simulation. This method will
	 * be called during an invocation of
	 * {@link SumoTraciConnection#nextSimStep()} and after any other
	 * {@link #vehicleArrived(String)} in the same simulation step.
	 * 
	 * @param id
	 */
	void vehicleDeparted(String id);

	/**
	 * Method called when a vehicle has exited the simulation. This method will
	 * be called during an invocation of
	 * {@link SumoTraciConnection#nextSimStep()} and before any other
	 * {@link #vehicleDeparted(String)} in the same simulation step.
	 * 
	 * @param id
	 */
	void vehicleArrived(String id);
	
	void vehicleTeleportStarting(String id);
	
	void vehicleTeleportEnding(String id);
}