Using Node.js with Caché - InterSystems Documentation

3
Accessing Caché from Node.js
The cache.node module provides the basic NoSQL-style methods, and also has more advanced methods that can be used
to implement a higher-level view of the Caché database which can, in turn, form the basis of an object oriented approach
to development. This chapter provides an overview of the available methods and the concepts behind them.
The following topics are discussed:
• JSON Objects and Caché Globals — describes the basic relationship between the globals in the Caché database and
JSON objects in the Node.js environment.
• Synchronous vs. Asynchronous cache.node Methods — describes how to use cache.node calls both synchronously
and asynchronously.
• Overview of cache.node Methods — provides a quick overview of the basic NoSQL-style cache.node database methods.
• Opening and Closing the Caché Database — describes how to load the cache.node module, create an instance of the
cache.node object, and open or close the target Caché database.
• Advanced Data Access with retrieve() and update() — describes advanced cache.node methods that perform certain
operations more efficiently than the basic NoSQL-style methods.
• Towards an Object Oriented Development Methodology — illustrates how the cache.node methods and JSON notation
can be used for object orientated development.
3.1 JSON Objects and Caché Globals
In this section we will look at the basic relationship between JSON objects in the Node.js environment and globals in the
Caché database.
Consider the following global node:
^Customer(1)="Chris Munt"
Note:
By convention, global names are prefixed with the ‘^’ character in Caché. However, this convention should not
be followed in the corresponding JSON representation.
The equivalent JSON construct will be:
{global: "Customer", subscripts: [1], data: "Chris Munt"}
Adding further nodes to this data construct:
Using Node.js with Caché 7