A very basic example of a CEAN stack application that makes use of Couchbase Server's N1QL query language.
The full stack application separates the Node.js, ExpressJS and Couchbase Server into the back-end and leaves AngularJS, HTML, and CSS as the front-end that requests data from the back-end and presents it to the user.
There are not many prerequisites required to build and run this project, but you'll need the following:
- Node.js
- Node Package Manager
- Couchbase Server 4+
Certain configuration in both the application and the database must be done before this project is usable.
Checkout the latest master branch from GitHub and navigate into it using your Terminal (Mac & Linux) or Command Prompt (Windows). Assuming you already have Node.js installed, run the following:
npm install
This will install all dependencies as defined in the package.json file.
This project requires Couchbase 4.0 or higher in order to function because it makes use of the N1QL query language. With Couchbase Server installed, create a new bucket called restful-sample or whatever you've named it in your config.json file.
We're not done yet. In order to use N1QL queries in your application you must create a primary index on your bucket. This can be done by using the Couchbase Query Client (CBQ).
On Mac, run the following to launch CBQ:
./Applications/Couchbase Server.app/Contents/Resources/couchbase-core/bin/cbq
On Windows, run the following to launch CBQ:
C:/Program Files/Couchbase/Server/bin/cbq.exe
With CBQ running, create an index like so:
CREATE PRIMARY INDEX ON `restful-sample` USING GSI;
Your database is now ready for use.
With all dependencies installed and Couchbase Server configured, run the following from your Command Prompt or Terminal:
node app.js
Now when you visit http://localhost:3000 from your web browser you will be able to use the application.
Couchbase - http://www.couchbase.com
ExpressJS - http://www.expressjs.com
AngularJS - http://www.angularjs.org
Node.js - http://www.nodejs.org