Spring/spring-data-cassandra
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Allow disabling entity lifecycle events.

Browse Source 
We now support disabling lifecycle events through the Template API to reduce the framework overhead when events are not needed.

Closes #1286
This commit is contained in:
Mark Paluch
2022-07-19 08:10:16 +02:00
parent 20eb0f47fa
commit a5047c91ed
6 changed files with 183 additions and 73 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
src/main/asciidoc/reference/mapping.adoc
View File

@@ -520,7 +520,10 @@ include::./converters.adoc[]
include::../{spring-data-commons-docs}/is-new-state-detection.adoc[leveloffset=+1]
NOTE: Cassandra provides no means to generate identifiers upon inserting data. As consequence, entities must be associated with identifier values. Spring Data defaults to identifier inspection to determine whether an entity is new. If you want to use <<cassandra.auditing,auditing>> make sure to either use <<cassandra.template.optimistic-locking>> or implement `Persistable` for proper entity state detection.
NOTE: Cassandra provides no means to generate identifiers upon inserting data.
As consequence, entities must be associated with identifier values.
Spring Data defaults to identifier inspection to determine whether an entity is new.
If you want to use <<cassandra.auditing,auditing>> make sure to either use <<cassandra.template.optimistic-locking>> or implement `Persistable` for proper entity state detection.
[[cassandra.mapping-usage.events]]
== Lifecycle Events
@@ -530,6 +533,8 @@ Being based on Spring's application context event infrastructure lets other prod
To intercept an object before it goes into the database, you can register a subclass of `org.springframework.data.cassandra.core.mapping.event.AbstractCassandraEventListener` that overrides the `onBeforeSave(…)` method.
When the event is dispatched, your listener is called and passed the domain object (which is a Java entity).
Entity lifecycle events can be costly and you may notice a change in the performance profile when loading large result sets.
You can disable lifecycle events on the link:https://docs.spring.io/spring-data/cassandra/docs/{version}/api/org/springframework/data/cassandra/core/CassandraTemplate.html#setEntityLifecycleEventsEnabled(boolean)[Template API].
The following example uses the `onBeforeSave` method:
====