ERXLocalizer (Project Wonder Reference Documentation)

java.lang.Object
- er.extensions.localization.ERXLocalizer

All Implemented Interfaces:

NSKeyValueCoding, NSKeyValueCodingAdditions

Direct Known Subclasses:

ERXDutchLocalizer, ERXItalianLocalizer, ERXNonPluralFormLocalizer
```
public class ERXLocalizer
extends Object
implements NSKeyValueCoding, NSKeyValueCodingAdditions
```
Provides KVC access to localization. Monitors a set of files in all loaded frameworks and returns a string given a key for a language. These types of keys are acceptable in the monitored files:
```
   "this is a test" = "some test";
   "unittest.key.path.as.string" = "some test";
   "unittest" = {
      "key" = { 
          "path" = { 
              "as" = {
                  "dict"="some test";
               };
          };
      };
   };
 
```
Note that if you only call for unittest, you'll get a dictionary not a string. So you can localize more complex objects than strings.
If you set the base class of your session to ERXSession, you can then use this code in your components:
```
  valueForKeyPath("session.localizer.this is a test")
  valueForKeyPath("session.localizer.unittest.key.path.as.string")
  valueForKeyPath("session.localizer.unittest.key.path.as.dict")
 
```
For sessionless Apps, you must use another method to get at the requested language and then call the localizer via:
```
  ERXLocalizer l = ERXLocalizer.localizerForLanguages(languagesThisUserCanHandle) or
  ERXLocalizer l = ERXLocalizer.localizerForLanguage("German")
 
```
These are the defaults can be set (listed with their current defaults):
```
  er.extensions.ERXLocalizer.defaultLanguage=English
  er.extensions.ERXLocalizer.fileNamesToWatch=("Localizable.strings","ValidationTemplate.strings")
  er.extensions.ERXLocalizer.availableLanguages=(English,German)
  er.extensions.ERXLocalizer.frameworkSearchPath=(app,ERDirectToWeb,ERExtensions)
 
```
There are also methods that pluralize using normal English pluralizing rules (y -> ies, x -> xes etc). You can provide your own plural strings by using a dict entry:
```
  localizerExceptions = {
      "Table.0" = "Table"; 
      "Table" = "Tables";
      ...
  };
 
```
in your Localizable.strings. Table.0 meaning no "Table", Table.1 one table and Table any other number. Note: unlike all other keys, you need to give the translated value ("Tisch" for "Table" in German) as the key, not the untranslated one. This is because this method is mainly called via d2wContext.displayNameForProperty which is already localized.
ローカライズ用の KVC アクセスを実現します。すべてのフレームワーク内のファイルセットをモニタし、指定キーと言語に従って String を戻します。次のキーがファイル内で可能です。
```
   "this is a test"; = "some test";
   "unittest.key.path.as.string" = "some test";
   "unittest" = {
      "key" = { 
          "path" = { 
              "as" = {
                  "dict"="some test";
               };
          };
      };
   };
 
```
メモ： unittest のみを呼ぶと、String の替わりに dictionary を取得します。 Stringよりも複雑なオブジェクトをローカライズが可能です。
session のベースクラスが ERXSession であれば、コンポーネント内に次のコードを実行できます。
```
  valueForKeyPath("session.localizer.this is a test")
  valueForKeyPath("session.localizer.unittest.key.path.as.string")
  valueForKeyPath("session.localizer.unittest.key.path.as.dict")
 
```
sessionの無いアプリケーションの場合は他の方法を使用することでリクエスト言語を取得します。
```
  ERXLocalizer l = ERXLocalizer.localizerForLanguages(languagesThisUserCanHandle) or
  ERXLocalizer l = ERXLocalizer.localizerForLanguage("German")
 
```
次のデフォルト情報をセットできます (カレント・デフォルト値含むでリストされています):
```
  er.extensions.ERXLocalizer.defaultLanguage=English
  er.extensions.ERXLocalizer.fileNamesToWatch=("Localizable.strings","ValidationTemplate.strings")
  er.extensions.ERXLocalizer.availableLanguages=(English,German)
  er.extensions.ERXLocalizer.frameworkSearchPath=(app,ERDirectToWeb,ERExtensions)
 
```
言語体系の英語複数形処理のメソッドもあります。(y -> ies, x -> xes など) dict に追加することで、自分の複数形処理ルールを設定できます。
```
  localizerExceptions = {
      "Table.0" = "Table"; 
      "Table" = "Tables";
      ...
  };
 
```
Localizable.strings ファイル内 Table.0 は"Table"がない、 Table.1 は"Table"が一つと Table はそれ以外の数のことです。 メモ: 他のすべてのキーと違って、翻訳済み値をキーとして使用します。 (ドイツ語では "Table" の替わりに "Tisch" を使います) なぜなら、このメソッドは良くd2wContext.displayNameForPropertyのようなメソッドより呼ばれ、既に翻訳済みなのです。

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class ERXLocalizer.Observer
- Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions
  NSKeyValueCodingAdditions.DefaultImplementation, NSKeyValueCodingAdditions.Utility
- Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding
  NSKeyValueCoding._BooleanFieldBinding, NSKeyValueCoding._BooleanMethodBinding, NSKeyValueCoding._FieldBinding, NSKeyValueCoding._ForwardingBinding, NSKeyValueCoding._KeyBinding, NSKeyValueCoding._KeyBindingCreation, NSKeyValueCoding._MethodBinding, NSKeyValueCoding._NumberFieldBinding, NSKeyValueCoding._NumberMethodBinding, NSKeyValueCoding._ReflectionKeyBindingCreation, NSKeyValueCoding.ErrorHandling, NSKeyValueCoding.MapImplementation, NSKeyValueCoding.Null<T>, NSKeyValueCoding.UnknownKeyException, NSKeyValueCoding.ValueAccessor

Nested Classes
Modifier and Type	Class and Description
`static class`	`ERXLocalizer.Observer`

Field Summary

Fields
Modifier and Type	Field and Description
`protected Map<String,Format>`	`_dateFormatters`
`protected Map<String,Format>`	`_numberFormatters`
`protected NSMutableDictionary<String,Object>`	`cache`
`static String`	`KEY_LOCALIZER_EXCEPTIONS`
`protected String`	`language`
`protected Locale`	`locale`
`static String`	`LocalizationDidResetNotification`

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions
_CLASS, _KeyPathSeparatorChar, KeyPathSeparator

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding
NullValue

Constructor Summary

Constructors
Constructor and Description

ERXLocalizer(String aLanguage)

Constructors
Constructor and Description
`ERXLocalizer(String aLanguage)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`addEntriesToCache(NSDictionary<String,Object> dict)`
`protected void`	`addToCreatedKeys(Object value, String key)` キー・リストに追加します
`protected String`	`applyRules(String str, Map<Pattern,String> rules)` Apply the set of rules in the given Map to the input String and return a modified string that matches the case of the input string.
`static NSArray<String>`	`availableLanguages()` 使用可能な言語を配列として戻します
`NSDictionary<String,Object>`	`cache()` キャシュを戻します
`NSDictionary<String,Object>`	`createdKeys()` 作成されているキーをdictionaryとして戻します
`protected static ERXLocalizer`	`createLocalizerForLanguage(String language, boolean pluralForm)` Creates a localizer for a given language and with an indication if the language supports plural forms.
`static ERXLocalizer`	`currentLocalizer()` Returns the current localizer for the current thread.
`static String`	`defaultLanguage()` Returns the default language (English) or the contents of the `er.extensions.ERXLocalizer.defaultLanguage` property.
`static ERXLocalizer`	`defaultLocalizer()` Gets the localizer for the default language.
`protected Map<Pattern,String>`	`defaultPlurifyRules()` Returns the default plurify rules for this language.
`protected Map<Pattern,String>`	`defaultSingularifyRules()` Returns the default singularify rules for this language.
`void`	`dumpCreatedKeys()` キー・リストをダンプします
`static ERXLocalizer`	`englishLocalizer()` 英語のローカライザーを戻します
`static boolean`	`fallbackToDefaultLanguage()` デフォルト言語に戻ります。
`static NSArray<String>`	`fileNamesToWatch()` ウォッチするファイル名配列を戻します
`static NSArray<String>`	`frameworkSearchPath()` フレームワーク検索パスの配列を戻します
`static void`	`initialize()` 初期化を行います
`static boolean`	`isLocalizationEnabled()` ローカライズ可能かどうかを戻します
`String`	`language()` 言語を戻します
`String`	`languageCode()` 言語コードを戻します
`void`	`load()` ローカライザーのロード作業
`Locale`	`locale()` ロケールをセット
`Format`	`localizedDateFormatForKey(String formatString)` Returns a localized date formatter for the given key.
`String`	`localizedDisplayNameForKey(EOClassDescription classDescription, String key)` Returns a localized string for a given entity class description.
`String`	`localizedDisplayNameForKey(String prefix, String key)` Returns a localized string for the given prefix and keyPath, inserting it "prefix.keyPath" = "Key Path"; Also tries to find "Key Path" 指定の prefix と key のローカライズ済みの文字列を戻します。例えば、
`Format`	`localizedNumberFormatForKey(String formatString)` Returns a localized number formatter for the given key.
`String`	`localizedStringForKey(String key)` 指定キーのローカライズ済みの文字列を戻します
`String`	`localizedStringForKeyWithDefault(String key)` 指定キーのローカライズ済みの文字列を戻します
`String`	`localizedTemplateStringForKeyWithObject(String key, Object o1)` 指定のキーのローカライズ済み文字列を取得し、ERXSimpleTemplateParserに処理させてから戻します
`String`	`localizedTemplateStringForKeyWithObjectOtherObject(String key, Object o1, Object o2)` 指定のキーのローカライズ済み文字列を取得し、ERXSimpleTemplateParserに処理させてから戻します
`Object`	`localizedValueForKey(String key)` Returns the localized value for a key.
`Object`	`localizedValueForKeyWithDefault(String key)` キーを使って、ローカライズ・オブジェクトを戻します @ キーパス `session.localizer.@locale.getLanguage` でキーファイルを探すかわりに ERXLocalizer メソッドを実行します。
`static ERXLocalizer`	`localizerForLanguage(String language)` Get a localizer for a specific language.
`static ERXLocalizer`	`localizerForLanguages(NSArray<String> languages)` Gets the best localizer for a set of languages.
`static ERXLocalizer`	`localizerForRequest(WORequest request)` ブラウザー・リクエスト言語のローカライザーを戻します
`String`	`plurifiedString(String name, int count)` Returns a plurified string.
`String`	`plurifiedStringWithTemplateForKey(String key, String name, int count, Object helper)`
`protected String`	`plurify(String str, int howMany)`
`protected Map<Pattern,String>`	`plurifyRules()` Returns the plurify rules for the current language.
`protected NSDictionary`	`readPropertyListFromFileInFramework(String fileName, String framework, NSArray<String> languages)`
`static void`	`resetCache()` Resets the localizer cache.
`static void`	`setAvailableLanguages(NSArray<String> value)` 使用可能な言語を配列でセットする
`protected void`	`setCacheValueForKey(Object value, String key)`
`static void`	`setCurrentLocalizer(ERXLocalizer currentLocalizer)` Sets a localizer for the current thread.
`static void`	`setDefaultLanguage(String value)` Sets the default language.
`static void`	`setFileNamesToWatch(NSArray<String> value)` ウォッチするファイル名をセットします
`static void`	`setFrameworkSearchPath(NSArray<String> value)` フレームワーク検索パスをセットします
`static void`	`setIsLocalizationEnabled(boolean value)` ローカライズ可能かどうかをセットします
`void`	`setLocale(Locale value)` ロケールをゲット
`void`	`setLocalizedDateFormatForKey(NSTimestampFormatter formatter, String pattern)` ローカライズ済み TimestampFormatter を保存します。
`void`	`setLocalizedNumberFormatForKey(Format formatter, String pattern)` ローカライズ済み NumberFormatter を保存します。
`static void`	`setLocalizerForLanguage(ERXLocalizer l, String language)` ローカライザーをセットします
`String`	`singularifiedString(String value)` Returns a singularified string 単数形処理されている文字列を戻します
`protected String`	`singularify(String str)`
`protected Map<Pattern,String>`	`singularifyRules()` Returns the singularify rules for the current language.
`void`	`takeValueForKey(Object value, String key)`
`void`	`takeValueForKeyPath(Object value, String key)`
`String`	`toString()` このクラスの文字列表現
`static boolean`	`useLocalizedFormatters()` ローカライズ・フォーマッタを使用するかどうかを戻します
`Object`	`valueForKey(String key)` Cover method that calls `localizedStringForKey`.
`Object`	`valueForKeyPath(String key)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - KEY_LOCALIZER_EXCEPTIONS
```
public static final String KEY_LOCALIZER_EXCEPTIONS
```
    See Also:
    
    Constant Field Values
  - LocalizationDidResetNotification
```
public static final String LocalizationDidResetNotification
```
    See Also:
    
    Constant Field Values
  - cache
```
protected NSMutableDictionary<String,Object> cache
```
  - _dateFormatters
```
protected Map<String,Format> _dateFormatters
```
  - _numberFormatters
```
protected Map<String,Format> _numberFormatters
```
  - language
```
protected String language
```
  - locale
```
protected Locale locale
```
- Constructor Detail
  - ERXLocalizer
```
public ERXLocalizer(String aLanguage)
```
- Method Detail
  - initialize
```
public static void initialize()
```
    初期化を行います
  - isLocalizationEnabled
```
public static boolean isLocalizationEnabled()
```
    ローカライズ可能かどうかを戻します
    
    Returns:
    
    boolean - true 可能
  - setIsLocalizationEnabled
```
public static void setIsLocalizationEnabled(boolean value)
```
    ローカライズ可能かどうかをセットします
    
    Parameters:
    
    value - - true 可能
  - currentLocalizer
```
public static ERXLocalizer currentLocalizer()
```
    Returns the current localizer for the current thread. Note that the localizer for a given session is pushed onto the thread when a session awakes and is nulled out when a session sleeps. In case there is no localizer set, it tries to pull it from the current WOContext or the default language.
    
    カレント・スレッドのカレント・ローカライザーを戻します。メモ：指定 session が awake 時にローカライザーをスレッドにプッシュし、session が sleep 時に null されますローカライザーが設定されていない場合、カレント WOContext より取得を試し、駄目の場合はデフォルト言語を使用する
    
    Returns:
    
    the current localizer that has been pushed into thread storage.
    
    カレント・ローカライザー
  - setCurrentLocalizer
```
public static void setCurrentLocalizer(ERXLocalizer currentLocalizer)
```
    Sets a localizer for the current thread. This is accomplished by using the object ERXThreadStorage
    
    カレント・スレッドのローカライザーをセットします。 ERXThreadStorage を参照
    
    Parameters:
    
    currentLocalizer -
    to set in thread storage for the current thread.
    
    スレッドにセットするローカライザー
  - defaultLocalizer
```
public static ERXLocalizer defaultLocalizer()
```
    Gets the localizer for the default language.
    
    デフォルト言語のローカライザーを戻します
    
    Returns:
    
    localizer for the default language
    
    ローカライザー
  - englishLocalizer
```
public static ERXLocalizer englishLocalizer()
```
    英語のローカライザーを戻します
    
    Returns:
    
    英語のローカライザー
  - localizerForRequest
```
public static ERXLocalizer localizerForRequest(WORequest request)
```
    ブラウザー・リクエスト言語のローカライザーを戻します
    
    Parameters:
    
    request - - WORequest
    
    Returns:
    
    ローカライザー
  - resetCache
```
public static void resetCache()
```
    Resets the localizer cache. If WOCaching is enabled then after being reinitialize all of the localizers will be reloaded.
    
    ローカライザー・キャシュをリセットする WOCaching が使用可能な場合、リセットする時にすべてのローカライザーをリロードします
  - addToCreatedKeys
```
protected void addToCreatedKeys(Object value,
                                String key)
```
    キー・リストに追加します
    
    Parameters:
    
    value - - オブジェクト
    
    key - - キー
  - localizerForLanguages
```
public static ERXLocalizer localizerForLanguages(NSArray<String> languages)
```
    Gets the best localizer for a set of languages.
    
    言語配列に一番適用ローカライザーを戻します
    
    Parameters:
    
    languages -
    
    言語配列セット
    
    Returns:
    
    ローカライザー
  - localizerForLanguage
```
public static ERXLocalizer localizerForLanguage(String language)
```
    Get a localizer for a specific language. If none could be found or language is null a localizer for the defaultLanguage() is returned.
    
    指定言語のローカライザーを戻します。language が null 又は見つからない場合には defaultLanguage() が戻ります。
    
    Parameters:
    
    language -
    name of the requested language
    
    言語
    
    Returns:
    
    ローカライザー
  - defaultLanguage
```
public static String defaultLanguage()
```
    Returns the default language (English) or the contents of the er.extensions.ERXLocalizer.defaultLanguage property.
    
    デフォルト言語(English) や er.extensions.ERXLocalizer.defaultLanguageプロパティーを戻します
    
    Returns:
    
    default language name
    
    デフォルト言語
  - setDefaultLanguage
```
public static void setDefaultLanguage(String value)
```
    Sets the default language.
    
    デフォルト言語をセットします
    
    Parameters:
    
    value -
    
    デフォルト言語
  - fileNamesToWatch
```
public static NSArray<String> fileNamesToWatch()
```
    ウォッチするファイル名配列を戻します
    
    Returns:
    
    NSAray - ファイル名配列
  - setFileNamesToWatch
```
public static void setFileNamesToWatch(NSArray<String> value)
```
    ウォッチするファイル名をセットします
    
    Parameters:
    
    value - - ファイル配列
  - availableLanguages
```
public static NSArray<String> availableLanguages()
```
    使用可能な言語を配列として戻します
    
    Returns:
    
    使用可能な言語のNSArray
  - setAvailableLanguages
```
public static void setAvailableLanguages(NSArray<String> value)
```
    使用可能な言語を配列でセットする
    
    Parameters:
    
    value - - 使用可能な言語のNSArray
  - frameworkSearchPath
```
public static NSArray<String> frameworkSearchPath()
```
    フレームワーク検索パスの配列を戻します
    
    Returns:
    
    フレームワーク検索パスの配列
  - setFrameworkSearchPath
```
public static void setFrameworkSearchPath(NSArray<String> value)
```
    フレームワーク検索パスをセットします
    
    Parameters:
    
    value - - フレームワーク検索
  - createLocalizerForLanguage
```
protected static ERXLocalizer createLocalizerForLanguage(String language,
                                                         boolean pluralForm)
```
    Creates a localizer for a given language and with an indication if the language supports plural forms. To provide your own subclass of an ERXLocalizer you can set the system property er.extensions.ERXLocalizer.pluralFormClassName or er.extensions.ERXLocalizer.nonPluralFormClassName.
    
    指定言語のローカライザーを作成します。さらに言語体系が複数を持つかどうかのフラグを持っています。自分専用のクラスを作成する為にプロパティーで設定が可能です。 er.extensions.ERXLocalizer.pluralFormClassName or er.extensions.ERXLocalizer.nonPluralFormClassName.
    
    Parameters:
    
    language -
    name to construct the localizer for
    
    言語
    
    pluralForm -
    denotes if the language supports the plural form
    
    true 言語体系が複数を使用している場合
    
    Returns:
    
    a localizer for the given language
    
    ローカライザー
  - setLocalizerForLanguage
```
public static void setLocalizerForLanguage(ERXLocalizer l,
                                           String language)
```
    ローカライザーをセットします
    
    Parameters:
    
    l - - ERXLocalizer ローカライザー
    
    language - - 言語
  - cache
```
public NSDictionary<String,Object> cache()
```
    キャシュを戻します
    
    Returns:
    
    NSDictionaryキャシュ
  - load
```
public void load()
```
    ローカライザーのロード作業
  - plurifyRules
```
protected Map<Pattern,String> plurifyRules()
```
    Returns the plurify rules for the current language. This first checks for a property of the form:
    er.extensions.ERXLocalizer.en.plurifyRules=(.*)person$=$1people:(.*)man$=$1men
    which is
    er.extensions.ERXLocalizer.en.plurifyRules=pattern1=replacement1:pattern2=replacement2:etc
    In the absence of a rule set for a particular language, the default rules are English and ported from the pluralizer in Rails.
    カレント言語の複数形ルールを戻します。最初はプロパティーをチェックします。
    er.extensions.ERXLocalizer.en.plurifyRules=(.*)person$=$1people:(.*)man$=$1men
    が次のように
    er.extensions.ERXLocalizerr.en.plurifyRules=pattern1=replacement1:pattern2=replacement2:etc
    各言語のルール不足分で、デフォルト・ルールは英語です。
    Returns:
    
    the plurify rules for the current language
    
    カレント言語の複数形ルールを戻します。
  - defaultPlurifyRules
```
protected Map<Pattern,String> defaultPlurifyRules()
```
    Returns the default plurify rules for this language. The default implementation is English and ported from the plurify code in Ruby on Rails. The returned Map should have regex Pattern objects as keys mapping to the replacement String to apply to that pattern
    
    デフォルト複数形ルールを戻します。デフォルト実装は英語です。戻り値のマップは regex パターンのキー・マッピングです。
    
    Returns:
    
    the default plurify rules
    
    デフォルト複数形ルールを戻します
  - singularifyRules
```
protected Map<Pattern,String> singularifyRules()
```
    Returns the singularify rules for the current language. This first checks for a property of the form:
    er.extensions.ERXLocalizer.en.singularifyRules=(.*)person$=$1people:(.*)man$=$1men
    which is
    er.extensions.ERXLocalizer.en.singularifyRules=pattern1=replacement1:pattern2=replacement2:etc
    In the absence of a rule set for a particular language, the default rules are English and ported from the singularizer in Rails.
    カレント言語の単数形ルールを戻します。最初はプロパティーをチェックします。
    er.extensions.ERXLocalizer.en.singularifyRules=(.*)person$=$1people:(.*)man$=$1men
    が次のように
    er.extensions.ERXLocalizer.en.singularifyRules=pattern1=replacement1:pattern2=replacement2:etc
    各言語のルール不足分で、デフォルト・ルールは英語です。
    Returns:
    
    the singularify rules for the current language
    
    カレント言語の単数形ルールを戻します。
  - defaultSingularifyRules
```
protected Map<Pattern,String> defaultSingularifyRules()
```
    Returns the default singularify rules for this language. The default implementation is English and ported from the singularize code in Ruby on Rails. The returned Map should have regex Pattern objects as keys mapping to the replacement String to apply to that pattern.
    
    デフォルト単数形ルールを戻します。デフォルト実装は英語です。戻り値のマップは regex パターンのキー・マッピングです。
    
    Returns:
    
    the default singularify rules
    
    デフォルト単数形ルールを戻します
  - addEntriesToCache
```
protected void addEntriesToCache(NSDictionary<String,Object> dict)
```
  - readPropertyListFromFileInFramework
```
protected NSDictionary readPropertyListFromFileInFramework(String fileName,
                                                           String framework,
                                                           NSArray<String> languages)
```
  - valueForKey
```
public Object valueForKey(String key)
```
    Cover method that calls localizedStringForKey.
    
    Specified by:
    
    valueForKey in interface NSKeyValueCoding
    
    Parameters:
    
    key - to resolve a localized variant of
    
    Returns:
    
    localized string for the given key
  - setCacheValueForKey
```
protected void setCacheValueForKey(Object value,
                                   String key)
```
  - valueForKeyPath
```
public Object valueForKeyPath(String key)
```
    Specified by:
    
    valueForKeyPath in interface NSKeyValueCodingAdditions
  - takeValueForKey
```
public void takeValueForKey(Object value,
                            String key)
```
    Specified by:
    
    takeValueForKey in interface NSKeyValueCoding
  - takeValueForKeyPath
```
public void takeValueForKeyPath(Object value,
                                String key)
```
    Specified by:
    
    takeValueForKeyPath in interface NSKeyValueCodingAdditions
  - language
```
public String language()
```
    言語を戻します
  - createdKeys
```
public NSDictionary<String,Object> createdKeys()
```
    作成されているキーをdictionaryとして戻します
    
    Returns:
    
    NSDictionary
  - dumpCreatedKeys
```
public void dumpCreatedKeys()
```
    キー・リストをダンプします
  - localizedValueForKeyWithDefault
```
public Object localizedValueForKeyWithDefault(String key)
```
    キーを使って、ローカライズ・オブジェクトを戻します @ キーパス session.localizer.@locale.getLanguage でキーファイルを探すかわりに ERXLocalizer メソッドを実行します。
    
    Parameters:
    
    key - - キー
    
    Returns:
    
    ローカライズ済みオブジェクト又は @ キーパス
  - localizedValueForKey
```
public Object localizedValueForKey(String key)
```
    Returns the localized value for a key. An @ keypath such as session.localizer.@locale.getLanguage indicates that the methods on ERXLocalizer itself should be called instead of searching the strings file for a '@locale.getLanguage' key.
    
    キーを使って、ローカライズ・オブジェクトを戻します @ キーパス session.localizer.@locale.getLanguage でキーファイルを探すかわりに ERXLocalicer メソッドを実行します。
    
    Parameters:
    
    key -
    the keyPath string
    
    キー
    
    Returns:
    
    a localized string value or the object value of the @ keyPath
    
    ローカライズ済みオブジェクト又は @ キーパス
  - localizedStringForKeyWithDefault
```
public String localizedStringForKeyWithDefault(String key)
```
    指定キーのローカライズ済みの文字列を戻します
    
    Parameters:
    
    key - - キー
    
    Returns:
    
    ローカライズ済み String
  - localizedStringForKey
```
public String localizedStringForKey(String key)
```
    指定キーのローカライズ済みの文字列を戻します
    
    Parameters:
    
    key - - キー
    
    Returns:
    
    ローカライズ済み String
  - localizedDisplayNameForKey
```
public String localizedDisplayNameForKey(String prefix,
                                         String key)
```
    Returns a localized string for the given prefix and keyPath, inserting it "prefix.keyPath" = "Key Path"; Also tries to find "Key Path"
    指定の prefix と key のローカライズ済みの文字列を戻します。
    例えば、
    s = <ERXLocalizer>.localizedDisplayNameForKey( "Tester", "samplekey" );
    Tester.samplekey になります
    　　あれば、そのローカライズ済み String が戻ります
    　　なければ、ERXStringUtilities.displayNameForKey処理が行われ、
    Tester.samplekey -> Samplekey になり、再度ローカライザーへ問い合わせが行きます。
    　　あれば、そのローカライズ済み String が戻ります
    　　なければ、キーが戻ります。
    Parameters:
    
    prefix -
    
    key -
    
    キー
    
    Returns:
    
    the localized string
    
    ローカライズ済み String
  - localizedDisplayNameForKey
```
public String localizedDisplayNameForKey(EOClassDescription classDescription,
                                         String key)
```
    Returns a localized string for a given entity class description. If the entity uses inheritance it will traverse the inheritance chain until it finds a localization.
    
    Parameters:
    
    classDescription - the entity class description
    
    key - the attribute name
    
    Returns:
    
    the localized string
  - localizedTemplateStringForKeyWithObject
```
public String localizedTemplateStringForKeyWithObject(String key,
                                                      Object o1)
```
    指定のキーのローカライズ済み文字列を取得し、ERXSimpleTemplateParserに処理させてから戻します
    
    Parameters:
    
    key - - キー
    
    o1 - - オブジェクト
    
    Returns:
    
    ERXSimpleTemplateParser処理されているローカライズ済み文字列
  - localizedTemplateStringForKeyWithObjectOtherObject
```
public String localizedTemplateStringForKeyWithObjectOtherObject(String key,
                                                                 Object o1,
                                                                 Object o2)
```
    指定のキーのローカライズ済み文字列を取得し、ERXSimpleTemplateParserに処理させてから戻します
    
    Parameters:
    
    key - - キー
    
    o1 - - オブジェクト
    
    o2 - - オブジェクト
    
    Returns:
    
    ERXSimpleTemplateParser処理されているローカライズ済み文字列
  - plurify
```
protected String plurify(String str,
                         int howMany)
```
  - singularify
```
protected String singularify(String str)
```
  - applyRules
```
protected String applyRules(String str,
                            Map<Pattern,String> rules)
```
    Apply the set of rules in the given Map to the input String and return a modified string that matches the case of the input string. For instance, if the input string is "Person" and the rules are _plurifyRules, then this would return "People".
    
    Parameters:
    
    str - the input string
    
    rules - the rules to apply
    
    Returns:
    
    a case-matched string converted according to the rules
  - plurifiedStringWithTemplateForKey
```
public String plurifiedStringWithTemplateForKey(String key,
                                                String name,
                                                int count,
                                                Object helper)
```
  - plurifiedString
```
public String plurifiedString(String name,
                              int count)
```
    Returns a plurified string.
    
    複数形処理されている文字列を戻します
    
    Parameters:
    
    name -
    the string to plurify
    
    名称
    
    count -
    number to determine the plural form
    
    カウント
    
    Returns:
    
    plurified string
    
    複数形処理されている文字列
  - singularifiedString
```
public String singularifiedString(String value)
```
    Returns a singularified string
    
    単数形処理されている文字列を戻します
    
    Parameters:
    
    value -
    the value to singularify
    
    単数にする String
    
    Returns:
    
    a singularified string
    
    単数形処理されている文字列
  - toString
```
public String toString()
```
    このクラスの文字列表現
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    文字列表現
  - localizedDateFormatForKey
```
public Format localizedDateFormatForKey(String formatString)
```
    Returns a localized date formatter for the given key.
    
    ローカライズ済み NumberFormatter を指定キーを使って戻します。 Localizable.strings 内でキーとパターンを定義することもできます。
    
    Parameters:
    
    formatString -
    
    フォーマット表記
    
    Returns:
    
    the formatter object
    
    フォーマット・オブジェクト
  - localizedNumberFormatForKey
```
public Format localizedNumberFormatForKey(String formatString)
```
    Returns a localized number formatter for the given key. Also, can localize units to, just define in your Localizable.strings a suitable key, with the appropriate pattern.
    
    ローカライズ済み NumberFormatter を指定キーを使って戻します。 Localizable.strings 内でキーとパターンを定義することもできます。
    
    Parameters:
    
    formatString -
    
    フォーマット表記
    
    Returns:
    
    the formatter object
    
    フォーマット・オブジェクト
  - setLocalizedNumberFormatForKey
```
public void setLocalizedNumberFormatForKey(Format formatter,
                                           String pattern)
```
    ローカライズ済み NumberFormatter を保存します。
    
    Parameters:
    
    formatter -
    
    フォーマット
    
    pattern -
    
    パターン
  - locale
```
public Locale locale()
```
    ロケールをセット
  - setLocale
```
public void setLocale(Locale value)
```
    ロケールをゲット
  - setLocalizedDateFormatForKey
```
public void setLocalizedDateFormatForKey(NSTimestampFormatter formatter,
                                         String pattern)
```
    ローカライズ済み TimestampFormatter を保存します。
    
    Parameters:
    
    formatter -
    
    フォーマット
    
    pattern -
    
    パターン
  - useLocalizedFormatters
```
public static boolean useLocalizedFormatters()
```
    ローカライズ・フォーマッタを使用するかどうかを戻します
    
    Returns:
    
    true ローカライズ・フォーマッタを使用する場合
  - languageCode
```
public String languageCode()
```
    言語コードを戻します
    
    Returns:
    
    言語コード
  - fallbackToDefaultLanguage
```
public static boolean fallbackToDefaultLanguage()
```
    デフォルト言語に戻ります。
    
    Returns:
    
    true の場合にはデフォルト言語に戻ります、

Class ERXLocalizer

Nested Class Summary

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding

Field Summary

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

KEY_LOCALIZER_EXCEPTIONS

LocalizationDidResetNotification

cache

_dateFormatters

_numberFormatters

language

locale

Constructor Detail

ERXLocalizer

Method Detail

initialize

isLocalizationEnabled

setIsLocalizationEnabled

currentLocalizer

setCurrentLocalizer

defaultLocalizer

englishLocalizer

localizerForRequest

resetCache

addToCreatedKeys

localizerForLanguages

localizerForLanguage

defaultLanguage

setDefaultLanguage

fileNamesToWatch

setFileNamesToWatch

availableLanguages

setAvailableLanguages

frameworkSearchPath

setFrameworkSearchPath

createLocalizerForLanguage

setLocalizerForLanguage

cache

load

plurifyRules

defaultPlurifyRules

singularifyRules

defaultSingularifyRules

addEntriesToCache

readPropertyListFromFileInFramework

valueForKey

setCacheValueForKey

valueForKeyPath

takeValueForKey

takeValueForKeyPath

language

createdKeys

dumpCreatedKeys

localizedValueForKeyWithDefault

localizedValueForKey

localizedStringForKeyWithDefault

localizedStringForKey

localizedDisplayNameForKey

localizedDisplayNameForKey

localizedTemplateStringForKeyWithObject

localizedTemplateStringForKeyWithObjectOtherObject

plurify

singularify

applyRules

plurifiedStringWithTemplateForKey

plurifiedString

singularifiedString

toString

localizedDateFormatForKey

localizedNumberFormatForKey

setLocalizedNumberFormatForKey

locale

setLocale

setLocalizedDateFormatForKey