package org.bouncycastle.util;

Interface for Memoable objects. Memoable objects allow the taking of a snapshot of their internal state
via the copy() method and then reseting the object back to that state later using the reset() method.
/**
 * Interface for Memoable objects. Memoable objects allow the taking of a snapshot of their internal state
 * via the copy() method and then reseting the object back to that state later using the reset() method.
 */
public interface Memoable
{
    
Produce a copy of this object with its configuration and in its current state.

The returned object may be used simply to store the state, or may be used as a similar object
starting from the copied state.
/**
     * Produce a copy of this object with its configuration and in its current state.
     * <p>
     * The returned object may be used simply to store the state, or may be used as a similar object
     * starting from the copied state.
     */
    Memoable copy();

    
Restore a copied object state into this object.

Implementations of this method should try to avoid or minimise memory allocation to perform the reset.
Params:
other – an object originally copied from an object of the same type as this instance.
Throws:
ClassCastException – if the provided object is not of the correct type.
MemoableResetException – if the other parameter is in some other way invalid./**
     * Restore a copied object state into this object.
     * <p>
     * Implementations of this method <em>should</em> try to avoid or minimise memory allocation to perform the reset.
     *
     * @param other an object originally {@link #copy() copied} from an object of the same type as this instance.
     * @throws ClassCastException if the provided object is not of the correct type.
     * @throws MemoableResetException if the <b>other</b> parameter is in some other way invalid.
     */
    void reset(Memoable other);
}