Use

Use cache-requests in combination with a cache like memory-cache or localstorage-cache. For example, to make it so response data is cached in memory:

var memoryStore = require("can-memory-store");
var dataUrl = require("can-connect/data/url/url");
var cacheRequests = require("can-connect/cache-requests/cache-requests");
var queryLogic = require("can-query-logic");

var todoQueryLogic = new QueryLogic({});

var cacheConnection = memoryStore({queryLogic: todoQueryLogic});
var todoConnection = connect([dataUrl, cacheRequests],{
  cacheConnection: cacheConnection,
  url: "/todos",
  queryLogic: todoQueryLogic
});

Now if today's todos are loaded:

todoConnection.getListData({filter: {due: "today"}});

And later, a subset of those todos are loaded:

todoConnection.getListData({filter: {due: "today", status: "critical"}});

The second request will be created from the original request's data.

QueryLogic Usage

cache-requests will "fill-in" the cacheConnection using queryLogic.

For example, if you requested paginated data like:

todoConnection.getListData({filter: {status: "critical"}})

And then later requested:

todoConnection.getListData({})

cache-requests will only request {filter: {status: ["low","medium"]}}, merging that response with the data already present in the cache.

That configuration looks like:

var memoryStore = require("can-memory-store");
var dataUrl = require("can-connect/data/url/url");
var cacheRequests = require("can-connect/cache-requests/cache-requests");
var queryLogic = require("can-query-logic");

var todoQueryLogic = new QueryLogic({
  keys: {
    status: QueryLogic.makeEnum(["low","medium","critical"])
  }
});

var cacheConnection = memoryStore({queryLogic: todoQueryLogic});
var todoConnection = connect([dataUrl, cacheRequests], {
  cacheConnection: cacheConnection,
  url: "/todos",
  queryLogic: todoQueryLogic
})

Note: cacheConnection shares the same queryLogic configuration as the primary connection.