ReadModifiers (GigaSpaces XAP 10.1.1 API)

java.lang.Object
- com.j_spaces.core.client.ReadModifiers

```
public class ReadModifiers
extends Object
```
The ReadModifiers class provides static methods and constants to decode Read type modifiers. The sets of modifiers are represented as integers with distinct bit positions representing different modifiers.
You could use bitwise or operator "|" to unite different modifiers.
Note that REPEATABLE_READ, DIRTY_READ and READ_COMMITTED are mutually exclusive (i.e. can't be used together). While EXCLUSIVE_READ_LOCK can be joined with any of them.
These modifiers can be set either at the proxy level IJSpace.setReadModifiers(int) or at the operation level (e.g. using one of IJSpace read/readIfExists/readMultiple/count methods with a modifiers parameter )
The default behavior is that of the REPEATABLE_READ modifier (as defined by the JavaSpace specification ).

Since:

6.0

Version:

1.0

Author:

Guy Korland

See Also:

IJSpace.setReadModifiers(int)

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`DIRTY_READ` Allows non-transactional read operations to have full visibility of the entities in the space, including entities that are `exclusively-locked`.
`static int`	`EXCLUSIVE_READ_LOCK` Allows read operations to have exclusive visibility of entities that are not locked by active transactions.
`static int`	`FIFO` Indicates the operation should comply with First-In-First-Out order.
`static int`	`FIFO_GROUPING_POLL` A modifier passed to take & read operations.
`static int`	`IGNORE_PARTIAL_FAILURE` A modifier passed to read multiple and take multiple operations.
`static int`	`MATCH_BY_ID` Deprecated. use `GigaSpace.takeById(Class, Object, Object)` instead
`static int`	`MEMORY_ONLY_SEARCH` Search for matching entries in cache memory only (do not use the underlying EDS).
`static int`	`READ_COMMITTED` Allows read operations to have visibility of already committed entities, regardless of the fact that these entities might be updated (with a newer version) or taken under an uncommitted transaction.
`static int`	`REPEATABLE_READ` Allows read operations to have visibility of entities that are not write-locked or `exclusively-locked` by active transactions.
`static int`	`THROW_PARTIAL_FAILURE` Deprecated. This is the default behavior, for old behavior use `IGNORE_PARTIAL_FAILURE`

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static boolean`	`isDirtyRead(int mod)` Checks if the DIRTY_READ bit was set for this modifier.
`static boolean`	`isExclusiveReadLock(int mod)` Checks if the EXCLUSIVE_READ_LOCK bit was set for this modifier.
`static boolean`	`isFifo(int mod)` Checks if the FIFO bit was set for this modifier.
`static boolean`	`isFifoGroupingPoll(int mod)` Checks if the FIFO_GROUPING_POLL bit was set for this modifier.
`static boolean`	`isMatchByID(int mod)` Deprecated. use `GigaSpace.takeById(Class, Object, Object)` instead
`static boolean`	`isMemoryOnlySearch(int mod)` Checks if the MEMORY_ONLY_SEARCH bit was set for this modifier.
`static boolean`	`isReadCommitted(int mod)` Checks if the READ_COMMITTED bit was set for this modifier.
`static boolean`	`isThrowPartialFailure(int mod)` Deprecated. This is the default behavior, for old behavior use `IGNORE_PARTIAL_FAILURE`
`static int`	`setIsolationLevelModifier(int modifiers, int newIsolationModifier)`

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

- Field Detail
  - REPEATABLE_READ
```
public static final int REPEATABLE_READ
```
    Allows read operations to have visibility of entities that are not write-locked or exclusively-locked by active transactions.
    This is the default read isolation-level.
    
    See Also:
    
    Constant Field Values
  - DIRTY_READ
```
public static final int DIRTY_READ
```
    Allows non-transactional read operations to have full visibility of the entities in the space, including entities that are exclusively-locked.
    
    See Also:
    
    Constant Field Values
  - EXCLUSIVE_READ_LOCK
```
public static final int EXCLUSIVE_READ_LOCK
```
    Allows read operations to have exclusive visibility of entities that are not locked by active transactions. Once exclusively locked, no other transactional operation is allowed. This supports the ability to perform reads in a "SELECT FOR UPDATE" fashion.
    
    See Also:
    
    Constant Field Values
  - READ_COMMITTED
```
public static final int READ_COMMITTED
```
    Allows read operations to have visibility of already committed entities, regardless of the fact that these entities might be updated (with a newer version) or taken under an uncommitted transaction.
    
    See Also:
    
    Constant Field Values
  - MATCH_BY_ID
```
@Deprecated
public static final int MATCH_BY_ID
```
    Deprecated. use GigaSpace.takeById(Class, Object, Object) instead
    
    The int value required matching to be done only by UID if provided (not in POJO) modifier.
    
    Since:
    
    6.5
    
    See Also:
    
    Constant Field Values
  - THROW_PARTIAL_FAILURE
```
@Deprecated
public static final int THROW_PARTIAL_FAILURE
```
    Deprecated. This is the default behavior, for old behavior use IGNORE_PARTIAL_FAILURE
    
    A modifier passed to read multiple and take multiple operations. The modifier will cause operation specific exception ReadMultipleException,TakeMultipleException to be thrown when not all of the requested number of entries are returned and one or more cluster members are not available.
    
    See Also:
    
    Constant Field Values
  - IGNORE_PARTIAL_FAILURE
```
public static final int IGNORE_PARTIAL_FAILURE
```
    A modifier passed to read multiple and take multiple operations. The modifier will cause partial results to be returned instead of throwing operation specific exception ReadMultipleException,TakeMultipleException when not all of the requested number of entries are returned and one or more cluster members are not available.
    
    Since:
    
    7.1
    
    See Also:
    
    Constant Field Values
  - FIFO
```
public static final int FIFO
```
    Indicates the operation should comply with First-In-First-Out order.
    
    See Also:
    
    Constant Field Values
  - FIFO_GROUPING_POLL
```
public static final int FIFO_GROUPING_POLL
```
    A modifier passed to take & read operations. The modifier will cause a group fifo poll based on the passed template. The template must have a property marked with the SpaceFifoGroupingProperty
    
    Since:
    
    9.0.0
    
    See Also:
    
    Constant Field Values
  - MEMORY_ONLY_SEARCH
```
public static final int MEMORY_ONLY_SEARCH
```
    Search for matching entries in cache memory only (do not use the underlying EDS).
    
    Since:
    
    9.0.1
    
    See Also:
    
    Constant Field Values
- Method Detail
  - setIsolationLevelModifier
```
public static int setIsolationLevelModifier(int modifiers,
                                            int newIsolationModifier)
```
  - isDirtyRead
```
public static boolean isDirtyRead(int mod)
```
    Checks if the DIRTY_READ bit was set for this modifier.
    
    Parameters:
    
    mod - a set of modifiers
    
    Returns:
    
    true if mod includes the DIRTY_READ bit is set.
  - isExclusiveReadLock
```
public static boolean isExclusiveReadLock(int mod)
```
    Checks if the EXCLUSIVE_READ_LOCK bit was set for this modifier.
    
    Parameters:
    
    mod - a set of modifiers
    
    Returns:
    
    true if mod includes the EXCLUSIVE_READ_LOCK bit is set.
  - isReadCommitted
```
public static boolean isReadCommitted(int mod)
```
    Checks if the READ_COMMITTED bit was set for this modifier.
    
    Parameters:
    
    mod - a set of modifiers
    
    Returns:
    
    true if mod includes the READ_COMMITTED bit is set.
  - isMatchByID
```
@Deprecated
public static boolean isMatchByID(int mod)
```
    Deprecated. use GigaSpace.takeById(Class, Object, Object) instead
    
    Checks if the MATCH_BY_ID bit was set for this modifier.
    
    Parameters:
    
    mod - a set of modifiers
    
    Returns:
    
    true if mod includes the MATCH_BY_UID modifier; false otherwise.
  - isThrowPartialFailure
```
@Deprecated
public static boolean isThrowPartialFailure(int mod)
```
    Deprecated. This is the default behavior, for old behavior use IGNORE_PARTIAL_FAILURE
    
    Checks if the THROW_PARTIAL_FAILURE bit was set for this modifier.
    
    Parameters:
    
    mod - a set of modifiers
  - isFifo
```
public static boolean isFifo(int mod)
```
    Checks if the FIFO bit was set for this modifier.
    
    Parameters:
    
    mod - a set of modifiers
    
    Returns:
    
    true if mod includes the FIFO modifier; false otherwise.
  - isFifoGroupingPoll
```
public static boolean isFifoGroupingPoll(int mod)
```
    Checks if the FIFO_GROUPING_POLL bit was set for this modifier.
    
    Parameters:
    
    mod - a set of modifiers
    
    Returns:
    
    true if mod includes the FIFO_GROUPING_POLL modifier; false otherwise.
  - isMemoryOnlySearch
```
public static boolean isMemoryOnlySearch(int mod)
```
    Checks if the MEMORY_ONLY_SEARCH bit was set for this modifier.
    
    Parameters:
    
    mod - a set of modifiers
    
    Returns:
    
    true if mod includes the MEMORY_ONLY_SEARCH modifier; false otherwise.
    
    Since:
    
    9.0.1

Class ReadModifiers

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

REPEATABLE_READ

DIRTY_READ

EXCLUSIVE_READ_LOCK

READ_COMMITTED

MATCH_BY_ID

THROW_PARTIAL_FAILURE

IGNORE_PARTIAL_FAILURE

FIFO

FIFO_GROUPING_POLL

MEMORY_ONLY_SEARCH

Method Detail

setIsolationLevelModifier

isDirtyRead

isExclusiveReadLock

isReadCommitted

isMatchByID

isThrowPartialFailure

isFifo

isFifoGroupingPoll

isMemoryOnlySearch