使用Bluemix中的Rules服务构建一个酒店预订应用程序

步骤 4. 在 Bluemix 中构建一个 Node.js Express 应用程序

1. 创建一个 Node.js 启动器应用程序并将它绑定到 Rules 服务

1. 在 Bluemix 目录中，选择 Node.js 运行时，然后单击 CREATE APP。为应用程序命名并提供一个主机 URL，后者将作为应用程序在 Internet 上的访问点，例如 mybookingapp.mybluemix.net。然后单击 CREATE。                                                                   
2. 选择应用程序，然后单击 Bind a service。选择在前一步骤中创建的 Rules 服务实例，然后单击 OK。Rules 服务现在已被绑定到您的应用程序。 
3. 现在您可以下载由 Bluemix 生成的示例启动器，并进行一些修改。单击 VIEW > GUIDE，然后单击 Download the starter application package 来下载 ZIP 文件，并将它解压缩到您的文件系统中。

2. 添加和下载依赖项

让我们从向依赖项添加必要的 Node.js 模块开始。在 package.json 文件中修改应用程序名称、描述与依赖项。

{"name": "mybookingapp","version": "0.0.1","description": "A simple hotel booking app using Rules Service in BlueMix","dependencies": {"express": "3.4.7","ejs": "0.8.5","async": "0.7.0"},"engines": {"node": "0.10.0"},"repository": {}}

在应用程序的根目录中运行 npm install 命令，将依赖项下载到 node_modules 目录中。

3. 绘制一个页面来搜索酒店

在示例中，我们选择使用 EJS 作为模板引擎，因为它使用的是标准的 HTML 语法。但您也可以使用其他任意模板引擎，比 Jade、Hogan 或 Underscore。

1. 修改 'view engine' 配置参数，将它变为应用程序的默认值：

   app.set('view engine', 'ejs');

2. 在项目的 views 文件夹中创建一个 index.ejs 文件，同时创建一个包含三个输入内容的 HTML 表单：城市、入住日期和结账离开日期，以便利用它们来来搜索酒店。您可能希望让页面变得更加美观，并在 Bootstrap 的帮助下能够适应各种屏幕大小，但我们在本文中不会详细讨论 HTML 标记和 CSS 样式的内容。另外，您可以从 Git 库中的 BlueBookingServer 项目复制和粘贴代码
3. 当 index.ejs 完成时，只需将默认请求路由到这个主页面即可。

   // Main app pageapp.get('/', function(req, res){  res.render('index');});

4. 在一个城市中搜索酒店

提交搜索表单时，GET 请求被路由到 /hotels。我们想从请求中提取参数，从而在被请求的城市中找到可用酒店的列表。请注意，日期是使用协调世界时间 (UTC, Coordinated Universal Time) 时区进行解析的。点击查看代码清单

// Hotel search resultsapp.get('/hotels', function(req, res){  // get the request parameters  var city = req.query.city;  // the date string is in mm/dd/yyyy format  var fromDateStr = req.query.from;  var toDateStr = req.query.to;  // parse the date string in UTC timezone  var fromDate = Date.UTC(fromDateStr.split('/')[2], fromDateStr.split('/')[0]-1, fromDateStr.split('/')[1]);  var toDate = Date.UTC(toDateStr.split('/')[2], toDateStr.split('/')[0]-1, toDateStr.split('/')[1]);  … //render the page});

为了简便起见，我们不会在这个示例应用程序中通过数据库查询酒店。相反，我们加载了一个数据文件 (data/hotels.json)，然后为所请求城市返回一个酒店数组。

function findHotels(city) {  var hotels = require(__dirname + '/data/hotels.json');  return hotels[city];}

5. 调用 Rules 服务获取结果

当我们将 Rules 服务绑定到应用程序时，会将服务配置添加到 VCAP_SERVICES，这是应用程序的一个只读环境变量。您可以在显示面板中看到它。

{{  "Rules-8.5.1": [    {       "name": "BlueBooking-Rules",       "label": "Rules-8.5.1",       "plan": "free",       "credentials": {          "executionRestUrl": "http://ds-XXXXX.ng.bluemix.net/DecisionService/rest",          "executionSoapUrl": "http://ds-XXXXX.ng.bluemix.net/DecisionService/ws",          "executionAdminUrl": "https://ds-XXXXX.ng.bluemix.net/res",          "executionAdminRestUrl": "https://ds-XXXXX.ng.bluemix.net/res/api",          "user": "username",          "password": "password"       }    }  ]}

1. 通过调用执行 REST API 可以执行在 Rules 服务中部署的规则集。您需要解析 VCAP_SERVICES 变量，并在应用程序中使用它来获取 REST 执行端点。

   // Retrieve the Rules Service parametersif (process.env.VCAP_SERVICES) {  var env = JSON.parse(process.env.VCAP_SERVICES);  var rules = env['Rules-8.5.1'][0].credentials;} else {  // for local testing, set the execution endpoint manually  var rules = {"executionRestUrl": "http://ds-XXXXX.ng.bluemix.net/DecisionService/rest",  };}

2. 然后，在 Node.js 应用程序中，您可以加载 https 和 url 模块，然后使用它们对 REST 客户端进行编码。

   var https = require('https')  , url = require('url');

3. 创建一个采用以下参数的实用工具函数（invokeRulesService）：
   • rulesetPath：一个 /{ruleappName}/{ruleappVersion}/{rulesetName}/{rulesetVersion} 格式的字符串。Rules 服务支持 RuleApps 和规则集的版本控制。如果不指定版本，则会自动使用最新版本。
   • inputParam：一个包含规则集输入参数容量的 JSON 对象。
   • callback：一个用于响应的回调函数，因为 HTTP 请求是异步的。
4. 该函数将向 executionRestUrl+rulesetpath ㄆ鹨桓 POST 请求，同时将 Content-Type 设置为 application/json 和请求主体中的规则集输入参数。Rules 服务将执行规则集，并在 JSON 格式的响应体中返回输出值。

   function invokeRulesService(rulesetPath, inputParams, callback) {  var restUrl = url.parse(rules.executionRestUrl);  var dataString = JSON.stringify(inputParams);  headers = {    'Content-Type': 'application/json',    'Content-Length': dataString.length  };  var options = {    host: restUrl.host,path: restUrl.path + rulesetPath,    method: 'POST',    headers: headers  };  var req = https.request(options, function(resp) {    resp.setEncoding('utf-8');    var responseString = '';    resp.on('data', function(data) {      responseString += data;    });    resp.on('end', function() {      console.log(responseString);      var responseObject = JSON.parse(responseString);      callback(responseObject);    });  });    req.write(dataString);  req.end();}

5. 最后，您可以使用实用工具函数对每家酒店调用 Rules 服务，以便获 带入住率的结果。确保规则集路径的正确性，而且输入参数名称就是规则集中定义的那些名称。因为对 Rules 服务的调用是异步的，所以您可以使用 async 模块对酒店数组进行迭代，并在所有调用完成时返回一个结果数组。不要忘记导出此函数，以便从 app.js 调用它。

   /* * Invoke the Rules Service to calculate the rate for each of the hotels */function getResults(city, fromDate, toDate, callback) {    var results = new Array();    var rulesetPath = '/BlueBookingRuleApp/BlueBookingRules/';    var hotels = findHotels(city);    async.each(hotels, function(hotel, callback) {  var inputParams = {"hotel": hotel, "checkin": fromDate, "checkout": toDate};  invokeRulesService(rulesetPath, inputParams, function(responseObj) {  results.push(responseObj['result']);callback();  });      }, function(err) {      if (err) {        console.log(err);      } else {        callback(results);      }    });}// export public functionsexports.getResults = getResults;

6. 显示结果

回到 app.js；现在可以使用 Rules 服务返回的结果来呈现 hotel.ejs 页面。

service.getResults(city, fromDate, toDate, function(results){    // render the page with data    res.render('hotels', {"city": city, "from": req.query.from, "to": req.query.to, "results": results});  });

步骤 5. 在 Bluemix 中推送和运行应用程序

现在，我们可以将 Node.js 应用程序推送给 Bluemix。在项目文件夹中可以找到一个 manifest.yml 文件，该文件用于描述 Bluemix 中应用程序的名称和域、创建实例的数量、分配的内存，等等。

1. 使用命令行 cf login -a api.ng.bluemix.net 登录 Bluemix。根据提示输入您的用户名、密码、组织和空间。
2. 通过运行 cf push 将应用程序部署到 Bluemix。
3. 在运行应用程序的时候访问 http://mybookingapp.mybluemix.net，以便测试应用程序。

结束语 

Rules服务允许您将业务逻辑与应用程序逻辑分离，从而获得更玫挠τ昧榛钚浴Ｄ可以更新业务逻辑，然后重新部署 RuleApp，同时不对预订应用程序进行任何修改，减少花费在记录与测试业务策略变更上的时间，比如定价计算、合格鉴定或信用授权。此预订应用程序示例显示了将Rules服务与云中Node.js应用程序相集成的可能茫同时还利用了Bluemix平台的部署简便性与可扩展性。

原文出自：IBM developerworks