nio-memory-manager

`nio-memory-manager`

Used in: external-scheme, paged-external-scheme, async-store-manager.

Description

Configures a store-manager which uses an off JVM heap, memory region for storage, which means that it does not affect the Java heap size and the related JVM garbage-collection performance that can be responsible for application pauses. See the NIO cache sample for an example of an NIO cache configuration.

Some JVMs (starting with 1.4) require the use of a command line parameter if the total NIO buffers will be greater than 64MB. For example: -XX:MaxDirectMemorySize=512M

Implementation

Implemented by the com.tangosol.io.nio.DirectStoreManager class. The BinaryStore objects created by this class are instances of the com.tangosol.io.nio.BinaryMapStore.

Elements

The following table describes the elements you can define within the nio-memory-manager element.

Element	Required/Optional	Description
`<class-name>`	Optional	Specifies a custom implementation of the local cache. Any custom implementation must extend the `com.tangosol.io.nio.DirectStoreManager` class and declare the exact same set of public constructors.
`<init-params>`	Optional	Specifies initialization parameters, for use in custom `nio-memory-manager` implementations which implement the `com.tangosol.run.xml.XmlConfigurable` interface.
`<initial-size>`	Optional	Specifies the initial buffer size in bytes. The value of this element must be in the following format: [\d]+[[.][\d]+]?[K\|k\|M\|m]?[B\|b]? where the first non-digit (from left to right) indicates the factor with which the preceeding decimal value should be multiplied: `K` or `k` (kilo, 2¹⁰) `M` or `m` (mega, 2²⁰) `G` or `g` (giga, 2³⁰) `T` or `t` (tera, 2⁴⁰) If the value does not contain a factor, a factor of mega is assumed. Legal values are positive integers between `1` and `Integer.MAX_VALUE - 1023`. Default value is `1MB`.
`<maximum-size>`	Optional	Specifies the maximum buffer size in bytes. The value of this element must be in the following format: [\d]+[[.][\d]+]?[K\|k\|M\|m]?[B\|b]? where the first non-digit (from left to right) indicates the factor with which the preceeding decimal value should be multiplied: `K` or `k` (kilo, 2¹⁰) `M` or `m` (mega, 2²⁰) `G` or `g` (giga, 2³⁰) `T` or `t` (tera, 2⁴⁰) If the value does not contain a factor, a factor of mega is assumed. Legal values are positive integers between `1` and `Integer.MAX_VALUE - 1023`. Default value is `1024MB`.