Jorge Bay Gondra

<p>There are a lot of new features in the&nbsp;<a href="https://github.com/datastax/nodejs-driver">Node.js Driver for Apache Cassandra</a>&nbsp;that we hope every Node.js developer will love.</p>

<p>This new version of the DataStax Node.js Driver improves the data type support in Javascript, delivering types not available in the Ecmascript standard that will make working with Cassandra data types a lot easier. We also added support for the new ES 6 Map/Set built-in types.</p>

<p>We introduced support for batches of prepared statements and named parameters for prepared statements, allowing the use of javascript objects to pass in parameter values.</p>

<p>Now, let’s have a more detailed look at the new features:</p>

<h2>Improved Javascript type support</h2>

<p>The Ecmascript specification, on which Javascript is based, is very poor in terms of built-in types: Numbers for representing int32/float/doubles, no int64 support, etc. Apache Cassandra, on the other side, is very rich in terms of type support, thanks to Java primitive types and classes.</p>

<p>To overcome this, we have to build our own Javascript types and include some of the Google Closure Math module classes.</p>

<h3>Numerical types</h3>

<p>We now use our own BigDecimal representation for Cassandra decimal support and Google Closure Integer for varint. These classes provide string representation and most common operations such as add()/substract()/etc.</p>

<h3>Uuid and timeuuids/h3&gt;</h3>

<p>We used to depend on node-uuid module to support uuid generation. As we wanted to provide a more tuneable UUID generation and proper date decoding of TimeUuids, we rolled our own Uuid and TimeUuid classes:</p>

<pre>
var cassandra = require('cassandra-driver');
var id = cassandra.types.Uuid.random(); //new uuid v4
var timeId = cassandra.types.TimeUuid.now() //new instance based on current date
var date = timeId.getDate(); //date representation</pre>

<h3>Ecmascript 6 Map and Set</h3>

<p>Coinciding with the release of&nbsp;<a href="http://blog.nodejs.org/2015/02/06/node-v0-12-0-stable/" target="_blank">Node.js 0.12</a>&nbsp;that supports the most stable Ecmascript 6 (ES6) features, the new&nbsp;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map" target="_blank">Map</a>&nbsp;and&nbsp;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set" target="_blank">Set</a>&nbsp;built-in types can be used to represent Cassandra map and set values. To enable this option, you should specify the constructors in the client options:</p>

<pre>
var options = {
  contactPoints: contactPoints,
  encoding: { 
    map: Map,
    set: Set
  }
};
var client = new cassandra.Client(options);</pre>

<h2>Named parameters</h2>

<p>Previous versions of the driver only supported positional parameters (specified by ? markers). Starting with this new version, you can use Javascript objects to bind parameter by names, when using Cassandra 2.0 or above:</p>

<pre>
var query = 'INSERT INTO tbl (id, name) VALUES (:id, :name)';
var params = { name: 'Keith Richards', id: 'krichards'};
client.execute(query, params, { prepare: true }, callback);</pre>

<h2>Batch of prepared statements</h2>

<p>By preparing your queries, you will get the best performance and your Javascript parameters will be correctly encoded to Cassandra types. The driver will prepare each query once on each host and execute the batch every time with the different set of parameters provided.</p>

<pre>
var query1 = 'UPDATE user_profiles SET email=? WHERE key=?';
var query2 = 'INSERT INTO user_track (key, text, date) VALUES (?, ?, ?)';
var queries = [
  { query: query1, params: [emailAddress, 'hendrix'] },
  { query: query2, params: ['hendrix', 'Changed email', new Date()] }
];

client.batch(queries, { prepare: true}, function (err) {
  //all queries have been executed successfully
  //or none of the changes have been applied (err)
});</pre>

<p>Version 2.0 of the Node.js driver is available on npm, we hope you'll enjoy it!</p>


Build and scale cloud native apps

Discover the benefits of DBaaS and why your apps deserve an upgrade.

Learn about NoSQL Databases

Learn about NoSQL databases with Apache Cassandra and Astra DB.

2022 Recap: A Year for Customers, Community, and Real-Time Data

Highlights from 2022 and a glimpse into the year ahead.

ViewingTechnical How To’s

Node.js and Cassandra: Improved Javascript Type Support

Sign up for our Developer Newsletter