Store a key but only if it doesn't already exist on the server.
Store a key but only if it doesn't already exist on the server.
flags
is an arbitrary integer that the server stores along with
the data and sends back when the item is retrieved.
Clients may use this as a bit field to store data-specific
information; this field is opaque to the server.
expiry
is the expiration time for entries. If it is Time.epoch,
Time.Top,
Time.Bottom or
Time.Undefined then the item
never expires, although it may be deleted from the cache to
make room for other items. This is also the case for values
where the number of seconds is larger than
Long.MaxValue.
Otherwise, clients will not be able to retrieve this item after
the expiration time arrives (measured on the cache server).
true if stored, false if not stored
Append bytes to the end of an existing key.
Append bytes to the end of an existing key. If the key doesn't exist, the operation has no effect.
flags
is an arbitrary integer that the server stores along with
the data and sends back when the item is retrieved.
Clients may use this as a bit field to store data-specific
information; this field is opaque to the server.
expiry
is the expiration time for entries. If it is Time.epoch,
Time.Top,
Time.Bottom or
Time.Undefined then the item
never expires, although it may be deleted from the cache to
make room for other items. This is also the case for values
where the number of seconds is larger than
Long.MaxValue.
Otherwise, clients will not be able to retrieve this item after
the expiration time arrives (measured on the cache server).
true if stored, false if not stored
Perform a CAS operation on the key, only if the value has not
changed since the value was last retrieved, and casUnique
extracted from a gets
command.
Perform a CAS operation on the key, only if the value has not
changed since the value was last retrieved, and casUnique
extracted from a gets
command. We treat the "cas unique" token
opaquely, but in reality it is a string-encoded u64.
flags
is an arbitrary integer that the server stores along with
the data and sends back when the item is retrieved.
Clients may use this as a bit field to store data-specific
information; this field is opaque to the server.
expiry
is the expiration time for entries. If it is Time.epoch,
Time.Top,
Time.Bottom or
Time.Undefined then the item
never expires, although it may be deleted from the cache to
make room for other items. This is also the case for values
where the number of seconds is larger than
Long.MaxValue.
Otherwise, clients will not be able to retrieve this item after
the expiration time arrives (measured on the cache server).
Stored if the operation was successful, Exists if the operation failed because someone else had changed the value, or NotFound if the key was not found in the cache.
gets and getsResult for retreiving the cas token.
Decrement the key
by n
.
Decrement the key
by n
.
Interprets the stored value for key
as a Long if it is parseable
as a decimal representation of a 64-bit unsigned integer.
This operation has no effect if there is no value there already.
Remove a key.
Get a set of keys from the server.
Get a set of keys from the server. Returns a Future[GetResult] that encapsulates hits, misses and failures.
getsResult if you need "cas unique" tokens.
Get a set of keys from the server.
Get a set of keys from the server. Returns a Future[GetsResult] that encapsulates hits, misses and failures. This variant includes the casToken from memcached.
checkAndSet for using the token.
getResult if you do not need "cas unique" tokens.
Increment the key
by delta
.
Increment the key
by delta
.
Interprets the stored value for key
as a Long if it is parseable
as a decimal representation of a 64-bit unsigned integer.
This operation has no effect if there is no value there already.
Prepend bytes to the beginning of an existing key.
Prepend bytes to the beginning of an existing key. If the key doesn't exist, the operation has no effect.
flags
is an arbitrary integer that the server stores along with
the data and sends back when the item is retrieved.
Clients may use this as a bit field to store data-specific
information; this field is opaque to the server.
expiry
is the expiration time for entries. If it is Time.epoch,
Time.Top,
Time.Bottom or
Time.Undefined then the item
never expires, although it may be deleted from the cache to
make room for other items. This is also the case for values
where the number of seconds is larger than
Long.MaxValue.
Otherwise, clients will not be able to retrieve this item after
the expiration time arrives (measured on the cache server).
true if stored, false if not stored
release the underlying service(s)
release the underlying service(s)
Replace bytes on an existing key.
Replace bytes on an existing key. If the key doesn't exist, the operation has no effect.
flags
is an arbitrary integer that the server stores along with
the data and sends back when the item is retrieved.
Clients may use this as a bit field to store data-specific
information; this field is opaque to the server.
expiry
is the expiration time for entries. If it is Time.epoch,
Time.Top,
Time.Bottom or
Time.Undefined then the item
never expires, although it may be deleted from the cache to
make room for other items. This is also the case for values
where the number of seconds is larger than
Long.MaxValue.
Otherwise, clients will not be able to retrieve this item after
the expiration time arrives (measured on the cache server).
true if stored, false if not stored
Store a key.
Store a key. Override an existing value.
flags
is an arbitrary integer that the server stores along with
the data and sends back when the item is retrieved.
Clients may use this as a bit field to store data-specific
information; this field is opaque to the server.
expiry
is the expiration time for entries. If it is Time.epoch,
Time.Top,
Time.Bottom or
Time.Undefined then the item
never expires, although it may be deleted from the cache to
make room for other items. This is also the case for values
where the number of seconds is larger than
Long.MaxValue.
Otherwise, clients will not be able to retrieve this item after
the expiration time arrives (measured on the cache server).
Send a stats command with optional arguments to the server.
Send a stats command with optional arguments to the server.
a sequence of strings, each of which is a line of output
Store a key but only if it doesn't already exist on the server.
Store a key but only if it doesn't already exist on the server.
Neither flags nor expiry are supplied.
true if stored, false if not stored
Append a set of bytes to the end of an existing key.
Append a set of bytes to the end of an existing key. If the key doesn't exist, the operation has no effect.
true if stored, false if not stored
Deserialize from the bytes in a Buf
into the client's type, T
.
Deserialize from the bytes in a Buf
into the client's type, T
.
Perform a CAS operation on the key, only if the value has not changed since the value was last retrieved.
Perform a CAS operation on the key, only if the value has not changed
since the value was last retrieved. This is enforced by passing a
casUnique
token extracted from a gets
command. If the casUnique
token matches the one on the server, the value is replaced. We treat the
"cas unique" token opaquely, but in reality it is a string-encoded u64.
Neither flags nor expiry are supplied.
Stored if the operation was successful, Exists if the operation failed because someone else had changed the value, or NotFound if the key was not found in the cache.
gets and getsResult for retreiving the cas token.
Decrement the key
by 1.
Decrement the key
by 1.
Interprets the stored value for key
as a Long if it is parseable
as a decimal representation of a 64-bit unsigned integer.
This operation has no effect if there is no value there already.
Get a set of keys from the server.
Get a set of keys from the server.
a Map[String, T] of all of the keys that the server had.
gets if you need a "cas unique" token.
Get a key from the server.
Get a key from the server.
None
if there is no value stored for key
.
gets if you need a "cas unique" token.
Get a set of keys from the server, together with a "cas unique" token.
Get a set of keys from the server, together with a "cas unique" token. The token is treated opaquely by the memcache client but is in reality a string-encoded u64.
a Map[String, (T, Buf)] of all the keys the server had, together with their "cas unique" token
checkAndSet for using the token.
get if you do not need a "cas unique" token.
Get a key from the server along with a "cas unique" token.
Get a key from the server along with a "cas unique" token. The token is treated opaquely by the memcache client but is in reality a string-encoded u64.
None
if there is no value stored for key
.
checkAndSet for using the token.
get if you do not need a "cas unique" token.
Increment the key
by 1
.
Increment the key
by 1
.
Interprets the stored value for key
as a Long if it is parseable
as a decimal representation of a 64-bit unsigned integer.
This operation has no effect if there is no value there already.
Prepend a set of bytes to the beginning of an existing key.
Prepend a set of bytes to the beginning of an existing key. If the key doesn't exist, the operation has no effect.
Neither flags nor expiry are supplied.
true if stored, false if not stored
Send a quit command to the server.
Send a quit command to the server. Alternative to release, for protocol compatibility.
Replace an item if it exists.
Replace an item if it exists. If it doesn't exist, the operation has no effect.
Neither flags nor expiry are supplied.
true if stored, false if not stored
Store a key.
Store a key. Override an existing values.
Neither flags nor expiry are supplied.
Send a stats command to the server.
Send a stats command to the server.
a sequence of strings, each of which is a line of output
Send a stats command with the given args
to the server.
Send a stats command with the given args
to the server.
a sequence of strings, each of which is a line of output
Adaptor to use Array[Byte] as values
Adaptor to use String as values
Perform a CAS operation on the key, only if the value has not
changed since the value was last retrieved, and casUnique
extracted from a gets
command.
Perform a CAS operation on the key, only if the value has not
changed since the value was last retrieved, and casUnique
extracted from a gets
command. We treat the "cas unique" token
opaquely, but in reality it is a string-encoded u64.
Neither flags nor expiry are supplied.
true if replaced, false if not
(Since version 2015-12-10) BaseClient.cas deprecated in favor of checkAndSet
this is superceded by checkAndSet which returns a higher fidelity return value
Perform a CAS operation on the key, only if the value has not
changed since the value was last retrieved, and casUnique
extracted from a gets
command.
Perform a CAS operation on the key, only if the value has not
changed since the value was last retrieved, and casUnique
extracted from a gets
command. We treat the "cas unique" token
opaquely, but in reality it is a string-encoded u64.
flags
is an arbitrary integer that the server stores along with
the data and sends back when the item is retrieved.
Clients may use this as a bit field to store data-specific
information; this field is opaque to the server.
expiry
is the expiration time for entries. If it is Time.epoch,
Time.Top,
Time.Bottom or
Time.Undefined then the item
never expires, although it may be deleted from the cache to
make room for other items. This is also the case for values
where the number of seconds is larger than
Long.MaxValue.
Otherwise, clients will not be able to retrieve this item after
the expiration time arrives (measured on the cache server).
true if replaced, false if not
(Since version 2015-12-10) BaseClient.cas deprecated in favor of checkAndSet
this is superceded by checkAndSet which returns a higher fidelity return value