【HANA系列】SAP HANA XS的JavaScript API详解

公众号：sap technical

本文作者：matinal

原文出处：http://www.cnblogs.com/sapmatinal/

原文链接：【hana系列】sap hana xs的javascript api详解

 

前言部分

本文介绍sap hana xs使用服务器端javascript api。

sap hana扩展应用程序服务（sap hana xs）提供了一组服务器端javascript应用程序编程接口（api），可配置应用程序与sap hana进行交互。

 

api介绍

sap hana xs javascript reference列出了在应用程序和sap hana之间编程交互时可用的所有功能。例如，可以使用数据库api从应用程序内部调用sql语句，或使用请求处理api访问sap hana数据的当前http请求的详细信息.ap hana xs包含以下服务器端javascript api集：database、outbound connectivity、request processing、session、job schedule、security、trace、utilities、xs data services、xs procedures这里不再详细介绍每一个api的用处。

 

介绍几个api

简单说几个如下：

1、database api

sap hana xs数据库api（$ .hdb）提供了能够简单方便地访问数据库的工具。

$ .hdb命名空间旨在替代旧的$ .db命名空间。 由于$ .hdb和$ .db api使用不同的数据库连接，因此避免在单个http请求中使用这两个api，例如更新相同的表，可能会导致死锁等等等这样的问题。

那么，$.hdb有哪些可用选项呢。

$ .hdb.connection：与sap hana数据库建立连接。

$ .hdb.procedureresult：表示对sap hana数据库的存储过程调用的结果。

$ .hdb.resultset：表示数据库查询的结果。

举例前，说明一点：默认情况下，自动提交模式被禁用，这意味着所有的数据库更改都必须被明确的提交。

var connection = $.hdb.getconnection();
connection.executeupdate('update "db_example"."icecream" set quantity=? where flavor=?', 9, 'chocolate');
connection.commit();

以下sap hana xs数据库api的使用示例显示了如何建立与sap hana的连接并从指定的过程调用返回结果集。请看存储过程参数部分：

这样可用访问结果集，最好访问结果集的json格式，还要注意一点$ resultsets不可枚举。

2、job api

在sap hana xs中，通过.xsjob文件创建计划作业，该文件是提交（并激活）sap hana存储库的设计时文件。 .xsjob文件可用于定义在后台运行的循环任务; 作业计划api允许开发人员从这些作业中添加和删除计划。 作业计划api提供以下工具：

$ .jobs.job：表示预定的xs作业。

$ .jobs.joblog：提供对计划作业的日志条目的访问。

$ .jobs.jobschedules：可以控制xs作业的计划。

作为xs作业的一部分，不可能调用$ .request和$ .response对象。xs作业api $ .jobs.job能够在其中定义的作业添加计划（并从中删除计划）一个.xsjob文件。

举个栗子，来说明，服务器端javascript如何使用作业计划api向现有作业添加计划并从现有作业中删除计划。

 

如果uri中引用的xs作业文件与被调用的xs javascript或sqlscript函数不在同一个包中，则必须将完整的包路径添加到上述示例第1行中所示的uri中指定的xs作业文件 ，例如</ path / to / package>> myxsjob.xsjob。

此外，sqlcc / otheruser.xssqlcc中定义的sql连接用于修改作业; 它不用于执行myjob.xsjob中指定的作业。要了解xscron作业调度程序所需的类似cron的语法，我就来简单讲解一下这里的参数，其实很简单啦，下面就和matinal一起解析这些参数。

比如：2013 * * fri 12 0 0

这样写就代表：2013年每周五12点执行此job。是不是很简单。

好了，本文就暂时讲解这两种sap hana xs的javascript api的用法。