/**
* Copyright (C) 2002-2012 The FreeCol Team
*
* This file is part of FreeCol.
*
* FreeCol 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 2 of the License, or
* (at your option) any later version.
*
* FreeCol is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTLIMIT 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 FreeCol. If not, see <http://www.gnu.org/licenses/>.
*/
package net.sf.freecol.common.model.mission;
import java.util.List;
import javax.xml.stream.XMLStreamConstants;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamReader;
import javax.xml.stream.XMLStreamWriter;
import net.sf.freecol.common.model.Game;
import org.w3c.dom.Element;
/**
* The CompoundMission provides a wrapper for several more basic
* Missions that will be carried out in order.
*/
public class CompoundMission extends AbstractMission {
/**
* The individual missions this CompoundMission wraps.
*/
private List<Mission> missions;
/**
* The index of the current mission.
*/
private int index;
/**
* Creates a new <code>CompoundMission</code> instance.
*
* @param game a <code>Game</code> value
*/
public CompoundMission(Game game) {
super(game);
}
/**
* Creates a new <code>CompoundMission</code> instance.
*
* @param game a <code>Game</code> value
* @param in a <code>XMLStreamReader</code> value
* @exception XMLStreamException if an error occurs
*/
public CompoundMission(Game game, XMLStreamReader in) throws XMLStreamException {
super(game, in);
}
/**
* Creates a new <code>CompoundMission</code> instance.
*
* @param game a <code>Game</code> value
* @param e an <code>Element</code> value
*/
public CompoundMission(Game game, Element e) {
super(game, e);
readFromXMLElement(e);
}
/**
* Creates a new <code>CompoundMission</code> instance.
*
* @param game a <code>Game</code> value
* @param id a <code>String</code> value
*/
public CompoundMission(Game game, String id) {
super(game, id);
}
/**
* Get the <code>Missions</code> value.
*
* @return a <code>List<Mission></code> value
*/
public final List<Mission> getMissions() {
return missions;
}
/**
* Set the <code>Missions</code> value.
*
* @param newMissions The new Missions value.
*/
public final void setMissions(final List<Mission> newMissions) {
this.missions = newMissions;
}
/**
* Get the <code>Index</code> value.
*
* @return an <code>int</code> value
*/
public final int getIndex() {
return index;
}
/**
* Set the <code>Index</code> value.
*
* @param newIndex The new Index value.
*/
public final void setIndex(final int newIndex) {
this.index = newIndex;
}
/**
* Returns true if the mission is valid.
*
* @return a <code>boolean</code> value
*/
public boolean isValid() {
if (super.isValid() && !missions.isEmpty()) {
for (Mission mission : missions) {
if (!mission.isValid()) return false;
}
return true;
}
return false;
}
/**
* {@inheritDoc}
*/
public MissionState doMission() {
MissionState state = missions.get(index).doMission();
if (state == MissionState.COMPLETED) {
index++;
if (index == missions.size()) {
setRepeatCount(getRepeatCount() - 1);
if (getRepeatCount() > 0) {
index = 0;
} else {
return MissionState.COMPLETED;
}
}
if (getUnit().getMovesLeft() > 0) {
return doMission();
}
}
return state;
}
/**
* {@inheritDoc}
*/
protected void writeAttributes(XMLStreamWriter out)
throws XMLStreamException {
super.writeAttributes(out);
out.writeAttribute("index", Integer.toString(index));
}
/**
* {@inheritDoc}
*/
protected void writeChildren(XMLStreamWriter out)
throws XMLStreamException {
super.writeChildren(out);
for (Mission mission : missions) {
mission.toXML(out);
}
}
/**
* {@inheritDoc}
*/
protected void readAttributes(XMLStreamReader in)
throws XMLStreamException {
super.readAttributes(in);
index = getAttribute(in, "index", 0);
}
/**
* {@inheritDoc}
*/
protected void readChildren(XMLStreamReader in) throws XMLStreamException {
missions.clear();
Mission mission;
while (in.nextTag() != XMLStreamConstants.END_ELEMENT) {
mission = MissionManager.getMission(getGame(), in);
if (mission != null) {
missions.add(mission);
}
}
}
}