/*
* Copyright @ 2013 CurisTEC, S.A.S. All Rights Reserved.
*/
package net.curisit.securis.db.common;

import java.util.Date;

/**
* ModificationTimestampEntity
* <p>
* Contract for entities that track a <b>modification timestamp</b>.
* Typical usage: attach {@code @EntityListeners(ModificationTimestampListener.class)}
* so the value is updated automatically on persist/update.
*
* Methods:
* - {@link #getModificationTimestamp()} exposes the timestamp.
* - {@link #setModificationTimestamp(Date)} sets the timestamp.
*
* @author JRA
* Last reviewed by JRA on Oct 7, 2025.
*/
public interface ModificationTimestampEntity {

    /** 
     * getModificationTimestamp<p>
     * Return the last modification timestamp. 
     * 
     * @return modificationTimestamp
     */
    Date getModificationTimestamp();

    /** 
     * setModificationTimestamp<p>
     * Set/update the last modification timestamp.
     * 
     * @param modificationTimestamp
     */
    void setModificationTimestamp(Date modificationTimestamp);
}