* <code>null</code>.
* @throws <code>IllegalStateException</code> if the node does not contain
* a valid <code>Entity</code>.
*/
public static Entity decode(ParsedXML node, IGame game) {
Tank entity = null;
String attrStr;
int attrVal;
// Did we get a null node?
if (null == node) {
throw new IllegalArgumentException("The Tank node is null.");
}
// Make sure that the node is for an Tank unit.
attrStr = node.getAttribute("name");
if (!node.getName().equals("class") || null == attrStr
|| !attrStr.equals("Tank")) {
throw new IllegalStateException("Not passed an Tank node.");
}
// TODO : perform version checking.
// Create the entity.
entity = new Tank();
// Walk the board node's children.
Enumeration<?> children = node.elements();
while (children.hasMoreElements()) {
ParsedXML child = (ParsedXML) children.nextElement();
String childName = child.getName();
// Handle null child names.
if (null == childName) {
// No-op.
}
// Did we find the stunnedTurns node?
else if (childName.equals("stunnedTurns")) {
// Get the Tank's stunned turns.
attrStr = child.getAttribute("value");
if (null == attrStr) {
throw new IllegalStateException(
"Couldn't decode the stunnedTurns for a Tank unit.");
}
// Try to pull the number from the attribute string
try {
attrVal = Integer.parseInt(attrStr);
} catch (NumberFormatException exp) {
throw new IllegalStateException(
"Couldn't get an integer from " + attrStr);
}
entity.setStunnedTurns(attrVal);
}
// Did we find the hasNoTurret node?
else if (childName.equals("hasNoTurret")) {
// See if the Tank has a no turret.
attrStr = child.getAttribute("value");
if (null == attrStr) {
throw new IllegalStateException(
"Couldn't decode hasNoTurret for a Tank unit.");
}
// If the value is "true", the Tank has a no turret.
if (attrStr.equals("true")) {
entity.setHasNoTurret(true);
} else {
entity.setHasNoTurret(false);
}
}
// Did we find the moveHit node?
else if (childName.equals("moveHit")) {
// See if the Tank has a move hit.
attrStr = child.getAttribute("value");
if (null == attrStr) {
throw new IllegalStateException(
"Couldn't decode moveHit for a Tank unit.");
}
// If the value is "true", the Tank move a hit pending.
if (attrStr.equals("true")) {
entity.immobilize();
entity.applyDamage();
}
}
// Did we find the moveHitPending node?
else if (childName.equals("moveHitPending")) {
// See if the Tank has a move hit pending.
attrStr = child.getAttribute("value");
if (null == attrStr) {
throw new IllegalStateException(
"Couldn't decode moveHitPending for a Tank unit.");
}
// If the value is "true", the Tank move a hit pending.
if (attrStr.equals("true")) {
entity.immobilize();
}
}
// Did we find the facing node?
else if (childName.equals("facing")) {
// Get the Tank's facing.
attrStr = child.getAttribute("value");
if (null == attrStr) {
throw new IllegalStateException(
"Couldn't decode the facing for a Tank unit.");
}
// Try to pull the number from the attribute string
try {
attrVal = Integer.parseInt(attrStr);
} catch (NumberFormatException exp) {
throw new IllegalStateException(
"Couldn't get an integer from " + attrStr);
}
entity.setFacing(attrVal);
}
// Did we find the turret's secondaryFacing node?
else if (childName.equals("turretFacing")) {
// Get the Tank's turret's facing.
attrStr = child.getAttribute("value");
if (null == attrStr) {
throw new IllegalStateException(
"Couldn't decode the turret's secondaryFacing for a Tank unit.");
}
// Try to pull the number from the attribute string
try {
attrVal = Integer.parseInt(attrStr);
} catch (NumberFormatException exp) {
throw new IllegalStateException(
"Couldn't get an integer from " + attrStr);
}
entity.setSecondaryFacing(attrVal);
}
// Did we find the turretLocked node?
else if (childName.equals("turretLocked")) {
// See if the Tank move a hit pending.
attrStr = child.getAttribute("value");
if (null == attrStr) {
throw new IllegalStateException(
"Couldn't decode turretLocked for a Tank unit.");
}
// If the value is "true", the Tank move a hit pending.
if (attrStr.equals("true")) {
entity.lockTurret();
}
}
} // Handle the next element.