Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ......
Transcript of Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ......
![Page 1: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/1.jpg)
Elevate Web Builder 2 Modules Manual
Table Of Contents
Chapter 1 - Getting Started 1
1.1 Creating a Module 1
1.2 Database Modules 3
1.3 Handling Requests 4
Chapter 2 - Component Reference 13
2.1 TEWBDatabaseAdapter Component 13
2.2 TEWBDataSetAdapter Component 30
2.3 TEWBJSONReader Component 45
2.4 TEWBJSONWriter Component 73
2.5 TEWBMIMEPart Component 104
2.6 TEWBMIMEParts Component 112
2.7 TEWBModule Component 116
2.8 TEWBServerRequest Component 123
Chapter 3 - Type Reference 169
3.1 TEWBAuthenticationEvent Type 169
3.2 TEWBFilterDataSetRowsEvent Type 170
3.3 TEWBGetDataSetAdapterEvent Type 171
3.4 TEWBGetDataSetsEvent Type 172
3.5 TEWBHashType Type 173
3.6 TEWBInitializeDataSetAdapterEvent Type 174
3.7 TEWBJSONDateTimeFormat Type 175
3.8 TEWBModuleExecuteEvent Type 176
3.9 TEWBRequestMethod Type 177
Table of Contents
Preface
![Page 2: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/2.jpg)
This page intentionally left blank
Table of Contents
Preface
![Page 3: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/3.jpg)
Chapter 1Getting Started
1.1 Creating a Module
To create a new module, please complete the following steps:
1. In the RAD Studio IDE, select the File/New/Other menu option from the main menu.
2. The New Items dialog will then appear. Select the Elevate Web Builder option folder from the list onthe left-hand side of the dialog. Click on the Elevate Web Builder Module and then click on the OKbutton.
Getting Started
Page 1
![Page 4: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/4.jpg)
3. The Browse for Folder dialog will then appear. Select the desired target folder for the new moduleproject and click on the OK button.
4. The new module project will be created in the desired target folder and opened as the active project inthe RAD Studio IDE.
Please see the Handling Requests topic for more information on adding the appropriate code forhandling incoming requests to the module.
Getting Started
Page 2
![Page 5: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/5.jpg)
1.2 Database Modules
Database modules are exactly like any other module, but are coded to handle database operations usingthe TEWBDatabaseAdapter and TEWBDataSetAdapter components. Specifically, any incoming request canbe passed directly to the TEWBDatabaseAdapter HandleRequest method and the database adaptercomponent will completely handle the database request, calling the applicable TEWBDatabaseAdapterand TEWBDataSetAdapter methods and events as necessary to complete the request and send back aresponse.
Please see the Configuring the Web Server section in the Elevate Web Builder manual that is includedwith the Elevate Web Builder IDE for more information on configuring the database modules resourcename used with database module requests.
Database Module Example
The Elevate Web Builder 2 Modules installation includes an example database module project that showshow to load a dataset from an ElevateDB database. This project also demonstrates the usage of theTEWBDatabaseAdapter and TEWBDataSetAdapter components for generating/consuming JSON fromTDataSet-descendant component instances in Embarcadero RAD Studio and Delphi. It is installed into the\examples\databasemodule subdirectory under the main installation directory of the Elevate Web Builder2 Modules installation.
In addition, a database module client example project called databaseclient.wbp is automatically installedwith the example applications that come with Elevate Web Builder 2. It provides the front-end foraccessing the dataset that is handled by the database module example project. A pre-compiled copy(databasemodule.dll) of the databasemodule example project will be also be located in the\bin\databasemodule\win32 subdirectory under the main installation directory of Elevate Web Builder 2,and this pre-compiled database module will be added to the IDE during the example installation so that itcan be used with the database module client example project.
Getting Started
Page 3
![Page 6: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/6.jpg)
1.3 Handling Requests
Note Before reading the following material, please be sure that you understand how HTTP requestswork by reading the Using Server Requests and Using the Web Server sections of the ElevateWeb Builder manual that is included with the Elevate Web Builder IDE. These sections containimportant information such as how server requests work and how HTTP headers are formatted.
Incoming Requests
When an HTTP request is received by the Elevate Web Builder Web Server, the URL of the request ischecked to see if the request is for static content or a database request. If the URL for the request is notthat of static content or a database request, then the URL is checked to see if it is an Elevate Web Buildermodule request. A module request is any request that uses one of the following URL structures:
Normal Module
http://<Domain Name>/<Modules Resource Name>/<Module Name> orhttps://<Domain Name>/<Modules Resource Name>/<Module Name>
Database Module
http://<Domain Name>/<Database Modules Resource Name>/<Database Module Name> orhttps://<Domain Name>/<Database Modules Resource Name>/<Database Module Name>
Note The <Module Resource Name> and <Database Module Resource Name> components of the URLare the default resource names for modules and database modules defined in the Elevate WebBuilder Web Server, but can be changed in the web server configuration. If you've changed thedefault modules resource name of 'modules', then please replace any subsequent references to thedefault 'modules' resource name in the following examples with the resource name that you'reusing instead. The same holds true for the default database modules resource name of'databasemodules'.
If the URL matches either of the above patterns, the web server will automatically instantiate aTEWBModule component to represent the module specified in the URL for use with the request. The webserver will then pass the request information to the module instance by firing its OnExecute event handler.The request is passed to the OnExecute event handler as an instance of the TEWBServerRequest object.This TEWBServerRequest object instance is used both to retrieve information about the request and tosend content as a response to the request.
Getting Started
Page 4
![Page 7: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/7.jpg)
For database module requests, you can use the OnExecute event handler to pass the incoming requestdirectly to the TEWBDatabaseAdapter HandleRequest method and the database adapter component willcompletely handle the database request, calling the applicable TEWBDatabaseAdapter andTEWBDataSetAdapter methods and events as necessary to complete the request and send back aresponse.
Warning Each module instance is executed in a separate thread, so you must make sure that all codeincluded in an OnExecute event handler is completely thread-safe. Also, all modules in the webserver run in-process, so a fatal error such as a memory overwrite due to improper threading codein a module could cause the server to fail.
Determining if a Request Is Secure
You can determine if a request is secure (using HTTPS) by examining the RequestSecure property of theincoming request.
Note The web server does not currently support secure requests.
Determining the Request Type
Module requests can be HTTP HEAD, GET, POST, PUT, and DELETE requests. You can determine therequest type by examining the RequestMethod property of the incoming request. HEAD requests arenormally associated with static resources such as files, but they can be sent to modules when the contenttype of the resource being handled by the module is unknown to the client application. PUT and DELETErequests are normally associated with REST APIs, which are possible to handle using modules.
Determining the Browser Type
You can determine the type of browser that is submitting the request by examining the followingproperties of the incoming request:
RequestIERequestFireFoxRequestChromeRequestOperaRequestSafari
Note These properties are set by the web server examining the RequestHeaders that are passed to theweb server as part of the request, and therefore can be easily forged by any client that is trying toimpersonate a particular browser. However, for the majority of clients, these properties willaccurately reflect the browser being used on the client.
Reading URL Parameters
Getting Started
Page 5
![Page 8: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/8.jpg)
Parameters are specified in a URL in the following manner:
<BaseURL>?<Params>
<Params> = <Param> [? <Param>]
<Param> = <Key>=<Value>
For example, the following URL will result in a request to the module called "Compute" with parametersfor X and Y axis values:
http://www.domain.com/modules/compute?x=100&y=200
The URL and any parameters included in the URL are specified in the request's RequestURL andRequestURLParams properties, respectively. The RequestURLParams property, however, is in its raw form.An easier way to examine the URL parameters would be to use the RequestParams property. TheRequestParams property is a TStrings instance of key-value pairs that represent all URL parameters. To usethe above example, the following values would be present in the RequestParams property for thespecified URL:
x=100y=200
Reading Request Cookies
Cookies are simple textual data that is persisted in the client across connections to the web server. Anycookies that apply to the request URL will automatically be sent by the client and will be available in theTServerRequest RequestCookies property. The RequestCookies property is a TStrings instance of key-valuepairs that represent all applicable cookies. See the Sending a Response section below for information onhow to set cookies in responses.
Authenticating a Request
The Elevate Web Builder Web Server supports two different forms of automated authentication:
Custom HTTP headers
URL Parameters
Custom HTTP Authentication Headers
The custom HTTP authentication headers must be sent to the web server as follows:
X-EWBUser: <UserName>X-EWBPassword: <Password>
Getting Started
Page 6
![Page 9: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/9.jpg)
URL Authentication Parameters
The URL authentication parameters must be sent to the web server as follows:
user=<UserName>&password=<Password>
Note By default, all database requests sent by an Elevate Web Builder application use custom HTTPauthentication headers. However, database requests can also be configured to use URL parametersfor authentication.
If the Elevate Web Builder application, or any client application, sends authentication information usingeither method described above, then the Elevate Web Builder Web Server will automatically populate theincoming TServerRequest RequestUser and RequestPassword properties with the authenticationinformation provided by the client application.
In order to handle verifying the provided authentication information, you can call the AuthenticateUsermethod. This method call will trigger the OnAuthenticateUser event, and if the event handler sets theResult parameter to True, then the module will populate the UserName and Password properties with theauthentication information.
Reading Request Content
POST requests are normally accompanied by content that is submitted as part of the request. TheRequestContentType, RequestContentLength, and RequestContent properties of the request contain thecontent type, content length, and actual content.
HTML Form Submittals
When an HTML form is submitted to the URL for the module, the form data may be sent over using one oftwo formats. Depending upon value of the RequestContentType property, the web server willautomatically perform some pre-processing of the incoming conent in the following ways:
application/x-www-form-urlencoded
This is the default encoding for form submittals, and common for form submittals that do notinclude file uploads. The web server will pre-parse all textual form variables and they are accessiblevia the RequestContentParams property as key-value pairs
Getting Started
Page 7
![Page 10: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/10.jpg)
multipart/form-data
If a form submittal includes one or more file uploads, then the browser will use a special MIMEencoding. The web server will pre-parse all textual form variables as with the default encoding, butwill also include any file content in the RequestMIMEParts property, with each file in its ownTEWBMIMEPart instance. Each TEWBMimePart instance includes both Headers and Content. TheHeaders property contains MIME headers, which are formatted in the same fashion as HTTPheaders. These headers can be used to determine how to deal with the Content property, and themost useful are:
Header Description
Content-Transfer-Encoding This header identifies the encoding of the file contentcontained in the Content property. This is essential inknowing how to deal with the content.
Content-Disposition This header identifies the actual name of the file. This isuseful if the file content must be saved under its sourcename and then later retrieved using its file name.
Sending a Response
The web server doesn't automatically send a response to an HTTP request once the OnExecute eventhandler terminates, so it is important that you send a response from within the OnExecute event handler.You can use one of several methods to send a response to the client's request:
Getting Started
Page 8
![Page 11: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/11.jpg)
Method Description
SendContent Sends Unicode content as a UTF-8 string along with anoptional HTTP status code and message.
SendContentHeader Sends an HTTP status code and message in response to aHEAD request.
SendContentStream Sends content as a binary stream along with an optional HTTPstatus code and message.
SendCustomContent Sends Unicode or ANSI content with a specific disposition.The disposition is used to give the client an indication of howthe content should be saved, such as the file name for a file.
Note There are two SendCustomContent methods, one forUnicode strings and one for ANSI strings.
SendCustomContentHeader Sends a content type and disposition in response to a HEADrequest. The disposition is used to give the client anindication of how the content should be saved, such as thefile name for a file.
SendCustomContentStream Sends content as a binary stream with a specific disposition.The disposition is used to give the client an indication of howthe content should be saved, such as the file name for a file.
SendRedirect Sends the new location (URL) for a resource (if its location hasbeen changed) along with a optional Unicode content as aUTF-8 string, HTTP status code, and message.
SendError Sends a Unicode error message along with an HTTP status(error) code.
Warning Once one of the above methods is called, you should clean up any allocated resources and exit theOnExecute event handler. Not only is it important that you call one of the Send methods, it is alsoequally important that you do not call one of the above methods more than once, or more thanone method per request.
In an Elevate Web Builder module, there are defined constants that represent the common HTTP statuscodes, and you will find these constants in the ewbhttpcommon unit, which is distributed as a .dcu (Delphicompiled unit) with the Elevate Web Builder Modules installlation.
The constants are defined as follows:
HTTP_NONE = 0; HTTP_CONTINUE = 100; HTTP_OK = 200; HTTP_MOVED_PERMANENTLY = 301; HTTP_FOUND = 302;
Getting Started
Page 9
![Page 12: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/12.jpg)
HTTP_SEE_OTHER = 303; HTTP_NOT_MODIFIED = 304; HTTP_MOVED_TEMPORARILY = 307; HTTP_BAD_REQUEST = 400; HTTP_NOT_FOUND = 404; HTTP_NO_LENGTH = 411; HTTP_INTERNAL_ERROR = 500; HTTP_NOT_IMPLEMENTED = 501; HTTP_SERVICE_UNAVAILABLE = 503;
Setting Cookies
As indicated above, any cookies that are stored on the client and are applicable to the request URL can befound in the RequestCookies property. You can add or modify such cookies by assigning key-value pairsto the TServerRequest ResponseCookies or ResponseSessionCookies properties. The key is the name ofthe cookie, and the value is the value to assign to that cookie. To "delete" a cookie, simply set its value tonothing.
Note You must set any cookies before calling any of the TServerRequest Send* methods detailed above,or the cookies will not be set properly on the client.
There are three cookie attributes that are also important. Cookie attributes are specified after the value ofa cookie and are always prefixed by a semicolon.
Attribute Description
expires Specifies the date/time that the cookie expires as a GMTstring. To convert a TDateTime into a GMT string, use theTServerRequest DateTimeToGMTStr method. If you do notspecify an expiration attribute, then the web server willautomatically set the expires attribute as 1460 days from thecurrent date/time for all cookies specified in theResponseCookies property. The web server will not set theexpires attribute for any cookies specified in theResponseSessionCookies property, which means that they willautomatically not persist past the current client session. This isuseful for session IDs and other types of information that youdo not want to be present in a new or different client session.
domain Specifies the domain that the cookie applies to. If you do notspecify a domain attribute, then the web server willautomatically set the domain attribute to that of theconfigured domain for the web server. Please see the ElevateWeb Builder manual for more information on configuring theweb server domain.
path Specifies the path attribute that the cookie applies to. If youdo not specify a path attribute, then the web server willautomatically set the path attribute to a single forward slash,meaning that the cookie applies to all paths within thecookie's domain.
Getting Started
Page 10
![Page 13: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/13.jpg)
Getting Started
Page 11
![Page 14: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/14.jpg)
This page intentionally left blank
Component Reference
Page 12
![Page 15: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/15.jpg)
Chapter 2Component Reference
2.1 TEWBDatabaseAdapter Component
Unit: ewbdatasetadapter
Inherits From TComponent
The TEWBDatabaseAdapter component is used in conjunction with various TEWBDataSetAdaptercomponents to create and load JSON dataset columns and rows to/from generic TDataSet descendantcomponents, as well as commit transaction operations to one or more datasets. It is used with databasemodules that need to deal with data from a data source that isn't supported by Elevate Web Builder WebServer's automatic database handling or need to perform special processing/authentication for databaserequests.
Properties Methods Events
InTransaction AuthenticateUser OnAuthenticateUser
Password BuildDataSets OnCommit
UserName Commit OnGetDataSetAdapter
Create OnGetDataSets
GetDataSetAdapter OnRollback
GetDataSets OnStartTransaction
HandleRequest
Component Reference
Page 13
![Page 16: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/16.jpg)
TEWBDatabaseAdapter.InTransaction Property
property InTransaction: Boolean
Specifies whether the database adapter is currently processing a transaction request. This is useful whenyou wish to use different datasets, or dataset adapters, with transactions than with requests for columns,rows, or BLOB values. You can read this property in an OnGetDataSetAdapter event handler in order toperform this type of conditional processing.
Component Reference
Page 14
![Page 17: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/17.jpg)
TEWBDatabaseAdapter.Password Property
property Password: String
Specifies the authenticated password included with a server request, if any was included. Authenticationinformation can be passed to a web server module from an Elevate Web Builder application via HTTPheaders or via HTTP URL parameters.
Note This property will be blank until the HandleRequest method is called, and the server request hasbeen successfully authenticated.
Component Reference
Page 15
![Page 18: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/18.jpg)
TEWBDatabaseAdapter.UserName Property
property UserName: String
Specifies the authenticated user name included with a server request, if any was included. Authenticationinformation can be passed to a web server module from an Elevate Web Builder application via HTTPheaders or via HTTP URL parameters.
Note This property will be blank until the HandleRequest method is called, and the server request hasbeen successfully authenticated.
Component Reference
Page 16
![Page 19: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/19.jpg)
TEWBDatabaseAdapter.AuthenticateUser Method
function AuthenticateUser(Request: TEWBServerRequest): Boolean
Use this method to trigger the OnAuthenticateUser event and authenticate the user name/passwordinformation provided with the Request parameter. Authentication information can be passed to a webserver module from an Elevate Web Builder application via HTTP headers or via HTTP URL parameters, andthis method will automatically handle the retrieving the authentication information from the request andpassing it to the OnAuthenticateUser event handler.
Note This method will only be automatically called when the HandleRequest method is called. In anyother situation, you will need to manually call this method to authenticate a request.
Component Reference
Page 17
![Page 20: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/20.jpg)
TEWBDatabaseAdapter.BuildDataSets Method
function BuildDataSets: String
Use this method to build a JSON string containing all of the datasets for the database.
Note This method will be automatically called when the HandleRequest method is called, so younormally will not need to call this method directly.
Component Reference
Page 18
![Page 21: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/21.jpg)
TEWBDatabaseAdapter.Commit Method
procedure Commit(const Operations: String)
procedure Commit(const Operations: AnsiString)
Use this method to commit a transaction received from an Elevate Web Builder client application into adatabase.
This method will automatically call the GetDataSetAdapter method as necessary to get access to thedataset adapters required to perform the insert, update, and delete row operations in the transaction. If adataset adapter cannot be accessed for a particular dataset, then an exception will be raised and thetransaction commit will fail.
Please see the JSON Reference section in the Elevate Web Builder manual that is included with theElevate Web Builder IDE for more information on the structure of the JSON used with databasetransactions.
Note This method will only be automatically called when the HandleRequest method is called. In anyother situation, you will need to manually call this method to commit transactions.
Component Reference
Page 19
![Page 22: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/22.jpg)
TEWBDatabaseAdapter.Create Method
constructor Create(AOwner: TComponent)
Call the constructor to create an instance of the TEWBDatabaseAdapter component.
Component Reference
Page 20
![Page 23: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/23.jpg)
TEWBDatabaseAdapter.GetDataSetAdapter Method
function GetDataSetAdapter(const DataSetName: String): TEWBDataSetAdapter
Use this method to trigger the OnGetDataSetAdapter event and retrieve the dataset adapter instance forthe specified dataset name.
Note This method will only be automatically called when the HandleRequest method is called. In anyother situation, you will need to manually call this method to retrieve a dataset adapter for adataset.
Component Reference
Page 21
![Page 24: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/24.jpg)
TEWBDatabaseAdapter.GetDataSets Method
procedure GetDataSets(DataSets: TStrings)
Use this method to trigger the OnGetDataSets event and retrieve the available dataset names for themodule.
Note This method will only be automatically called when the HandleRequest method is called. In anyother situation, you will need to manually call this method to retrieve a list of available datasetnames.
Component Reference
Page 22
![Page 25: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/25.jpg)
TEWBDatabaseAdapter.HandleRequest Method
procedure HandleRequest(Request: TEWBServerRequest)
Use this method to automatically handle a database request from an Elevate Web Builder clientapplication. Database requests use a standard request format in Elevate Web Builder. Unless you're usinga different request format, you can use this method without having to worry about the details of thedatabase request URLs, parameters, and authentication.
This method will automatically call the AuthenticateUser method first before attempting to perform anyother functionality. If the AuthenticateUser method returns True, then the database adapter will continueprocessing the database request, triggering the GetDataSets, GetDataSetAdapter, and Commit methods asnecessary.
Please see the JSON Reference section in the Elevate Web Builder manual that is included with theElevate Web Builder IDE for more information on the structure of the JSON used with databases.
Component Reference
Page 23
![Page 26: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/26.jpg)
TEWBDatabaseAdapter.OnAuthenticateUser Event
property OnAuthenticateUser: TEWBAuthenticationEvent
This event is triggered before the database adapter handles any dataset request and provides anopportunity for the developer to authenticate the request based upon the authentication informationprovided with the request.
Component Reference
Page 24
![Page 27: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/27.jpg)
TEWBDatabaseAdapter.OnCommit Event
property OnCommit: TNotifyEvent
This event is triggered when the database adapter needs to commit a transaction. The developer candefine an event handler for this event in order to handle committing a transaction using the database-specific component for handling transactions.
Component Reference
Page 25
![Page 28: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/28.jpg)
TEWBDatabaseAdapter.OnGetDataSetAdapter Event
property OnGetDataSetAdapter: TEWBGetDataSetAdapterEvent
This event is triggered when the GetDataSetAdapter method is called.
Warning If the Adapter variable parameter is not assigned a value, then an exception can occur duringtransaction commit operations that reference the specified dataset name.
Component Reference
Page 26
![Page 29: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/29.jpg)
TEWBDatabaseAdapter.OnGetDataSets Event
property OnGetDataSets: TEWBGetDataSetsEvent
This event is triggered when a list request is handled by the database adapter. Usage of this event iscompletely optional, but the event is useful for allowing client applications to enumerate the availabledatasets.
Component Reference
Page 27
![Page 30: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/30.jpg)
TEWBDatabaseAdapter.OnRollback Event
property OnRollback: TNotifyEvent
This event is triggered when the database adapter needs to roll back a transaction. The developer candefine an event handler for this event in order to handle rolling back a transaction using the database-specific component for handling transactions.
Component Reference
Page 28
![Page 31: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/31.jpg)
TEWBDatabaseAdapter.OnStartTransaction Event
property OnStartTransaction: TNotifyEvent
This event is triggered when the database adapter needs to start a transaction. The developer can definean event handler for this event in order to handle starting a transaction using the database-specificcomponent for handling transactions.
Component Reference
Page 29
![Page 32: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/32.jpg)
2.2 TEWBDataSetAdapter Component
Unit: ewbdatasetadapter
Inherits From TComponent
The TEWBDataSetAdapter component is used in conjunction with the TEWBDatabaseAdapter componentto create and load JSON dataset columns and rows to/from generic TDataSet descendant components, aswell as commit transaction operations to one or more datasets. It is used with database modules thatneed to deal with data from a data source that isn't supported by the Elevate Web Builder Web Server'sautomatic database handling or need to perform special processing/authentication for database requests.
Properties Methods Events
DataSet BuildColumns OnFilterRows
KeyCaseInsensitive BuildLoad OnInitialize
KeyFields BuildRows
LocalizeDateTimeColumns Create
NumKeyFields FilterRows
GetLoadContentType
Initialize
Component Reference
Page 30
![Page 33: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/33.jpg)
TEWBDataSetAdapter.DataSet Property
property DataSet: TDataSet
Specifies the TDataSet-descendant component to use for the dataset adapter.
Note The dataset must be capable of uniquely identifying rows using a primary key or some othermethod in order to work properly when inserting, updating, or deleting rows during transactions.
Component Reference
Page 31
![Page 34: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/34.jpg)
TEWBDataSetAdapter.KeyCaseInsensitive Property
property KeyCaseInsensitive: Boolean
Specifies whether the key fields for the dataset are case-insensitive.
Note This property can be set directly at any time, but it will automatically be cleared if the Initializemethod is called.
Component Reference
Page 32
![Page 35: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/35.jpg)
TEWBDataSetAdapter.KeyFields Property
property KeyFields: String
Specifies the key fields for the dataset, with each key field separated by a semicolon (;).
Note This property can be set directly at any time, but it will automatically be cleared if the Initializemethod is called.
Component Reference
Page 33
![Page 36: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/36.jpg)
TEWBDataSetAdapter.LocalizeDateTimeColumns Property
property LocalizeDateTimeColumns: Boolean
Specifies whether the adapter will localize date/time column values in the dataset when converting themto/from strings. The default value is False.
Component Reference
Page 34
![Page 37: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/37.jpg)
TEWBDataSetAdapter.NumKeyFields Property
property NumKeyFields: Integer
Specifies the number of key fields for the dataset.
Note This property can be set directly at any time, but it will automatically be cleared if the Initializemethod is called.
Component Reference
Page 35
![Page 38: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/38.jpg)
TEWBDataSetAdapter.BuildColumns Method
function BuildColumns: String
Use this method to build a JSON string containing all of the column definitions for the dataset specified inthe DataSet property.
Please see the JSON Reference section in the Elevate Web Builder manual that is included with theElevate Web Builder IDE for more information on the structure of the JSON used with dataset columns.
Note This method will be automatically called when the HandleRequest method is called, so younormally will not need to call this method directly.
Component Reference
Page 36
![Page 39: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/39.jpg)
TEWBDataSetAdapter.BuildLoad Method
function BuildLoad(const Column: String; const RowKey: String): AnsiString
Use this method to build an ANSI string containing the value for the specified BLOB field in the datasetspecified in the DataSet property. The RowKey parameter is a semicolon-delimited (;) list of key values thatuniquely identify the row that contains the desired BLOB field data.
Note This method will be automatically called when the HandleRequest method is called, so younormally will not need to call this method directly.
Component Reference
Page 37
![Page 40: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/40.jpg)
TEWBDataSetAdapter.BuildRows Method
function BuildRows(Params: TStrings=nil; const User: String=''; const Password: String=''): String
Use this method to build a JSON string containing all of the rows for the dataset specified in the DataSetproperty.
The Params parameter is used to include any additional dataset filtering parameters with any BLOB loadURLs that are included with the JSON row data built by this method. This ensures that any BLOB loads areexecuted using the same filtering parameters that were used to build the rows.
The User and Password parameters are used to include user and password authentication parameters withany BLOB load URLs that are included with the JSON row data built by this method. This ensures that anyBLOB loads are authenticated using the same authentication information that was used to build the rows.
Please see the JSON Reference section in the Elevate Web Builder manual that is included with theElevate Web Builder IDE for more information on the structure of the JSON used with dataset rows.
Note This method will be automatically called when the HandleRequest method is called, so younormally will not need to call this method directly.
Component Reference
Page 38
![Page 41: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/41.jpg)
TEWBDataSetAdapter.Create Method
constructor Create(AOwner: TComponent)
Call the constructor to create an instance of the TEWBDataSetAdapter component.
Component Reference
Page 39
![Page 42: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/42.jpg)
TEWBDataSetAdapter.FilterRows Method
procedure FilterRows(Request: TEWBServerRequest)
Use this method to filter a dataset based upon the parameters available in the Request parameter.
Note This method will be automatically called when the HandleRequest method is called, so younormally will not need to call this method directly.
Component Reference
Page 40
![Page 43: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/43.jpg)
TEWBDataSetAdapter.GetLoadContentType Method
function GetLoadContentType(const Column: String; const RowKey: String): String
Use this method to retrieve the MIME type for the specified BLOB field in the dataset specified in theDataSet property. The RowKey parameter is a semicolon-delimited (;) list of key values that uniquelyidentify the row that contains the desired BLOB field.
This method is a convenient way of associating MIME types with BLOB fields in a dataset. When thismethod is called, the TEWBDataSetAdapter will look for a field in the dataset with the name of:
<BLOB Field Name>_ContentType
and return its value as the result. If a field does not exist with that name, then the result will be a blankstring.
Note This method will be automatically called when the HandleRequest method is called, so younormally will not need to call this method directly.
Component Reference
Page 41
![Page 44: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/44.jpg)
TEWBDataSetAdapter.Initialize Method
procedure Initialize
Use this method to initialize a dataset's key field information. When this method is called, theNumKeyFields, KeyFields, and KeyCaseInsensitive properties are cleared and the OnInitialize event istriggered.
Component Reference
Page 42
![Page 45: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/45.jpg)
TEWBDataSetAdapter.OnFilterRows Event
property OnFilterRows: TEWBFilterDataSetRowsEvent
This event is triggered when the FilterRows method is called and provides an opportunity for thedeveloper to filter the rows in the dataset according to parameters passed in via the dataset request.
Component Reference
Page 43
![Page 46: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/46.jpg)
TEWBDataSetAdapter.OnInitialize Event
property OnInitialize: TEWBInitializeDataSetAdapterEvent
This event is triggered when the Initialize method is called, and gives the developer an opportunity toinitialize the NumKeyFields, KeyFields, and KeyCaseInsensitive properties of the dataset adapter.
Component Reference
Page 44
![Page 47: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/47.jpg)
2.3 TEWBJSONReader Component
Unit: ewbhttpcommon
Inherits From TObject
The TEWBJSONReader class is used to load class instance properties from JSON strings, and can be usedas a general-purpose JSON reader in your applications.
When a TEWBJSONReader instance is created, the constructor allows you to specify the date-time formatto use when reading date-time properties/values.
Properties Methods Events
Level BeginArray
RootObject BeginObject
Create
EndArray
EndObject
EndOfArray
EndOfObject
GetPropertyName
Initialize
IsArray
IsNull
IsObject
MoreArrayElements
MoreProperties
ReadBoolean
ReadDateTime
ReadFloat
ReadInteger
ReadString
SkipArrayElement
SkipProperty
SkipPropertyName
SkipPropertySeparator
SkipPropertyValue
Component Reference
Page 45
![Page 48: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/48.jpg)
Component Reference
Page 46
![Page 49: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/49.jpg)
TEWBJSONReader.Level Property
property Level: Integer
Indicates the current nesting level for any JSON objects and/or arrays. Whenever the TEWBJSONReaderclass begins to read an object or array using the BeginObject or BeginArray methods, the nesting level isincremented. Whenever the EndObject or EndArray methods are called, the nesting level is decremented.
Component Reference
Page 47
![Page 50: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/50.jpg)
TEWBJSONReader.RootObject Property
property RootObject: TComponent
Specifies an optional root object to use with the reader. The root object can be used by the developer totrack which container object instance is being loaded. The default value is nil.
Component Reference
Page 48
![Page 51: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/51.jpg)
TEWBJSONReader.BeginArray Method
procedure BeginArray
Use this method to begin reading an array. If the current token in the incoming JSON string is not a leftbracket ([), an exception will be raised.
Component Reference
Page 49
![Page 52: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/52.jpg)
TEWBJSONReader.BeginObject Method
procedure BeginObject
Use this method to begin reading an object. If the current token in the incoming JSON string is not a leftbrace ({), an exception will be raised.
Component Reference
Page 50
![Page 53: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/53.jpg)
TEWBJSONReader.Create Method
constructor Create(ADateTimeFormat: TEWBJSONDateTimeFormat=dtfRaw)
Use this method to create a new instance of the TJSONReader class. The optional ADateTimeFormatparameter indicates whether date and time values should be handled as an ISO 8601 date and time stringvalue, or as a raw Unix date and time integer value (the number of milliseconds since midnight, January 1,1970).
Component Reference
Page 51
![Page 54: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/54.jpg)
TEWBJSONReader.EndArray Method
procedure EndArray
Use this method to end reading an array. If the current token in the incoming JSON string is not a rightbracket (]), an exception will be raised.
Component Reference
Page 52
![Page 55: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/55.jpg)
TEWBJSONReader.EndObject Method
procedure EndObject
Use this method to end reading an object. If the current token in the incoming JSON string is not a rightbrace (}), an exception will be raised.
Component Reference
Page 53
![Page 56: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/56.jpg)
TEWBJSONReader.EndOfArray Method
function EndOfArray: Boolean
Use this method to determine if the current token in the incoming JSON string is a right bracket (]).
Component Reference
Page 54
![Page 57: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/57.jpg)
TEWBJSONReader.EndOfObject Method
function EndOfObject: Boolean
Use this method to determine if the current token in the incoming JSON string is a right brace (}).
Component Reference
Page 55
![Page 58: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/58.jpg)
TEWBJSONReader.GetPropertyName Method
function GetPropertyName: String
Use this method to read a property name, without any enclosing double-quote (") characters (ifapplicable).
Component Reference
Page 56
![Page 59: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/59.jpg)
TEWBJSONReader.Initialize Method
procedure Initialize(const Value: String)
Use this method to initialize the reader with a JSON string to read.
Component Reference
Page 57
![Page 60: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/60.jpg)
TEWBJSONReader.IsArray Method
function IsArray: Boolean
Use this method to determine if the current token in the incoming JSON string is a left bracket ([).
Component Reference
Page 58
![Page 61: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/61.jpg)
TEWBJSONReader.IsNull Method
function IsNull: Boolean
Use this method to determine if the current token in the incoming JSON string is a null literal.
Component Reference
Page 59
![Page 62: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/62.jpg)
TEWBJSONReader.IsObject Method
function IsObject: Boolean
Use this method to determine if the current token in the incoming JSON string is a left brace ({).
Component Reference
Page 60
![Page 63: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/63.jpg)
TEWBJSONReader.MoreArrayElements Method
function MoreArrayElements: Boolean
Use this method to determine if the current token in the incoming JSON string is a comma (,).
Component Reference
Page 61
![Page 64: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/64.jpg)
TEWBJSONReader.MoreProperties Method
function MoreProperties: Boolean
Use this method to determine if the current token in the incoming JSON string is a comma (,).
Component Reference
Page 62
![Page 65: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/65.jpg)
TEWBJSONReader.ReadBoolean Method
function ReadBoolean: Boolean
Use this method to read a boolean value. If the current token in the incoming JSON string is not a validJSON boolean literal (true, false), an exception will be raised.
Component Reference
Page 63
![Page 66: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/66.jpg)
TEWBJSONReader.ReadDateTime Method
function ReadDateTime: TDateTime
Use this method to read a date-time value. How a date-time value is read is controlled by theTEWBJSONDateTimeFormat parameter in the TEWBJSONReader class constructor.
Component Reference
Page 64
![Page 67: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/67.jpg)
TEWBJSONReader.ReadFloat Method
function ReadFloat: Double
Use this method to read a float value. If the current token in the incoming JSON string is not a valid JSONfloat or integer literal, an exception will be raised.
Component Reference
Page 65
![Page 68: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/68.jpg)
TEWBJSONReader.ReadInteger Method
function ReadInteger: Integer
Use this method to read an integer value. If the current token in the incoming JSON string is not a validJSON integer literal, an exception will be raised.
Component Reference
Page 66
![Page 69: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/69.jpg)
TEWBJSONReader.ReadString Method
function ReadString: String
Use this method to read a string value, without any enclosing double-quote (") characters. If the currenttoken in the incoming JSON string is not a valid JSON string literal, an exception will be raised.
Component Reference
Page 67
![Page 70: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/70.jpg)
TEWBJSONReader.SkipArrayElement Method
procedure SkipArrayElement
Use this method to skip over a JSON array element.
Component Reference
Page 68
![Page 71: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/71.jpg)
TEWBJSONReader.SkipProperty Method
procedure SkipProperty
Use this method to skip over a JSON object property.
Component Reference
Page 69
![Page 72: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/72.jpg)
TEWBJSONReader.SkipPropertyName Method
procedure SkipPropertyName
Use this method to skip over a JSON object property name.
Component Reference
Page 70
![Page 73: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/73.jpg)
TEWBJSONReader.SkipPropertySeparator Method
procedure SkipPropertySeparator
Use this method to skip over a JSON object property separator (:).
Component Reference
Page 71
![Page 74: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/74.jpg)
TEWBJSONReader.SkipPropertyValue Method
procedure SkipPropertyValue
Use this method to skip over a JSON object property value.
Component Reference
Page 72
![Page 75: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/75.jpg)
2.4 TEWBJSONWriter Component
Unit: ewbhttpcommon
Inherits From TObject
The TEWBJSONWriter class is used to save class instance properties to JSON strings, and can be used as ageneral-purpose JSON writer in your applications.
When a TEWBJSONWriter instance is created, the constructor allows you to specify:
The date-time format to use when writing date-time properties.
The number of spaces to use per indentation level, if the output is not compressed.
Whether to include line feeds in the JSON output, if the output is not compressed.
Whether to compress all whitespace in the JSON output. Compressing the whitespace removes anyunnecessary whitespace in order to keep the size of the JSON output to a minimum.
Component Reference
Page 73
![Page 76: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/76.jpg)
Properties Methods Events
Output BeginArray
BeginNewLine
BeginObject
BooleanProperty
BooleanValue
CancelNewLine
Create
DateTimeProperty
DateTimeValue
DecIndent
EndArray
EndObject
FloatProperty
FloatValue
IncIndent
Initialize
IntegerProperty
IntegerValue
Literal
NewLine
NullProperty
NullValue
ObjectProperty
PropertyName
Separator
StringProperty
StringValue
Whitespace
Component Reference
Page 74
![Page 77: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/77.jpg)
TEWBJSONWriter.Output Property
property Output: String
Indicates the current JSON output.
Component Reference
Page 75
![Page 78: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/78.jpg)
TEWBJSONWriter.BeginArray Method
procedure BeginArray(HasElements: Boolean)
Use this method to begin writing a new array.
Component Reference
Page 76
![Page 79: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/79.jpg)
TEWBJSONWriter.BeginNewLine Method
procedure BeginNewLine
Use this method to set a flag requesting that the next property should be written on a new line.
Note New lines are not used if the JSON output is being compressed.
Component Reference
Page 77
![Page 80: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/80.jpg)
TEWBJSONWriter.BeginObject Method
procedure BeginObject
Use this method to begin writing a new object.
Component Reference
Page 78
![Page 81: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/81.jpg)
TEWBJSONWriter.BooleanProperty Method
procedure BooleanProperty(const Name: String; Value: Boolean)
procedure BooleanProperty(const Name: String; Value: Boolean; DefaultValue: Boolean)
Use this method to write a boolean property.
Component Reference
Page 79
![Page 82: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/82.jpg)
TEWBJSONWriter.BooleanValue Method
procedure BooleanValue(Value: Boolean)
Use this method to write a boolean value.
Component Reference
Page 80
![Page 83: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/83.jpg)
TEWBJSONWriter.CancelNewLine Method
procedure CancelNewLine
Use this method to cancel a new line started via the NewLine method. This is useful if a new line is startedfor a property, but the property cannot be written for some reason.
Component Reference
Page 81
![Page 84: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/84.jpg)
TEWBJSONWriter.Create Method
constructor Create(ADateTimeFormat: TEWBJSONDateTimeFormat=dtfRaw; AIndentSpaces: Integer=3; AIncludeLineFeeds: Boolean=True; ACompressWhitespace: Boolean=False)
Use this method to create a new instance of the TEWBJSONWriter class. The optional ADateTimeFormatparameter indicates whether date and time values should be output as an ISO 8601 date and time stringvalue, or as a raw Unix date and time integer value (the number of milliseconds since midnight, January 1,1970). The optional AIndentSpaces parameter indicates how many spaces to use for indentation in theoutput, the optional AIncludeLineFeeds parameter indicates whether to include line feeds (CRLF) in theoutput, and the optional ACompressWhitespace parameter indicates whether any whitespace should becompressed (removed) from the output.
Component Reference
Page 82
![Page 85: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/85.jpg)
TEWBJSONWriter.DateTimeProperty Method
procedure DateTimeProperty(const Name: String; Value: TDateTime)
procedure DateTimeProperty(const Name: String; Value: TDateTime; DefaultValue: TDateTime)
Use this method to write a date-time property. How a date-time property is written is controlled by thefirst TDateTimeFormat parameter in the TEWBJSONWriter class constructor.
Component Reference
Page 83
![Page 86: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/86.jpg)
TEWBJSONWriter.DateTimeValue Method
procedure DateTimeValue(Value: TDateTime)
Use this method to write a date-time value. How a date-time value is written is controlled by the firstTDateTimeFormat parameter in the TEWBJSONWriter class constructor.
Component Reference
Page 84
![Page 87: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/87.jpg)
TEWBJSONWriter.DecIndent Method
procedure DecIndent
Decrement the indentation level for the output.
Note Indentation levels are not used if the JSON output is being compressed.
Component Reference
Page 85
![Page 88: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/88.jpg)
TEWBJSONWriter.EndArray Method
procedure EndArray(HasElements: Boolean)
Use this method to end writing an array.
Component Reference
Page 86
![Page 89: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/89.jpg)
TEWBJSONWriter.EndObject Method
procedure EndObject
Use this method to end writing an object.
Component Reference
Page 87
![Page 90: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/90.jpg)
TEWBJSONWriter.FloatProperty Method
procedure FloatProperty(const Name: String; Value: Double)
procedure FloatProperty(const Name: String; Value: Double; DefaultValue: Double)
Use this method to write a float property.
Component Reference
Page 88
![Page 91: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/91.jpg)
TEWBJSONWriter.FloatValue Method
procedure FloatValue(Value: Double)
Use this method to write a float value.
Component Reference
Page 89
![Page 92: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/92.jpg)
TEWBJSONWriter.IncIndent Method
procedure IncIndent
Increment the indentation level for the JSON output.
Note Indentation levels are not used if the JSON output is being compressed.
Component Reference
Page 90
![Page 93: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/93.jpg)
TEWBJSONWriter.Initialize Method
procedure Initialize
Use this method to initialize the writer so that the Output property is blank.
Component Reference
Page 91
![Page 94: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/94.jpg)
TEWBJSONWriter.IntegerProperty Method
procedure IntegerProperty(const Name: String; Value: Int64)
procedure IntegerProperty(const Name: String; Value: Int64; DefaultValue: Int64)
Use this method to write an integer property.
Component Reference
Page 92
![Page 95: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/95.jpg)
TEWBJSONWriter.IntegerValue Method
procedure IntegerValue(Value: Int64)
Use this method to write an integer value.
Component Reference
Page 93
![Page 96: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/96.jpg)
TEWBJSONWriter.Literal Method
procedure Literal(const Value: String)
Use this method to write a literal.
Component Reference
Page 94
![Page 97: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/97.jpg)
TEWBJSONWriter.NewLine Method
procedure NewLine
Use this method to write a new line (CRLF).
Note New lines are not written if the JSON output is being compressed, or if the writer was created withthe new line option turned off.
Component Reference
Page 95
![Page 98: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/98.jpg)
TEWBJSONWriter.NullProperty Method
procedure NullProperty(const Name: String)
Use this method to write a null property.
Component Reference
Page 96
![Page 99: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/99.jpg)
TEWBJSONWriter.NullValue Method
procedure NullValue
Use this method to write a null value.
Component Reference
Page 97
![Page 100: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/100.jpg)
TEWBJSONWriter.ObjectProperty Method
procedure ObjectProperty(const Name: String)
Use this method to write an object property's name using the PropertyName method.
Component Reference
Page 98
![Page 101: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/101.jpg)
TEWBJSONWriter.PropertyName Method
procedure PropertyName(const Name: String)
Use this method to write a property name.
Component Reference
Page 99
![Page 102: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/102.jpg)
TEWBJSONWriter.Separator Method
procedure Separator
Use this method to write a separator (,).
Component Reference
Page 100
![Page 103: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/103.jpg)
TEWBJSONWriter.StringProperty Method
procedure StringProperty(const Name: String; const Value: String)
procedure StringProperty(const Name: String; const Value: String; const DefaultValue: String)
Use this method to write a string property.
Component Reference
Page 101
![Page 104: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/104.jpg)
TEWBJSONWriter.StringValue Method
procedure StringValue(const Value: String)
Use this method to write a string value.
Component Reference
Page 102
![Page 105: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/105.jpg)
TEWBJSONWriter.Whitespace Method
procedure Whitespace
Use this method to write a space ( ).
Note Whitespace is not written if the JSON output is being compressed.
Component Reference
Page 103
![Page 106: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/106.jpg)
2.5 TEWBMIMEPart Component
Unit: ewbhttpcommon
Inherits From TObject
The TEWBMimePart object is used to represent a single MIME part in multi-part MIME-encoded contentincluded with a web server request. Multi-part MIME content is normally used with HTML form submittalsthat include file uploads.
Properties Methods Events
Content Create
Disposition Save
Encoding
FileName
Headers
Component Reference
Page 104
![Page 107: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/107.jpg)
TEWBMIMEPart.Content Property
property Content: AnsiString
Specifies the content of the MIME part encoded using the encoding specified in the Encodingproperty.
Component Reference
Page 105
![Page 108: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/108.jpg)
TEWBMIMEPart.Disposition Property
property Disposition: String
Specifies the disposition for the MIME content specified in the Content property. For HTML formsubmittals, this property will always be 'form-data'.
Component Reference
Page 106
![Page 109: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/109.jpg)
TEWBMIMEPart.Encoding Property
property Encoding: String
Specifies the encoding for the MIME content specified in the Content property.
Component Reference
Page 107
![Page 110: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/110.jpg)
TEWBMIMEPart.FileName Property
property FileName: String
Specifies the file name for the MIME content specified in the Content property.
Component Reference
Page 108
![Page 111: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/111.jpg)
TEWBMIMEPart.Headers Property
property Headers: TStrings
Specifies the headers for the MIME part. Each header has the format:
<Header>: <Value>[;<HeaderAttribute>=<Value>]
Component Reference
Page 109
![Page 112: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/112.jpg)
TEWBMIMEPart.Create Method
constructor Create(Owner: TEWBMIMEParts)
Use this method to create a new instance of the TEWBMIMEPart class. The Owner parameter indicates theMIME parts instance that will own and manage the MIME part.
Component Reference
Page 110
![Page 113: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/113.jpg)
TEWBMIMEPart.Save Method
procedure Save(Stream: TStream)
Use this method to save the content specified by the Content property to a stream.
Component Reference
Page 111
![Page 114: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/114.jpg)
2.6 TEWBMIMEParts Component
Unit: ewbhttpcommon
Inherits From TObject
The TEWBMimeParts object is used to represent all MIME parts in multi-part MIME-encoded contentincluded with a web server request. Multi-part MIME content is normally used with HTML form submittalsthat include file uploads.
Properties Methods Events
Count Create
Items
Component Reference
Page 112
![Page 115: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/115.jpg)
TEWBMIMEParts.Count Property
property Count: Integer
Indicates the number of MIME parts present in the request.
Note This number does not include form values that aren't file attachments since they are automaticallymoved to the TEWBServerRequest RequestContentParams property as key-value pairs in order tomake access to such values equivalent to requests that aren't MIME-encoded.
Component Reference
Page 113
![Page 116: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/116.jpg)
TEWBMIMEParts.Items Property
property Items[Index: Integer]: TEWBMIMEPart
Provides access to the MIME parts present in the request by ordinal index.
Note Form values that aren't file attachments are not included here since they are automatically movedto the TEWBServerRequest RequestContentParams property as key-value pairs in order to makeaccess to such values equivalent to requests that aren't MIME-encoded.
Component Reference
Page 114
![Page 117: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/117.jpg)
TEWBMIMEParts.Create Method
constructor Create
Use this method to create a new instance of the TEWBMIMEParts class.
Component Reference
Page 115
![Page 118: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/118.jpg)
2.7 TEWBModule Component
Unit: ewbhttpmodule
Inherits From TDataModule
The TEWBModule component represents an instance of a module in the web server. The web serverautomatically creates a new instance of a module for every executing thread that references the module inthe URL for a new request and fires the OnExecute event when the new request is handled by the thread.This means that all code in any OnExecute event handler must be completely thread-safe.
Warning All modules in the web server run in-process, so a fatal error such as a memory overwrite due toimproper threading code in a module could cause the server to fail.
Properties Methods Events
Password AuthenticateUser OnAuthenticateUser
UserName Create OnExecute
Component Reference
Page 116
![Page 119: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/119.jpg)
TEWBModule.Password Property
property Password: String
Specifies the authenticated password included with a server request, if any was included. Authenticationinformation can be passed to a web server module from an Elevate Web Builder application via HTTPheaders or via HTTP URL parameters.
Note This property will be blank until the server request has been successfully authenticated.
Component Reference
Page 117
![Page 120: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/120.jpg)
TEWBModule.UserName Property
property UserName: String
Specifies the authenticed user name included with a server request, if any was included. Authenticationinformation can be passed to a web server module from an Elevate Web Builder application via HTTPheaders or via HTTP URL parameters.
Note This property will be blank until the server request has been successfully authenticated.
Component Reference
Page 118
![Page 121: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/121.jpg)
TEWBModule.AuthenticateUser Method
function AuthenticateUser(Request: TEWBServerRequest): Boolean
Use this method to trigger the OnAuthenticateUser event and authenticate the user name/passwordinformation provided with the Request parameter. Authentication information can be passed to a webserver module from an Elevate Web Builder application via HTTP headers or via HTTP URL parameters, andthis method will automatically handle the retrieving the authentication information from the request andpassing it to the OnAuthenticateUser event handler.
Component Reference
Page 119
![Page 122: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/122.jpg)
TEWBModule.Create Method
constructor Create(AOwner: TComponent)
Use this method to create a new instance of the TEWBModule class. The AOwner parameter indicates thecomponent instance that will own and manage the module instance.
Component Reference
Page 120
![Page 123: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/123.jpg)
TEWBModule.OnAuthenticateUser Event
property OnAuthenticateUser: TEWBAuthenticationEvent
This event is triggered when the AuthenticateUser method is called and provides an opportunity for thedeveloper to authenticate the request based upon the authentication information provided with therequest.
Component Reference
Page 121
![Page 124: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/124.jpg)
TEWBModule.OnExecute Event
property OnExecute: TEWBModuleExecuteEvent
This event fires when a new request is received by the web server.
Component Reference
Page 122
![Page 125: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/125.jpg)
2.8 TEWBServerRequest Component
Unit: ewbhttpmodule
Inherits From TObject
The TEWBServerRequest object represents a web server request to a module and is passed as a parameterto the TEWBModule OnExecute event. You can use the RequestMethod property to determine what typeof request is being made, the RequestURLParams property to determine the parameters passed with theURL of the request, and the RequestContentType, RequestContentLength, RequestContent,RequestContentParams, RequestMIMEParts properties to access content that is included with the request:
When the RequestContentType property equals 'application/x-www-form-urlencoded', then thecontent is automatically parsed and moved into the RequestContentParams property.
When the RequestContentType property begins with 'multipart', then the content is automaticallyparsed and moved into the RequestMIMEParts property.
Component Reference
Page 123
![Page 126: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/126.jpg)
Properties Methods Events
RequestChrome ComputeHash
RequestClientAddress Create
RequestContent DateTimeToGMTStr
RequestContentLength DateTimeToMSecs
RequestContentParams GMTDateTimeToLocal
RequestContentType HeaderExists
RequestCookies LocalDateTimeToGMT
RequestFirefox MSecsToDateTime
RequestHeaders ParseHeader
RequestHost ParseHeaderAttribute
RequestIE SendContent
RequestMethod SendContentHeader
RequestMethodName SendContentStream
RequestMIMEParts SendCustomContent
RequestOpera SendCustomContentHeader
RequestParams SendCustomContentStream
RequestPassword SendError
RequestSafari SendRedirect
RequestSecure
RequestURL
RequestURLParams
RequestUser
RequestVersion
ResponseCookies
ResponseHeaders
ResponseSessionCookies
Component Reference
Page 124
![Page 127: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/127.jpg)
TEWBServerRequest.RequestChrome Property
property RequestChrome: Boolean
Indicates whether the client browser is Google Chrome.
Component Reference
Page 125
![Page 128: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/128.jpg)
TEWBServerRequest.RequestClientAddress Property
property RequestClientAddress: String
Indicates the client's IP address.
Component Reference
Page 126
![Page 129: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/129.jpg)
TEWBServerRequest.RequestContent Property
property RequestContent: AnsiString
Specifies any content sent with the request that is not 'multipart' or 'application/x-www-form-urlencoded'content, as indicated by the RequestContentType property.
Component Reference
Page 127
![Page 130: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/130.jpg)
TEWBServerRequest.RequestContentLength Property
property RequestContentLength: Integer
Specifies the length (in bytes) of the content in the RequestContent property.
Note For 'multipart' or 'application/x-www-form-urlencoded' content, as indicated by theRequestContentType property, this property may not accurately reflect the length of theRequestContent property since that type of content is automatically moved to other properties bythe web server.
Component Reference
Page 128
![Page 131: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/131.jpg)
TEWBServerRequest.RequestContentParams Property
property RequestContentParams: TStrings
For 'multipart' or 'application/x-www-form-urlencoded' content, as indicated by the RequestContentTypeproperty, this property will contain any form values submitted from an HTML form. The values arespecified as key-value pairs in the form:
<Key>=<Value>
Note For file uploads, the form value will simply be the form value name along with the name of the filebeing uploaded as the value. In order to access the actual uploaded file content, use theRequestMIMEParts property.
Component Reference
Page 129
![Page 132: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/132.jpg)
TEWBServerRequest.RequestContentType Property
property RequestContentType: String
Indicates the type and encoding of the content in the RequestContent property.
Component Reference
Page 130
![Page 133: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/133.jpg)
TEWBServerRequest.RequestCookies Property
property RequestCookies: TStrings
Specifies any cookies that are sent with the request by the client browser. The cookies are specified in key-value pairs in the form:
<Key>=<Value>
Component Reference
Page 131
![Page 134: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/134.jpg)
TEWBServerRequest.RequestFirefox Property
property RequestFirefox: Boolean
Indicates whether the client browser is Mozilla Firefox.
Component Reference
Page 132
![Page 135: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/135.jpg)
TEWBServerRequest.RequestHeaders Property
property RequestHeaders: TStrings
Specifies all of the raw HTTP headers included for the request.
Component Reference
Page 133
![Page 136: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/136.jpg)
TEWBServerRequest.RequestHost Property
property RequestHost: String
Indicates the value of the 'Host' header in the RequestHeaders property.
Component Reference
Page 134
![Page 137: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/137.jpg)
TEWBServerRequest.RequestIE Property
property RequestIE: Boolean
Indicates whether the client browser is Microsoft Internet Explorer.
Component Reference
Page 135
![Page 138: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/138.jpg)
TEWBServerRequest.RequestMethod Property
property RequestMethod: TEWBRequestMethod
Indicates the type of request.
Component Reference
Page 136
![Page 139: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/139.jpg)
TEWBServerRequest.RequestMethodName Property
property RequestMethodName: String
Indicates the type of request in its raw form.
Component Reference
Page 137
![Page 140: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/140.jpg)
TEWBServerRequest.RequestMIMEParts Property
property RequestMIMEParts: TEWBMIMEParts
For 'multipart' content, as indicated by the RequestContentType property, this property will contain anyMIME content that isnt't a textual form value.
Component Reference
Page 138
![Page 141: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/141.jpg)
TEWBServerRequest.RequestOpera Property
property RequestOpera: Boolean
Indicates whether the client browser is the Opera web browser.
Component Reference
Page 139
![Page 142: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/142.jpg)
TEWBServerRequest.RequestParams Property
property RequestParams: TStrings
Indicates the URL parameters for the request as key-value pairs in the form:
<Key>=<Value>
Component Reference
Page 140
![Page 143: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/143.jpg)
TEWBServerRequest.RequestPassword Property
property RequestPassword: String
Indicates the value of the 'X-EWB-Password' header in the RequestHeaders property. This header isnormally sent by Elevate Web Builder applications for dataset requests, but can be used for other types ofrequests as well.
Component Reference
Page 141
![Page 144: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/144.jpg)
TEWBServerRequest.RequestSafari Property
property RequestSafari: Boolean
Indicates whether the client browser is Apple Safari.
Component Reference
Page 142
![Page 145: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/145.jpg)
TEWBServerRequest.RequestSecure Property
property RequestSecure: Boolean
Indicates whether the request is secure (HTTPS) or not.
Note The web server does not currently support secure requests.
Component Reference
Page 143
![Page 146: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/146.jpg)
TEWBServerRequest.RequestURL Property
property RequestURL: String
Indicates the URL of the request without any URL parameters. The URL parameters can be retrieved via theRequestURLParams (raw) or RequestParams (key-value pairs) properties.
Component Reference
Page 144
![Page 147: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/147.jpg)
TEWBServerRequest.RequestURLParams Property
property RequestURLParams: String
Indicates the URL parameters for the request in their raw form. Use the RequestParams property to accessthe URL parameters as key-value pairs.
Component Reference
Page 145
![Page 148: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/148.jpg)
TEWBServerRequest.RequestUser Property
property RequestUser: String
Indicates the value of the 'X-EWB-User' header in the RequestHeaders property. This header is normallysent by Elevate Web Builder applications for dataset requests, but can be used for other types of requestsas well.
Component Reference
Page 146
![Page 149: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/149.jpg)
TEWBServerRequest.RequestVersion Property
property RequestVersion: String
Indicates the HTTP version in use by the client browser, and is usually 'HTTP/1.1'.
Component Reference
Page 147
![Page 150: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/150.jpg)
TEWBServerRequest.ResponseCookies Property
property ResponseCookies: TStrings
Use this property to specify any persistent cookies that you want to add/modify in the client browser.
Component Reference
Page 148
![Page 151: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/151.jpg)
TEWBServerRequest.ResponseHeaders Property
property ResponseHeaders: TStrings
Use this property to specify any special response headers that you want to send to the client browser. Bydefault, the following methods automatically send the indicated response headers:
Method Headers Sent
SendContent 'Date''From''Server''Connection''Content-Type' (text/html; charset=utf-8)'Content-Length'
SendCustomContent 'Date''From''Server''Connection''Content-Type' (specified in method)'Content-Length''Content-Disposition' (specified in method)
SendRedirect 'Date''From''Server''Connection''Content-Type' (text/html; charset=utf-8)'Content-Length''Location'
SendError 'Date''From''Server''Connection''Content-Type' (text/html; charset=utf-8)'Content-Length'
In addition, any cookies specified in the ResponseCookies or ResponseSessionCookies are automaticallysent using a 'Set-Cookie' header.
Component Reference
Page 149
![Page 152: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/152.jpg)
TEWBServerRequest.ResponseSessionCookies Property
property ResponseSessionCookies: TStrings
Use this property to specify any session-only cookies that you want to add/modify in the client browser.Session-only cookies persist only until the client browser session terminates, and then are cleared by thebrowser.
Component Reference
Page 150
![Page 153: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/153.jpg)
TEWBServerRequest.ComputeHash Method
function ComputeHash(AHashType: TEWBHashType; const Value: AnsiString): String
Use this method to compute a hash for a given input string. The AHashType parameter specifies the typeof hash to compute. The output is a hex-encoded string (2 characters per byte) that represents thecomputed hash.
Warning Do not use MD5 hashes for security purposes such as password hashes. Also, SHA-1 hashes arecurrently secure, but may be exploitable in the near future, so the stronger SHA-256 and SHA-512hashes are recommended for stored passwords.
Component Reference
Page 151
![Page 154: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/154.jpg)
TEWBServerRequest.Create Method
constructor Create
Use this method to create a new instance of the TEWBServerRequest class.
Component Reference
Page 152
![Page 155: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/155.jpg)
TEWBServerRequest.DateTimeToGMTStr Method
function DateTimeToGMTStr(Value: TDateTime): String
Converts a TDateTime value into a GMT date/time string that adheres to RFC1123 and has the format:
dow, day month year hours:mins:secs GMT
Component Reference
Page 153
![Page 156: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/156.jpg)
TEWBServerRequest.DateTimeToMSecs Method
function DateTimeToMSecs(Value: TDateTime): Int64
Converts a TDateTime value into the number of milliseconds since midnight, January 1, 1970.
Note The result is the native date/time representation used by JavaScript and Elevate Web Builder clientapplications.
Component Reference
Page 154
![Page 157: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/157.jpg)
TEWBServerRequest.GMTDateTimeToLocal Method
function GMTDateTimeToLocal(Value: TDateTime): TDateTime
Converts a GMT (UTC) TDateTime value into its local equivalent, optionally accounting for DaylightSavings Time.
Component Reference
Page 155
![Page 158: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/158.jpg)
TEWBServerRequest.HeaderExists Method
function HeaderExists(Headers: TStrings; const Header: String): Boolean
Use this method to determine if a specific HTTP header exists in the passed list of headers.
HTTP headers use the following format:
<Header Name>: <Header Value> [; <Attribute=<Attribute Value>...]
Component Reference
Page 156
![Page 159: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/159.jpg)
TEWBServerRequest.LocalDateTimeToGMT Method
function LocalDateTimeToGMT(Value: TDateTime): TDateTime
Converts a local TDateTime value into its GMT (UTC) equivalent, optionally accounting for DaylightSavings Time.
Component Reference
Page 157
![Page 160: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/160.jpg)
TEWBServerRequest.MSecsToDateTime Method
function MSecsToDateTime(Value: Int64): TDateTime
Converts the number of milliseconds since midnight, January 1, 1970 into a TDateTime value.
Note The input is the native date/time representation used by JavaScript and Elevate Web Builder clientapplications.
Component Reference
Page 158
![Page 161: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/161.jpg)
TEWBServerRequest.ParseHeader Method
function ParseHeader(Headers: TStrings; const Header: String): String
Use this method to parse a specific HTTP header value from the passed list of headers.
HTTP headers use the following format:
<Header Name>: <Header Value> [; <Attribute=<Attribute Value>...]
Component Reference
Page 159
![Page 162: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/162.jpg)
TEWBServerRequest.ParseHeaderAttribute Method
function ParseHeaderAttribute(const Attribute: String; const Header: String): String
Use this method to parse a specific HTTP header attribute from the passed header value.
HTTP headers use the following format:
<Header Name>: <Header Value> [; <Attribute=<Attribute Value>...]
Component Reference
Page 160
![Page 163: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/163.jpg)
TEWBServerRequest.SendContent Method
procedure SendContent(const Content: String; StatusCode: Integer=HTTP_OK; const StatusMessage: String='')
Sends a response to the client browser using the passed content, HTTP status code, and status message.The Unicode content is automatically sent in UTF-8 format.
Please see the following link for a complete list of HTTP status/error codes:
Status Code and Reason Phrase
Note Only one response can be sent per request. Attempting to send more than one response will causeerrors in the client browser.
Component Reference
Page 161
![Page 164: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/164.jpg)
TEWBServerRequest.SendContentHeader Method
procedure SendContentHeader(StatusCode: Integer=HTTP_OK; const StatusMessage: String='')
Sends response headers to the client browser using the passed HTTP status code and status message. Youshould use this method when responding to HEAD requests to a module, which can occur when thecontent type of the resource being handled by the module is unknown to the client application.
Please see the following link for a complete list of HTTP status/error codes:
Status Code and Reason Phrase
Note Only one response can be sent per request. Attempting to send more than one response will causeerrors in the client browser.
Component Reference
Page 162
![Page 165: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/165.jpg)
TEWBServerRequest.SendContentStream Method
procedure SendContentStream(const Content: TStream; StatusCode: Integer=HTTP_OK; const StatusMessage: String='')
Sends a response to the client browser using the passed content stream, HTTP status code, and statusmessage.
The content stream is sent to the client as-is (binary).
Please see the following link for a complete list of HTTP status/error codes:
Status Code and Reason Phrase
Note Only one response can be sent per request. Attempting to send more than one response will causeerrors in the client browser.
Component Reference
Page 163
![Page 166: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/166.jpg)
TEWBServerRequest.SendCustomContent Method
procedure SendCustomContent(const Content: String; const ContentType: String; const ContentDisposition: String)
procedure SendCustomContent(const Content: AnsiString; const ContentType: String; const ContentDisposition: String)
Sends a response to the client browser using the passed content, type, and disposition.
For the AnsiString version of this method, the content stream is sent to the client as-is (binary) and thecontent length is set based upon the length of the Content parameter.
For the Unicode string version of this method, the content length is set based upon the UTF-8 encodedversion of the Content parameter, so be sure to set the UTF-8 encoding (; charset=utf-8) as part of theContentType parameter with this version of the method.
Note Only one response can be sent per request. Attempting to send more than one response will causeerrors in the client browser.
Component Reference
Page 164
![Page 167: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/167.jpg)
TEWBServerRequest.SendCustomContentHeader Method
procedure SendCustomContentHeader(const ContentType: String; const ContentDisposition: String)
Sends response headers to the client browser using the passed content type and disposition. You shoulduse this method when responding to HEAD requests to a module, which can occur when the content typeof the resource being handled by the module is unknown to the client application.
Note Only one response can be sent per request. Attempting to send more than one response will causeerrors in the client browser.
Component Reference
Page 165
![Page 168: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/168.jpg)
TEWBServerRequest.SendCustomContentStream Method
procedure SendCustomContentStream(const Content: TStream; const ContentType: String; const ContentDisposition: String)
Sends a response to the client browser using the passed content stream, type, and disposition.
Note Only one response can be sent per request. Attempting to send more than one response will causeerrors in the client browser.
Component Reference
Page 166
![Page 169: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/169.jpg)
TEWBServerRequest.SendError Method
procedure SendError(ErrorCode: Integer; const ErrorMessage: String)
Sends an error response to the client browser using the passed HTTP error code and message. TheUnicode message is sent as the content in UTF-8 format.
Please see the following link for a complete list of HTTP status/error codes:
Status Code and Reason Phrase
Note Only one response can be sent per request. Attempting to send more than one response will causeerrors in the client browser.
Component Reference
Page 167
![Page 170: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/170.jpg)
TEWBServerRequest.SendRedirect Method
procedure SendRedirect(const NewLocationURL: String; const Content: String=''; StatusCode: Integer=HTTP_FOUND; const StatusMessage: String='Redirecting')
Sends a redirect response to the client browser using the passed new location, content, HTTP status codeand message. The Unicode content is automatically sent in UTF-8 format.
Please see the following link for a complete list of HTTP status/error codes:
Status Code and Reason Phrase
Note Only one response can be sent per request. Attempting to send more than one response will causeerrors in the client browser.
Component Reference
Page 168
![Page 171: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/171.jpg)
Chapter 3Type Reference
3.1 TEWBAuthenticationEvent Type
Unit: ewbdatasetadapter
TEWBAuthenticationEvent = procedure(const RequestUserName: String; const RequestPassword: String; var Authenticated: Boolean) of object
This type is used for the TEWBDatabaseAdapter OnAuthenticateUser event.
The RequestUserName and RequestPassword parameters specify the user information, and theAuthenticated variable parameter allows the developer to specify whether or not the authentication wassuccessful.
Note The default value of the Authenticated parameter is False, which means that you must authenticatethe user and set the Authenticated parameter to True in order for any dataset requests to executeproperly.
Type Reference
Page 169
![Page 172: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/172.jpg)
3.2 TEWBFilterDataSetRowsEvent Type
Unit: ewbdatasetadapter
TEWBFilterDataSetRowsEvent = procedure(Adapter: TEWBDataSetAdapter; Request: TEWBServerRequest) of object;
This type is used for the TEWBDataSetAdapter OnFilterRows event.
The Adapter parameter specifies the TEWBDataSetAdapter instance whose rows are being filtered, whilethe Request parameter specifies the TEWBServerRequest instance that is being handled by the datasetadapter.
Type Reference
Page 170
![Page 173: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/173.jpg)
3.3 TEWBGetDataSetAdapterEvent Type
Unit: ewbdatasetadapter
TEWBGetDataSetAdapterEvent = procedure(const DataSetName: String; var Adapter: TEWBDataSetAdapter) of object
This type is used for the TEWBDatabaseAdapter OnGetDataSetAdapter event.
The DataSetName parameter specifies the name of the dataset that requires an adapter, and the Adaptervariable parameter should be assigned the TEWBDataSetAdapter instance that will be used togenerate/consume the JSON for database requests.
Type Reference
Page 171
![Page 174: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/174.jpg)
3.4 TEWBGetDataSetsEvent Type
Unit: ewbdatasetadapter
TEWBGetDataSetsEvent = procedure(DataSets: TStrings) of object
This type is used for the TEWBDatabaseAdapter OnGetDataSets event.
The DataSets parameter specifies a TStrings instance to use for populating the list of available datasets.
Type Reference
Page 172
![Page 175: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/175.jpg)
3.5 TEWBHashType Type
Unit: ewbhttpmodule
TEWBHashType = (htMD5,htSHA1,htSHA256,htSHA512)
This type is used to represent the type of hash being computed with the TEWBServerRequestComputeHash method.
Element Description
htMD5 The hash will be computed as an MD5 hash.
htSHA1 The hash will be computed as an SHA-1 hash.
htSHA256 The hash will be computed as an SHA-256 hash.
htSHA512 The hash will be computed as an SHA-512 hash.
Type Reference
Page 173
![Page 176: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/176.jpg)
3.6 TEWBInitializeDataSetAdapterEvent Type
Unit: ewbdatasetadapter
TEWBInitializeDataSetAdapterEvent = procedure(Adapter: TEWBDataSetAdapter) of object
This type is used for the TEWBDataSetAdapter OnInitialize event.
The Adapter parameter specifies the TEWBDataSetAdapter instance that is being initialized.
Type Reference
Page 174
![Page 177: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/177.jpg)
3.7 TEWBJSONDateTimeFormat Type
Unit: ewbhttpcommon
TEWBJSONDateTimeFormat = (dtfRaw,dtfISO8601)
The TEWBJSONDateTimeFormat enumerated type is used with TEWBJSONReader and TEWBJSONWriterclasses to specify how TDateTime values are handled when reading/writing to/from JSON.
Element Description
dtfISO8601 Date-time values are handled as ISO-8601 date-time stringvalues.
dtfRaw Date-time values are handled as raw numeric Elevate WebBuilder DateTime values (the default).
Type Reference
Page 175
![Page 178: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/178.jpg)
3.8 TEWBModuleExecuteEvent Type
Unit: ewbhttpmodule
TEWBModuleExecuteEvent = procedure (Request: TEWBServerRequest) of object
This type is used for the TEWBModule OnExecute event.
The Request parameter specifies the TEWBServerRequest instance that is being handled by the module.
Type Reference
Page 176
![Page 179: Elevate Web Builder 2 Modules Manual · Elevate Web Builder 2 Modules Manual Table Of ... File/New/Other menu option from the main menu. 2. ... component instances in Embarcadero](https://reader031.fdocuments.in/reader031/viewer/2022021910/5c026ac109d3f26f1e8e2fed/html5/thumbnails/179.jpg)
3.9 TEWBRequestMethod Type
Unit: ewbhttpmodule
TEWBRequestMethod = (rmUnknown,rmGet,rmPost,rmHead,rmPut, rmDelete)
This type is used to represent the type of request in the TEWBServerRequest RequestMethod property.
Element Description
rmDelete The request is an HTTP DELETE request (not supported by theweb server for modules at this time).
rmGet The request is an HTTP GET request.
rmHead The request is an HTTP HEAD request (not supported by theweb server for modules at this time).
rmPost The request is an HTTP POST request.
rmPut The request is an HTTP PUT request (not supported by theweb server for modules at this time).
rmUnknown The request is an unknown HTTP request (not used by theweb server for modules - an error will occur before themodule is called if the request type is unknown).
Type Reference
Page 177