Aprog/test/net/sourceforge/aprog/i18n/TranslatorTest.java

   1 /*
   2  *  The MIT License
   3  *
   4  *  Copyright 2010 Codist Monk.
   5  *
   6  *  Permission is hereby granted, free of charge, to any person obtaining a copy
   7  *  of this software and associated documentation files (the "Software"), to deal
   8  *  in the Software without restriction, including without limitation the rights
   9  *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10  *  copies of the Software, and to permit persons to whom the Software is
  11  *  furnished to do so, subject to the following conditions:
  12  *
  13  *  The above copyright notice and this permission notice shall be included in
  14  *  all copies or substantial portions of the Software.
  15  *
  16  *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17  *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19  *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20  *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21  *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  22  *  THE SOFTWARE.
  23  */
  24
  25 package net.sourceforge.aprog.i18n;
  26
  27 import static org.junit.Assert.*;
  28
  29 import java.io.UnsupportedEncodingException;
  30 import java.util.Locale;
  31
  32 import net.sourceforge.aprog.tools.Tools;
  33
  34 import org.junit.Test;
  35
  36 /**
  37  * Automated tests using JUnit 4 for {@link Translator}.
  38  *
  39  * @author codistmonk (creation 2010-06-03)
  40  */
  41 public final class TranslatorTest {
  42
  43     @Test
  44     public final void testTranslateObject() {
  45         final String translationKey1 = "public_key";
  46         final String textPropertyName1 = "publicText";
  47         final String translationKey2 = "package_key";
  48         final String textPropertyName2 = "packageText";
  49         final Translator translator = new Translator();
  50
  51         translator.setLocale(Locale.ENGLISH);
  52
  53         final Translatable translatable = translator.translate(
  54                 new Translatable(),
  55                 textPropertyName1,
  56                 translationKey1,
  57                 MESSAGES_BASE);
  58
  59         assertEquals("", translatable.getPackageText());
  60
  61         translator.translate(translatable, textPropertyName2, translationKey2, MESSAGES_BASE);
  62
  63         assertEquals("Public key", translatable.getPublicText());
  64         assertEquals("Package key", translatable.getPackageText());
  65
  66         translator.setLocale(Locale.FRENCH);
  67
  68         assertEquals("Clé publique", translatable.getPublicText());
  69         assertEquals("Clé package", translatable.getPackageText());
  70
  71         translator.setLocale(Locale.ENGLISH);
  72
  73         assertEquals("Public key", translatable.getPublicText());
  74         assertEquals("Package key", translatable.getPackageText());
  75     }
  76
  77     @Test
  78     public final void testTranslateObjectWithParameterizedMessage() {
  79         final String translationKey = "life_universe_everything";
  80         final String textPropertyName = "parameterizedText";
  81         final Translator translator = new Translator();
  82
  83         translator.setLocale(Locale.ENGLISH);
  84
  85         final Translatable translatable = translator.translate(
  86                 new Translatable(),
  87                 textPropertyName,
  88                 translationKey,
  89                 MESSAGES_BASE,
  90                 42);
  91
  92         assertEquals("Answer: 42", translatable.getParameterizedText());
  93
  94         translator.setLocale(Locale.FRENCH);
  95
  96         assertEquals("Réponse : 42", translatable.getParameterizedText());
  97
  98         translator.setLocale(Locale.ENGLISH);
  99
 100         assertEquals("Answer: 42", translatable.getParameterizedText());
 101     }
 102
 103     @Test
 104     public final void testUntranslateObject() {
 105         final String translationKey1 = "public_key";
 106         final String textPropertyName1 = "publicText";
 107         final String translationKey2 = "package_key";
 108         final String textPropertyName2 = "packageText";
 109         final Translator translator = new Translator();
 110
 111         translator.setLocale(Locale.ENGLISH);
 112
 113         final Translatable translatable = translator.translate(
 114                 new Translatable(),
 115                 textPropertyName1,
 116                 translationKey1,
 117                 MESSAGES_BASE);
 118
 119         assertEquals("", translatable.getPackageText());
 120
 121         translator.translate(translatable, textPropertyName2, translationKey2, MESSAGES_BASE);
 122
 123         assertEquals("Public key", translatable.getPublicText());
 124         assertEquals("Package key", translatable.getPackageText());
 125
 126         translator.setLocale(Locale.FRENCH);
 127
 128         assertEquals("Clé publique", translatable.getPublicText());
 129         assertEquals("Clé package", translatable.getPackageText());
 130
 131         translator.untranslate(translatable, textPropertyName1);
 132         translator.setLocale(Locale.ENGLISH);
 133
 134         assertEquals(translationKey1, translatable.getPublicText());
 135         assertEquals("Package key", translatable.getPackageText());
 136
 137     }
 138
 139     @Test
 140     public final void testTranslateMessage() {
 141         final String translationKey = "life_universe_everything";
 142         final Translator translator = new Translator();
 143
 144         {
 145             translator.setLocale(Locale.ENGLISH);
 146
 147             final String result = translator.translate(translationKey, MESSAGES_BASE, 42);
 148
 149             assertNotNull(result);
 150             assertEquals("Answer: 42", result);
 151         }
 152         {
 153             translator.setLocale(Locale.FRENCH);
 154
 155             final String result = translator.translate(translationKey, MESSAGES_BASE, 42);
 156
 157             assertNotNull(result);
 158             assertEquals("Réponse : 42", result);
 159         }
 160     }
 161
 162     @Test
 163     public final void testGetBestAvailableLocale() {
 164         final Translator translator = new Translator();
 165
 166         translator.collectAvailableLocales(MESSAGES_BASE);
 167
 168         translator.setLocale(new Locale("fr", "FR"));
 169
 170         assertEquals(new Locale("fr"), translator.getBestAvailableLocale());
 171
 172         translator.setLocale(new Locale("en", "US"));
 173
 174         assertEquals(new Locale("en"), translator.getBestAvailableLocale());
 175     }
 176
 177     @Test
 178     public final void testCreateLocale() {
 179         {
 180             final Locale result = Translator.newLocale("fr");
 181
 182             assertNotNull(result);
 183             assertEquals(Locale.FRENCH, result);
 184         }
 185         {
 186             final Locale result = Translator.newLocale("fr_CA");
 187
 188             assertNotNull(result);
 189             assertEquals(Locale.CANADA_FRENCH, result);
 190         }
 191         {
 192             final Locale result = Translator.newLocale("fr_FR_parisien");
 193
 194             assertNotNull(result);
 195             assertEquals(new Locale("fr", "FR", "parisien"), result);
 196         }
 197     }
 198
 199     @Test
 200     public final void testGetLanguageCountryVariant() {
 201         final String language = "fr";
 202         final String country = "FR";
 203         final String variant = "parisien";
 204
 205         {
 206             final String result = Translator.getLanguageCountryVariant(new Locale(language));
 207
 208             assertNotNull(result);
 209             assertEquals(language, result);
 210
 211         }
 212         {
 213             final String result = Translator.getLanguageCountryVariant(new Locale(language, country));
 214
 215             assertNotNull(result);
 216             assertEquals(language + "_" + country, result);
 217
 218         }
 219         {
 220             final String result = Translator.getLanguageCountryVariant(new Locale(language, country, variant));
 221
 222             assertNotNull(result);
 223             assertEquals(language + "_" + country + "_" + variant, result);
 224
 225         }
 226     }
 227
 228     @Test
 229     public final void testIso88591ToUTF8() throws UnsupportedEncodingException {
 230         {
 231             final String iso88591 = new String(new byte[] { (byte) 0xCE, (byte) 0xA9 }, "ISO-8859-1");
 232             final String convertedString = Translator.iso88591ToUTF8(iso88591);
 233             final String expectedResult = "Ω";
 234
 235             assertNotNull(convertedString);
 236             assertNotSame(convertedString, iso88591);
 237             assertEquals("Î©", iso88591);
 238             assertFalse(expectedResult.equals(iso88591));
 239             assertEquals(expectedResult, convertedString);
 240         }
 241         {
 242             final String iso88591 = new String(new byte[] { (byte) 0xC3, (byte) 0xA9, (byte) 0xE2, (byte) 0x80, (byte) 0x99 }, "ISO-8859-1");
 243             final String convertedString = Translator.iso88591ToUTF8(iso88591);
 244             final String expectedResult = "é’";
 245
 246             assertNotNull(convertedString);
 247             assertNotSame(convertedString, iso88591);
 248             assertFalse(expectedResult.equals(iso88591));
 249             assertEquals(expectedResult, convertedString);
 250         }
 251     }
 252
 253     public static final String MESSAGES_BASE = Tools.getCallerPackagePath() + "Messages";
 254
 255     /**
 256      *
 257      * @author codistmonk (creation 2010-06-03)
 258      */
 259     private static final class Translatable {
 260
 261         private String publicText;
 262
 263         private String parameterizedText;
 264
 265         private String packageText;
 266
 267         Translatable() {
 268             this.publicText = "";
 269             this.packageText = "";
 270             this.parameterizedText = "";
 271         }
 272
 273         /**
 274          *
 275          * @return
 276          * <br>A non-null value
 277          * <br>A shared value
 278          */
 279         public final String getPublicText() {
 280             return this.publicText;
 281         }
 282
 283         /**
 284          *
 285          * @param publicText
 286          * <br>Should not be null
 287          * <br>Shared parameter
 288          */
 289         @SuppressWarnings("unused")
 290         public final void setPublicText(final String publicText) {
 291             this.publicText = publicText;
 292         }
 293
 294         /**
 295          *
 296          * @return
 297          * <br>A non-null value
 298          * <br>A shared value
 299          */
 300         public final String getParameterizedText() {
 301             return this.parameterizedText;
 302         }
 303
 304         /**
 305          *
 306          * @param parameterizedText
 307          * <br>Should not be null
 308          * <br>Shared parameter
 309          */
 310         @SuppressWarnings("unused")
 311         public final void setParameterizedText(final String parameterizedText) {
 312             this.parameterizedText = parameterizedText;
 313         }
 314
 315         /**
 316          *
 317          * @return
 318          * <br>A non-null value
 319          * <br>A shared value
 320          */
 321         final String getPackageText() {
 322             return this.packageText;
 323         }
 324
 325         /**
 326          *
 327          * @param packageText
 328          * <br>Should not be null
 329          * <br>Shared parameter
 330          */
 331         @SuppressWarnings("unused")
 332         final void setPackageText(final String packageText) {
 333             this.packageText = packageText;
 334         }
 335
 336     }
 337
 338 }