Infinispan Hot Rod JS Client 0.16.0: Transactions, Multimaps, and Flags
Hot on the heels of 0.15.0, we’re happy to announce the release of the Infinispan Hot Rod JS Client 0.16.0. This release brings three new features that round out the client’s capabilities: transactions, multimap support, and operation flags.
Transactions
Sometimes you need multiple operations to succeed or fail as a unit. The JS client now supports Hot Rod transactions with a simple begin/commit/rollback API:
var tm = client.getTransactionManager();
await tm.begin();
try {
await client.put('account-A', '900');
await client.put('account-B', '1100');
await tm.commit();
} catch (e) {
await tm.rollback();
throw e;
}During a transaction, reads go through the local write set first — so if you put a value and then get it within the same transaction, you’ll see your own write. Under the hood, the client uses XA-style two-phase commit with version-based conflict detection, so concurrent modifications are caught at commit time.
Multimaps
Multimaps let you associate multiple values with a single key — great for tags, categories, or any one-to-many relationship:
// Add values to a key
await client.multimapPut('colors', 'red');
await client.multimapPut('colors', 'green');
await client.multimapPut('colors', 'blue');
// Get all values for a key
var values = await client.multimapGet('colors');
console.log(values); // ['red', 'green', 'blue']
// Check containment
await client.multimapContainsEntry('colors', 'red'); // true
await client.multimapContainsValue('green'); // true
await client.multimapContainsKey('colors'); // true
// Remove a specific value or the entire key
await client.multimapRemoveEntry('colors', 'red');
await client.multimapRemoveKey('colors');
// Total number of key-value pairs across all keys
var size = await client.multimapSize();Operation flags
You can now pass Hot Rod flags to fine-tune how individual operations behave.
Flags are available as constants on the infinispan module and can be combined with bitwise OR:
var infinispan = require('infinispan');
// Skip cache store loading
await client.put('key', 'value', {
flags: infinispan.flags.SKIP_CACHE_LOAD
});
// Combine multiple flags
await client.put('key', 'value', {
flags: infinispan.flags.SKIP_CACHE_LOAD | infinispan.flags.SKIP_INDEXING
});
// Suppress listener notifications on remove
await client.remove('key', {
flags: infinispan.flags.SKIP_LISTENER_NOTIFICATION
});The available flags are:
-
FORCE_RETURN_VALUE— return the previous value on mutations -
DEFAULT_LIFESPAN— use the server-configured default lifespan -
DEFAULT_MAXIDLE— use the server-configured default max idle time -
SKIP_CACHE_LOAD— don’t load from the cache store -
SKIP_INDEXING— don’t index the entry -
SKIP_LISTENER_NOTIFICATION— don’t fire listener events
Get started
Install or update the client via npm:
npm install infinispan@0.16.0Check out the full source code and documentation on GitHub.
Get it, Use it, Ask us!
We’re hard at work on new features, improvements and fixes, so watch this space for more announcements!Please, download and test the latest release.
The source code is hosted on GitHub. If you need to report a bug or request a new feature, look for a similar one on our GitHub issues tracker. If you don’t find any, create a new issue.
If you have questions, are experiencing a bug or want advice on using Infinispan, you can use GitHub discussions. We will do our best to answer you as soon as we can.
The Infinispan community uses Zulip for real-time communications. Join us using either a web-browser or a dedicated application on the Infinispan chat.
Tristan Tarrant
Tristan is the Infinispan lead. He's been a passionate open-source advocate and contributor for over three decades.
