SAP HANA Developer Guide - Get a Free Blog

9.3.2 Writing Server-Side JavaScript Libraries
Server-side JavaScript libraries are a special type of JavaScript program that can be imported and called in other
JavaScript programs. You can use JavaScript libraries to perform simple, repetitive tasks, for example, to handle
forms and form date, to manipulate date and time strings, to parse URLs, and so on.
JavaScript libraries are internally developed extensions for SAP HANA. However, you can write your own libraries,
too. JavaScript libraries exist in the context of a package, which is referenced when you import the library. To
write a JavaScript library to use in your server-side JavaScript application, perform the following steps:
1. Create the file that contains the JavaScript library you want to add to the package and make available for
import.
In SAP HANA XS, server-side JavaScript libraries have the file extension .xsjslib, for example
greetLib.xsjslib.
The following example creates a simple library that displays the word “Hello” along with a supplied name and
adds an exclamation point (!) as a suffix.
var greetingPrefix = "Hello, ";
var greetingSuffix = "!";
function greet (name) {
return greetingPrefix + name + greetingSuffix;
}
2. Save the new JavaScript library.
It is important to remember where the JavaScript library is located; you have to reference the package path
when you import the library.
3. Activate your new library in the repository so that it is available for import by other JavaScript applications.
9.3.3 Importing Server-Side JavaScript Libraries
Server-side JavaScript libraries are a special type of JavaScript program that can be imported and called in other
JavaScript programs. You can use JavaScript libraries to perform simple, repetitive tasks, for example: handle
forms and form date, manipulate date and time strings, parse URLs, and so on.
JavaScript libraries are internally developed extensions for SAP HANA. The libraries exist in the context of a
package, which is referenced when you import the library. The following example of a JavaScript library displays
the word "Hello" along with a name and an exclamation mark as a suffix.
var greetingPrefix = "Hello, ";
var greetingSuffix = "!";
function greet (name) {
return greetingPrefix + name + greetingSuffix;
}
Note: This procedure uses the illustrated example JavaScript library to explain what happens when you
import a JavaScript library, for example, which objects are created, when, and where. If you have your own
library to import, substitute the library names and paths shown in the steps below as required.
To import a JavaScript library for use in your server-side JavaScript application, perform the following tasks
1. Import the JavaScript library into a JavaScript application.
220
Open the server-side JavaScript file into which you want to import the JavaScript library.
P U B L I C
© 2012 SAP AG. All rights reserved.
SAP HANA Developer Guide
Writing Server-Side JavaScript Applications