com.haulmont.cuba.core.app

Interface EntitySnapshotService

All Known Implementing Classes:

EntitySnapshotServiceBean

public interface EntitySnapshotService

Provides entity snapshots functionality.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NAME

Method Summary

Modifier and Type	Method and Description
EntitySnapshot	createSnapshot(Entity entity, View view) Create snapshot for entity and save it to database
EntitySnapshot	createSnapshot(Entity entity, View view, java.util.Date snapshotDate) Create snapshot for Entity with specific date and store it to database
EntitySnapshot	createSnapshot(Entity entity, View view, java.util.Date snapshotDate, User author) Create snapshot for Entity with specific date and author and store it to database
EntitySnapshot	createTempSnapshot(Entity entity, View view) Creates non-persistent snapshot for entity.
EntitySnapshot	createTempSnapshot(Entity entity, View view, java.util.Date snapshotDate) Creates non-persistent snapshot for entity with a specific date.
EntitySnapshot	createTempSnapshot(Entity entity, View view, java.util.Date snapshotDate, User author) Creates non-persistent snapshot for entity with a specific date and author.
Entity	extractEntity(EntitySnapshot snapshot) Get entity from snapshot
EntityDiff	getDifference(EntitySnapshot first, EntitySnapshot second) Get Diff for snapshots
EntitySnapshot	getLastEntitySnapshot(Entity entity) Get the last snapshot for the given entity.
EntitySnapshot	getLastEntitySnapshot(MetaClass metaClass, java.lang.Object referenceId) Get the last snapshot for the given entity by id.
java.util.List<EntitySnapshot>	getSnapshots(MetaClass metaClass, java.lang.Object id) Get snapshots for entity by id
void	migrateSnapshots(MetaClass metaClass, java.lang.Object id, java.util.Map<java.lang.Class,java.lang.Class> classMapping) Translate snapshots for archival classes

Field Detail

NAME

static final java.lang.String NAME

See Also:

Constant Field Values

Method Detail

getSnapshots

java.util.List<EntitySnapshot> getSnapshots(MetaClass metaClass,
                                            java.lang.Object id)

Get snapshots for entity by id

Parameters:

metaClass - Entity meta class

id - Entity id

Returns:

Snapshot list

createSnapshot

EntitySnapshot createSnapshot(Entity entity,
                              View view)

Create snapshot for entity and save it to database

Parameters:

entity - Entity

view - View

Returns:

Snapshot

createSnapshot

EntitySnapshot createSnapshot(Entity entity,
                              View view,
                              java.util.Date snapshotDate)

Create snapshot for Entity with specific date and store it to database

Parameters:

entity - Entity

view - View

snapshotDate - Date

Returns:

Snapshot

createSnapshot

EntitySnapshot createSnapshot(Entity entity,
                              View view,
                              java.util.Date snapshotDate,
                              User author)

Create snapshot for Entity with specific date and author and store it to database

Parameters:

entity - Entity

view - View

snapshotDate - Date

author - Author

Returns:

Snapshot

extractEntity

Entity extractEntity(EntitySnapshot snapshot)

Get entity from snapshot

Parameters:

snapshot - Snapshot

Returns:

Entity

getDifference

EntityDiff getDifference(@Nullable
                         EntitySnapshot first,
                         EntitySnapshot second)

Get Diff for snapshots

Parameters:

first - First snapshot

second - Second snapshot

Returns:

Diff

migrateSnapshots

void migrateSnapshots(MetaClass metaClass,
                      java.lang.Object id,
                      java.util.Map<java.lang.Class,java.lang.Class> classMapping)

Translate snapshots for archival classes

Parameters:

metaClass - Metaclass

id - Entity Id

classMapping - Map of [OldClass -> NewClass] for migration

getLastEntitySnapshot

@Nullable
EntitySnapshot getLastEntitySnapshot(Entity entity)

Get the last snapshot for the given entity. This method always starts a new transaction. It can be used for entities with composite key if they implement HasUuid interface.

Parameters:

entity - entity

Returns:

snapshot or null if there is no snapshots in database for the given entity

getLastEntitySnapshot

@Nullable
EntitySnapshot getLastEntitySnapshot(MetaClass metaClass,
                                               java.lang.Object referenceId)

Get the last snapshot for the given entity by id. This method always starts a new transaction.

Parameters:

metaClass - entity meta class

referenceId - reference id for which snapshot refers

Returns:

snapshot or null if there is no snapshots in database for the given entity

createTempSnapshot

EntitySnapshot createTempSnapshot(Entity entity,
                                  View view)

Creates non-persistent snapshot for entity. It can be used for entities with composite key if they implement HasUuid interface.

Parameters:

entity - entity

view - view

Returns:

not persistence snapshot

createTempSnapshot

EntitySnapshot createTempSnapshot(Entity entity,
                                  View view,
                                  java.util.Date snapshotDate)

Creates non-persistent snapshot for entity with a specific date. It can be used for entities with composite key if they implement HasUuid interface.

Parameters:

entity - entity

view - entity view

snapshotDate - date

Returns:

not persistence snapshot

createTempSnapshot

EntitySnapshot createTempSnapshot(Entity entity,
                                  View view,
                                  java.util.Date snapshotDate,
                                  User author)

Creates non-persistent snapshot for entity with a specific date and author. It can be used for entities with composite key if they implement HasUuid interface.

Parameters:

entity - entity

view - entity view

snapshotDate - date

author - author

Returns:

not persistence snapshot