Node.js Code Samples (SAP HANA)
This entry contains SAP HANA specific JavaScript listings for Node.js runtime within XS Advanced environment.
For basics knowledge on JavaScript language itself see JavaScript Basics
Language Basics on Node.js Runtime
https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/JavaScriptBasics.js
Content:
/dates - Date processing /array - Array processing /json - JSON JavaScript Object Notation processing /objects - JavaScript Objects /strings - String processing /classes - JavaScript Classes /promises - Promises /constants - Constants /blockScoped - Block-Scoped Variables and Functions /parameterDefaults - Parameter Defaults /parameterMultiple - Handling unknown number of input parameters easily /unicode - Unicode Strings and Literals /numFormat - International Number Formatting /currFormat - International Currency Formatting /dateFormat - International Date/Time Formatting
Text Bundles
Lessons Learned
- Use TextBundle module @sap/textbundle";
- Get locale from Client Browser Headers
- Store language specific text files in _i18n subfolder
- Create instance bundle of type TextBundle
- Get text with getText Method of bundle instance
https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/textBundle.js
Open Source Modules for Node.js
How to utilize open source Node.js modules for:
- Create Excel: https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/excel.js
- Create and parse XML: https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/xml.js
- Create ZIP: https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/zip.js
Object Oriented JavaScript
Types of Class Implementations
- Constructor and this-keyword: https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/ooTutorial1.js
- Static methods: https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/ooTutorial2.js
- Instance methods: https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/ooTutorial3.js
- Inheritance and extending methods: https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/ooTutorial4.js
Instanciating and Utilization of Classes
https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/oo.js
WebSockets
By default Webaccess is initiiated from the browser / client side by sending a request to the server in order to receive a result.
In use cases where one would like to update the data on the client side when something changed on server side the resulting periodical polling would not be efficient.
With Web Sockets the server can initiate the communication with one or even multiple clients at a time. This enables BI and Dashboard applications where the server can send new data to the client as soon as is has changed in the database.
Example: Chat application
https://github.com/mattxdev/openSAPHANA/blob/master/srv/router/routes/chatServer.js
Exits for OData V4 Services
Data models for OData V4 Services can be based on CDS views or even HANA SQL views (as the example below) and extended on the service level like this:
using PURCHASE_ORDER_ITEM_VIEW as ItemsView from '../db/data-model'; service CatalogService { ... extend ItemsView with { PARTNERS: association to BuyerView on PARTNERS.PARTNERID = PARTNER_ID; } entity POItemsView @( title: '{i18n>poService}', Capabilities: { InsertRestrictions: {Insertable: false}, UpdateRestrictions: {Updatable: false}, DeleteRestrictions: {Deletable: false} } ) as projection on ItemsView; ... }
Exits for OData V4 Services in Node.js are possible for:
- Before
- On
- After
for operations:
- Create
- Read
- Update
- Delete
CDS definition in /srv/server.js defines with .with(require("./lib/handlers"))
where to look for exit handlers.
<listing-here>