前言部分
大家可以关注我的公众号,公众号里的排版更好,阅读更舒适。
正文部分
上一篇我们讲了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(, );
这里的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应用程序导入。
就是这是一个类库,一个知识库,一个随时可以被人调用的资源库,很方便,也很便于查找。