ERXProperties (Project Wonder Reference Documentation)

java.lang.Object
- java.util.Dictionary<K,V>
- - java.util.Hashtable<Object,Object>
  - - java.util.Properties
    - - er.extensions.foundation.ERXProperties

All Implemented Interfaces:: NSKeyValueCoding, Serializable, Cloneable, Map<Object,Object>

public class ERXProperties
extends Properties
implements NSKeyValueCoding

Collection of simple utility methods used to get and set properties in the system properties. The only reason this class is needed is because all of the methods in NSProperties have been deprecated. This is a wee bit annoying. The usual method is to have a method like getBoolean off of Boolean which would resolve the System property as a Boolean object. Properties can be set in all the following places:

Properties in a bundle Resources directory
Properties.dev in a bundle Resources directory
Properties.username in a bundle Resources directory
~/Library/WebObjects.properties file
in the eclipse launcher or on the command-line

システム・プロパティーのセットや取得するユーティリティー・メソッド集です。このクラスが作成されている理由は、NSPropertiesの全メソッドが廃止になったからです。普通はシステム・プロパティーの Boolean オブジェクトを扱う為に getBoolean などがあればいいのです。

See Also:: Serialized Form

Properties
Name	Description
`er.extensions.ERXProperties.RetainDefaultsEnabled`	er.extensions.ERXProperties.RetainDefaultsEnabled
`NSProperties.useLoadtimeAppSpecifics`	Default is true.
`er.extensions.ERXProperties.loadOptionalProperties`	Default is true. When false loads only the standard properties. This will improve application startup time due to not looking for all files repeatedly. TODO - Neither of these property names are standard. Should be camel-case and proper prefix. TODO - What character sets can you use in property names? Only ISO-8859-1? UTF-8? TODO - If this would fallback to calling the System getProperty, we could ask that Project Wonder frameworks only use this class.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`ERXProperties._Properties` _Properties is a subclass of Properties that provides support for including other Properties files on the fly.
`static class`	`ERXProperties.EncryptedOperator` Encrypted operator supports decrypting values using the default crypter.
`static class`	`ERXProperties.InIpRangeOperator` InIpRangeOperator は指定IPレンジ内のあるプロパティーをセットする処理をサポートします。
`static class`	`ERXProperties.InRangeOperator` InRangeOperator provides support for defining properties that only get set if a value falls within a specific range of values.
`static interface`	`ERXProperties.Operator` Property operators work like array operators.
`static class`	`ERXProperties.Property`

Field Summary

Fields
Modifier and Type	Field and Description
`static boolean`	`_useLoadtimeAppSpecifics` This boolean controls the behavior of application specific properties.
`protected String`	`applicationNameForAppending` caches the application name that is appended to the key for lookup
`static String`	`DefaultString` default string
`static String`	`UNKNOWN_WONDER_VERSION` constant string used if Wonder version could not be determined

Fields inherited from class java.util.Properties
defaults

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

Constructor Summary

Constructors
Constructor and Description

ERXProperties()

Constructors
Constructor and Description
`ERXProperties()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static NSArray<ERXProperties.Property>`	`allProperties()` 全プロパティーの配列を戻します
`static Map<String,String>`	`allPropertiesMap(boolean protectValues)` Returns all of the properties in the system mapped to their evaluated values, sorted by key.
`static String`	`applicationDeveloperProperties()` Returns the application-specific user properties.
`static String`	`applicationMachinePropertiesPath(String fileName)` Returns the path to the application-specific system-wide file "fileName".
`protected String`	`applicationNameForAppending()` Caches the application name for appending to the key.
`static String`	`applicationUserProperties()` Returns the application-specific user properties.
`static Properties`	`applyConfiguration(Properties source, Properties commandLine)` Apply the current configuration to the supplied properties.
`static NSArray<String>`	`arrayForKey(String s)` Cover method for returning an NSArray for a given system property.
`static NSArray<String>`	`arrayForKeyWithDefault(String s, NSArray<String> defaultValue)` Cover method for returning an NSArray for a given system property and set a default value if not given.
`static BigDecimal`	`bigDecimalForKey(String s)` Cover method for returning a BigDecimal for a given system property.
`static BigDecimal`	`bigDecimalForKeyWithDefault(String s, BigDecimal defaultValue)` Cover method for returning a BigDecimal for a given system property or a default value.
`static boolean`	`booleanForKey(String s)` Cover method for returning a boolean for a given system property.
`static boolean`	`booleanForKeyWithDefault(String s, boolean defaultValue)` Cover method for returning a boolean for a given system property or a default value.
`static NSArray<String>`	`componentsSeparatedByString(String key, String separator)` Returns an array of strings separated with the given separator string.
`static NSArray<String>`	`componentsSeparatedByStringWithDefault(String key, String separator, NSArray<String> defaultValue)` Returns an array of strings separated with the given separator string.
`static String`	`decryptedStringForKey(String propertyName)` Returns the decrypted value for the given property name using the default crypter if the property propertyName.encrypted=true.
`static String`	`decryptedStringForKeyWithDefault(String propertyName, String defaultValue)` If the `propertyName.encrypted` property is set to true, returns the plain text value of the given property name, after decrypting it with the `ERXCrypto.defaultCrypter()`.
`static String`	`decryptedStringForKeyWithEncryptedDefault(String propertyName, String defaultValue)` Returns the decrypted value for the given property name using the `ERXCrypto.defaultCrypter()`.
`static NSDictionary`	`dictionaryForKey(String s)` Cover method for returning an NSDictionary for a given system property.
`static NSDictionary`	`dictionaryForKeyWithDefault(String s, NSDictionary defaultValue)` dictionaryForKeyWithDefault Cover method for returning an NSDictionary for a given system property or the default value.
`static double`	`doubleForKey(String s)` Cover method for returning a double for a given system property.
`static double`	`doubleForKeyWithDefault(String s, double defaultValue)` Cover method for returning a double for a given system property with a default value.
`static <T extends Enum> T`	`enumValueForKey(Class<T> enumClass, String key)` Returns an enum value for a given enum class and system property.
`static <T extends Enum> T`	`enumValueForKeyWithDefault(Class<T> enumClass, String key, T defaultValue)` Returns an enum value for a given enum class and system property.
`static void`	`evaluatePropertyOperators(Properties originalProperties, Properties destinationProperties)` For each property in originalProperties, process the keys and values with the registered property operators and stores the converted value into destinationProperties.
`static void`	`flattenPropertyNames(Properties properties)` For every application specific property, this method generates a similar property without the application name in the property key.
`static float`	`floatForKey(String s)` Cover method for returning a float for a given system property.
`static float`	`floatForKeyWithDefault(String s, float defaultValue)` Cover method for returning a float for a given system property with a default value.
`static ERXProperties`	`fromExternalForm(String string)` Load the properties from a String in Property file format.
`static String`	`getActualPath(String path)` Returns actual full path to the given file system path that could contain symbolic links.
`String`	`getProperty(String key)` Overriding the default getProperty method to first check: key.<ApplicationName> before checking for key.
`static boolean`	`hasKey(String key)` Checks if a property for the given key exists.
`static boolean`	`hasKey(String key, boolean ignoreEmptyValue)` Checks if a property for the given key exists.
`static int`	`intForKey(String s)` Cover method for returning an int for a given system property.
`static int`	`intForKeyWithDefault(String s, int defaultValue)` Cover method for returning an int for a given system property with a default value.
`static String`	`logString(Properties properties)` Returns a string suitable for logging.
`static long`	`longForKey(String s)` Cover method for returning a long for a given system property.
`static long`	`longForKeyWithDefault(String s, long defaultValue)` Cover method for returning a long for a given system property with a default value.
`static NSArray`	`optionalConfigurationFiles()` Gets an array of optionally defined configuration files.
`static String`	`pathForPropertiesUnderProjectPath(String projectPath)` Returns the full path to the Properties file under the given project path.
`static NSArray`	`pathsForUserAndBundleProperties()` Returns an array of paths to the `Properties` and `WebObjects.properties` files contained in the application/framework bundles and home directory.
`static NSArray<String>`	`pathsForUserAndBundleProperties(boolean reportLoggingEnabled)`
`static void`	`populateSystemProperties()` Puts handy properties such as `com.webobjects.version` into the system properties.
`static Properties`	`propertiesFromArgv(String[] argv)` Sets and returns properties object with the values from the given command line arguments string array.
`static Properties`	`propertiesFromFile(File file)` Gets the properties for a given file.
`static Properties`	`propertiesFromPath(String path)` Reads a Java properties file at the given path and returns a `Properties` object as the result.
`static Map<String,String>`	`propertiesMap(Properties properties, boolean protectValues)` Returns all of the properties in the system mapped to their evaluated values, sorted by key.
`static void`	`removeKey(String key)` キーを削除します
`static void`	`setArrayForKey(NSArray array, String key)` Sets an array in the System properties for a particular key.
`static void`	`setDictionaryForKey(NSDictionary dictionary, String key)` Sets a dictionary in the System properties for a particular key.
`static void`	`setOperatorForKey(ERXProperties.Operator operator, String key)` Registers a property operator for a particular key.
`static void`	`setStringForKey(String string, String key)` Sets a string in the System properties for another string.
`static String`	`sourceVersionString()` Returns the version string of the given framework.
`static String`	`stringFor2Keys(String s1, String s2)` システム・プロパティーの結果を String で戻します。最大2つのキーを指定可能で、最初に見つかったキーを使用します。
`static String`	`stringFor2KeysWithDefault(String s1, String s2, String defaultValue)` システム・プロパティーの結果を String で戻します。最大2つのキーを指定可能で、最初に見つかったキーを使用します。
`static String`	`stringFor3Keys(String s1, String s2, String s3)` システム・プロパティーの結果を String で戻します。最大3つのキーを指定可能で、最初に見つかったキーを使用します。
`static String`	`stringFor3KeysWithDefault(String s1, String s2, String s3, String defaultValue)` システム・プロパティーの結果を String で戻します。最大3つのキーを指定可能で、最初に見つかったキーを使用します。
`static String`	`stringForKey(String s)` Returning an string for a given system property.
`static String`	`stringForKeyWithDefault(String s, String defaultValue)` Returning an string for a given system property.
`static String`	`stringForManyKeys(String[] ss)` システム・プロパティーの結果を String で戻します。キーは文字列配列で渡され配列要素位置0から開始し最初に見つかったキーを使用します。
`static String`	`stringForManyKeysWithDefault(String[] ss, String defaultValue)` システム・プロパティーの結果やデフォルト値を String で戻します。キーは文字列配列で渡され配列要素位置0から開始し最初に見つかったキーを使用します。
`static void`	`systemPropertiesChanged()` システム・プロパティーが変更されたので、キャシュをクリアする
`void`	`takeValueForKey(Object anObject, String aKey)`
`Object`	`toExternalForm()` Returns the properties as a String in Property file format.
`static void`	`transferPropertiesFromSourceToDest(Properties source, Properties dest)` Copies all properties from source to dest.
`Object`	`valueForKey(String aKey)`
`static String`	`valueFromPlistBundleWithKey(NSBundle bundle, String plist, String key)` Returns the key in an plist of the given framework.
`static String`	`variantPropertiesInBundle(String userName, String bundleName)` Returns the application-specific variant properties for the given bundle.
`static String`	`versionStringForApplication()` Returns the version string of the application.
`static String`	`versionStringForFrameworkNamed(String frameworkName)` Returns the version string of the given framework.
`static String`	`wonderVersion()` Returns the version string of the Wonder frameworks.

Methods inherited from class java.util.Properties
getProperty, list, list, load, load, loadFromXML, propertyNames, save, setProperty, store, store, storeToXML, storeToXML, stringPropertyNames

Methods inherited from class java.util.Hashtable
clear, clone, compute, computeIfAbsent, computeIfPresent, contains, containsKey, containsValue, elements, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keys, keySet, merge, put, putAll, putIfAbsent, rehash, remove, remove, replace, replace, replaceAll, size, toString, values

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

- Field Detail
  - DefaultString
```
public static final String DefaultString
```
    default string
    
    See Also:
    
    Constant Field Values
  - _useLoadtimeAppSpecifics
```
public static final boolean _useLoadtimeAppSpecifics
```
    This boolean controls the behavior of application specific properties. Setting this to false makes the old behavior active, true activates the new behavior. The value of this boolean is controlled by the property "NSProperties.useLoadtimeAppSpecifics" and defaults to true. Please note this property MUST be defined with a -D argument on the application launch command.
    The old behavior will retain the original property names (including the application name), and will search for an application specific version of each property every time someone reads a property.
    The new behavior will analyze all properties after being loaded from their source, and create (or update) generic properties for each application specific one. So, if we are MyApp, foo.bar.MyApp=4 will originate a new property foo.bar=4 (or, if foo.bar already exists, update its value to 4). foo.bar.MyApp is also kept, because we cannot be sure foo.bar.MyApp is an app specific property or a regular property with an ambiguous name.
    The advantage of the new method is getting rid of the performance hit each time an app accesses a property, and making application specific properties work for code that uses the native Java System.getProperty call.
  - UNKNOWN_WONDER_VERSION
```
public static final String UNKNOWN_WONDER_VERSION
```
    constant string used if Wonder version could not be determined
    
    See Also:
    
    Constant Field Values
  - applicationNameForAppending
```
protected String applicationNameForAppending
```
    caches the application name that is appended to the key for lookup
- Constructor Detail
  - ERXProperties
```
public ERXProperties()
```
- Method Detail
  - populateSystemProperties
```
public static void populateSystemProperties()
```
    Puts handy properties such as com.webobjects.version into the system properties. This method is called when the framework is initialized (when WOApplication.ApplicationWillFinishLaunchingNotification is posted.)
    
    com.webobjects.version をシステム・プロパティーへセットします。フレームワークが初期化される時に呼ばれます。 (WOApplication.ApplicationWillFinishLaunchingNotification 発行時)
  - versionStringForApplication
```
public static String versionStringForApplication()
```
    Returns the version string of the application. It checks CFBundleShortVersionString property in the info.plist resource and returns a trimmed version of the value.
    
    アプリケーションのバージョンを取得します CustomInfo.plist 内の CFBundleShortVersionString プロパティーを調べ、Trimした結果を戻します
    
    Returns:
    
    version number as string; can be a null-string when the application doesn't have the value of CFBundleShortVersionString in its info.plist resource.
    
    バージョン番号を文字列として戻ります。見つからない場合には null-string が戻ります。
    
    See Also:
    
    versionStringForFrameworkNamed(java.lang.String), #webObjectsVersion
  - versionStringForFrameworkNamed
```
public static String versionStringForFrameworkNamed(String frameworkName)
```
    Returns the version string of the given framework. It checks CFBundleShortVersionString property in the info.plist resource and returns a trimmed version of the value.
    
    指定されたフレームワークのバージョンを取得します CustomInfo.plist 内の CFBundleShortVersionString プロパティーを調べ、Trimした結果を戻します
    
    Parameters:
    
    frameworkName -
    name
    
    フレームワーク名
    
    Returns:
    
    version number as string; can be null-string when the framework is not found or the framework doesn't have the value of CFBundleShortVersionString in its info.plist resource.
    
    バージョン番号を文字列として戻ります。フレームワークが見つからない場合には null-string が戻ります。
    
    See Also:
    
    versionStringForApplication(), #webObjectsVersion(), ERXStringUtilities.removeExtraDotsFromVersionString(String)
  - sourceVersionString
```
public static String sourceVersionString()
```
    Returns the version string of the given framework. It checks SourceVersion property in the version.plist resource and returns a trimmed version of the value.
    
    WebObjectsフレームワークのバージョンを取得します version.plist内の SourceVersion プロパティーを調べ、Trimした結果を戻します
    
    Returns:
    
    version number as string; can be null-string when the framework is not found or the framework doesn't have the value of SourceVersion in its info.plist resource.
    
    バージョン番号をStringとして戻します。フレームワークが見つからなければ、null-stringが戻ります。
    
    See Also:
    
    versionStringForApplication(), #webObjectsVersion
  - valueFromPlistBundleWithKey
```
public static String valueFromPlistBundleWithKey(NSBundle bundle,
                                                 String plist,
                                                 String key)
```
    Returns the key in an plist of the given framework.
    
    対象バンドル内のplistファイル内のキーを使って、結果を戻します。
    
    Parameters:
    
    bundle -
    bundle name
    
    対象するバンドル名
    
    plist -
    plist Filename
    
    plist ファイル名
    
    key -
    key
    
    plist 内に調べるキー
    
    Returns:
    
    Result
    
    結果文字列
  - wonderVersion
```
public static String wonderVersion()
```
    Returns the version string of the Wonder frameworks.
    
    Returns:
    
    version string
  - arrayForKey
```
public static NSArray<String> arrayForKey(String s)
```
    Cover method for returning an NSArray for a given system property.
    
    システム・プロパティーの結果を NSArray で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    Returns:
    
    array de-serialized from the string in the system properties
    
    システム・プロパティー内の連結した String を NSArray に変換した配列
  - arrayForKeyWithDefault
```
public static NSArray<String> arrayForKeyWithDefault(String s,
                                                     NSArray<String> defaultValue)
```
    Cover method for returning an NSArray for a given system property and set a default value if not given.
    
    システム・プロパティーの結果を NSArray で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    defaultValue -
    default value
    
    デフォルト値
    
    Returns:
    
    array de-serialized from the string in the system properties or default value
    
    システム・プロパティー内の連結した String を NSArray に変換した配列
  - booleanForKey
```
public static boolean booleanForKey(String s)
```
    Cover method for returning a boolean for a given system property. This method uses the method booleanValue from ERXUtilities.
    
    システム・プロパティーの結果を boolean で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    Returns:
    
    boolean value of the string in the system properties.
    
    boolean 値、デフォルトはfalse
  - booleanForKeyWithDefault
```
public static boolean booleanForKeyWithDefault(String s,
                                               boolean defaultValue)
```
    Cover method for returning a boolean for a given system property or a default value. This method uses the method booleanValue from ERXUtilities.
    
    システム・プロパティーの結果やデフォルト値を boolean で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    defaultValue -
    default value
    
    デフォルト値
    
    Returns:
    
    boolean value of the string in the system properties.
    
    boolean 値
  - dictionaryForKey
```
public static NSDictionary dictionaryForKey(String s)
```
    Cover method for returning an NSDictionary for a given system property.
    
    システム・プロパティーの結果を NSDictionary で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    Returns:
    
    dictionary de-serialized from the string in the system properties
    
    システム・プロパティー内の NSDictionary に変換
  - dictionaryForKeyWithDefault
```
public static NSDictionary dictionaryForKeyWithDefault(String s,
                                                       NSDictionary defaultValue)
```
    dictionaryForKeyWithDefault Cover method for returning an NSDictionary for a given system property or the default value.
    
    システム・プロパティーの結果を NSDictionary で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    defaultValue -
    default value
    
    デフォルト値
    
    Returns:
    
    dictionary de-serialized from the string in the system properties
    
    システム・プロパティーの結果を NSDictionary
  - hasKey
```
public static boolean hasKey(String key)
```
    Checks if a property for the given key exists.
    
    Parameters:
    
    key - name of the property
    
    Returns:
    
    true if a property for key exists
  - hasKey
```
public static boolean hasKey(String key,
                             boolean ignoreEmptyValue)
```
    Checks if a property for the given key exists. If you want to ignore properties that have an empty value pass true as parameter (i.e. 'my.property=').
    
    Parameters:
    
    key - name of the property
    
    ignoreEmptyValue - true if you want to ignore properties with empty values
    
    Returns:
    
    true if a property exists
  - intForKey
```
public static int intForKey(String s)
```
    Cover method for returning an int for a given system property.
    
    システム・プロパティーの結果を int で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    Returns:
    
    int value of the system property or 0
    
    int 値、デフォルトは 0
  - longForKey
```
public static long longForKey(String s)
```
    Cover method for returning a long for a given system property.
    
    システム・プロパティーの結果を long で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    Returns:
    
    long value of the system property or 0
    
    long 値、デフォルトは 0
  - floatForKey
```
public static float floatForKey(String s)
```
    Cover method for returning a float for a given system property.
    
    システム・プロパティーの結果を float で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    Returns:
    
    float value of the system property or 0
    
    float 値、デフォルトは 0
  - doubleForKey
```
public static double doubleForKey(String s)
```
    Cover method for returning a double for a given system property.
    
    システム・プロパティーの結果を double で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    Returns:
    
    double value of the system property or 0
    
    double 値、デフォルトは 0
  - bigDecimalForKey
```
public static BigDecimal bigDecimalForKey(String s)
```
    Cover method for returning a BigDecimal for a given system property. This method uses the method bigDecimalValueWithDefault from ERXValueUtilities.
    
    システム・プロパティーの結果を BigDecimal で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    Returns:
    
    BigDecimal value of the string in the system properties. Scale is controlled by the string, ie "4.400" will have a scale of 3.
    
    BigDecimal 値、デフォルトは null
  - bigDecimalForKeyWithDefault
```
public static BigDecimal bigDecimalForKeyWithDefault(String s,
                                                     BigDecimal defaultValue)
```
    Cover method for returning a BigDecimal for a given system property or a default value. This method uses the method bigDecimalValueWithDefault from ERXValueUtilities.
    
    システム・プロパティーの結果を BigDecimal で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    defaultValue -
    default value
    
    デフォルト値
    
    Returns:
    
    BigDecimal value of the string in the system properties. Scale is controlled by the string, ie "4.400" will have a scale of 3.
    
    BigDecimal 値、又はデフォルト値
  - intForKeyWithDefault
```
public static int intForKeyWithDefault(String s,
                                       int defaultValue)
```
    Cover method for returning an int for a given system property with a default value.
    
    システム・プロパティーの結果を int で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    defaultValue -
    default value
    
    デフォルト値
    
    Returns:
    
    int value of the system property or the default value
    
    int 値、又はデフォルト値
  - longForKeyWithDefault
```
public static long longForKeyWithDefault(String s,
                                         long defaultValue)
```
    Cover method for returning a long for a given system property with a default value.
    
    システム・プロパティーの結果を long で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    defaultValue -
    default value
    
    デフォルト値
    
    Returns:
    
    long value of the system property or the default value
    
    long 値、又はデフォルト値
  - floatForKeyWithDefault
```
public static float floatForKeyWithDefault(String s,
                                           float defaultValue)
```
    Cover method for returning a float for a given system property with a default value.
    
    システム・プロパティーの結果やデフォルト値を float で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    defaultValue -
    default value
    
    デフォルト値
    
    Returns:
    
    float value of the system property or the default value
    
    float 値
  - doubleForKeyWithDefault
```
public static double doubleForKeyWithDefault(String s,
                                             double defaultValue)
```
    Cover method for returning a double for a given system property with a default value.
    
    システム・プロパティーの結果やデフォルト値を double で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    defaultValue -
    default value
    
    デフォルト値
    
    Returns:
    
    double value of the system property or the default value
    
    double 値
  - stringForKey
```
public static String stringForKey(String s)
```
    Returning an string for a given system property. This is a cover method of System.getProperty(java.lang.String)
    
    システム・プロパティーの結果を String で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    Returns:
    
    string value of the system property or null
    
    String 値、デフォルトはnull
  - stringForKeyWithDefault
```
public static String stringForKeyWithDefault(String s,
                                             String defaultValue)
```
    Returning an string for a given system property. This is a cover method of System.getProperty(java.lang.String)
    
    システム・プロパティーの結果やデフォルト値を String で戻します
    
    Parameters:
    
    s -
    system property
    
    キー（システム・プロパティー内）
    
    defaultValue -
    default value
    
    デフォルト値
    
    Returns:
    
    string value of the system property or null
    
    String 値、又はデフォルト値
  - decryptedStringForKey
```
public static String decryptedStringForKey(String propertyName)
```
    Returns the decrypted value for the given property name using the default crypter if the property propertyName.encrypted=true. For instance, if you are requesting my.password, if my.password.encrypted=true the value of my.password will be passed to the default crypter's decrypt method.
    
    指定プロパティー名とデフォルト暗号化方法 (propertyName.encrypted=true) を使って復元されている値を戻します。例えば、my.password を取得する場合、my.password.encrypted=true も設定されていれば、 my.password は復元する時にデフォルト暗号化方法 ERXCrypto.defaultCrypter() を使用します。
    
    Parameters:
    
    propertyName -
    the property name to retrieve and optionally decrypt
    
    プロパティー名
    
    Returns:
    
    the decrypted property value
    
    復元されている値
  - decryptedStringForKeyWithDefault
```
public static String decryptedStringForKeyWithDefault(String propertyName,
                                                      String defaultValue)
```
    If the propertyName.encrypted property is set to true, returns the plain text value of the given property name, after decrypting it with the ERXCrypto.defaultCrypter(). For instance, if you are requesting my.password and my.password.encrypted is set to true, the value of my.password will be sent to the default crypter's decrypt() method.
    
    指定プロパティー名とデフォルト暗号化方法 (propertyName.encrypted=true) を使って復元されている値を戻します。例えば、my.password を取得する場合、my.password.encrypted=true も設定されていれば、 my.password は復元する時にデフォルト暗号化方法 ERXCrypto.defaultCrypter() を使用します。
    
    Parameters:
    
    propertyName -
    the property name to retrieve and optionally decrypt
    
    プロパティー名
    
    defaultValue -
    the default value to return if there is no password
    
    プロパティーが無ければ、デフォルト値
    
    Returns:
    
    the decrypted property value
    
    復元されている値
  - decryptedStringForKeyWithEncryptedDefault
```
public static String decryptedStringForKeyWithEncryptedDefault(String propertyName,
                                                               String defaultValue)
```
    Returns the decrypted value for the given property name using the ERXCrypto.defaultCrypter(). This is slightly different than decryptedStringWithKeyWithDefault in that it does not require the encrypted property to be set.
    
    指定プロパティー名とデフォルト暗号化方法 (propertyName.encrypted=true) を使って復元されている値を戻します。例えば、my.password を取得する場合、my.password.encrypted=true も設定されていれば、 my.password は復元する時にデフォルト暗号化方法 ERXCrypto.defaultCrypter() を使用します。
    
    Parameters:
    
    propertyName -
    the name of the property to decrypt
    
    プロパティー名
    
    defaultValue -
    the default encrypted value
    
    プロパティーが無ければ、暗号化されているデフォルト値
    
    Returns:
    
    the decrypted value
    
    復元されている値
  - componentsSeparatedByString
```
public static NSArray<String> componentsSeparatedByString(String key,
                                                          String separator)
```
    Returns an array of strings separated with the given separator string.
    
    システム・プロパティーの結果を指定 key と指定 separator より配列を戻します。取得文字列は句切れ文字で配列に切り出します。
    
    Parameters:
    
    key -
    the key to lookup
    
    キー（システム・プロパティー内）
    
    separator -
    the separator (",")
    
    句切れ文字 (",")
    
    Returns:
    
    the array of strings or NSArray.EmptyArray if not found
    
    文字列よりの配列、無ければ NSArray.EmptyArray が戻ります
  - componentsSeparatedByStringWithDefault
```
public static NSArray<String> componentsSeparatedByStringWithDefault(String key,
                                                                     String separator,
                                                                     NSArray<String> defaultValue)
```
    Returns an array of strings separated with the given separator string.
    
    システム・プロパティーの結果を指定 key と指定 separator より配列を戻します。取得文字列は句切れ文字で配列に切り出します。
    
    Parameters:
    
    key -
    the key to lookup
    
    キー（システム・プロパティー内）
    
    separator -
    the separator (",")
    
    句切れ文字 (",")
    
    defaultValue -
    the default array to return if there is no value
    
    値が無ければ、デフォルト値
    
    Returns:
    
    the array of strings
    
    文字列よりの配列、無ければ defaultValue が戻ります
  - enumValueForKey
```
public static <T extends Enum> T enumValueForKey(Class<T> enumClass,
                                                 String key)
```
    Returns an enum value for a given enum class and system property. If the property is not set or matches no enum constant, null will be returned. The search for the enum value is case insensitive, i.e. a property value "foo" will match the enum constant FOO.
    
    Parameters:
    
    enumClass - the enum class
    
    key - the property key
    
    Returns:
    
    the enum value
  - enumValueForKeyWithDefault
```
public static <T extends Enum> T enumValueForKeyWithDefault(Class<T> enumClass,
                                                            String key,
                                                            T defaultValue)
```
    Returns an enum value for a given enum class and system property. If the property is not set or matches no enum constant, the specified default value will be returned. The search for the enum value is case insensitive, i.e. a property value "foo" will match the enum constant FOO.
    
    Parameters:
    
    enumClass - the enum class
    
    key - the property key
    
    defaultValue - the default value
    
    Returns:
    
    the enum value
  - setArrayForKey
```
public static void setArrayForKey(NSArray array,
                                  String key)
```
    Sets an array in the System properties for a particular key.
    
    システム・プロパティーに NSArray をセットします
    
    Parameters:
    
    array -
    to be set in the System properties
    
    システム・プロパティーにセットする配列
    
    key -
    to be used to get the value
    
    セットする為のキー
  - setDictionaryForKey
```
public static void setDictionaryForKey(NSDictionary dictionary,
                                       String key)
```
    Sets a dictionary in the System properties for a particular key.
    
    システム・プロパティーの指定キーをディクショナリー内にセットします
    
    Parameters:
    
    dictionary -
    to be set in the System properties
    
    システム・プロパティーをセットするディクショナリー
    
    key -
    to be used to get the value
    
    値をアクセスするキー
  - setStringForKey
```
public static void setStringForKey(String string,
                                   String key)
```
    Sets a string in the System properties for another string.
    
    システム・プロパティーに String をセットします
    
    Parameters:
    
    string -
    to be set in the System properties
    
    システム・プロパティーにセットするString
    
    key -
    to be used to get the value
    
    セットする為のキー
  - removeKey
```
public static void removeKey(String key)
```
    キーを削除します
    
    Parameters:
    
    key - - キー
  - transferPropertiesFromSourceToDest
```
public static void transferPropertiesFromSourceToDest(Properties source,
                                                      Properties dest)
```
    Copies all properties from source to dest.
    
    全てのプロパティーをコピー元からコピー先へコピーします。
    
    Parameters:
    
    source -
    properties copied from
    
    コピー元するプロパティー
    
    dest -
    properties copied to
    
    コピー先のプロパティー
  - propertiesFromPath
```
public static Properties propertiesFromPath(String path)
```
    Reads a Java properties file at the given path and returns a Properties object as the result. If the file does not exist, returns an empty properties object.
    
    指定パスを使って、 Java プロパティー・ファイルを読込み、 Properties オブジェクトとして戻します。ファイルが存在していなければ、empty プロパティー・オブジェクトが戻ります。
    
    Parameters:
    
    path -
    file path to the properties file
    
    プロパティー・ファイルへのパス
    
    Returns:
    
    properties object with the values from the file specified.
    
    ファイルの内容を持つプロパティー・オブジェクト
  - propertiesFromFile
```
public static Properties propertiesFromFile(File file)
                                     throws IOException
```
    Gets the properties for a given file.
    
    指定ファイルのプロパティーをプロパティー・オブジェクトへロードします。
    
    Parameters:
    
    file -
    the properties file
    
    プロパティー・ファイル
    
    Returns:
    
    properties from the given file
    
    ファイルの内容を持つプロパティー・オブジェクト
    
    Throws:
    
    IOException - if the file is not found or cannot be read
  - propertiesFromArgv
```
public static Properties propertiesFromArgv(String[] argv)
```
    Sets and returns properties object with the values from the given command line arguments string array.
    
    コマンドライン等で渡されている文字列配列をプロパティー・オブジェクトへロードします。
    
    Parameters:
    
    argv -
    string array typically provided by the command line arguments
    
    コマンドライン等で渡されている文字列配列
    
    Returns:
    
    properties object with the values from the argv
    
    argv の内容を持つプロパティー・オブジェクト
  - pathsForUserAndBundleProperties
```
public static NSArray pathsForUserAndBundleProperties()
```
    Returns an array of paths to the Properties and WebObjects.properties files contained in the application/framework bundles and home directory.
    If ProjectBuilder (for Mac OS X) has the project opened, it will attempt to get the path to the one in the project directory instead of the one in the bundle.
    This opened project detection feature is pretty fragile and will change between versions of the dev-tools.
    
    application/framework バンドルとホーム・ダイレクトリーに含む Properties と WebObjects.properties ファイルへのファイル・パス配列を戻します
    プロジェクト・ビルダーがプロジェクトを開いていれば、バンドルではなく、プロジェクトへのパスが戻されます。
    開いているプロジェクト問題は開発ツールによって違っています。
    
    Returns:
    
    paths to Properties files
    
    プロパティー・ファイルパス配列
  - pathsForUserAndBundleProperties
```
public static NSArray<String> pathsForUserAndBundleProperties(boolean reportLoggingEnabled)
```
  - applyConfiguration
```
public static Properties applyConfiguration(Properties source,
                                            Properties commandLine)
```
    Apply the current configuration to the supplied properties.
    
    Parameters:
    
    source -
    
    commandLine -
    
    Returns:
    
    the applied properties
  - allPropertiesMap
```
public static Map<String,String> allPropertiesMap(boolean protectValues)
```
    Returns all of the properties in the system mapped to their evaluated values, sorted by key.
    
    値にマップされているシステム内の全プロパティーをキーでソート済みとして戻します。
    
    Parameters:
    
    protectValues -
    if true, keys with the word "password" in them will have their values removed
    
    true の場合にはパスワードを含むキーが出力されません。
    
    Returns:
    
    all of the properties in the system mapped to their evaluated values, sorted by key
    
    値にマップされているシステム内の全プロパティーをキーでソート済み
  - propertiesMap
```
public static Map<String,String> propertiesMap(Properties properties,
                                               boolean protectValues)
```
    Returns all of the properties in the system mapped to their evaluated values, sorted by key.
    
    Parameters:
    
    properties -
    
    protectValues - if true, keys with the word "password" in them will have their values removed
    
    Returns:
    
    all of the properties in the system mapped to their evaluated values, sorted by key
  - logString
```
public static String logString(Properties properties)
```
    Returns a string suitable for logging.
    
    Parameters:
    
    properties -
    
    Returns:
    
    string for logging
  - allProperties
```
public static NSArray<ERXProperties.Property> allProperties()
```
    全プロパティーの配列を戻します
    
    Returns:
    
    全プロパティーの配列
  - pathForPropertiesUnderProjectPath
```
public static String pathForPropertiesUnderProjectPath(String projectPath)
```
    Returns the full path to the Properties file under the given project path. At the current implementation, it looks for /Properties and /Resources/Properties. If the Properties file doesn't exist, returns null.
    
    指定プロジェクト・パスのプロパティー・ファイルの完全パスを戻します。カレントの実装では、 /Properties と /Resources/Properties を参照します。プロパティー・ファイルが存在していなければ、 null が戻ります。
    
    Parameters:
    
    projectPath -
    string to the project root directory
    
    プロジェクトのルート・ダイレクトリーへのパス
    
    Returns:
    
    the path to the Properties file if it exists
    
    プロパティー・ファイルへのパス
  - applicationDeveloperProperties
```
public static String applicationDeveloperProperties()
```
    Returns the application-specific user properties.
    
    アプリケーション開発者プロパティーへのパスを戻します。
    
    Returns:
    
    application-specific user properties
    
    開発者プロパティーへのパス
  - variantPropertiesInBundle
```
public static String variantPropertiesInBundle(String userName,
                                               String bundleName)
```
    Returns the application-specific variant properties for the given bundle.
    
    Parameters:
    
    userName -
    
    bundleName -
    
    Returns:
    
    the application-specific variant properties for the given bundle.
  - applicationUserProperties
```
public static String applicationUserProperties()
```
    Returns the application-specific user properties.
    
    アプリケーション特定のユーザ・プロパティーへのパスを戻します。
    
    Returns:
    
    the application-specific user properties
    
    ユーザ・プロパティーへのパス
  - applicationMachinePropertiesPath
```
public static String applicationMachinePropertiesPath(String fileName)
```
    Returns the path to the application-specific system-wide file "fileName". By default this path is /etc/WebObjects, and the application name will be appended. For instance, if you are asking for the MyApp Properties file for the system, it would go in /etc/WebObjects/MyApp/Properties.
    
    アプリケーション特定の "fileName" へのパスを戻します。デフォルトでは /etc/WebObjects とアプリケーション名です。例えば、MyApp プロパティー・ファイルへの問い合わせをすると、/etc/WebObjects/MyApp/Properties が戻ります。
    
    Parameters:
    
    fileName -
    the Filename
    
    ファイル名
    
    Returns:
    
    the path, or null if the path does not exist
    
    プロパティーへのパス、無ければ null
  - optionalConfigurationFiles
```
public static NSArray optionalConfigurationFiles()
```
    Gets an array of optionally defined configuration files. For each file, if it does not exist as an absolute path, ERXProperties will attempt to resolve it as an application resource and use that instead.
    
    オプションで定義セットアップファイルの配列を取得します。各ファイル、完全パスとして存在していなければ、 ERXProperties はアプリケーション・リソースとして処理します。
    
    Returns:
    
    array of configuration file names
    
    オプションで定義セットアップファイルの配列
  - getActualPath
```
public static String getActualPath(String path)
```
    Returns actual full path to the given file system path that could contain symbolic links. For example: /Resources will be converted to /Versions/A/Resources when /Resources is a symbolic link.
    
    指定ファイル・システム・パスへの完全パスを戻します。（シンボリックリンク可）例えば、/Resources がシンボリックであれば、 /Resources は /Versions/A/Resources へコンバートされる
    
    Parameters:
    
    path -
    path string to a resource that could contain symbolic links
    
    リソースへの文字列パス（シンボリックリンクである可能性があります）
    
    Returns:
    
    actual path to the resource
    
    リソースへの実際のパス
  - systemPropertiesChanged
```
public static void systemPropertiesChanged()
```
    システム・プロパティーが変更されたので、キャシュをクリアする
  - applicationNameForAppending
```
protected String applicationNameForAppending()
```
    Caches the application name for appending to the key. Note that for a period when the application is starting up application() will be null and name() will be null.
    Note: this is redundant with the scheme checked in on March 21, 2005 by clloyd (ben holt did checkin). This scheme requires the user to swizzle the existing properties file with a new one of this type.
    
    キーに追加する為のアプリケーション名を戻します。注意：起動時には少しの間 application() と name() がまだ null のままのです。
    
    Returns:
    
    application name used for appending, for example ".ERMailer"
    
    キーに追加する為のアプリケーション名、例えば ".ERMailer"
  - getProperty
```
public String getProperty(String key)
```
    Overriding the default getProperty method to first check: key.<ApplicationName> before checking for key. If nothing is found then key.Default is checked.
    
    デフォルト・プロパティーの getProperty メソッドをオーバライドします。キー <ApplicationName> を先にチェックします。何も見つからなければ、キーを使用します。
    
    Overrides:
    
    getProperty in class Properties
    
    Parameters:
    
    key -
    to check
    
    チェックするキー
    
    Returns:
    
    property value
    
    プロパティー値
  - toExternalForm
```
public Object toExternalForm()
                      throws IOException
```
    Returns the properties as a String in Property file format. Useful when you use them as custom value types, you would set this as the conversion method name.
    
    プロパティーをプロパティー・ファイル・フォーマットの文字列として戻します。カスタム値タイプとして使用する時に便利です。コンバーション・メソッド名として使用するといい
    
    Returns:
    
    Returns the properties as a String in Property file format
    
    プロパティーをプロパティー・ファイル・フォーマットの文字列
    
    Throws:
    
    IOException
  - fromExternalForm
```
public static ERXProperties fromExternalForm(String string)
```
    Load the properties from a String in Property file format. Useful when you use them as custom value types, you would set this as the factory method name.
    
    プロパティー・ファイル・フォーマットの文字列からプロパティーを読込みます。カスタム値タイプとして使用する時に便利です。ファクトリー・メソッド名として使用するといい
    
    Parameters:
    
    string -
    
    プロパティー・ファイル・フォーマットの文字列
    
    Returns:
  - takeValueForKey
```
public void takeValueForKey(Object anObject,
                            String aKey)
```
    Specified by:
    
    takeValueForKey in interface NSKeyValueCoding
  - valueForKey
```
public Object valueForKey(String aKey)
```
    Specified by:
    
    valueForKey in interface NSKeyValueCoding
  - setOperatorForKey
```
public static void setOperatorForKey(ERXProperties.Operator operator,
                                     String key)
```
    Registers a property operator for a particular key.
    
    あるキーへのプロパティー・オペレータを登録します。
    
    Parameters:
    
    operator -
    the operator to register
    
    登録するオペレータ
    
    key -
    the key name of the operator
    
    オペレータのキー名
  - evaluatePropertyOperators
```
public static void evaluatePropertyOperators(Properties originalProperties,
                                             Properties destinationProperties)
```
    For each property in originalProperties, process the keys and values with the registered property operators and stores the converted value into destinationProperties.
    
    オリジナル・プロパティーの各プロパティーのキーと値を登録されているオペレータで処理し、変換されている結果をターゲット・プロパティーに記録します。 ※ ERXSystemより呼ばれる ※
    
    Parameters:
    
    originalProperties -
    the properties to convert
    
    オリジナル・プロパティー
    
    destinationProperties -
    the properties to copy into
    
    変換済みのターゲット・プロパティー
  - flattenPropertyNames
```
public static void flattenPropertyNames(Properties properties)
```
    For every application specific property, this method generates a similar property without the application name in the property key. The original property is not removed.
    Ex: if current application is MyApp, for a property foo.bar.MyApp=true a new property foo.bar=true is generated.
    
    Parameters:
    
    properties - Properties to update
  - stringFor2Keys
```
public static String stringFor2Keys(String s1,
                                    String s2)
```
    システム・プロパティーの結果を String で戻します。最大2つのキーを指定可能で、最初に見つかったキーを使用します。
    
    Parameters:
    
    s1 - - キー1（システム・プロパティー内）
    
    s2 - - キー2（システム・プロパティー内）
    
    Returns:
    
    String 値、デフォルトはnull
    
    Author:
    
    A10 nettani
  - stringFor2KeysWithDefault
```
public static String stringFor2KeysWithDefault(String s1,
                                               String s2,
                                               String defaultValue)
```
    システム・プロパティーの結果を String で戻します。最大2つのキーを指定可能で、最初に見つかったキーを使用します。
    
    Parameters:
    
    s1 - - キー1（システム・プロパティー内）
    
    s2 - - キー2（システム・プロパティー内）
    
    defaultValue - - デフォルト値
    
    Returns:
    
    String 値、デフォルトはdefaultValue
    
    Author:
    
    A10 nettani
  - stringFor3Keys
```
public static String stringFor3Keys(String s1,
                                    String s2,
                                    String s3)
```
    システム・プロパティーの結果を String で戻します。最大3つのキーを指定可能で、最初に見つかったキーを使用します。
    
    Parameters:
    
    s1 - - キー1（システム・プロパティー内）
    
    s2 - - キー2（システム・プロパティー内）
    
    s3 - - キー3（システム・プロパティー内）
    
    Returns:
    
    String 値、デフォルトは null
    
    Author:
    
    A10 nettani
  - stringFor3KeysWithDefault
```
public static String stringFor3KeysWithDefault(String s1,
                                               String s2,
                                               String s3,
                                               String defaultValue)
```
    システム・プロパティーの結果を String で戻します。最大3つのキーを指定可能で、最初に見つかったキーを使用します。
    
    Parameters:
    
    s1 - - キー1（システム・プロパティー内）
    
    s2 - - キー2（システム・プロパティー内）
    
    s3 - - キー3（システム・プロパティー内）
    
    defaultValue - - デフォルト値
    
    Returns:
    
    String 値、デフォルトはdefaultValue
    
    Author:
    
    A10 nettani
  - stringForManyKeys
```
public static String stringForManyKeys(String[] ss)
```
    システム・プロパティーの結果を String で戻します。キーは文字列配列で渡され配列要素位置0から開始し最初に見つかったキーを使用します。
    
    Parameters:
    
    ss - - キーs（システム・プロパティー内）
    
    Returns:
    
    String 値、デフォルトはnull
    
    Author:
    
    A10 nettani
  - stringForManyKeysWithDefault
```
public static String stringForManyKeysWithDefault(String[] ss,
                                                  String defaultValue)
```
    システム・プロパティーの結果やデフォルト値を String で戻します。キーは文字列配列で渡され配列要素位置0から開始し最初に見つかったキーを使用します。
    
    Parameters:
    
    ss - - キーs（システム・プロパティー内）
    
    defaultValue - - デフォルト値
    
    Returns:
    
    String 値
    
    Author:
    
    A10 nettani

Class ERXProperties

Nested Class Summary

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

Field Summary

Fields inherited from class java.util.Properties

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

Constructor Summary

Method Summary

Methods inherited from class java.util.Properties

Methods inherited from class java.util.Hashtable

Methods inherited from class java.lang.Object

Field Detail

DefaultString

_useLoadtimeAppSpecifics

UNKNOWN_WONDER_VERSION

applicationNameForAppending

Constructor Detail

ERXProperties

Method Detail

populateSystemProperties

versionStringForApplication

versionStringForFrameworkNamed

sourceVersionString

valueFromPlistBundleWithKey

wonderVersion

arrayForKey

arrayForKeyWithDefault

booleanForKey

booleanForKeyWithDefault

dictionaryForKey

dictionaryForKeyWithDefault

hasKey

hasKey

intForKey

longForKey

floatForKey

doubleForKey

bigDecimalForKey

bigDecimalForKeyWithDefault

intForKeyWithDefault

longForKeyWithDefault

floatForKeyWithDefault

doubleForKeyWithDefault

stringForKey

stringForKeyWithDefault

decryptedStringForKey

decryptedStringForKeyWithDefault

decryptedStringForKeyWithEncryptedDefault

componentsSeparatedByString

componentsSeparatedByStringWithDefault

enumValueForKey

enumValueForKeyWithDefault

setArrayForKey

setDictionaryForKey

setStringForKey

removeKey

transferPropertiesFromSourceToDest

propertiesFromPath

propertiesFromFile

propertiesFromArgv

pathsForUserAndBundleProperties

pathsForUserAndBundleProperties

applyConfiguration

allPropertiesMap

propertiesMap

logString

allProperties

pathForPropertiesUnderProjectPath

applicationDeveloperProperties

variantPropertiesInBundle

applicationUserProperties

applicationMachinePropertiesPath

optionalConfigurationFiles

getActualPath

systemPropertiesChanged

applicationNameForAppending

getProperty

toExternalForm

fromExternalForm

takeValueForKey