com.couchbase.client.java.transcoder

Class TranscoderUtils

java.lang.Object

com.couchbase.client.java.transcoder.TranscoderUtils

public class TranscoderUtils
extends java.lang.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	BOOLEAN_COMPAT_FLAGS
static int	DOUBLE_COMPAT_FLAGS
static int	JSON_COMMON_FLAGS
static int	JSON_COMPAT_FLAGS
static int	LONG_COMPAT_FLAGS
static int	PRIVATE_COMMON_FLAGS
static int	SERIALIZED_COMPAT_FLAGS
static int	STRING_COMMON_FLAGS
static int	STRING_COMPAT_FLAGS

Constructor Summary

Constructors

Constructor and Description
TranscoderUtils()

Method Summary

Methods

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 java.io.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	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(java.io.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

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_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.

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.

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 java.io.Serializable deserialize(com.couchbase.client.deps.io.netty.buffer.ByteBuf content)
                                        throws java.lang.Exception

Takes the input content and deserializes it.

Parameters:

content - the content to deserialize.

Returns:

the serializable object.

Throws:

java.lang.Exception - if something goes wrong during deserialization.

serialize

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

Serializes the input into a ByteBuf.

Parameters:

serializable - the object to serialize.

Returns:

the serialized object.

Throws:

java.lang.Exception - if something goes wrong during serialization.