net.openhft.chronicle.bytes.util

Class UTF8StringInterner

java.lang.Object

net.openhft.chronicle.bytes.util.AbstractInterner<String>

net.openhft.chronicle.bytes.util.UTF8StringInterner

public class UTF8StringInterner
extends AbstractInterner<String>

AbstractInterner implementation for interning String objects decoded from UTF-8 byte sequences within a BytesStore.

Example usage:

 UTF8StringInterner interner = new UTF8StringInterner(256);
 String s = interner.intern(store, length);
 

Field Summary

Fields inherited from class net.openhft.chronicle.bytes.util.AbstractInterner

entries, mask, shift, toggle

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected @NotNull String	getValue(@NotNull BytesStore<?,?> cs, int length) Decodes a UTF-8 string from the supplied BytesStore.

Methods inherited from class net.openhft.chronicle.bytes.util.AbstractInterner

intern, intern, intern, intern, toggle, valueCount

Methods inherited from class java.lang.Object

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

Constructor Detail

UTF8StringInterner

public UTF8StringInterner(int capacity)

Constructs a new UTF8StringInterner with the specified capacity.

Parameters:

capacity - the maximum number of items that the interner can hold.

Method Detail

getValue

@NotNull
protected @NotNull String getValue(@NotNull
                                            @NotNull BytesStore<?,?> cs,
                                            int length)
                                     throws UTFDataFormatRuntimeException,
                                            IllegalStateException,
                                            BufferUnderflowException

Decodes a UTF-8 string from the supplied BytesStore. Exactly length bytes are read starting from cs.readPosition() and the read position is left unchanged.

Specified by:

getValue in class AbstractInterner<String>

Parameters:

cs - the bytes store containing UTF-8 data

length - the number of bytes to read

Returns:

the decoded string

Throws:

UTFDataFormatRuntimeException - If the bytes are not valid UTF-8 encoded characters

BufferUnderflowException - If the buffer's limits are exceeded

net.openhft.chronicle.core.io.ClosedIllegalStateException - If the resource has been released or closed.

net.openhft.chronicle.core.io.ThreadingIllegalStateException - If this resource was accessed by multiple threads in an unsafe way

IllegalStateException