com.exalead.mercury.mami.indexing.v10

Class ArityBasedFullCompactPolicy

java.lang.Object

com.exalead.mercury.mami.indexing.v10.FullCompactPolicy

com.exalead.mercury.mami.indexing.v10.ArityBasedFullCompactPolicy

All Implemented Interfaces:

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

public class ArityBasedFullCompactPolicy
extends FullCompactPolicy
implements com.exalead.util.Checkable, java.io.Serializable

A FullCompactPolicy that compacts all slots into one whenever the "tail" of slots with smaller arities exceeds together a certain arity.
The idea is that the arity-based policy guarantees occasional full-compaction, but the time interval between full-compaction increases exponentially.
This add-on policy caps the increase at a certain arity, and schedules full-compacts at regular intervals afterwards.
This policy is appropriate when auto-compacts are managed per generation-arity.
In this case, a full optimization can occasionally be triggered to purge the deletes.
If not, the deletes occurring in later slots would never be deleted, incurring performance costs at query-time and extra disk space consumption.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MAX_ARITY
static long	DEFAULT_MIN_SIZE
int	maxArity
long	minSize

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
void	check(boolean deep, java.lang.String errorContext) Checks this ArityBasedFullCompactPolicy.
static ArityBasedFullCompactPolicy	fromString(java.lang.String s) String representation of this ArityBasedFullCompactPolicy.
int	getMaxArity() Whenever the long tail total arity reaches maxArity, a full compact is scheduled. The "long tail" are the slots whose span has an arity inferior to this parameter. This is generally a multiple of the auto-compact Arity policy arity parameter.
long	getMinSize() Slots below this size are considered neglectable.
ArityBasedFullCompactPolicy	makeCopy() Creates and returns a deep copy of this ArityBasedFullCompactPolicy.
static ArityBasedFullCompactPolicy	readFrom(java.io.InputStream is) Read this ArityBasedFullCompactPolicy from an XML fragment.
void	setMaxArity(int maxArity) Whenever the long tail total arity reaches maxArity, a full compact is scheduled. The "long tail" are the slots whose span has an arity inferior to this parameter. This is generally a multiple of the auto-compact Arity policy arity parameter.
void	setMinSize(long minSize) Slots below this size are considered neglectable.
java.lang.String	toString() String representation of this ArityBasedFullCompactPolicy.
ArityBasedFullCompactPolicy	withMaxArity(int maxArity)
ArityBasedFullCompactPolicy	withMaxArity(java.lang.Integer maxArity)
ArityBasedFullCompactPolicy	withMinSize(long minSize)
ArityBasedFullCompactPolicy	withMinSize(java.lang.Long minSize)
void	writeTo(java.io.OutputStream os) Write this ArityBasedFullCompactPolicy as an XML fragment

Methods inherited from class java.lang.Object

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

Field Detail

maxArity

public int maxArity

DEFAULT_MAX_ARITY

public static final int DEFAULT_MAX_ARITY

See Also:

Constant Field Values

minSize

public long minSize

DEFAULT_MIN_SIZE

public static final long DEFAULT_MIN_SIZE

See Also:

Constant Field Values

Constructor Detail

ArityBasedFullCompactPolicy

public ArityBasedFullCompactPolicy()

ArityBasedFullCompactPolicy

public ArityBasedFullCompactPolicy(ArityBasedFullCompactPolicy o)

Copy constructor

Method Detail

setMaxArity

public void setMaxArity(int maxArity)

Whenever the long tail total arity reaches maxArity, a full compact is scheduled.
The "long tail" are the slots whose span has an arity inferior to this parameter.
This is generally a multiple of the auto-compact Arity policy arity parameter.

getMaxArity

public int getMaxArity()

Whenever the long tail total arity reaches maxArity, a full compact is scheduled.
The "long tail" are the slots whose span has an arity inferior to this parameter.
This is generally a multiple of the auto-compact Arity policy arity parameter.

withMaxArity

public ArityBasedFullCompactPolicy withMaxArity(int maxArity)

withMaxArity

public ArityBasedFullCompactPolicy withMaxArity(java.lang.Integer maxArity)

setMinSize

public void setMinSize(long minSize)

Slots below this size are considered neglectable.

getMinSize

public long getMinSize()

Slots below this size are considered neglectable.

withMinSize

public ArityBasedFullCompactPolicy withMinSize(long minSize)

withMinSize

public ArityBasedFullCompactPolicy withMinSize(java.lang.Long minSize)

makeCopy

public ArityBasedFullCompactPolicy makeCopy()

Creates and returns a deep copy of this ArityBasedFullCompactPolicy.

Overrides:

makeCopy in class FullCompactPolicy

readFrom

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

Read this ArityBasedFullCompactPolicy 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 ArityBasedFullCompactPolicy as an XML fragment

Overrides:

writeTo in class FullCompactPolicy

Throws:

javax.xml.bind.JAXBException

java.io.IOException

fromString

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

String representation of this ArityBasedFullCompactPolicy.

Throws:

javax.xml.bind.JAXBException

java.io.UnsupportedEncodingException

toString

public java.lang.String toString()

String representation of this ArityBasedFullCompactPolicy.

Overrides:

toString in class FullCompactPolicy

check

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

Checks this ArityBasedFullCompactPolicy.

Specified by:

check in interface com.exalead.util.Checkable

Overrides:

check in class FullCompactPolicy

Throws:

com.exalead.util.TypedException