io.mongock.api.annotations

Annotation Type ChangeUnit

@Target(value=TYPE)
 @Retention(value=RUNTIME)
public @interface ChangeUnit

For old classes, this annotation can remain. It won't be removed from the legacy library. For new classes, use io.flamingock.api.annotations.Change

See Also:

Change

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.String	id Change unit's id.
java.lang.String	order Sequence that provide correct order for change unit execution.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
java.lang.String	author Author of the changeset.
boolean	failFast If true, will make the entire migration to break if the change unit produce an exception or the validation doesn't success.
boolean	runAlways Executes the change set on every Mongock's execution, even if it has been run before.
java.lang.String	systemVersion Specifies the software systemVersion on which the change unit is to be applied.
boolean	transactional If true, Mongock will try to run the changeUnit in a native transaction, if possible.

Element Detail

id

public abstract java.lang.String id

Change unit's id. It will be used to identify both change entries, the one linked to @Execution and @BeforeExecution(this one with the suffix `_before`) Obligatory.

Equivalent to field `id` in ChangeSet annotation

Returns:

Change unit's id

See Also:

ChangeSet

order

public abstract java.lang.String order

Sequence that provide correct order for change unit execution. Sorted alphabetically, ascending. Obligatory.

Equivalent to field `order` in ChangeSet annotation and ChangeLog, as now there is only one "changeSet", annotated with @Execution

Returns:

Change unit's execution order

See Also:

ChangeSet

author

public abstract java.lang.String author

Author of the changeset.

Equivalent to field `author` in ChangeSet annotation

Returns:

Change unit's author

See Also:

ChangeSet

Default:

""

failFast

public abstract boolean failFast

If true, will make the entire migration to break if the change unit produce an exception or the validation doesn't success. Migration will continue otherwise.

Equivalent to field `failFast` in ChangeSet annotation

Returns:

failFast

See Also:

ChangeSet

Default:

true

runAlways

public abstract boolean runAlways

Executes the change set on every Mongock's execution, even if it has been run before. Optional (default is false)

Equivalent to field `runAlways` in ChangeSet annotation

Returns:

should run always?

See Also:

ChangeSet

Default:

false

systemVersion

public abstract java.lang.String systemVersion

Specifies the software systemVersion on which the change unit is to be applied. Optional (default is 0 and means all)

Equivalent to field `systemVersion` in ChangeSet annotation

Returns:

systemVersion

See Also:

ChangeSet

Default:

"0"

transactional

public abstract boolean transactional

If true, Mongock will try to run the changeUnit in a native transaction, if possible.

Returns:

If the changeUnit should be run in a native transaction.

Default:

true