| OLD | NEW |
| 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 /** | 5 /** |
| 6 * Message/plural format library with locale support. This can have different | 6 * Message/plural format library with locale support. This can have different |
| 7 * implementations based on the mechanism for finding the localized versions | 7 * implementations based on the mechanism for finding the localized versions |
| 8 * of messages. This version expects them to be in a library named e.g. | 8 * of messages. This version expects them to be in a library named e.g. |
| 9 * 'messages_en_US'. The prefix is set in the [initializeMessages] call, which | 9 * 'messages_en_US'. The prefix is set in the [initializeMessages] call, which |
| 10 * must be made for a locale before any lookups can be done. | 10 * must be made for a locale before any lookups can be done. |
| 11 * | 11 * |
| 12 * See Intl class comment or `tests/message_format_test.dart` for more examples. | 12 * See Intl class comment or `tests/message_format_test.dart` for more examples. |
| 13 */ | 13 */ |
| 14 //TODO(efortuna): documentation example involving the offset parameter? | 14 //TODO(efortuna): documentation example involving the offset parameter? |
| 15 | 15 |
| 16 library message_lookup_local; | 16 library message_lookup_local; |
| 17 | 17 |
| 18 import 'dart:async'; |
| 18 import 'intl.dart'; | 19 import 'intl.dart'; |
| 19 import 'src/intl_helpers.dart'; | 20 import 'src/intl_helpers.dart'; |
| 20 import 'dart:mirrors'; | 21 import 'dart:mirrors'; |
| 21 | 22 |
| 22 /** | 23 /** |
| 23 * Initialize the user messages for [localeName]. Note that this is an ASYNC | 24 * Initialize the user messages for [localeName]. Note that this is an ASYNC |
| 24 * operation. This must be called before attempting to use messages in | 25 * operation. This must be called before attempting to use messages in |
| 25 * [localeName]. | 26 * [localeName]. |
| 26 */ | 27 */ |
| 27 Future initializeMessages(localeName, [String source = 'messages_']) { | 28 Future initializeMessages(localeName, [String source = 'messages_']) { |
| (...skipping 53 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 81 * The values of [desc] and [examples] are not used at run-time but are only | 82 * The values of [desc] and [examples] are not used at run-time but are only |
| 82 * made available to the translators, so they MUST be simple Strings available | 83 * made available to the translators, so they MUST be simple Strings available |
| 83 * at compile time: no String interpolation or concatenation. | 84 * at compile time: no String interpolation or concatenation. |
| 84 * The expected usage of this is inside a function that takes as parameters | 85 * The expected usage of this is inside a function that takes as parameters |
| 85 * the variables used in the interpolated string. | 86 * the variables used in the interpolated string. |
| 86 * | 87 * |
| 87 * Ultimately, the information about the enclosing function and its arguments | 88 * Ultimately, the information about the enclosing function and its arguments |
| 88 * will be extracted automatically but for the time being it must be passed | 89 * will be extracted automatically but for the time being it must be passed |
| 89 * explicitly in the [name] and [args] arguments. | 90 * explicitly in the [name] and [args] arguments. |
| 90 */ | 91 */ |
| 91 String lookupMessage(String message_str, [final String desc='', | 92 Future<String> lookupMessage(String message_str, [final String desc='', |
| 92 final Map examples=const {}, String locale, | 93 final Map examples=const {}, String locale, |
| 93 String name, List<String> args]) { | 94 String name, List<String> args]) { |
| 94 if (name == null) return message_str; | 95 if (name == null) return new Future.immediate(message_str); |
| 95 // The translations also make use of Intl.message, so we need to not | 96 // The translations also make use of Intl.message, so we need to not |
| 96 // recurse and just stop when we find the first substitution. | 97 // recurse and just stop when we find the first substitution. |
| 97 if (_lookupInProgress) return message_str; | 98 if (_lookupInProgress) return new Future.immediate(message_str); |
| 98 _lookupInProgress = true; | 99 _lookupInProgress = true; |
| 99 var result; | 100 var result; |
| 100 try { | 101 try { |
| 101 var actualLocale = (locale == null) ? Intl.getCurrentLocale() : locale; | 102 var actualLocale = (locale == null) ? Intl.getCurrentLocale() : locale; |
| 102 // For this usage, if the locale doesn't exist for messages, just return | 103 // For this usage, if the locale doesn't exist for messages, just return |
| 103 // it and we'll fall back to the original version. | 104 // it and we'll fall back to the original version. |
| 104 var verifiedLocale = | 105 var verifiedLocale = |
| 105 Intl.verifiedLocale( | 106 Intl.verifiedLocale( |
| 106 actualLocale, | 107 actualLocale, |
| 107 localeExists, | 108 localeExists, |
| 108 onFailure: (locale)=>locale); | 109 onFailure: (locale)=>locale); |
| 109 LibraryMirror messagesForThisLocale = | 110 LibraryMirror messagesForThisLocale = |
| 110 _libraries['$_sourcePrefix$verifiedLocale']; | 111 _libraries['$_sourcePrefix$verifiedLocale']; |
| 111 if (messagesForThisLocale == null) return message_str; | 112 if (messagesForThisLocale == null) { |
| 113 return new Future.immediate(message_str); |
| 114 } |
| 112 MethodMirror localized = messagesForThisLocale.functions[name]; | 115 MethodMirror localized = messagesForThisLocale.functions[name]; |
| 113 if (localized == null) return message_str; | 116 if (localized == null) return new Future.immediate(message_str); |
| 114 result = messagesForThisLocale.invoke(localized.simpleName, args); | 117 result = messagesForThisLocale.invoke(localized.simpleName, args); |
| 115 } | 118 } finally { |
| 116 finally { | |
| 117 _lookupInProgress = false; | 119 _lookupInProgress = false; |
| 118 } | 120 } |
| 119 return result.value.reflectee; | 121 return result.then((value) => value.reflectee); |
| 120 } | 122 } |
| 121 } | 123 } |
| OLD | NEW |