Interface BinaryMemcacheMessage

All Superinterfaces:
DecoderResultProvider, MemcacheMessage, MemcacheObject, ReferenceCounted
All Known Subinterfaces:
BinaryMemcacheRequest, BinaryMemcacheResponse, FullBinaryMemcacheRequest, FullBinaryMemcacheResponse
All Known Implementing Classes:
AbstractBinaryMemcacheMessage, DefaultBinaryMemcacheRequest, DefaultBinaryMemcacheResponse, DefaultFullBinaryMemcacheRequest, DefaultFullBinaryMemcacheResponse

@UnstableApi public interface BinaryMemcacheMessage extends MemcacheMessage
An interface that defines a binary Memcache message, providing common properties for BinaryMemcacheRequest and BinaryMemcacheResponse.

A BinaryMemcacheMessage always consists of a header and optional extras or/and a key.

See Also:
  • Method Details

    • magic

      byte magic()
      Returns the magic byte for the message.
      Returns:
      the magic byte.
    • setMagic

      BinaryMemcacheMessage setMagic(byte magic)
      Sets the magic byte.
      Parameters:
      magic - the magic byte to use.
      See Also:
    • opcode

      byte opcode()
      Returns the opcode for the message.
      Returns:
      the opcode.
    • setOpcode

      BinaryMemcacheMessage setOpcode(byte code)
      Sets the opcode for the message.
      Parameters:
      code - the opcode to use.
    • keyLength

      short keyLength()
      Returns the key length of the message.

      This may return 0, since the key is optional.

      Returns:
      the key length.
    • extrasLength

      byte extrasLength()
      Return the extras length of the message.

      This may be 0, since the extras content is optional.

      Returns:
      the extras length.
    • dataType

      byte dataType()
      Returns the data type of the message.
      Returns:
      the data type of the message.
    • setDataType

      BinaryMemcacheMessage setDataType(byte dataType)
      Sets the data type of the message.
      Parameters:
      dataType - the data type of the message.
    • totalBodyLength

      int totalBodyLength()
      Returns the total body length.

      Note that this may be 0, since the body is optional.

      Returns:
      the total body length.
    • setTotalBodyLength

      BinaryMemcacheMessage setTotalBodyLength(int totalBodyLength)
      Sets the total body length.

      Note that this may be 0, since the body length is optional.

      Parameters:
      totalBodyLength - the total body length.
    • opaque

      int opaque()
      Returns the opaque value.
      Returns:
      the opaque value.
    • setOpaque

      BinaryMemcacheMessage setOpaque(int opaque)
      Sets the opaque value.
      Parameters:
      opaque - the opaque value to use.
    • cas

      long cas()
      Returns the CAS identifier.
      Returns:
      the CAS identifier.
    • setCas

      BinaryMemcacheMessage setCas(long cas)
      Sets the CAS identifier.
      Parameters:
      cas - the CAS identifier to use.
    • key

      ByteBuf key()
      Returns the optional key of the document.
      Returns:
      the key of the document.
    • setKey

      Sets the key of the document. ReferenceCounted.release() ownership of key is transferred to this BinaryMemcacheMessage.
      Parameters:
      key - the key of the message. ReferenceCounted.release() ownership is transferred to this BinaryMemcacheMessage.
    • extras

      ByteBuf extras()
      Returns a ByteBuf representation of the optional extras.
      Returns:
      the optional extras.
    • setExtras

      BinaryMemcacheMessage setExtras(ByteBuf extras)
      Sets the extras buffer on the message. ReferenceCounted.release() ownership of extras is transferred to this BinaryMemcacheMessage.
      Parameters:
      extras - the extras buffer of the document. ReferenceCounted.release() ownership is transferred to this BinaryMemcacheMessage.
    • retain

      Increases the reference count by 1.
      Specified by:
      retain in interface MemcacheMessage
      Specified by:
      retain in interface ReferenceCounted
    • retain

      BinaryMemcacheMessage retain(int increment)
      Increases the reference count by the specified increment.
      Specified by:
      retain in interface MemcacheMessage
      Specified by:
      retain in interface ReferenceCounted
    • touch

      Description copied from interface: ReferenceCounted
      Records the current access location of this object for debugging purposes. If this object is determined to be leaked, the information recorded by this operation will be provided to you via ResourceLeakDetector. This method is a shortcut to touch(null).
      Specified by:
      touch in interface MemcacheMessage
      Specified by:
      touch in interface ReferenceCounted
    • touch

      Description copied from interface: ReferenceCounted
      Records the current access location of this object with an additional arbitrary information for debugging purposes. If this object is determined to be leaked, the information recorded by this operation will be provided to you via ResourceLeakDetector.
      Specified by:
      touch in interface MemcacheMessage
      Specified by:
      touch in interface ReferenceCounted