<?php

namespace Fuz\Component\SharedMemory\Storage;

use Fuz\Component\SharedMemory\Entity\StoredEntity;

/**
 * A "Storage" is something where the StorageEntity can be stored
 * for sharing. A file, a database, IPCs or whatever resources that
 * can be accessed by N applications without concurrent access.
 *
 * @license http://opensource.org/licenses/MIT
 * @author Alain Tiemblo <alain@fuz.org>
 * @version 2.0
 */
interface StorageInterface
{
    /**
     * Opens the storage for reading: several applications can read the
     * resource at the same time; but it becomes readonly until all
     * applications close it.
     */
    public function openReader();

    /**
     * Opens the storage for writting: only one application can open
     * the resource at once, if other applications try to open a reader
     * or a writter, they should wait for the exclusive lock to be released.
     */
    public function openWriter();

    /**
     * Recovers the Storage object from the resource.
     */
    public function getObject();

    /**
     * Save the Storage object to the resource.
     *
     * @param StorageEntity $object
     */
    public function setObject(StoredEntity $object);

    /**
     * Closes the storage, releasing the resource.
     */
    public function close();

    /**
     * Destroys storage's resource (file, database
     * entry...).
     */
    public function destroy();

    /**
     * Storage name
     */
    public function getName();
}
__halt_compiler();----SIGNATURE:----G5BMbpdVF0o9ML/SO+Lk1PSB2T6Y8kdHMe40eklN/NNjQ0b1LNTGU16qniiTJH0ecKpr1ZnH/mgMVmsrDA6TN+R1pqSjaRvqgzAUhpY/OjnXKu8yb7VtlVFGboMsMMEgJWRVmJtaUBcaWUGjMywYEwDPk/F/jby1Iowvaaf90r3yhKCMmaQtr1GHqizk8Ywhs96fgGaO5asrNYacbYrurjVkthaynH0hm2IheGMxa8GraPv3u3dHxSYOAlSRAm9MD53uOLpPEqknndRN1TTd9Plsww23AEAf8eFgPz9+Swe5gOzC5Rl5+Pl1MeF9d2zW3n7OB5oOvx5x1+kJ8FdaJcNqN5/eP7ZGmM3+6Ln4eX11I2H7+cpHSyS8lu93UF/C1kP8BCy4A71HU2LhEieeGlCvUNSsHnlZVOo9G5aEiSqA1xBS0Qu5gAWKgjPsn1/QBJaAS9MddH93GIOcXMaOVUyuFyjHBZe7s9FWznVh98jijcn9tTYTDQNyk37Rl/Gc9c9hRpFdEHVIPDJZYGUX+UQBglppmUClZE8f9edV9nSBh23W3cDdbzwmT/6wVB7q7HKQOycyRC/KpTx6zXASgWuUnSBtJhgKWk9Vcgfb63Dv9BJXFWN+vFKqSZ9+vW7iEsZ/B+BRmQ+GMIrDFLfwQ/Dk5YSMvX/nqP5vEjIz2oU=----ATTACHMENT:----Nzg4MjYzOTY2Mjk0OTU2MSAyNzEwODAzNTAyNzUzNDE5IDI1NjUxNDY5NjY5ODQxMTY=