Mercurial > repos > IBBoard
annotate Lang/Translation.cs @ 7:f4da31cb09d9
* Add translation DTD to utils project
* Alter Translation class to resolve error when initialising with an empty local language (should default to no local language, not exception)
no-open-ticket
author | IBBoard <dev@ibboard.co.uk> |
---|---|
date | Fri, 02 Jan 2009 20:12:06 +0000 |
parents | f269d8bcc152 |
children | d6ce8764e92b |
rev | line source |
---|---|
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
1 using System; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
2 using System.IO; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
3 using System.Xml; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
4 using System.Xml.Schema; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
5 using System.Collections.Generic; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
6 using System.Reflection; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
7 using System.ComponentModel; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
8 using IBBoard.IO; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
9 using IBBoard.Logging; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
10 using IBBoard.Xml; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
11 |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
12 namespace IBBoard.Lang |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
13 { |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
14 /// <summary> |
6 | 15 /// A basic string translator that loads a default language and a specified language and returns translated strings that correspond to translation IDs. |
16 /// If the string doesn't exist in the specified language then the translator falls back to the default language. If the translation doesn't exist in the default language | |
17 /// then either a supplied value or a "no validation available" message is returned. | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
18 /// </summary> |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
19 public class Translation |
6 | 20 { |
21 private static readonly string DEFAULT_LANGUAGE = "en"; | |
22 private static readonly string DIVIDER_STRING = "-"; | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
23 private static string lang = ""; |
6 | 24 private static DirectoryInfo translationDir; |
25 private static Dictionary<string, string> translationsLocal; | |
26 private static Dictionary<string, string> translationsDefault; | |
27 | |
28 /// <summary> | |
29 /// Initialises the translations for the language specified and the default translations so that the Translation class can be used | |
30 /// </summary> | |
31 /// <param name="appPath"> | |
32 /// The full path that the application is running from. Must contain the "translations" folder. | |
33 /// </param> | |
34 /// <param name="language"> | |
35 /// The language to use as the load language | |
36 /// </param> | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
37 public static void InitialiseTranslations(string appPath, string language) |
6 | 38 { |
39 InitialiseDefaults(appPath); | |
40 FileInfo file = GetTranslationFile(DEFAULT_LANGUAGE); | |
41 XmlDocument doc = LoadTranslationDocument(file); | |
42 LoadTranslationsFromDocument(doc, translationsDefault); | |
43 translationsLocal = null; | |
44 LoadTranslation(lang); | |
45 } | |
46 | |
47 private static void InitialiseDefaults(string appPath) | |
48 { | |
49 string translationPath = appPath.TrimEnd(Constants.DirectoryChar) + Constants.DirectoryString + "translations"; | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
50 |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
51 if (Directory.Exists(translationPath)) |
6 | 52 { |
53 translationsDefault = new Dictionary<string,string>(); | |
54 translationsLocal = new Dictionary<string,string>(); | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
55 translationDir = new DirectoryInfo(translationPath); |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
56 } |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
57 else |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
58 { |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
59 throw new ArgumentException("Translation path must exist ("+translationPath+")"); |
6 | 60 } |
61 } | |
62 | |
63 private static XmlDocument LoadTranslationDocument(FileInfo file) | |
64 { | |
65 XmlDocument doc = new XmlDocument(); | |
66 XmlReaderSettings settings = new XmlReaderSettings(); | |
67 settings.XmlResolver = new IBBXmlResolver(translationDir.Parent.FullName); | |
68 settings.ValidationType = ValidationType.DTD; | |
69 settings.ProhibitDtd = false; | |
70 settings.ValidationEventHandler+= new ValidationEventHandler(ValidationEventMethod); | |
71 XmlReader valReader = XmlReader.Create(file.FullName, settings); | |
72 doc.Load(valReader); | |
73 valReader.Close(); | |
74 return doc; | |
75 } | |
76 | |
77 private static FileInfo GetTranslationFile(string language) | |
78 { | |
79 FileInfo file = new FileInfo(translationDir.FullName + Constants.DirectoryString + language + ".translation"); | |
80 | |
81 if (!file.Exists) | |
82 { | |
83 throw new FileNotFoundException(language + "translation could not be found in "+translationDir.FullName); | |
84 } | |
85 | |
86 return file; | |
87 } | |
88 | |
89 private static void LoadTranslationsFromDocument(XmlDocument doc, Dictionary<string, string> translationTable) | |
90 { | |
91 try | |
92 { | |
93 XmlNodeList translations = doc.GetElementsByTagName("translation"); | |
94 | |
95 if (translations.Count==0) | |
96 { | |
97 throw new InvalidFileException("No translations found in "+GetLanguageOfDocument(doc)+".translation"); | |
98 } | |
99 | |
100 Dictionary<string, string> tempTranslationTable = new Dictionary<string,string>(); | |
101 | |
102 foreach (XmlNode node in translations) | |
103 { | |
104 tempTranslationTable.Add(node.Attributes["id"].Value, node.InnerText); | |
105 } | |
106 | |
107 translationTable.Clear(); | |
108 | |
109 foreach (string key in tempTranslationTable.Keys) | |
110 { | |
111 string translation; | |
112 tempTranslationTable.TryGetValue(key, out translation); | |
113 translationTable.Add(key, translation); | |
114 } | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
115 } |
6 | 116 catch(Exception ex) |
117 { | |
118 throw new XmlParseException("Error while parsing " + GetLanguageOfDocument(doc)+" translation: "+ex.Message); | |
119 } | |
120 } | |
121 | |
122 private static string GetLanguageOfDocument(XmlDocument doc) | |
123 { | |
124 return doc != null ? doc.DocumentElement.GetAttribute("lang") : ""; | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
125 } |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
126 |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
127 private static void ValidationEventMethod(object sender, ValidationEventArgs e) |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
128 { |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
129 //TODO: Fire a validation failure event |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
130 LogNotifier.Error(typeof(Translation), "Validation Error", e.Exception); |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
131 } |
6 | 132 |
133 /// <summary> | |
134 /// Loads translations for a given language and sets them as the local language | |
135 /// </summary> | |
136 /// <param name="translationLang"> | |
137 /// The new local language to load | |
138 /// </param> | |
7
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
139 public static void LoadTranslation(string translationLanguage) |
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
140 { |
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
141 if (translationLanguage == "" || translationLanguage == null) |
6 | 142 { |
143 throw new ArgumentException("Translation language cannot be empty or null"); | |
144 } | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
145 |
7
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
146 LoadTranslationForLang(translationLanguage); |
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
147 } |
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
148 |
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
149 private static void LoadTranslationForLanguage(string translationLanguage) |
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
150 { |
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
151 checkInitialisation(); |
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
152 |
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
153 if (translationLanguage != DEFAULT_LANGUAGE && translationLanguage != "" && translationLanguage != null) |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
154 { |
6 | 155 FileInfo file = GetTranslationFile(translationLang); |
156 XmlDocument doc = LoadTranslationDocument(file); | |
157 LoadTranslationsFromDocument(doc, translationsLocal); | |
158 } | |
159 else | |
160 { | |
161 translationsLocal.Clear(); | |
162 } | |
163 | |
7
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
164 lang = translationLang; |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
165 } |
6 | 166 |
167 /// <summary> | |
168 /// Gets a translation for a given ID, falling back to a "missing translation" message if none can be found. Also optionally replaces any placeholders with the supplied values. | |
169 /// </summary> | |
170 /// <param name="translationID"> | |
171 /// The ID to look up the translation for | |
172 /// </param> | |
173 /// <param name="replacements"> | |
174 /// A collection of <see cref="System.Object"/>s to replace placeholders with | |
175 /// </param> | |
176 /// <returns> | |
177 /// The translation with the placeholders replaced or a "missing translation" message | |
178 /// </returns> | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
179 public static string GetTranslation(string translationID, params object[] replacements) |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
180 { |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
181 return GetTranslation(translationID, false, replacements); |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
182 } |
6 | 183 |
184 /// <summary> | |
185 /// Gets a translation for a given ID, falling back to null or a warning message if a translation cannot be found. Also optionally replaces any placeholders with the supplied values. | |
186 /// </summary> | |
187 /// <param name="translationID"> | |
188 /// The ID to look up the translation for | |
189 /// </param> | |
190 /// <param name="returnNullOnFail"> | |
191 /// TRUE if null should be returned when no translation can be found, or FALSE if a "missing translation" message should be returned | |
192 /// </param> | |
193 /// <param name="replacements"> | |
194 /// A collection of <see cref="System.Object"/>s to replace placeholders with | |
195 /// </param> | |
196 /// <returns> | |
197 /// The translation with the placeholders replaced, or a "missing translation" message or null depending on <param name="returnNullOnFail"> | |
198 /// </returns> | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
199 public static string GetTranslation(string translationID, bool returnNullOnFail, params object[] replacements) |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
200 { |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
201 return GetTranslation(translationID, returnNullOnFail ? null : "", replacements); |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
202 } |
6 | 203 |
204 /// <summary> | |
205 /// Gets a translation for a given ID, falling back to a supplied default if a translation cannot be found. Also optionally replaces any placeholders with the supplied values. | |
206 /// </summary> | |
207 /// <param name="translationID"> | |
208 /// The ID to look up the translation for | |
209 /// </param> | |
210 /// <param name="defaultTranslation"> | |
211 /// The string to return if no translation can be found. Can be null or any string. | |
212 /// </param> | |
213 /// <param name="replacements"> | |
214 /// A collection of <see cref="System.Object"/>s to replace placeholders with | |
215 /// </param> | |
216 /// <returns> | |
217 /// The translation, if one exists, or the supplied default with the placeholders replaced | |
218 /// </returns> | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
219 public static string GetTranslation(string translationID, string defaultTranslation, params object[] replacements) |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
220 { |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
221 checkInitialisation(); |
6 | 222 string trans = GetTranslationFromTables(translationID); |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
223 |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
224 if (trans == null) |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
225 { |
6 | 226 trans = GetDefaultTranslation(translationID, defaultTranslation); |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
227 } |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
228 |
6 | 229 trans = AddVariablesToTranslation(trans, replacements); |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
230 |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
231 return trans; |
6 | 232 } |
233 | |
234 private static string GetTranslationFromTables(string translationID) | |
235 { | |
236 string translation = null; | |
237 | |
238 if (translationsLocal!=null) | |
239 { | |
240 translationsLocal.TryGetValue(translationID, out translation); | |
241 } | |
242 | |
243 if (translation == null) | |
244 { | |
245 translationsDefault.TryGetValue(translationID, out translation); | |
246 } | |
247 | |
248 return translation; | |
249 } | |
250 | |
251 private static string GetDefaultTranslation(string translationID, string defaultTranslation) | |
252 { | |
253 return (defaultTranslation != "" && defaultTranslation != null) ? defaultTranslation : GetMissingTranslationMessage(translationID); | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
254 } |
6 | 255 |
256 private static string GetMissingTranslationMessage(string translationID) | |
257 { | |
258 return "++ Missing Translation "+translationID+" ++"; | |
259 } | |
260 | |
261 private static string AddVariablesToTranslation(string translation, object[] replacements) | |
262 { | |
263 if (translation != null && replacements != null && replacements.Length > 0) | |
264 { | |
265 translation = String.Format(translation, replacements); | |
266 } | |
267 | |
268 return translation; | |
269 } | |
270 | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
271 private static void checkInitialisation() |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
272 { |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
273 if (translationDir==null) |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
274 { |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
275 throw new InvalidOperationException("Translation class has not been initialised"); |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
276 } |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
277 } |
6 | 278 |
279 /// <summary> | |
280 /// Translate an <see cref="ITranslatable"/> item, with optional string replacement | |
281 /// </summary> | |
282 /// <param name="item"> | |
283 /// A <see cref="ITranslatable"/> to set the text for | |
284 /// </param> | |
285 /// <param name="replacements"> | |
286 /// A collection of <see cref="System.Object"/>s that will be used to fill place-holders | |
287 /// </param> | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
288 public static void Translate(ITranslatable item, params object[] replacements) |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
289 { |
6 | 290 if (item.Text == "" || item.Text == DIVIDER_STRING) |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
291 { |
6 | 292 //it doesn't need translating - either there is no text from the developer or it's a hyphen for a divider |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
293 return; |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
294 } |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
295 |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
296 item.Text = GetTranslation(item.Name, replacements); |
6 | 297 } |
298 | |
299 /// <summary> | |
300 /// Get the current local translation language. This is an arbitrary string used in the translation file's name and will not necessarily match the ISO language code. | |
301 /// </summary> | |
302 /// <returns> | |
303 /// The string used in the file name of the current local translation | |
304 /// </returns> | |
305 public static string GetTranslationLanguage() | |
306 { | |
307 return lang; | |
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
308 } |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
309 } |
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
310 } |