/*******************************************************************************
* Copyright (c) 2001, 2010 Mathew A. Nelson and Robocode contributors
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://robocode.sourceforge.net/license/epl-v10.html
*
* Contributors:
* Pavel Savara
* - Initial implementation
* Flemming N. Larsen
* - Javadocs
*******************************************************************************/
package robocode.control.events;
/**
* A BattleFinishedEvent is sent to {@link IBattleListener#onBattleFinished(BattleFinishedEvent)
* onBattleFinished()} when the battle is finished. This event is always sent as the last battle event,
* both when the battle is completed successfully, terminated due to an error, or aborted by the user.
* Hence, this events is well-suited for cleanup after the battle.
*
* @see IBattleListener
* @see BattleStartedEvent
* @see BattleCompletedEvent
*
* @author Pavel Savara (original)
* @author Flemming N. Larsen (contributor)
*
* @since 1.6.2
*/
public class BattleFinishedEvent extends BattleEvent {
private final boolean isAborted;
/**
* Called by the game to create a new BattleFinishedEvent.
* Please don't use this constructor as it might change.
*
* @param isAborted a flag specifying if the battle was aborted:
* {@code true} if the battle was aborted; {@code false} otherwise.
*/
public BattleFinishedEvent(boolean isAborted) {
super();
this.isAborted = isAborted;
}
/**
* Checks if the battle was aborted.
*
* @return {@code true} if the battle was aborted; {@code false} otherwise.
*/
public boolean isAborted() {
return isAborted;
}
}