Fires before the JSDO, by means of a saveChanges( ) call following an add( ) call, sends a request to create a record in the Data Object resource on the server.
This event fires before each Create operation request is sent without using Submit, and fires before each one of possibly multiple record creates are sent with a single Submit operation request.
Note: A single Create operation request is sent for each record object that you have created in the JSDO with a single call to saveChanges( ) or saveChanges(false). A single Submit operation request for any and all created, updated, and deleted JSDO record objects is sent with a single call to saveChanges(true).
The following parameters appear in the signature of any event handler (callback) function (or functions) that you subscribe to this event:
Syntax
function ( jsdo , record , request )
jsdo
A reference to the JSDO that is invoking the create request. For more information, see the description of jsdo property of the request object.
record
A reference to the table record upon which the create request is about to act. For more information, see the description of jsrecord property of the request object.
request
A reference to the request object before the create request is sent. For more information, see the description of request object.
Application code can subscribe a callback to this event by invoking the subscribe( ) method on a JSDO instance or one of its table references.
Example
The following code fragment subscribes the function, onBeforeCreate, to handle the beforeCreate event fired on the JSDO, myjsdo, created for a single-table resource, by assigning data to the newly created record before sending it to the server:
/* subscribe to event */
myjsdo.subscribe( 'beforeCreate', onBeforeCreate );
/* some code that might add one or more
records and save them on the server */
var jsrecord = myjsdo.add();
. . .
myjsdo.saveChanges();
function onBeforeCreate( jsdo , record , request ) {
/* for example, here you might update data in the record
before it is sent to the server to be created */
record.assign( { myField1 = myvalue, myField2 = myvalue2 } );
};