com.exalead.mercury.mami.indexing.v10

Class SlotsLogSizeBasedCompactPolicy

java.lang.Object

com.exalead.mercury.mami.indexing.v10.AutoCompactPolicy

com.exalead.mercury.mami.indexing.v10.SlotsLogSizeBasedCompactPolicy

All Implemented Interfaces:

com.exalead.util.Checkable, java.io.Serializable

public class SlotsLogSizeBasedCompactPolicy
extends AutoCompactPolicy
implements com.exalead.util.Checkable, java.io.Serializable

A CompactPolicy that tries to compact slots into levels of exponentially increasing size, where each level has fewer slots than the value of the compact factor.
Whenever extra slots (beyond the compact factor upper bound) are encountered, all slots within the level are compacted.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
int	compactFactor
static int	DEFAULT_COMPACT_FACTOR
static long	DEFAULT_MAX_SIZE
static long	DEFAULT_MIN_SIZE
long	maxSize
long	minSize

Fields inherited from class com.exalead.mercury.mami.indexing.v10.AutoCompactPolicy

component, fullCompactPolicy

Constructor Summary

Constructors

Constructor and Description
SlotsLogSizeBasedCompactPolicy()
SlotsLogSizeBasedCompactPolicy(SlotsLogSizeBasedCompactPolicy o) Copy constructor

Method Summary

Modifier and Type	Method and Description
void	check(boolean deep, java.lang.String errorContext) Checks this SlotsLogSizeBasedCompactPolicy.
static SlotsLogSizeBasedCompactPolicy	fromString(java.lang.String s) String representation of this SlotsLogSizeBasedCompactPolicy.
int	getCompactFactor() Determines how often slots are compacted.
long	getMaxSize() A size setting type which sets the largest slot that may be merged with other segments.
long	getMinSize() A size setting type which sets the minimum size for the lowest level slots. Slots below this size are considered to be on the same level (even if they vary drastically in size) and will be merged whenever there are mergeFactor for them. This effectively truncates the "long tail" of small slots that would otherwise be created into a single level. If you set this too large, it can greatly increase the merging cost during indexing (if you flush many small slots).
SlotsLogSizeBasedCompactPolicy	makeCopy() Creates and returns a deep copy of this SlotsLogSizeBasedCompactPolicy.
static SlotsLogSizeBasedCompactPolicy	readFrom(java.io.InputStream is) Read this SlotsLogSizeBasedCompactPolicy from an XML fragment.
void	setCompactFactor(int compactFactor) Determines how often slots are compacted.
void	setMaxSize(long maxSize) A size setting type which sets the largest slot that may be merged with other segments.
void	setMinSize(long minSize) A size setting type which sets the minimum size for the lowest level slots. Slots below this size are considered to be on the same level (even if they vary drastically in size) and will be merged whenever there are mergeFactor for them. This effectively truncates the "long tail" of small slots that would otherwise be created into a single level. If you set this too large, it can greatly increase the merging cost during indexing (if you flush many small slots).
java.lang.String	toString() String representation of this SlotsLogSizeBasedCompactPolicy.
SlotsLogSizeBasedCompactPolicy	withCompactFactor(int compactFactor)
SlotsLogSizeBasedCompactPolicy	withCompactFactor(java.lang.Integer compactFactor)
SlotsLogSizeBasedCompactPolicy	withComponent(java.lang.String component) Deprecated.
SlotsLogSizeBasedCompactPolicy	withFullCompactPolicy(FullCompactPolicy fullCompactPolicy)
SlotsLogSizeBasedCompactPolicy	withMaxSize(long maxSize)
SlotsLogSizeBasedCompactPolicy	withMaxSize(java.lang.Long maxSize)
SlotsLogSizeBasedCompactPolicy	withMinSize(long minSize)
SlotsLogSizeBasedCompactPolicy	withMinSize(java.lang.Long minSize)
void	writeTo(java.io.OutputStream os) Write this SlotsLogSizeBasedCompactPolicy as an XML fragment

Methods inherited from class com.exalead.mercury.mami.indexing.v10.AutoCompactPolicy

getComponent, getFullCompactPolicy, setComponent, setFullCompactPolicy

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

compactFactor

public int compactFactor

DEFAULT_COMPACT_FACTOR

public static final int DEFAULT_COMPACT_FACTOR

See Also:

Constant Field Values

minSize

public long minSize

DEFAULT_MIN_SIZE

public static final long DEFAULT_MIN_SIZE

See Also:

Constant Field Values

maxSize

public long maxSize

DEFAULT_MAX_SIZE

public static final long DEFAULT_MAX_SIZE

See Also:

Constant Field Values

Constructor Detail

SlotsLogSizeBasedCompactPolicy

public SlotsLogSizeBasedCompactPolicy()

SlotsLogSizeBasedCompactPolicy

public SlotsLogSizeBasedCompactPolicy(SlotsLogSizeBasedCompactPolicy o)

Copy constructor

Method Detail

withComponent

@Deprecated
public SlotsLogSizeBasedCompactPolicy withComponent(java.lang.String component)

Deprecated.

Overrides:

withComponent in class AutoCompactPolicy

withFullCompactPolicy

public SlotsLogSizeBasedCompactPolicy withFullCompactPolicy(FullCompactPolicy fullCompactPolicy)

Overrides:

withFullCompactPolicy in class AutoCompactPolicy

setCompactFactor

public void setCompactFactor(int compactFactor)

Determines how often slots are compacted.
With smaller values, less RAM is used while indexing, and searches on unoptimized indices are faster, but indexing speed is slower.
With larger values, more RAM is used during indexing, and while searches on unoptimized indices are slower, indexing is faster.
Thus larger values (greater than 10) are best for batch index creation, and smaller values (lower than 10) for indices that are interactively maintained.

getCompactFactor

public int getCompactFactor()

Determines how often slots are compacted.
With smaller values, less RAM is used while indexing, and searches on unoptimized indices are faster, but indexing speed is slower.
With larger values, more RAM is used during indexing, and while searches on unoptimized indices are slower, indexing is faster.
Thus larger values (greater than 10) are best for batch index creation, and smaller values (lower than 10) for indices that are interactively maintained.

withCompactFactor

public SlotsLogSizeBasedCompactPolicy withCompactFactor(int compactFactor)

withCompactFactor

public SlotsLogSizeBasedCompactPolicy withCompactFactor(java.lang.Integer compactFactor)

setMinSize

public void setMinSize(long minSize)

A size setting type which sets the minimum size for the lowest level slots.
Slots below this size are considered to be on the same level (even if they vary drastically in size) and will be merged whenever there are mergeFactor for them.
This effectively truncates the "long tail" of small slots that would otherwise be created into a single level.
If you set this too large, it can greatly increase the merging cost during indexing (if you flush many small slots).

getMinSize

public long getMinSize()

A size setting type which sets the minimum size for the lowest level slots.
Slots below this size are considered to be on the same level (even if they vary drastically in size) and will be merged whenever there are mergeFactor for them.
This effectively truncates the "long tail" of small slots that would otherwise be created into a single level.
If you set this too large, it can greatly increase the merging cost during indexing (if you flush many small slots).

withMinSize

public SlotsLogSizeBasedCompactPolicy withMinSize(long minSize)

withMinSize

public SlotsLogSizeBasedCompactPolicy withMinSize(java.lang.Long minSize)

setMaxSize

public void setMaxSize(long maxSize)

A size setting type which sets the largest slot that may be merged with other segments.

getMaxSize

public long getMaxSize()

A size setting type which sets the largest slot that may be merged with other segments.

withMaxSize

public SlotsLogSizeBasedCompactPolicy withMaxSize(long maxSize)

withMaxSize

public SlotsLogSizeBasedCompactPolicy withMaxSize(java.lang.Long maxSize)

makeCopy

public SlotsLogSizeBasedCompactPolicy makeCopy()

Creates and returns a deep copy of this SlotsLogSizeBasedCompactPolicy.

Overrides:

makeCopy in class AutoCompactPolicy

readFrom

public static SlotsLogSizeBasedCompactPolicy readFrom(java.io.InputStream is)
                                               throws javax.xml.bind.JAXBException

Read this SlotsLogSizeBasedCompactPolicy from an XML fragment.

Throws:

javax.xml.bind.JAXBException

writeTo

public void writeTo(java.io.OutputStream os)
             throws javax.xml.bind.JAXBException,
                    java.io.IOException

Write this SlotsLogSizeBasedCompactPolicy as an XML fragment

Overrides:

writeTo in class AutoCompactPolicy

Throws:

javax.xml.bind.JAXBException

java.io.IOException

fromString

public static SlotsLogSizeBasedCompactPolicy fromString(java.lang.String s)
                                                 throws javax.xml.bind.JAXBException,
                                                        java.io.UnsupportedEncodingException

String representation of this SlotsLogSizeBasedCompactPolicy.

Throws:

javax.xml.bind.JAXBException

java.io.UnsupportedEncodingException

toString

public java.lang.String toString()

String representation of this SlotsLogSizeBasedCompactPolicy.

Overrides:

toString in class AutoCompactPolicy

check

public void check(boolean deep,
                  java.lang.String errorContext)
           throws com.exalead.util.TypedException

Checks this SlotsLogSizeBasedCompactPolicy.

Specified by:

check in interface com.exalead.util.Checkable

Overrides:

check in class AutoCompactPolicy

Throws:

com.exalead.util.TypedException