net.openhft.chronicle.bytes.util

Class StringInternerBytes

java.lang.Object

net.openhft.chronicle.core.pool.StringInterner

net.openhft.chronicle.bytes.util.StringInternerBytes

public class StringInternerBytes
extends net.openhft.chronicle.core.pool.StringInterner

String interner optimized for Bytes. This class extends StringInterner and is specifically designed to handle interning of strings represented in Bytes objects.

Nested Class Summary

Nested classes/interfaces inherited from class net.openhft.chronicle.core.pool.StringInterner

net.openhft.chronicle.core.pool.StringInterner.Changed

Field Summary

Fields inherited from class net.openhft.chronicle.core.pool.StringInterner

interner, mask, shift, toggle

Constructor Summary

Constructors

Constructor and Description
StringInternerBytes(int capacity) Constructs a new StringInternerBytes instance with the specified capacity.

Method Summary

Modifier and Type	Method and Description
String	intern(@NotNull Bytes<?> bytes) Interns the string representation of the given bytes.
String	intern(@NotNull Bytes<?> bytes, int length) Converts the given bytes to an ISO-8859-1 encoded string, and interns it.

Methods inherited from class net.openhft.chronicle.core.pool.StringInterner

capacity, get, index, intern, toggle, valueCount

Methods inherited from class java.lang.Object

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

Constructor Detail

StringInternerBytes

public StringInternerBytes(int capacity)
                    throws IllegalArgumentException

Constructs a new StringInternerBytes instance with the specified capacity.

Parameters:

capacity - the number of strings that can be stored in the interner.

Throws:

IllegalArgumentException - if the specified capacity is negative.

Method Detail

intern

public String intern(@NotNull
                     @NotNull Bytes<?> bytes)
              throws ArithmeticException,
                     IllegalStateException,
                     BufferUnderflowException

Interns the string representation of the given bytes. The length of the string is automatically determined based on the remaining bytes to read.

Parameters:

bytes - the bytes to be converted and interned as a string.

Returns:

the interned string representation of the bytes.

Throws:

ArithmeticException - if there is an integer overflow when calculating the length.

IllegalStateException - if the underlying bytes store is not readable.

BufferUnderflowException - if there are not enough bytes remaining to read.

intern

public String intern(@NotNull
                     @NotNull Bytes<?> bytes,
                     int length)
              throws IllegalStateException,
                     BufferUnderflowException

Converts the given bytes to an ISO-8859-1 encoded string, and interns it. The string ends either at the byte limit or the specified length, whichever comes first. If the string is already in the pool, the pooled instance is returned. Otherwise, the string is added to the pool.

Parameters:

bytes - the bytes to convert to a string.

length - specifies the maximum number of bytes to be converted, must be non-negative.

Returns:

the interned string representation of the bytes.

Throws:

IllegalArgumentException - if length is negative.

IllegalStateException - if the underlying bytes store is not readable.

BufferUnderflowException - if there are not enough bytes remaining to read.