Mercurial > repos > snowblizz-super-API-ideas
view api/Factories/Xml/WarFoundryXmlFactory.cs @ 6:150a5669cd7b
Re #9 - more granular loading
* Remove SystemStatsSet class so that other classes don't know the internals of how GameSystem stores its stats (cleaner code principle)
* Make XML loader each stats set and add to the game system
* Add methods to GameSystem to remove use of SystemStatsSet and hide internal handling
* Add methods to add SystemStats to GameSystem
author | IBBoard <dev@ibboard.co.uk> |
---|---|
date | Sun, 04 Jan 2009 12:13:59 +0000 |
parents | 520818033bb6 |
children | 613bc5eaac59 |
line wrap: on
line source
// WarFoundryXmlFactory.cs // // Copyright (C) 2007 IBBoard // // This library is free software; you can redistribute it and/or // modify it under the terms of the GNU Lesser General Public // License version 2.1 of the License as published by the Free // Software Foundation. // // This library 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 // Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public // License along with this library; if not, write to the Free Software // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA // // using System; using System.IO; using System.Xml; using System.Xml.Schema; using System.Collections.Generic; using System.Text; using IBBoard; using IBBoard.IO; using IBBoard.Lang; using IBBoard.Logging; using IBBoard.Xml; using IBBoard.WarFoundry.API.Requirements; using IBBoard.WarFoundry.API.Objects; using ICSharpCode.SharpZipLib.Zip; namespace IBBoard.WarFoundry.API.Factories.Xml { /// <summary> /// Summary description for WarFoundryXmlFactory. /// </summary> public class WarFoundryXmlFactory : AbstractNativeWarFoundryFactory { private Dictionary<IWarFoundryObject, XmlDocument> extraData = new Dictionary<IWarFoundryObject, XmlDocument>(); private XmlResolver xmlResolver; public static AbstractNativeWarFoundryFactory CreateFactory() { return new WarFoundryXmlFactory(); } protected WarFoundryXmlFactory() : base() { xmlResolver = new IBBXmlResolver(Constants.ExecutablePath); } protected override bool CheckCanFindArmyFileContent(ZipFile file) { return file.FindEntry("data.armyx", true) > -1; } protected override bool CheckCanFindSystemFileContent(ZipFile file) { return file.FindEntry("data.systemx", true) > -1; } protected override bool CheckCanFindRaceFileContent(ZipFile file) { return file.FindEntry("data.racex", true) > -1; } protected XmlElement GetRootElementFromStream(Stream stream, WarFoundryXmlElementName elementName) { XmlDocument doc = CreateXmlDocumentFromStream(stream); XmlElement elem = (XmlElement)doc.LastChild; if (!elem.Name.Equals(elementName.Value)) { throw new InvalidFileException(String.Format("Root element of XML was not valid. Expected {0} but got {1}", elementName.Value, elem.Name)); } return elem; } protected override Stream GetArmyDataStream(ZipFile file) { return file.GetInputStream(file.FindEntry("data.armyx", true)); } protected override Army CreateArmyFromStream (ZipFile file, Stream dataStream) { XmlElement elem = GetRootElementFromStream(dataStream, WarFoundryXmlElementName.ARMY_ELEMENT); return CreateArmyFromElement(file, elem); } private Army CreateArmyFromElement(ZipFile file, XmlElement elem) { string name = elem.GetAttribute("name"); string systemID = elem.GetAttribute("gameSystem"); GameSystem system = WarFoundryLoader.GetDefault().GetGameSystem(systemID); string raceID = elem.GetAttribute("race"); Race race = WarFoundryLoader.GetDefault().GetRace(system, raceID); string pointsString = elem.GetAttribute("maxPoints"); int points = 0; try { points = int.Parse(pointsString); } catch(FormatException) { throw new FormatException("Attribute 'maxPoints' of army '"+name+"' was not a valid number"); } Army army = new Army(race, name, points, file);//, this); extraData[army] = elem.OwnerDocument; return army; } protected override Stream GetGameSystemDataStream (ZipFile file) { return file.GetInputStream(file.FindEntry("data.systemx", true)); } protected override GameSystem CreateGameSystemFromStream (ZipFile file, Stream dataStream) { XmlElement elem = GetRootElementFromStream(dataStream, WarFoundryXmlElementName.SYSTEM_ELEMENT); LogNotifier.Debug(GetType(), "Create GameSystem"); return CreateSystemFromElement(file, elem); } private GameSystem CreateSystemFromElement(ZipFile file, XmlElement elem) { string id = elem.GetAttribute("id"); string name = elem.GetAttribute("name"); GameSystem system = new StagedLoadingGameSystem(id, name, this); //system.SourceZipFile = file.; extraData[system] = elem.OwnerDocument; return system; } protected override Stream GetRaceDataStream (ZipFile file) { return file.GetInputStream(file.FindEntry("data.racex", true)); } protected override Race CreateRaceFromStream (ZipFile file, Stream dataStream) { XmlElement elem = GetRootElementFromStream(dataStream, WarFoundryXmlElementName.RACE_ELEMENT); LogNotifier.Debug(GetType(), "Create Race"); return CreateRaceFromElement(file, elem); } private Race CreateRaceFromElement(ZipFile file, XmlElement elem) { string id = elem.GetAttribute("id"); string subid = elem.GetAttribute("subid"); string systemID = elem.GetAttribute("system"); string name = elem.GetAttribute("name"); Race race = new StagedLoadingRace(id, subid, name, systemID, this); //race.SourceZipFile = file; //TODO reference source file extraData[race] = elem.OwnerDocument; return race; } /*public WarFoundryObject CreateObjectFromStream(ZipFile file, Stream stream) { try { WarFoundryObject obj = LoadFileObjectFromElement(file, elem); if (obj != null) { extraData[obj] = doc; return obj; } else { throw new InvalidFileException(String.Format(Translation.GetTranslation("ErrorInvalidXmlFile", "XML file '{0}' was not a loadable XML file. Please ensure it is a valid and supported WarFoundry XML file."), file.Name)); } } catch (XmlSchemaException ex) { throw new InvalidFileException(String.Format(Translation.GetTranslation("ErrorInvalidXmlFile", "Failed to parse invalid XML data file in {0}. Error at line {1} position {2}: {3}"), file.Name, ex.LineNumber, ex.LinePosition, ex.Message.Substring(0, ex.Message.IndexOf(".")+1)), ex); } catch (InvalidFileException ex) { throw new InvalidFileException(String.Format(Translation.GetTranslation("ErrorInvalidNamedXmlFile", "XML data file in '{0}' was not a valid XML file. It should contain three child nodes - XML definition, DocType and root node."), file.Name), ex); } } private WarFoundryObject LoadFileObjectFromElement(ZipFile file, XmlElement elem) { WarFoundryObject obj = null; if (elem.Name.Equals(WarFoundryXmlElementName.SYSTEM_ELEMENT.Value)) { logger.Debug("Create GameSystem"); obj = CreateSystemFromElement(file, elem); } else if (elem.Name.Equals(WarFoundryXmlElementName.RACE_ELEMENT.Value)) { logger.Debug("Create Race"); obj = CreateRaceFromElement(file, elem); } return obj; }*/ public override void CompleteLoading(IWarFoundryStagedLoadObject obj) { LogNotifier.DebugFormat(GetType(), "Complete loading of {0} with ID {1}", obj.GetType().Name, obj.ID); if (!obj.IsFullyLoaded) { XmlDocument extra = extraData[obj]; if (obj is GameSystem) { GameSystem system = (GameSystem)obj; XmlNode elem = extra.LastChild; XmlNode catsElem = elem.FirstChild; Category[] cats; List<Category> catList = new List<Category>(); WarFoundryObject tempObj; foreach (XmlElement cat in catsElem.ChildNodes) { tempObj = CreateObjectFromElement(cat); if (tempObj is Category) { catList.Add((Category)tempObj); } else { LogNotifier.WarnFormat(GetType(), "Object for string {0} was not of type Category", cat.OuterXml); } } cats = catList.ToArray(); LogNotifier.DebugFormat(GetType(), "Found {0} categories", cats.Length); XmlElement statsElem = (XmlElement)catsElem.NextSibling; LoadSystemStatsFromElement(statsElem, system); string defaultStatsID = statsElem.GetAttribute("defaultStats"); LogNotifier.DebugFormat(GetType(), "Complete loading of {0}", system.Name); system.Categories = cats; system.StandardSystemStatsID = defaultStatsID; } else if (obj is Race) { Race race = (Race)obj; XmlNode elem = extra.LastChild; XmlNode colNode = elem.FirstChild; Dictionary<string, UnitType> unitTypes = new Dictionary<string, UnitType>(); foreach (XmlElement node in colNode.ChildNodes) { UnitType type = CreateUnitTypeFromElement(node, race, race.GameSystem); unitTypes.Add(type.ID, type); } colNode = colNode.NextSibling; List<Category> catOverrides = new List<Category>(); if (colNode!=null && colNode.Name == WarFoundryXmlElementName.CATEGORIES_ELEMENT.Value) { foreach (XmlElement node in colNode.ChildNodes) { catOverrides.Add(CreateCategoryFromElement(node)); } colNode = colNode.NextSibling; } Dictionary<string, EquipmentItem> raceEquipment = new Dictionary<string, EquipmentItem>(); if (colNode!=null && colNode.Name == WarFoundryXmlElementName.RACE_EQUIPMENT_ITEMS_ELEMENT.Value) { foreach (XmlElement node in colNode.ChildNodes) { EquipmentItem item = CreateEquipmentItemFromElement(node, race); raceEquipment.Add(item.ID, item); } } Dictionary<string, Ability> raceAbilities = new Dictionary<string, Ability>(); //TODO: Load abilities LogNotifier.DebugFormat(GetType(), "Complete loading of {0}", race.Name); race.Categories = catOverrides.ToArray(); race.SetUnitTypes(unitTypes); race.SetEquipmentItems(raceEquipment); race.SetAbilities(raceAbilities); } } else { LogNotifier.Debug(GetType(), "Object is already fully loaded"); } } protected XmlDocument CreateXmlDocumentFromStream(Stream stream) { XmlDocument doc = new XmlDocument(); XmlReaderSettings settings = new XmlReaderSettings(); settings.XmlResolver = xmlResolver; settings.ValidationType = ValidationType.DTD; settings.ProhibitDtd = false; settings.ValidationEventHandler+= new ValidationEventHandler(ValidationEventMethod); XmlReader reader = XmlReader.Create(stream, settings); try { doc.Load(reader); } //Don't catch XMLSchemaExceptions - let them get thrown out finally { reader.Close(); } if (doc.ChildNodes.Count!=3) { throw new InvalidFileException(Translation.GetTranslation("ErrorInvalidXmlFile", "XML file was not a valid XML file. It should contain three child nodes - XML definition, DocType and root node.")); } return doc; } protected XmlDocument CreateXmlDocumentFromString(string xmlString) { XmlReaderSettings settings = new XmlReaderSettings(); settings.XmlResolver = xmlResolver; settings.ValidationType = ValidationType.DTD; settings.ProhibitDtd = false; settings.ValidationEventHandler+= new ValidationEventHandler(ValidationEventMethod); XmlReader reader = XmlReader.Create(new MemoryStream(Encoding.UTF8.GetBytes(xmlString)), settings); XmlDocument doc = new XmlDocument(); try { doc.Load(reader); } catch(XmlSchemaException ex) { throw new InvalidFileException(Translation.GetTranslation("ErrorInvalidXmlString", "Failed to parse invalid XML string"), ex); } finally { //We might not need to make sure the memory stream is closed, but do it just in case reader.Close(); } if (doc.ChildNodes.Count!=3) { throw new InvalidFileException(String.Format(Translation.GetTranslation("ErrorInvalidXmlFile", "XML string was not a valid XML file. It should contain three child nodes - XML definition, DocType and root node."))); } return doc; } private WarFoundryObject CreateObjectFromElement(XmlElement elem) { WarFoundryObject obj = null; LogNotifier.DebugFormat(GetType(), "Create object for <{0}>", elem.Name); if (elem.Name.Equals(WarFoundryXmlElementName.CATEGORY_ELEMENT.Value)) { LogNotifier.Debug(GetType(), "Create Category"); obj = CreateCategoryFromElement(elem); } else { LogNotifier.Debug(GetType(), "No match"); } return obj; } private Category CreateCategoryFromElement(XmlElement elem) { string id = elem.GetAttribute("id"); string name = elem.GetAttribute("name"); int minPc, maxPc, minPts, maxPts, minChoices, maxChoices, baseValue, incValue, incAmount; try { minPc = int.Parse(elem.GetAttribute("minPercentage")); } catch(FormatException) { throw new FormatException("Attribute 'minPercentage' of category "+id+" was not a valid number"); } try { maxPc = int.Parse(elem.GetAttribute("maxPercentage")); } catch(FormatException) { throw new FormatException("Attribute 'maxPercentage' of category "+id+" was not a valid number"); } try { minPts = int.Parse(elem.GetAttribute("minPoints")); } catch(FormatException) { throw new FormatException("Attribute 'minPoints' of category "+id+" was not a valid number"); } try { maxPts = int.Parse(elem.GetAttribute("maxPoints")); } catch(FormatException) { throw new FormatException("Attribute 'maxPoints' of category "+id+" was not a valid number"); } try { minChoices = int.Parse(elem.GetAttribute("minChoices")); } catch(FormatException) { throw new FormatException("Attribute 'minChoices' of category "+id+" was not a valid number"); } try { maxChoices = int.Parse(elem.GetAttribute("maxChoices")); } catch(FormatException) { throw new FormatException("Attribute 'maxChoices' of category "+id+" was not a valid number"); } try { baseValue = int.Parse(elem.GetAttribute("baseValue")); } catch(FormatException) { throw new FormatException("Attribute 'baseValue' of category "+id+" was not a valid number"); } try { incValue = int.Parse(elem.GetAttribute("incValue")); } catch(FormatException) { throw new FormatException("Attribute 'incValue' of category "+id+" was not a valid number"); } try { incAmount = int.Parse(elem.GetAttribute("incAmount")); } catch(FormatException) { throw new FormatException("Attribute 'incAmount' of category "+id+" was not a valid number"); } return new Category(id, name, minPts, maxPts, minPc, maxPc, minChoices, maxChoices, baseValue, incValue, incAmount); } private UnitType CreateUnitTypeFromElement(XmlElement elem, Race parentRace, GameSystem system) { string id = elem.GetAttribute("id"); string name = elem.GetAttribute("typeName"); string mainCatID = elem.GetAttribute("cat"); int minNum, maxNum, minSize, maxSize, baseSize;//TODO: Add base size float points, unitPoints; Stats stats; List<UnitRequirement> unitRequirements = new List<UnitRequirement>(); bool found = false; List<string> catIDs = new List<string>(); string catID; try { minNum = int.Parse(elem.GetAttribute("minNum")); } catch(FormatException) { throw new FormatException("Attribute 'minNum' of unit "+id+" was not a valid number"); } try { maxNum = int.Parse(elem.GetAttribute("maxNum")); } catch(FormatException) { throw new FormatException("Attribute 'maxNum' of unit "+id+" was not a valid number"); } try { minSize = int.Parse(elem.GetAttribute("minSize")); } catch(FormatException) { throw new FormatException("Attribute 'minSize' of unit "+id+" was not a valid number"); } try { maxSize = int.Parse(elem.GetAttribute("maxSize")); } catch(FormatException) { throw new FormatException("Attribute 'maxSize' of unit "+id+" was not a valid number"); } if (minSize > maxSize && maxSize!=-1) { minSize = maxSize; } try { points = int.Parse(elem.GetAttribute("points")); } catch(FormatException) { throw new FormatException("Attribute 'points' of unit "+id+" was not a valid number"); } try { unitPoints = int.Parse(elem.GetAttribute("unitPoints")); } catch(FormatException) { throw new FormatException("Attribute 'trooperPoints' of unit "+id+" was not a valid number"); } XmlNode node = elem.FirstChild; foreach(XmlElement cat in node.ChildNodes) { catID = cat.GetAttribute("catID"); catIDs.Add(catID); if (catID == mainCatID) { found = true; } } if (!found) { throw new InvalidFileException("The main cat "+mainCatID+" was not found in the list of categories for unit "+id); } node = node.NextSibling; stats = ParseUnitStats((XmlElement)node, system); //TODO: Add unit requirements UnitType type = new UnitType(id, name, mainCatID, catIDs.ToArray(), minNum, maxNum, minSize, maxSize, unitPoints, points, stats, unitRequirements.ToArray(), parentRace); return type; } private Stats ParseUnitStats(XmlElement elem, GameSystem system) { List<Stat> statsList = new List<Stat>(); String statsID = elem.GetAttribute("statSet"); SystemStats statsSet; if (statsID == "") { statsSet = system.StandardSystemStats; } else { statsSet = system.GetSystemStatsForID(statsID); } Stats stats = new Stats(statsSet); foreach (XmlElement stat in elem.ChildNodes) { String statID = stat.GetAttribute("name"); StatSlot slot = statsSet[statID]; if (slot!=null) { statsList.Add(new Stat(slot, stat.InnerText)); } else { throw new InvalidFileException("The stat "+statID+" was not found in stats set "+statsID); } } stats.SetStats(statsList); return stats; } private void LoadSystemStatsFromElement(XmlElement elem, GameSystem system) { foreach (XmlElement stats in elem.ChildNodes) { SystemStats sysStats = CreateSystemStatsFromElement(stats); system.AddSystemStats(sysStats); } } private SystemStats CreateSystemStatsFromElement(XmlElement elem) { List<StatSlot> slots = new List<StatSlot>(); string id = elem.GetAttribute("id"); foreach (XmlElement slot in elem.ChildNodes) { StatSlot statSlot = new StatSlot(slot.GetAttribute("name")); slots.Add(statSlot); } return new SystemStats(id, slots.ToArray()); } private EquipmentItem CreateEquipmentItemFromElement(XmlElement elem, Race race) { string id = elem.GetAttribute("id"); string name = elem.GetAttribute("name"); float cost = 0, min = 0, max = 0; ArmourType armourType; try { cost = float.Parse(elem.GetAttribute("cost")); } catch(FormatException) { throw new FormatException("Attribute 'cost' of equipment item "+id+" was not a valid number"); } try { min = float.Parse(elem.GetAttribute("min")); } catch(FormatException) { throw new FormatException("Attribute 'min' of equipment item "+id+" was not a valid number"); } try { max = float.Parse(elem.GetAttribute("max")); } catch(FormatException) { throw new FormatException("Attribute 'max' of equipment item "+id+" was not a valid number"); } try { armourType = (ArmourType)Enum.Parse(typeof(ArmourType), elem.GetAttribute("armourType")); } catch(FormatException) { throw new InvalidFileException("Attribute 'armourType' of equipment "+id+" was not a valid value from the enumeration"); } if (elem.ChildNodes.Count>0) { //It has stats! //TODO: Parse equipment stats } return new EquipmentItem(id, name, cost, min, max, armourType, race); } private void ValidationEventMethod(object sender, ValidationEventArgs e) { //TODO: Fire a validation failure event LogNotifier.WarnFormat(GetType(), "Validation Error: {0}", e.Message); } } }