Skip to content

Saving New Objects

In order to determine if an object needs to be stored as new or the existing one should be updated, Backendless checks if the object in the API call has the objectId value. This principle is used in the save and update API as well as in the Deep Save API. Below are some of the examples demonstrating various scenarios:

Important

When using the Deep Save API to save new objects, make sure the tables are defined in the database. If the table does not have a column defined for a non-relational property in your object, the API will return an error.

Parent/Child Objects with one-to-one Relation

The sample below stores parent (Product) and child (Manufacturer) objects in the corresponding tables and creates a relationship between the objects in the database:

curl \  
-H Content-Type:application/json \  
-X PUT  \  
-d "{    \  
  \"name\":\"iPhone X\", \  
  \"price\":1199,        \  
  \"manufacturer\": {    \  
    \"name\":\"Apple\",  \  
    \"industry\":\"Consumer Electronics\" \  
  } \  
}" \  
-v https://xxxx.backendless.app/api/data/Product/deep-save

Server response:

{
  "price": 1199,
  "created": 1624090691000,
  "name": "iPhone X",
  "___class": "Product",
  "ownerId": null,
  "updated": null,
  "objectId": "748471BF-F2E7-4AF0-A60C-68291B52999F",
  "manufacturer": {
    "created": 1624090692000,
    "name": "Apple",
    "___class": "Manufacturer",
    "industry": "Consumer Electronics",
    "ownerId": null,
    "updated": null,
    "objectId": "8494BFCC-964E-4F7F-95E3-2497C5D34011"
  }
}

Once the code runs, the following two objects are stored in the Manufacturer and Product tables:

Object in the Manufacturer table:

manufacturer-obj

Object in the Product table:

product-obj

Parent/Child Objects with one-to-many Relation

In the example below the parent object (Order) contains two relations: one is a one-to-one relation to a Customer object and the other  is a collection (а one-to-many relation) of child objects (OrderItem). The Deep Save API stores the parent object, the children and establishes a relationship in the database between the parent and its children:

curl \  
-H Content-Type:application/json \  
-X PUT  \  
-d "{   \  
  \"customer\":{                \  
    \"name\":\"John Smith\",    \  
    \"phoneNumber\":\"5551212\" \  
  },                            \  
  \"orderItems\":[              \  
    {                           \  
      \"name\":\"Apples\",      \  
      \"price\":5.99            \  
    },                          \  
    {                           \  
      \"name\":\"Oranges\",     \  
      \"price\":9.99            \  
    } \  
  ] \  
}" \  
-v https://xxxx.backendless.app/api/data/Order/deep-save

Server response:

{
  "created": 1624093011000,
  "___class": "Order",
  "ownerId": null,
  "orderItems": [
    {
      "created": 1624093012000,
      "price": 9.99,
      "___class": "OrderItem",
      "name": "Oranges",
      "ownerId": null,
      "updated": null,
      "objectId": "81451CE2-5E7E-4200-9DE5-A8BE5E47FA2A"
    },
    {
      "created": 1624093012000,
      "price": 5.99,
      "___class": "OrderItem",
      "name": "Apples",
      "ownerId": null,
      "updated": null,
      "objectId": "B4508F7B-3F6A-4A17-AE0D-B7AE010E64F2"
    }
  ],
  "updated": null,
  "objectId": "479090D2-5E85-48AB-B959-3FA14859A222",
  "customer": {
    "phoneNumber": "5551212",
    "created": 1624093012000,
    "name": "John Smith",
    "___class": "Customer",
    "ownerId": null,
    "updated": null,
    "objectId": "DBCB7BC6-2E29-4A8A-BF0E-FADDC9728AC5"
  }
}

When the Deep Save operation completes, the database will have the following objects:

Order object/table:

order-obj-deepsave

Customer object/table:

customer-obj-deepsave

OrderItem objects/table:

orderitem-obj-deepsave

Codeless Reference

data_api_deep_save_1

where:

Argument                Description
table name Name of the data table where a new record must be saved or updated.
object An object to save or update in the database. Object properties must match the names of the table columns.
return result Optional parameter. When this box is checked, the operation returns the saved or updated object with the objectId property.

The Deep Save API allows saving new objects or updating existing ones in the specified data table. You can easily save or update objects that have relations, this includes: parent objects and child objects.

Returns the saved object with the objectId property assigned by Backendless. This object has the other nested objects containing the related data.

Consider the structure of the data table called Customers. The "orders" column is configured to have one-to-many relations with objects stored in the Orders data table:

data_api_deep_save_2

The Orders data table contains the "items" column where the order details are stored in the JSON format.

data_api_deep_save_3

The example below saves a new JSON object to the Customers data table. This object has two nested objects containing the related data that will be saved to the Orders data table, since initially the one-to-many relation was set in the Customers data table.

data_api_deep_save_4

After the Codeless logic runs, the new object gets saved to the Customers data table. As you can see, now the "orders" column is active and has relations to two other objects stored in the Orders data table.

data_api_deep_save_5

Two other objects stored in the Orders data table contain order information in the "items" column:

data_api_deep_save_6

The result of this operation will look as shown below after the Codeless logic runs:

data_api_deep_save_7