ERXProperties.InRangeOperator (Project Wonder Reference Documentation)

java.lang.Object
- er.extensions.foundation.ERXProperties.InRangeOperator

All Implemented Interfaces:

ERXProperties.Operator

Enclosing class:

ERXProperties
```
public static class ERXProperties.InRangeOperator
extends Object
implements ERXProperties.Operator
```
InRangeOperator provides support for defining properties that only get set if a value falls within a specific range of values.
An example of this is instance-number-based properties, where you want to only set a specific value if the instance number of the application falls within a certain value. In this example, because instance number is something that is associated with a request rather than the application itself, it is up to the class registering this operator to specify which instance number this application is (via, for instance, a custom system property).
InRangeOperator supports specifying keys like:
```
er.extensions.akey.@forInstance.50=avalue
```
which would set the value of "er.extensions.akey" to "avalue" if this instance is 50.
```
er.extensions.akey.@forInstance.60,70=avalue
```
which would set the value of "er.extensions.akey" to "avalue" if this instance is 60 or 70.
```
er.extensions.akey.@forInstance.100-300=avalue
```
which would set the value of "er.extensions.akey" to "avalue" if this instance is between 100 and 300 (inclusive).
```
er.extensions.akey.@forInstance.20-30,500=avalue
```
which would set the value of "er.extensions.akey" to "avalue" if this instance is between 20 and 30 (inclusive), or if the instance is 50.
If there are multiple inRange operators that match for the same key, the last property (when sorted alphabetically by key name) will win. As a result, it's important to not define overlapping ranges, or you may get unexpected results.
InRangeOperator は指定レンジ内のあるプロパティーをセットする処理をサポートします。
このメソッドのサンプルとして、インスタンス番号ベース・プロパティーです。指定値をプロパティーとしてセットするのはインスタンス番号がある値の間にある時だけ。例えば、インスタンス番号はアプリケーションよりも、リクエストと関連されています。クラス登録によって、このオペレータがインスタンス番号がわかるのです。
InRangeOperator は次のようなキーをサポートしています：
```
er.extensions.akey.@forInstance.50=avalue
```
インスタンスが50になると "er.extensions.akey" の値を "avalue" にセットします。
```
er.extensions.akey.@forInstance.60,70=avalue
```
インスタンスが60又は70の場合 "er.extensions.akey" の値を "avalue" にセットします。
```
er.extensions.akey.@forInstance.100-300=avalue
```
インスタンスが100から300の間にある場合 "er.extensions.akey" の値を "avalue" にセットします。
```
er.extensions.akey.@forInstance.20-30,50=avalue
```
インスタンスが20から30の間、又は50の場合 "er.extensions.akey" の値を "avalue" にセットします。
複数の処理が同じキーでヒットすると、最後のプロパティー（キー名でソートされて）が採用されます。結果として、オーバラップされる値をセットしないように、そうしないと思わない結果が得られます。
Author:

mschrag

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ForInstanceKey` The default key name of the ForInstance variant of the InRange operator. InRangeオペレータのインスタンス・デフォルト・キー名

Constructor Summary

Constructors
Constructor and Description

InRangeOperator(int value)
Constructs a new InRangeOperator.

Constructors
Constructor and Description
`InRangeOperator(int value)` Constructs a new InRangeOperator.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`NSDictionary<String,String>`	`compute(String key, String value, String parameters)` Performs some computation on the key, value, and parameters and returns a dictionary of new properties.

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

- Field Detail
  - ForInstanceKey
```
public static final String ForInstanceKey
```
    The default key name of the ForInstance variant of the InRange operator.
    
    InRangeオペレータのインスタンス・デフォルト・キー名
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - InRangeOperator
```
public InRangeOperator(int value)
```
    Constructs a new InRangeOperator.
    
    新規 InRangeOperator を作成します。「コンストラクタ」
    
    Parameters:
    
    value -
    the instance number of this application
    
    このアプリケーションのインスタンス番号
- Method Detail
  - compute
```
public NSDictionary<String,String> compute(String key,
                                           String value,
                                           String parameters)
```
    Description copied from interface: ERXProperties.Operator
    
    Performs some computation on the key, value, and parameters and returns a dictionary of new properties. If this method returns null, the original key and value will be used. If any other dictionary is returned, the properties in the dictionary will be copied into the destination properties.
    
    キー、値とパラメータを処理し、新プロパティーのディクショナリーを戻します。もし、このメソッドが null を戻すなら、オリジナル・キーと値が使用されます。他のディクショナリーが戻される、ディクショナリーのプロパティーはターゲット・プロパティーにコピーされます。
    
    Specified by:
    
    compute in interface ERXProperties.Operator
    
    Parameters:
    
    key -
    the key ("er.extensions.akey" in "er.extensions.akey.@someOperatorKey.aparameter=somevalue")
    
    キー ("er.extensions.akey.@someOperatorKey.aparameter=somevalue" 内の "er.extensions.akey")
    
    value -
    ("somevalue" in "er.extensions.akey.@someOperatorKey.aparameter=somevalue")
    
    値 ("er.extensions.akey.@someOperatorKey.aparameter=somevalue" 内の "somevalue")
    
    parameters -
    ("aparameter" in "er.extensions.akey.@someOperatorKey.aparameter=somevalue")
    
    パラメータ ("er.extensions.akey.@someOperatorKey.aparameter=somevalue" 内の "aparameter")
    
    Returns:
    
    a dictionary of properties (or null to use the original key and value)
    
    プロパティーのディクショナリー (null の場合にはオリジナルのキーと値が使用)

Class ERXProperties.InRangeOperator

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ForInstanceKey

Constructor Detail

InRangeOperator

Method Detail

compute