com.couchbase.client.java.transcoder

Class TranscoderUtils

java.lang.Object

com.couchbase.client.java.transcoder.TranscoderUtils

public class TranscoderUtils
extends Object

Helper methods and flags for the shipped Transcoders.

Since:

2.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TranscoderUtils.CommonFlags The common flags enum.

Field Summary

Fields

Modifier and Type	Field and Description
static int	BINARY_COMMON_FLAGS
static int	BINARY_COMPAT_FLAGS
static int	BINARY_LEGACY_FLAGS
static int	BOOLEAN_COMPAT_FLAGS
static int	BOOLEAN_LEGACY_FLAGS
static int	COMMON_FORMAT_MASK 32bit flag is composed of: - 3 compression bits - 1 bit reserved for future use - 4 format flags bits.
static int	DOUBLE_COMPAT_FLAGS
static int	DOUBLE_LEGACY_FLAGS
static int	JSON_COMMON_FLAGS
static int	JSON_COMPAT_FLAGS
static int	JSON_LEGACY_FLAGS
static int	LONG_COMPAT_FLAGS
static int	LONG_LEGACY_FLAGS
static int	PRIVATE_COMMON_FLAGS
static int	SERIALIZED_COMPAT_FLAGS
static int	SERIALIZED_LEGACY_FLAGS
static int	STRING_COMMON_FLAGS
static int	STRING_COMPAT_FLAGS
static int	STRING_LEGACY_FLAGS

Constructor Summary

Constructors

Constructor and Description
TranscoderUtils()

Method Summary

Modifier and Type	Method and Description
static int	createCommonFlags(int flags) Takes a integer representation of flags and moves them to the common flags MSBs.
static Serializable	deserialize(com.couchbase.client.deps.io.netty.buffer.ByteBuf content) Takes the input content and deserializes it.
static int	extractCommonFlags(int flags) Returns only the common flags from the full flags.
static boolean	hasBinaryFlags(int flags) Checks if the flags identify a binary document.
static boolean	hasCommonFlags(int flags) Checks whether the upper 8 bits are set, indicating common flags presence.
static boolean	hasCommonFormat(int flags, int expectedCommonFlag) Checks that flags has common flags bits set and that they correspond to expected common flags format.
static boolean	hasCompressionFlags(int flags) Checks whether the upper 3 bits are set, indicating compression presence.
static boolean	hasJsonFlags(int flags) Checks if the flags identify a JSON document.
static boolean	hasSerializableFlags(int flags) Checks if the flags identify a serialized document.
static boolean	hasStringFlags(int flags) Checks if the flags identify a String document.
static com.couchbase.client.deps.io.netty.buffer.ByteBuf	serialize(Serializable serializable) Serializes the input into a ByteBuf.

Methods inherited from class java.lang.Object

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

Field Detail

COMMON_FORMAT_MASK

public static final int COMMON_FORMAT_MASK

32bit flag is composed of: - 3 compression bits - 1 bit reserved for future use - 4 format flags bits. those 8 upper bits make up the common flags - 8 bits reserved for future use - 16 bits for legacy flags

This mask allows to compare a 32 bits flags with the 4 common flag format bits (“00001111 00000000 00000000 00000000”).

See Also:

extractCommonFlags(int), hasCommonFlags(int), hasCompressionFlags(int), Constant Field Values

PRIVATE_COMMON_FLAGS

public static final int PRIVATE_COMMON_FLAGS

JSON_COMMON_FLAGS

public static final int JSON_COMMON_FLAGS

BINARY_COMMON_FLAGS

public static final int BINARY_COMMON_FLAGS

STRING_COMMON_FLAGS

public static final int STRING_COMMON_FLAGS

SERIALIZED_LEGACY_FLAGS

public static final int SERIALIZED_LEGACY_FLAGS

See Also:

Constant Field Values

BINARY_LEGACY_FLAGS

public static final int BINARY_LEGACY_FLAGS

See Also:

Constant Field Values

STRING_LEGACY_FLAGS

public static final int STRING_LEGACY_FLAGS

See Also:

Constant Field Values

JSON_LEGACY_FLAGS

public static final int JSON_LEGACY_FLAGS

See Also:

Constant Field Values

BOOLEAN_LEGACY_FLAGS

public static final int BOOLEAN_LEGACY_FLAGS

See Also:

Constant Field Values

LONG_LEGACY_FLAGS

public static final int LONG_LEGACY_FLAGS

See Also:

Constant Field Values

DOUBLE_LEGACY_FLAGS

public static final int DOUBLE_LEGACY_FLAGS

See Also:

Constant Field Values

SERIALIZED_COMPAT_FLAGS

public static final int SERIALIZED_COMPAT_FLAGS

JSON_COMPAT_FLAGS

public static final int JSON_COMPAT_FLAGS

BINARY_COMPAT_FLAGS

public static final int BINARY_COMPAT_FLAGS

BOOLEAN_COMPAT_FLAGS

public static final int BOOLEAN_COMPAT_FLAGS

LONG_COMPAT_FLAGS

public static final int LONG_COMPAT_FLAGS

DOUBLE_COMPAT_FLAGS

public static final int DOUBLE_COMPAT_FLAGS

STRING_COMPAT_FLAGS

public static final int STRING_COMPAT_FLAGS

Constructor Detail

TranscoderUtils

public TranscoderUtils()

Method Detail

hasCommonFlags

public static boolean hasCommonFlags(int flags)

Checks whether the upper 8 bits are set, indicating common flags presence.

It does this by shifting bits to the right until only the most significant bits are remaining and then checks if one of them is set.

Parameters:

flags - the flags to check.

Returns:

true if set, false otherwise.

hasCompressionFlags

public static boolean hasCompressionFlags(int flags)

Checks whether the upper 3 bits are set, indicating compression presence.

It does this by shifting bits to the right until only the most significant bits are remaining and then checks if one of them is set.

Parameters:

flags - the flags to check.

Returns:

true if compression set, false otherwise.

hasCommonFormat

public static boolean hasCommonFormat(int flags,
                                      int expectedCommonFlag)

Checks that flags has common flags bits set and that they correspond to expected common flags format.

Parameters:

flags - the 32 bits flags to check

expectedCommonFlag - the expected common flags format bits

Returns:

true if common flags bits are set and correspond to expectedCommonFlag format

extractCommonFlags

public static int extractCommonFlags(int flags)

Returns only the common flags from the full flags.

Parameters:

flags - the flags to check.

Returns:

only the common flags simple representation (8 bits).

createCommonFlags

public static int createCommonFlags(int flags)

Takes a integer representation of flags and moves them to the common flags MSBs.

Parameters:

flags - the flags to shift.

Returns:

an integer having the common flags set.

hasJsonFlags

public static boolean hasJsonFlags(int flags)

Checks if the flags identify a JSON document.

This method is strict if it finds common flags set, and if not falls back to a check of legacy JSON string (identified by 0 flags and no compression).

Parameters:

flags - the flags to check.

Returns:

true if JSON, false otherwise.

hasStringFlags

public static boolean hasStringFlags(int flags)

Checks if the flags identify a String document.

This method is strict if it finds common flags set, and if not falls back to a check of legacy String (identified by 0 flags and no compression).

Parameters:

flags - the flags to check.

Returns:

true if String, false otherwise.

hasSerializableFlags

public static boolean hasSerializableFlags(int flags)

Checks if the flags identify a serialized document.

Parameters:

flags - the flags to check.

Returns:

true if serializable, false otherwise.

hasBinaryFlags

public static boolean hasBinaryFlags(int flags)

Checks if the flags identify a binary document.

Parameters:

flags - the flags to check.

Returns:

true if binary, false otherwise.

deserialize

public static Serializable deserialize(com.couchbase.client.deps.io.netty.buffer.ByteBuf content)
                                throws Exception

Takes the input content and deserializes it.

Parameters:

content - the content to deserialize.

Returns:

the serializable object.

Throws:

Exception - if something goes wrong during deserialization.

serialize

public static com.couchbase.client.deps.io.netty.buffer.ByteBuf serialize(Serializable serializable)
                                                                   throws Exception

Serializes the input into a ByteBuf.

Parameters:

serializable - the object to serialize.

Returns:

the serialized object.

Throws:

Exception - if something goes wrong during serialization.