saveEntities

abstract fun <E : Any> saveEntities(entities: Iterable<E>, con: Connection? = null, block: KSaveCommandDsl.() -> Unit? = null): KBatchSaveResult<E>

Save some entity objects

Return

The saved result for multiple objects

Parameters

entities

The saved entity objects.

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-roots 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


open fun <E : Any> saveEntities(entities: Iterable<E>, mode: SaveMode, associatedMode: AssociatedSaveMode = AssociatedSaveMode.REPLACE, con: Connection? = null, block: KSaveCommandPartialDsl.() -> Unit? = null): KBatchSaveResult<E>

Save some entity objects

Return

The saved result for multiple objects

Parameters

entities

The saved entity objects.

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.

mode

The save mode of aggregate-roots

associatedMode

The associated save mode for associated objects, its default value is AssociatedSaveMode.REPLACE

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


open fun <E : Any> saveEntities(entities: Iterable<E>, associatedMode: AssociatedSaveMode, con: Connection? = null, block: KSaveCommandPartialDsl.() -> Unit? = null): KBatchSaveResult<E>

Save some entity objects

Return

The saved result for multiple objects

Parameters

entities

The saved entity objects.

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-roots is SaveMode.UPSERT, it can be overwritten by the lambda represented by the parameter block

associatedMode

The associated save mode for associated objects, its default value is AssociatedSaveMode.REPLACE

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