【SAP HANA系列】SAP HANA XS使用服务器JavaScript Libraries详解

正文部分

上一篇我们讲了SAP HANA XS JavaScript的安全事项，这一篇讲一下JavaScript的资源库使用。

常规服务器端JavaScript程序中定义的元素无法从其他JavaScript程序访问。为了实现程序元素的重用，SAP HANA扩展应用程序服务支持服务器端JavaScript库。

服务器端JavaScript库是一种特殊类型的JavaScript程序，可以在其他JavaScript程序中导入和调用。 可以使用JavaScript库执行简单，重复的任务，例如，处理表单和表单日期，操纵日期和时间字符串，解析URL等等。

举个简单的例子来说明如何使用导入功能导入JavaScript资源库：

​
// import math lib
$.import("sap.myapp.lib","math");
// use math lib
var max_res = $.sap.myapp.lib.math.max(3, 7);

​

这里的sap.myapp.lib是要导入的库对象的包的全名，math是要导入的库对象的名称，这些名称有哪些限制和使用规则呢，一般情况下：允许的字符是：大小写字母（Aa-Zz），数字0-9还有就是$符号。

标准的JavaScript限制适用于在创建的XSJS库的名称或库部署的包的名称中使用的字符。比如：不能在XSJS库的名称中使用连字符（ - ），或者引用库，则应用程序包路径中的包名称。为了防止在SAP HANA存储库中激活对象的问题，必须按照名称访问JavaScript属性对象的标准规则。 以下示例显示了如何使用方括号和引号（[“<STRING>”]）访问名称使用不允许的字符（例如连字符（ - ））的对象：

​
// import math lib
$.import("sap.myapp.lib.XS-QGP-SPS7","math");
// use math lib
var max_res = $.sap.myapp.lib["XS-QGP-SPS7"].math.max(3, 7);

​

下面讲一下如何导入JavaScript资源库

服务器端JavaScript库是一种特殊类型的JavaScript程序，可以在其他JavaScript程序中导入和调用。

JavaScript库是内部开发的SAP HANA扩展。 这些库存在于包的上下文中，在导入库时引用它。 JavaScript库的以下示例显示单词“Hello”以及名称和感叹号作为后缀。

​
var greetingPrefix = "Hello, ";
var greetingSuffix = "!";
function greet (name) {
 return greetingPrefix + name + greetingSuffix;
}

​

将JavaScript库导入JavaScript应用程序的步骤如下。

第一步、打开要导入JavaScript库的服务器端JavaScript文件。使用$ .import函数，如下所示：

​
$.import("<path.to.your.library.filename>","greetLib");
var greeting = $.<path.to.your.library.filename>.greet("World");
$.response.setBody(greeting);

​

第二步、保存并激活对JavaScript文件的更改。

虽然操作简单，但请记住以下几点：

1、导入操作会生成类似于库中位置的$以下的对象的层次结构，比如资源库的路径：path/to/your/library/greetLib.xsjslib

​
$.path.to.your.library.greetLib

​

　　2、新生成的库对象的附加属性

​
$.path.to.your.library.greetLib.greet()
$.path.to.your.library.greetLib.greetingSuffix
$.path.to.your.library.greetLib.greetingPrefix

​

3、如果导入操作将覆盖任何预定义的运行时对象，则无法导入引用的库。如果引用库已经存在于包中，则不导入。

4、导入的库存在于其存储库位置定义的上下文中。

在存储库中激活已经创建的新库，以便其可供其他JavaScript应用程序导入。

就是这是一个类库，一个知识库，一个随时可以被人调用的资源库，很方便，也很便于查找。