memcache 0.3.0+2

Pub Package Build Status

Memcache interface for the appengine package.

This package define Dart interfaces for memcache. The package defines both a high-level interface and a low-level interface.

These interfaces are used for the memcache support in the appengine package. Therefore these interfaces only support the memcache operations supported by App Engine.

High-level interface #

The high-level interface is called Memcache. It provides a Future based API for the most common access patterns. It defaults to use String values for both keys and values. Store and retrieve single values:

Memcache memcache = ...
memcache.set('MyKey', 'MyValue').then((_) {
  memcache.get('MyKey').then((String value) {
    // value is read from memcache.

Store and retrieve multiple values:

Memcache memcache = ...
memcache.setAll({'MyKey1': 'MyValue1',
                 'MyKey2': 'MyValue2').then((_) {
  memcache.getAll(['MyKey1', 'MyKey2']).then((Map result) {
    // result is a map with the values for MyKey1 and MyKey2.

The high-level interface does not expose the CAS values directly. However through the withCAS method, it becomes simple to use CAS with memcache operations. withCAS returns an implemetation of Memcache which internally keeps track of the CAS for all keys retrieved. When a key is stored the CAS value from when it was retrieved, will be passed automatically to memcache.

Memcache memcache = ...
Memcache cas = memcache.withCAS();
cas.get('MyKey').then((value) {
  memcache.set('MyKey', 'MyNewValue').then((_) {
    // MyNewValue is stored in memcache if the CAS did not
    // change from when it was retrieved.

Low-level interface #

The low-level interface is called RawMemcache and provides a generic interface using request/response objects send in batches to memcache.

Using these interfaces in an App Engine application. #

In a Dart App Engine application using the appengine package the memcahce interface is available on the client context.'MyKey').then(String value) => ...

Native protocol implementation #

This package will also provide an implementation of the native memcached protocol. This is still work in progress, and it will support the interfaces defined in this package.

0.3.0+2 #

  • Fix onError type cast error.

0.3.0 #

  • Update code for Dart 2.

0.2.2 #

  • Ignore exceptions when closing connection in error state.

0.2.1+2 #

  • Fix bug in [Memcache.get] to throw an exception if we a get operation resulted in neither found/not-found but rather in an error (i.e. if the tcp connection is fine, but the server returns an error instead found/not-found).

0.2.1+1 #

  • Added [Memcache.fromRaw] constructor.

0.2.1 #

  • Added [BinaryMemcacheProtocol] which implements the [RawMemcache] API.

  • Fix bugs in the [MemCacheNativeConnection] which used typed-data views incorrectly.

  • Switch from package:unittest to package:test.

0.2.0 #

  • Added expiration to the RawMemcache API when adding values. Pass the expiration from the Memcache implemented on RawMemcache.

  • Removed the expiration from the clear method on the Memcache interface. Some implementations do not support it.

0.1.0 #

  • First release.

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:

  memcache: ^0.3.0+2

2. Install it

You can install packages from the command line:

with pub:

$ pub get

Alternatively, your editor might support pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:memcache/memcache.dart';
Describes how popular the package is relative to other packages. [more]
Code health derived from static analysis. [more]
Reflects how tidy and up-to-date the package is. [more]
Weighted score of the above. [more]
Learn more about scoring.

This package is not analyzed, because it is discontinued.


Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.0.0-dev.20.0 <3.0.0