Mercurial > repos > IBDev-IBBoard.WarFoundry.API
annotate api/Factories/Xml/WarFoundryXmlFactoryUtils.cs @ 392:db6713d5b35f default-army-size
RRe #97: Default army size issues
| author | snowblizz |
|---|---|
| date | Wed, 01 Dec 2010 20:00:58 +0000 |
| parents | 3f14a792fd41 |
| children |
| rev | line source |
|---|---|
| 52 | 1 // This file (WarFoundryXmlFactoryUtils.cs) is a part of the IBBoard.WarFoundry.API project and is copyright 2009 IBBoard |
| 2 // | |
|
104
2f3cafb69799
Re #121: Migrate to AGPL license
IBBoard <dev@ibboard.co.uk>
parents:
52
diff
changeset
|
3 // The file and the library/program it is in are licensed and distributed, without warranty, under the GNU Affero GPL license, either version 3 of the License or (at your option) any later version. Please see COPYING for more information and the full license. |
| 52 | 4 |
| 5 using System; | |
| 6 using System.IO; | |
| 7 using System.Xml; | |
| 8 using System.Xml.Schema; | |
| 9 using IBBoard.WarFoundry.API.Objects; | |
| 218 | 10 using IBBoard.IO; |
| 52 | 11 |
| 12 namespace IBBoard.WarFoundry.API.Factories.Xml | |
| 13 { | |
| 14 /// <summary> | |
| 15 /// A collection of useful utility methods for loading WarFoundry data from XML files | |
| 16 /// </summary> | |
| 17 public class WarFoundryXmlFactoryUtils | |
| 18 { | |
|
146
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
19 public static readonly string NS_BASE = "http://ibboard.co.uk/warfoundry/"; |
| 52 | 20 private static XmlReaderSettings settings; |
| 21 private static XmlNamespaceManager nsManager; | |
| 22 | |
| 23 public static XmlNodeList SelectNodes(XmlNode element, string xpathQuery) | |
| 24 { | |
| 25 return element.SelectNodes(xpathQuery, GetNamespaceManager()); | |
| 26 } | |
| 27 | |
| 28 public static XmlNode SelectSingleNode(XmlNode element, string xpathQuery) | |
| 29 { | |
| 30 return element.SelectSingleNode(xpathQuery, GetNamespaceManager()); | |
| 31 } | |
| 32 | |
| 33 public static XmlElement SelectSingleElement(XmlNode element, string xpathQuery) | |
| 34 { | |
| 35 XmlNode node = SelectSingleNode(element, xpathQuery); | |
| 36 return (node is XmlElement) ? (XmlElement) node : null; | |
| 37 } | |
| 38 | |
| 39 public static XmlNamespaceManager GetNamespaceManager() | |
| 40 { | |
| 41 if (nsManager == null) | |
| 42 { | |
| 43 nsManager = new XmlNamespaceManager(new NameTable()); | |
|
146
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
44 nsManager.AddNamespace("core", NS_BASE + "core"); |
|
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
45 nsManager.AddNamespace("cat", NS_BASE + "cats"); |
|
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
46 nsManager.AddNamespace("race", NS_BASE + "race"); |
|
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
47 nsManager.AddNamespace("system", NS_BASE + "system"); |
|
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
48 nsManager.AddNamespace("army", NS_BASE + "army"); |
| 52 | 49 } |
| 50 | |
| 51 return nsManager; | |
| 52 } | |
| 53 | |
| 54 /// <summary> | |
| 55 /// Lazy-getter for XML reader settings. May throw a <see cref="InvalidDataException"/> if there is a problem with the translation schema. | |
| 56 /// </summary> | |
| 57 /// <returns> | |
| 58 /// A <see cref="XmlReaderSettings"/> with the default values for validating the translation document against the translation schema | |
| 59 /// </returns> | |
| 60 public static XmlReaderSettings GetReaderSettings() | |
| 61 { | |
| 62 if (settings == null) | |
| 63 { | |
| 64 settings = new XmlReaderSettings(); | |
| 65 settings.ValidationType = ValidationType.Schema; | |
|
267
3f14a792fd41
Re #274: Crash when missing unit member ID
IBBoard <dev@ibboard.co.uk>
parents:
245
diff
changeset
|
66 //settings.ValidationFlags = XmlSchemaValidationFlags.ReportValidationWarnings; |
| 52 | 67 settings.ProhibitDtd = true; |
| 68 settings.ValidationEventHandler+= new ValidationEventHandler(ValidationEventMethod); | |
| 69 XmlSchemaSet cache = new XmlSchemaSet(); | |
|
224
f097888efcfe
Fixes #233: "unitPoints" attribute is badly named
IBBoard <dev@ibboard.co.uk>
parents:
218
diff
changeset
|
70 string path = IBBoard.Constants.ExecutablePath + "/schemas/"; |
|
146
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
71 AddSchemaToCache(cache, NS_BASE + "core", path + "warfoundry-core.xsd"); |
|
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
72 AddSchemaToCache(cache, NS_BASE + "cats", path + "warfoundry-cats.xsd"); |
|
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
73 AddSchemaToCache(cache, NS_BASE + "race", path + "race.xsd"); |
|
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
74 AddSchemaToCache(cache, NS_BASE + "system", path + "system.xsd"); |
|
0b32cc40d82f
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
104
diff
changeset
|
75 AddSchemaToCache(cache, NS_BASE + "army", path + "army.xsd"); |
| 52 | 76 settings.Schemas.Add(cache); |
|
245
bbd86698240a
Re #152: Test and fix extensibility of current schemas
IBBoard <dev@ibboard.co.uk>
parents:
224
diff
changeset
|
77 settings.Schemas.CompilationSettings.EnableUpaCheck = false; |
| 52 | 78 } |
| 79 | |
| 80 return settings; | |
| 81 } | |
| 82 | |
| 83 private static void ValidationEventMethod(object sender, ValidationEventArgs e) | |
| 84 { | |
|
267
3f14a792fd41
Re #274: Crash when missing unit member ID
IBBoard <dev@ibboard.co.uk>
parents:
245
diff
changeset
|
85 if (e.Severity == XmlSeverityType.Error) |
|
3f14a792fd41
Re #274: Crash when missing unit member ID
IBBoard <dev@ibboard.co.uk>
parents:
245
diff
changeset
|
86 { |
|
3f14a792fd41
Re #274: Crash when missing unit member ID
IBBoard <dev@ibboard.co.uk>
parents:
245
diff
changeset
|
87 throw new InvalidFileException("Problem validating against schema for WarFoundry data: " + e.Message, e.Exception); |
|
3f14a792fd41
Re #274: Crash when missing unit member ID
IBBoard <dev@ibboard.co.uk>
parents:
245
diff
changeset
|
88 } |
|
3f14a792fd41
Re #274: Crash when missing unit member ID
IBBoard <dev@ibboard.co.uk>
parents:
245
diff
changeset
|
89 else |
|
3f14a792fd41
Re #274: Crash when missing unit member ID
IBBoard <dev@ibboard.co.uk>
parents:
245
diff
changeset
|
90 { |
|
3f14a792fd41
Re #274: Crash when missing unit member ID
IBBoard <dev@ibboard.co.uk>
parents:
245
diff
changeset
|
91 //TODO: Fire some kind of warning event |
|
3f14a792fd41
Re #274: Crash when missing unit member ID
IBBoard <dev@ibboard.co.uk>
parents:
245
diff
changeset
|
92 } |
| 52 | 93 } |
| 94 | |
| 95 private static void AddSchemaToCache(XmlSchemaSet cache, string xmlNamespace, string schemaLocation) | |
| 96 { | |
| 97 try | |
| 98 { | |
| 99 cache.Add(xmlNamespace, schemaLocation); | |
| 100 } | |
| 101 catch (IOException ex) | |
| 102 { | |
|
179
c1caf467dd40
Re #193: Unhandled exception in dictionary?
IBBoard <dev@ibboard.co.uk>
parents:
146
diff
changeset
|
103 //TODO: Warn on schema failure |
| 52 | 104 } |
| 105 catch (XmlSchemaException ex) | |
| 106 { | |
|
179
c1caf467dd40
Re #193: Unhandled exception in dictionary?
IBBoard <dev@ibboard.co.uk>
parents:
146
diff
changeset
|
107 //TODO: Warn on schema failure |
| 52 | 108 } |
| 109 catch (XmlException ex) | |
| 110 { | |
|
179
c1caf467dd40
Re #193: Unhandled exception in dictionary?
IBBoard <dev@ibboard.co.uk>
parents:
146
diff
changeset
|
111 //TODO: Warn on schema failure |
| 52 | 112 } |
| 113 } | |
| 114 | |
| 115 public static XmlDocument CreateXmlDocumentFromStream(Stream stream) | |
| 116 { | |
| 117 XmlDocument doc = new XmlDocument(); | |
| 118 XmlReader reader = XmlReader.Create(stream, GetReaderSettings()); | |
| 119 | |
| 120 try | |
| 121 { | |
| 122 doc.Load(reader); | |
| 123 } | |
| 124 //Don't catch XMLSchemaExceptions - let them get thrown out | |
| 125 finally | |
| 126 { | |
| 127 reader.Close(); | |
| 128 } | |
| 129 | |
| 130 return doc; | |
| 131 } | |
| 132 | |
| 133 public static bool CanCompleteLoading(IWarFoundryStagedLoadObject obj) | |
| 134 { | |
| 135 bool canLoad = true; | |
| 136 | |
| 137 if (obj.IsFullyLoaded) | |
| 138 { | |
| 139 canLoad = false; | |
| 140 } | |
| 141 else if (obj.IsLoading) | |
| 142 { | |
| 143 canLoad = false; | |
| 144 } | |
| 145 | |
| 146 return canLoad; | |
| 147 } | |
| 148 } | |
| 149 } |