Difference between revisions of "AJAX and REST"
imported>Aeric |
imported>Aeric |
||
| Line 21: | Line 21: | ||
When you create a [[Pages|Page]] in the platform, you are creating a JSP page. You can embed Java code in that page, and use it to directly interact with the platform. Or you can use AJAX and the REST APIs, whichever is easiest. | When you create a [[Pages|Page]] in the platform, you are creating a JSP page. You can embed Java code in that page, and use it to directly interact with the platform. Or you can use AJAX and the REST APIs, whichever is easiest. | ||
For information on using AJAX in a JSP page, see the tech community article [http://techcommunity.softwareag.com/pwiki/-/wiki/Main/Invoking%20REST%20API%20Calls%20using%20AJAX%20in%20AgileApps%20Pages Invoking REST API Calls using AJAX in AgileApps Pages]. | |||
=====Example: Validating a CSRF session for POST, PUT, and DELETE===== | =====Example: Validating a CSRF session for POST, PUT, and DELETE===== | ||
Revision as of 12:30, 31 August 2020
The combination of JavaScript and the platform's REST APIs lets you build a lot of power into a page that displays on a client-side browser.
About AJAX
AJAX is the name given to a set of JavaScript functions that let you connect to a server, get back data, and parse the data into something usable. It originally stood for "Asynchronous JavaScript and XML", but it can also use the JSON format for data interchange.
Perhaps the best summary of AJAX comes from the w3c.schools tutorial:
- "AJAX is the art of exchanging data with a server, and updating parts of a web page, without reloading the whole page."
While an arbitrary string can be passed to or from the server, the two most popular formats by far are XML and JSON. The platform understands both, so you can choose the flavor you prefer. (A common variation is to send XML data to the platform because it's easy to build up strings in XML format, and then get JSON back because that is the easiest format to parse in JavaScript.)
Learn more: AJAX Tutorial
Using AJAX in a Form
The jQuery functions included in the platform make it as simple as possible to make an AJAX call.
The code is expected to be executed as part of a Form, either as part of a Field Script or a Form Script. It builds up an XML string to send to a REST API. In this case, it creates the input XML required by the REST exec API, which executes a method in a Java class. And then tells the API to return JSON, which allows individual elements to be accessed by specifying little more than a JavaScript path.
For more information about using AJAX in a form, see the tech community article How to invoke a class from formscript using AJAX.
Using AJAX in a JSP Page
When you create a Page in the platform, you are creating a JSP page. You can embed Java code in that page, and use it to directly interact with the platform. Or you can use AJAX and the REST APIs, whichever is easiest.
For information on using AJAX in a JSP page, see the tech community article Invoking REST API Calls using AJAX in AgileApps Pages.
Example: Validating a CSRF session for POST, PUT, and DELETE
You have to validate a CSRF session for POST, PUT, and DELETE requests. For information about validating a CSRF session, see the Tech Community article at Validating a CSRF session for POST, PUT, and DELETE. This article provides sample codes for validating CSRF sessions for Form Submissions and REST APIs.
Note: Ensure to add the header X-XSRF-TOKEN with value of xsrfToken from the login response.
