memcache 0.2.1+2

  • README.md
  • CHANGELOG.md
  • Installing
  • Versions
  • 69

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.

context.services.memcache.get('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.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.

1. Depend on it

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


dependencies:
  memcache: "^0.2.1+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';
        
Version Uploaded Documentation Archive
0.2.1+2 Nov 7, 2017 Go to the documentation of memcache 0.2.1+2 Download memcache 0.2.1+2 archive
0.2.1+1 Mar 9, 2017 Go to the documentation of memcache 0.2.1+1 Download memcache 0.2.1+1 archive
0.2.1 Mar 9, 2017 Go to the documentation of memcache 0.2.1 Download memcache 0.2.1 archive
0.2.0 Apr 16, 2015 Go to the documentation of memcache 0.2.0 Download memcache 0.2.0 archive
0.1.0 Nov 3, 2014 Go to the documentation of memcache 0.1.0 Download memcache 0.1.0 archive
0.0.1 Jun 20, 2014 Go to the documentation of memcache 0.0.1 Download memcache 0.0.1 archive

Analysis

This feature is new.
We welcome feedback.

We analyzed this package, and provided a score, details, and suggestions below.

  • tool failures on Dec 6, 2017
  • Dart: 2.0.0-dev.8.0
  • pana: 0.7.3+1

Scores

Popularity:
Describes how popular the package is relative to other packages. [more]
66
Health:
Code health derived from static analysis. [more]
66
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
79
Overall score:
Weighted score of the above. [more]
69

Platforms

Detected platforms:

Error(s) in lib/memcache_raw.dart: The argument type 'List<Future>' can't be assigned to the parameter type 'Iterable<Future<Response>>'.

Suggestions

  • Fix lib/memcache_raw.dart.

    Strong-mode analysis of lib/memcache_raw.dart failed with the following error:

    line: 163 col: 60
    The argument type 'List<Future>' can't be assigned to the parameter type 'Iterable<Future<Response>>'.

Dependencies

Package Constraint Resolved Available
Dev dependencies
test ^0.12.0