Quick and Easy Development with Node.js and Couchbase Server

©2015 Couchbase Inc. 1
Nic Raboy, Developer Advocate at Couchbase
Quick and Easy Development with Node.js
and Couchbase Server

About Me
Nic Raboy
Developer Advocate at Couchbase
@nraboy (Twitter)
Node.js, Android, Java, Ionic Framework, NoSQL, SQL

What Is Couchbase?

What makes Couchbase unique?
4
Performance &
scalability leader
Sub millisecond latency
with high throughput;
memory-centric
architecture
Multi-
purpose
Simplified
administration
Easy to deploy &
manage; integrated
Admin Console, single-
click cluster expansion
& rebalance
Cache, key value store,
document database,
and local/mobile
database in single
platform
Always-on
availability
Data replication across
nodes, clusters, and
data centers
Enterprises choose Couchbase for several key advantages
24x365

 Consolidated cache and
database
 Tune memory required based
on application requirements
Multi-purpose database supports many uses
5
5
Tunable built-in
cache
Flexible schemas
with JSON
Couchbase Lite
 Represent data with varying
schemas using JSON on the
server or on the device
 Index and query data with
Javascript views
 Light weight embedded DB for
always available apps
 Sync Gateway syncs data
seamlessly with Couchbase
Server

Couchbase leads in performance and scalability
Auto
Sharding
Memory-memory
XDCR
Single
NodeType
 No manual sharding
 Database manages data
movement to scale out – not
the user
 Market’s only memory-to-
memory database replication
across clusters and geos
 Provides disaster recover /
data locality
 Hugely simplifies management
of clusters
 Easy to scale clusters by adding
any number of nodes

Available Couchbase Server SDKs
And more…

Overview of the Node.js SDK

Node.js SDK
 Uses the high performance Couchbase C library
 Compatible with Node.js frameworks
 Minimal coding

Node.js
// InstantiateThe Query API
var couchbase = require(“couchbase”);
var myCluster = new Couchbase.Cluster(“localhost:8091”);
var myBucket = myCluster.openBucket(“travel-sample”);
var myQuery = couchbase.N1qlQuery();

Node.js
function query(sql, done) {
var queryToRun = myQuery.fromString(sql);
myBucket.query(queryToRun, function(error, result) {
if(error) {
console.log(“ERROR: “, error);
done(error, null);
return;
}
done(null, result);
return;
});
}

Node.js
if(error) {
done(error, null);
return;
}
done(null, result);
return;
});
}

Node.js Data Querying
 Document lookups
 Couchbase views
 N1QL

Node.jsView Query
var query =ViewQuery.from("travel", "by_name").skip(6).limit(3);
myBucket.query(query, function(error, results) {
for(i in results) {
console.log("Row: ", results[i]);
}
});

Node.js Application Design
AngularJS
Client Frontend
Node.js
Server Backend

Node.js Separation of Frontend and Backend
 No Jade markup
 API driven
 Less client and server coupling
 The backend can evolve without affecting the frontend
 Frontend can be extended to web as well as mobile

Multiple Frontends & One Backend

The Node.js Backend

Node.js Configuration
// config.json
{
"couchbase": {
"server": "127.0.0.1:8091",
"bucket": "restful-sample"
}
}

// Project’s app.js file
var express = require("express");
var bodyParser = require("body-parser");
var couchbase = require("couchbase");
var path = require("path");
var config = require("./config");
var app = express();

// app.js continued…
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));
module.exports.bucket = (new
couchbase.Cluster(config.couchbase.server)).openBucket(config.couchbase.bucket);
app.use(express.static(path.join(__dirname, "public")));
var routes = require("./routes/routes.js")(app);
var server = app.listen(3000, function () {
console.log("Listening on port %s...", server.address().port);
});

Node.js Create or Update Endpoint
// routes.js
app.post("/api/create", function(req, res) {
if(!req.body.firstname) {
return res.status(400).send({"status": "error", "message": "A firstname is required"});
}
// …
RecordModel.create(req.body, function(error, result) {
if(error) {
return res.status(400).send(error);
}
res.send(result);
});
});

Node.js Get Document Endpoint
// routes.js continued…
app.get("/api/get", function(req, res) {
if(!req.query.document_id) {
return res.status(400).send({"status": "error", "message": "A document id is required"});
}
RecordModel.getByDocumentId(req.query.document_id, function(error, result) {
if(error) {
}
res.send(result);
});
});

Node.js Delete Endpoint
// routes.js continued…
app.post("/api/delete", function(req, res) {
if(!req.body.document_id) {
return res.status(400).send({"status": "error", "message": "A document id is required"});
}
RecordModel.delete(req.body.document_id, function(error, result) {
if(error) {
}
res.send(result);
});
});

Node.js Upsert Document Function
// recordmodel.js
RecordModel.save = function(data, callback) {
var jsonObject = {
type: “user”,
firstname: data.firstname,
lastname: data.lastname,
email: data.email
}
var documentId = data.document_id ? data.document_id : uuid.v4();
db.upsert(documentId, jsonObject, function(error, result) {
if(error) {
return callback(error, null);
}
callback(null, {message: "success", data: result});
});
}

Couchbase JSON Document

Node.js Get Document with N1QL Function
// recordmodel.js continued…
RecordModel.getByDocumentId = function(documentId, callback) {
var statement = "SELECT firstname, lastname, email " +
"FROM `" + config.couchbase.bucket + "` AS users " +
"WHERE META(users).id = $1";
var query = N1qlQuery.fromString(statement);
db.query(query, [documentId], function(error, result) {
if(error) {
}
callback(null, result);
});
};

Node.js Delete Document Function
// recordmodel.js continued…
RecordModel.delete = function(documentId, callback) {
db.remove(documentId, function(error, result) {
if(error) {
callback(error, null);
return;
}
callback(null, {message: "success", data: result});
});
};

The AngularJS Frontend

// AngularJS app.js
$scope.fetchAll = function() {
$http(
{
method: "GET",
url: "/api/getAll"
}
)
.success(function(result) {
for(var i = 0; i < result.length; i++) {
$scope.items[result[i].id] = result[i];
}
});
}

// AngularJS app.s
$scope.save = function(firstname, lastname, email) {
$http(
{
method: "POST",
url: "/api/create",
data: {
firstname: firstname,
lastname: lastname,
email: email,
document_id: $stateParams.documentId
}
}
)
}

More Complex Node.js Queries

Node.jsTravel Sample
FlightPath.findAll = function(documentId, callback) {
var statement = "SELECT faa AS fromAirport, geo " +
"FROM `" + config.couchbase.bucket + "` r" +
"WHERE airportname = $1 " +
"UNION SELECT faa AS toAirport, geo " +
"WHERE airportname = $2";
db.query(query, [from, to], function(error, result) {
if(error) {
}
});
};

Node.jsTravel Sample
FlightPath.findAll = function(documentId, callback) {
var statement = "SELECT r.id, a.name, s.flight, s.utc, r.sourceairport, r.destinationairport, r.equipment " +
"UNNEST r.schedule s " +
"JOIN `" + config.couchbase.bucket + "` a ON KEYS r.airlineid " +
"WHERE r.sourceairport = $1AND r.destinationairport = $2AND s.day = $3 ”
"ORDER BY a.name";
db.query(query, [queryFrom, queryTo, leave], function(error, result) {
if(error) {
}
});
};

Node.js Sample Applications
https://github.com/couchbaselabs/try-cb-nodejs
https://github.com/couchbaselabs/restful-angularjs-nodejs

Couchbase N1QLTutorial
http://query.pub.couchbase.com/tutorial

Quick and Easy Development with Node.js and Couchbase Server

More Related Content

What's hot

Viewers also liked

Similar to Quick and Easy Development with Node.js and Couchbase Server

More from Nic Raboy

Recently uploaded

Quick and Easy Development with Node.js and Couchbase Server

Editor's Notes