Author: tchemit Date: 2014-02-08 08:51:40 +0100 (Sat, 08 Feb 2014) New Revision: 2031 Url: http://nuiton.org/projects/i18n/repository/revisions/2031 Log: fixes #3071: Readd n_() and _() as deprecated methods Modified: trunk/i18n-maven-plugin/pom.xml trunk/nuiton-i18n-editor/pom.xml trunk/nuiton-i18n/pom.xml trunk/nuiton-i18n/src/main/java/org/nuiton/i18n/I18n.java trunk/pom.xml Modified: trunk/i18n-maven-plugin/pom.xml =================================================================== --- trunk/i18n-maven-plugin/pom.xml 2014-02-04 09:31:29 UTC (rev 2030) +++ trunk/i18n-maven-plugin/pom.xml 2014-02-08 07:51:40 UTC (rev 2031) @@ -25,7 +25,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>i18n</artifactId> - <version>3.1-SNAPSHOT</version> + <version>2.9-SNAPSHOT</version> </parent> <groupId>org.nuiton.i18n</groupId> Modified: trunk/nuiton-i18n/pom.xml =================================================================== --- trunk/nuiton-i18n/pom.xml 2014-02-04 09:31:29 UTC (rev 2030) +++ trunk/nuiton-i18n/pom.xml 2014-02-08 07:51:40 UTC (rev 2031) @@ -26,7 +26,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>i18n</artifactId> - <version>3.1-SNAPSHOT</version> + <version>2.9-SNAPSHOT</version> </parent> <groupId>org.nuiton.i18n</groupId> Modified: trunk/nuiton-i18n/src/main/java/org/nuiton/i18n/I18n.java =================================================================== --- trunk/nuiton-i18n/src/main/java/org/nuiton/i18n/I18n.java 2014-02-04 09:31:29 UTC (rev 2030) +++ trunk/nuiton-i18n/src/main/java/org/nuiton/i18n/I18n.java 2014-02-08 07:51:40 UTC (rev 2031) @@ -62,8 +62,8 @@ * I18n initializer, * * @deprecated since 2.1, will be removed in version 3.0, in stead use the - * method {@link I18n#init(I18nInitializer, Locale)} which - * will pass directly the initializer to the store. + * method {@link I18n#init(I18nInitializer, Locale)} which + * will pass directly the initializer to the store. */ @Deprecated protected static I18nInitializer initializer; @@ -222,7 +222,7 @@ * Look into the {@link I18nLanguage} associated to the {@code locale} if * the given {@code message} can be found. * - * @param locale the locale to be used to get the I18nLanguage + * @param locale the locale to be used to get the I18nLanguage * @param message the message to check presence * @return true/false whether the message is present for the given locale * @since 2.4.1 @@ -252,9 +252,25 @@ * @param message message formate avec {@link I18nMessageFormatter} * @param args les parametres pour le message. * @return la traduction si possible ou la chaine passee en parametre - * sinon. + * sinon. * @since 2.1 + * @deprecated since 2.9, and is removed in 3.0 */ + @Deprecated + public static String l_(Locale locale, String message, Object... args) { + return l(locale, message, args); + } + + /** + * Retourne la chaine traduite si possible dans la locale demandée. + * + * @param locale la locale dans lequel on souhaite la traduction + * @param message message formate avec {@link I18nMessageFormatter} + * @param args les parametres pour le message. + * @return la traduction si possible ou la chaine passee en parametre + * sinon. + * @since 2.1 + */ public static String l(Locale locale, String message, Object... args) { checkInit(); @@ -300,8 +316,22 @@ * @param message message formate avec {@link I18nMessageFormatter} * @param args les parametres pour le message. * @return la traduction si possible ou la chaine passee en parametre - * sinon. + * sinon. + * @deprecated since 2.9, and is removed in 3.0 */ + @Deprecated + public static String t_(String message, Object... args) { + return t(message, args); + } + + /** + * Retourne la chaine traduite si possible. + * + * @param message message formate avec {@link I18nMessageFormatter} + * @param args les parametres pour le message. + * @return la traduction si possible ou la chaine passee en parametre + * sinon. + */ public static String t(String message, Object... args) { // if the key to translate is null, just return null @@ -336,7 +366,33 @@ * @param message message formate avec {@link I18nMessageFormatter} * @param args les parametres pour le message. * @return le message passe en argument mais formatté avec les parametres + * @deprecated since 2.9, and is removed in 3.0 */ + @Deprecated + public static String n_(String message, Object... args) { + return n(message, args); + } + + /** + * Retourne la chaine passée en argument. + * <p/> + * Utile surtout pour collecter les chaines et ne pas les traduires à leur + * apparition. + * <p/> + * Par exemple : + * <pre>String key = "nuitonutils.key"; + * String result = l(key)</pre> + * fonctionnera, mais la chaine n'aura pas été marquée comme devant être + * internationalisé. + * <p/> + * Tres utile par exemple, pour crée des objets non internationnalisé, et + * devant être traduit seulement à leur lecture suivant la locale du lecteur + * et non du créateur. + * + * @param message message formate avec {@link I18nMessageFormatter} + * @param args les parametres pour le message. + * @return le message passe en argument mais formatté avec les parametres + */ public static String n(String message, Object... args) { if (args.length == 0) { return message; @@ -405,7 +461,7 @@ * with the default locale of the store. * * @return the current language of the store, or the default one if store is - * not init. + * not init. */ protected static I18nLanguage getCurrentLanguage() { I18nLanguage language = getLanguage(null); Modified: trunk/nuiton-i18n-editor/pom.xml =================================================================== --- trunk/nuiton-i18n-editor/pom.xml 2014-02-04 09:31:29 UTC (rev 2030) +++ trunk/nuiton-i18n-editor/pom.xml 2014-02-08 07:51:40 UTC (rev 2031) @@ -32,7 +32,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>i18n</artifactId> - <version>3.0-SNAPSHOT</version> + <version>2.9-SNAPSHOT</version> </parent> <groupId>org.nuiton.i18n</groupId> Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2014-02-04 09:31:29 UTC (rev 2030) +++ trunk/pom.xml 2014-02-08 07:51:40 UTC (rev 2031) @@ -29,11 +29,11 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>mavenpom4redmineAndCentral</artifactId> - <version>4.7</version> + <version>5.0-SNAPSHOT</version> </parent> <artifactId>i18n</artifactId> - <version>3.1-SNAPSHOT</version> + <version>2.9-SNAPSHOT</version> <packaging>pom</packaging> <name>I18n</name> <description>Nuiton i18n tools</description>