insert If Absent
Insert an entity object if necessary, if the entity object exists in database, ignore it.
If the value of id property decorated by Id is specified, use id value to check whether the entity object exists in database
otherwise, if the values of key properties decorated by Key is specified use key values to check whether the entity object exists in database
If neither value of id property nor values of key properties is specified, exception will be raised.
Return
The saved result for single object
Parameters
The inserted entity object.
Note: The jimmer entity is not POJO, it can easily express data structures of arbitrary shape, you can use it to save data structures of arbitrary shape.
Unlike most JVM ORMs, Jimmer does not sepcified the shape of the saved data structure by using configuration such as insertable, updatable or cascade; instead, it uses the dynamic nature of entity object itself to describe the shape of saved data structure, without prior design
Unspecified properties will be ignored, only the specified properties (whether null or not) will be saved. In addition to objects with only id property, any associated objects will result in deeper recursive saves.
The SaveMode of aggregate-root is SaveMode.INSERT_IF_ABSENT
The save mode of associated-objects. This parameter is optional and its default value AssociatedSaveMode.APPEND_IF_ABSENT
An optional lambda to add additional configuration. In addition to setting the SaveMode of aggregate root and the default value of the AssociatedSaveMode of associated objects, you can add any other configuration.
The type of saved entity
Insert an input DTO if necessary, that means to convert the input DTO to entity object and save it. If the entity object exists in database, ignore it.
If the value of id property decorated by Id is specified, use id value to check whether the entity object exists in database
otherwise, if the values of key properties decorated by Key is specified use key values to check whether the entity object exists in database
If neither value of id property nor values of key properties is specified, exception will be raised.
Return
The saved result for single object
Parameters
The inserted input DTOs.
In terms of internal mechanisms, any type of Input DTO is automatically converted into an entity object of the same type
Note: The jimmer entity is not POJO, it can easily express data structures of arbitrary shape, you can use it to save data structures of arbitrary shape.
Unlike most JVM ORMs, Jimmer does not sepcified the shape of the saved data structure by using configuration such as insertable, updatable or cascade; instead, it uses the dynamic nature of entity object itself to describe the shape of saved data structure, without prior design
Unspecified properties will be ignored, only the specified properties (whether null or not) will be saved. In addition to objects with only id property, any associated objects will result in deeper recursive saves.
The SaveMode of aggregate-root is SaveMode.INSERT_IF_ABSENT
The save mode of associated-objects. This parameter is optional and its default value AssociatedSaveMode.APPEND_IF_ABSENT
An optional lambda to add additional configuration. In addition to setting the SaveMode of aggregate root and the default value of the AssociatedSaveMode of associated objects, you can add any other configuration.
The type of saved entity