save

open override fun <E : Any> save(entity: E, con: Connection?, block: KSaveCommandDsl.() -> Unit?): KSimpleSaveResult<E>

Save an entity object

Return

The saved result for single object

Parameters

entity

The saved 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 specified 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 default value of the SaveMode of aggregate-root is SaveMode.UPSERT, it can be overwritten by the lambda represented by the parameter block

  • The default value of the AssociatedSaveMode of associated objects is AssociatedSaveMode.REPLACE, it can be overwritten by the lambda represented by the parameter block

con

An optional JDBC connection. If it is null, a connection will be brown from org.babyfish.jimmer.sql.runtime.ConnectionManager

block

An optional lambda to add additional configuration.

E

The type of saved entity