SAP Hana 数据库编程接口 - Node.js

自 SAP HANA SP 11 之后，可以使用 Node.js 作为 Hana 的编程接口。SAP 将 Application server 简称为 XS。现在 XS 已经演化为 Advanced 版本。为了区别，早期的 XS 被称为 XS Classical。

从下图可以看出，和 Hana DB 进行交互的有 HANA XS Classical 、Hana Cloud Platform (HCP) 和 XS Advanced。而能够运行在 HCP 和 XS Advanced 的编程接口包括 XSJS (SAP 推出的服务器端 JavaScript，但目前看，社区并不活跃）、Node.js、Tomcat / TomEE (Java 应用程序编写）等。最近测试了 Node.js 编程接口，感觉还不错。

hdb 模块

Node.js 的编程接口模块是 hdb，可以用 npm install hdb 安装。Github 的源码地址为：node-hdb。有示例和说明，容易学习。

hdb CRUD

本文打算介绍两个方面：

  • hdb CRUD 的基本方法；

  • 以及如何利用 Node.js 的 express 框架实现 REST 风格 API (Restful API)。

先看看基本使用方法：

var hdb = require('hdb')

var client = hdb.createClient({
    host: '192.168.2.100,
    port: 30015,
    user: 'STONE',
    password: 'pwd'
});

client.connect(function(err){
    if (err){
        return console.error('Connect error', err);
    }
    var sql = 'SELECT * FROM STONE.EMP_MASTER';
    client.exec(sql, function(err, rows){
        if (err){
            return console.error('Execute error', err);
        }
        console.log('Results:', rows);
    });
});

和前几篇一样，仍然使用 STONE.EMP_MASTER 作为数据源。我们注意到，Node.js 广泛使用异步和回调函数。使用异步的原因是 : Node.js 是单线程的，通过异步来避免阻塞 （blocking）。比如，从Hana 数据库查询 employees 表，但不知道需要多久能获得查询结果，通过异步机制，数据查询到之后放在 rows 中。

上面的 SQL 语句没有参数。下面通过 insert 语句来说明带参数 SQL 语句的处理方法。

client.connect(function(err){
    if (err){
        return console.error('Connect error', err);
    }

    var sql = 'INSERT INTO STONE.EMP_MASTER VALUES(?,?,?,?,?,?,?,?)';

    client.prepare(sql, function(err, statement){
        if (err){
            return console.error('Prepare error:', err);
        }

        var params = ['9001','Male',18,'test4@qq.com','13800-138000','Bachelor','Married',1];

        statement.exec(params, function(err, affectedRows){
            if (err){
                return console.error('Execute error:', err);
            }
            console.log('Affected rows:', affectedRows);
        });
    });
});

  • client.prepare() 先处理语句，成功后放在 statement 中

  • statement.exec() 语句执行查询，函数的第一个参数是 SQL 语句的参数。注意这个参数是数组类型，即使只有一个参数，也要使用数组。

提供 REST 风格的 Service

使用 Node.js 的 express 框架来实现。网上有非常多使用 express 创建 REST 风格 API 的教程，这里就不细说步骤了。后面会介绍怎样在 OpenUI5 中通过 Rest Service 来对对数据库进行增删改查。

  • 安装 Node.js

  • 创建一个文件夹，在文件夹中运行 npm init 创建 packages.json 文件。

  • 安装 express，这里提供一种方法： npm install express --save。--save 参数会修改 packages.json 文件。

  • 安装 body-parser。这个模块将处理 post 请求，对 post 请求进行解析。

工程的文件结构如下：

主要文件有：

  • server.js : 启动服务
  • dbconfig.js: hana 数据库连接的配置信息
  • emp.controller.js: emp_master 表增删改查
  • emp_routes.js: 路由管理

先说明 package.json 文件，管理 app 依赖的模块：

{
  "name": "hana_app",
  "version": "1.0.0",
  "description": "hana in nodejs + express",
  "main": "server.js",
  "dependencies": {
    "body-parser": "^1.18.2",
    "express": "^4.16.2",
    "hdb": "^0.15.2"
  },
  "devDependencies": {},
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "Stone Wang",
  "license": "MIT"
}

server.js

var express = require('express');
var bodyParser = require('body-parser');

var app = express();

// parse requests of content-type - application/x-www-form-urlencoded
app.use(bodyParser.urlencoded({extended: true}));

// parse requests of content-type - application/json
app.use(bodyParser.json());

// home page
app.get('/', function(req, res){
    res.json('Welcome.');
});

// register routes
var route = require('./app/routes/emp.routes.js')
route(app);

// listen on port 3000
app.listen(3000, function(){
    console.log('Server is running on port 3000.');
});

在 server.js 中定义首页的响应，注册路由以及侦听 3000 端口。

dbconfig.js

保存数据库的配置信息，是一个对象：

module.exports = {
    hana:{
        host: '192.168.2.100',
        port: 30015,
        user: 'STONE',
        password: 'pwd'
    }
};

emp.controller.js

var hdb = require("hdb");
var dbconfig = require("../../config/dbconfig.js");

var client = hdb.createClient(dbconfig.hana);

// list all
exports.listAll = function(req, res){
    var sql = "SELECT * FROM STONE.EMP_MASTER";

    client.connect(function(err){
        if (err){
            res.send({"error": err.message});
        }
        client.exec(sql, function(err, rows){
            if (err){
                res.send({"error": err.message});
            }
            client.end();
            res.send({rows});
        });
    })
};

// query by id
exports.queryById = function(req, res){
    var sql = "SELECT * FROM STONE.EMP_MASTER WHERE EMP_ID=?";
    client.connect(function(err){
        if (err){
            res.send({"error": err.message});
        }
        client.prepare(sql, function(err, statement){
            if (err){
                res.send({"error": err.message});
            }
            statement.exec([req.params.emp_id], function(err, rows){
                if (err){
                    res.send({"error": err.message});
                }
                client.end();
                res.send({rows});
            });
        });
    });
};

// create
exports.create = function(req, res){
    var sql = "INSERT INTO STONE.EMP_MASTER VALUES(?,?,?,?,?,?,?,?)";
    client.connect(function(err){
        if (err){
            res.send({"error": err.message});
        }
        client.prepare(sql, function(err, statement){
            if (err){
                res.send({"error": err.message});
            }

            var params = [
                req.body.EMP_ID,
                req.body.GENDER,
                req.body.AGE,
                req.body.EMAIL,
                req.body.PHONE_NR,
                req.body.EDUCATION,
                req.body.MARITAL_STAT,
                req.body.NR_OF_CHILDREN
            ];
            statement.exec(params, function(err, data){
                if (err){
                    res.send({"error": err.message});
                }
                client.end();
                res.sendStatus(200);
            });
        });
    });
};

// update
exports.update = function(req, res){
    var sql = "UPDATE STONE.EMP_MASTER SET GENDER=?, AGE=?, EMAIL=?, PHONE_NR=?, EDUCATION=?, MARITAL_STAT=?, NR_OF_CHILDREN=? WHERE EMP_ID=?";
    client.connect(function(err){
        if (err){
            res.send({"error": err.message});
        }
        client.prepare(sql, function(err, statement){
            if (err){
                res.send({"error": err.message});
            }

            var params = [       
                req.body.GENDER,
                req.body.AGE,
                req.body.EMAIL,
                req.body.PHONE_NR,
                req.body.EDUCATION,
                req.body.MARITAL_STAT,
                req.body.NR_OF_CHILDREN,
                req.params.emp_id
            ];

            statement.exec(params, function(err, data){
                if (err){
                    res.send({"error": err.message});
                }
                client.end();
                res.sendStatus(200);
            });
        });
    });
};

// delete
exports.delete = function(req, res){
    var sql = "DELETE FROM STONE.EMP_MASTER WHERE EMP_ID=?";
    client.connect(function(err){
        if (err){
            res.send({"error": err.message});
        }
        client.prepare(sql, function(err, statement){
            if (err){
                res.send({"error": err.message});
            }

            statement.exec([req.params.emp_id], function(err, data){
                if (err){
                    res.send({"error": err.message});
                }
                client.end();
                res.sendStatus(200);
            });
        });
    });
};

emp.routes.js

module.exports = function(app){
    var empController = require("../controllers/emp.controller.js");

    // list all
    app.get('/employees', empController.listAll);

    // query by ID
    app.get('/employee/:emp_id', empController.queryById);

    // create
    app.post('/employee/create', empController.create);

    // update
    app.put('/employee/:emp_id',empController.update);

    // delete
    app.delete('/employee/:emp_id', empController.delete);
};

使用 Postman 测试

在项目文件下，通过 node server.js 启动服务。然后打开 Postman 进行测试。以下是部分截图。

  • listAll
  • create
  • update
  • delete
  • update
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 205,132评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 87,802评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,566评论 0赞 338
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,858评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,867评论 5赞 368
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,695评论 1赞 282
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,064评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,705评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 42,915评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,677评论 2赞 323
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,796评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,432评论 4赞 322
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,041评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,992评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,223评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,185评论 2赞 352
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,535评论 2赞 343