<?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:----k7RQIS18xtHyqqzVbs+qrNs4yoxFm7vX5Z3BbR4a64O91ZC4CZRUWW+TgqKF/gYfZRksD6ND+VoALhlDCAlQp4JbeOy6WflXimimqONM/ITsyFhDxyaGP01PjB/M1eL9sq7H/dzCIabSOUHtRsxJUul2o+ScxT7Bj1VVGUKNsmNWn2573GLWxb/WCX2LUdeF3jjiJZirQjlb8L1qdrs8QcQg2o2KAt/smKFNc7hTvppFjYUbL/6Rwspdrvq0pJLSvtyu3Jz3m+GjeAYh5ofu7fGPodw5dlp0OyADJuWI16/cwYn4CeID+ND3gtSg5tky/lhGMhVtIl8UNNitwnqHalyBcuHrd2sE9bmihzWwlCxKEOURASqCKhHLYiihVqUMx5bmMYVH+KNN1CZ6Oey7cy3Exx1569aC3OTn4KXApgWOIBdwSulVc58Bb3UFRoG5J9R01zjySE9o72gUFD/odK4AhkXZwogeaapPaGnJOjR1dABqQoXK7C6LOsfJ4+rQDvMwnUaEb/LNFPA9pnsGBBhzSTYw/Pv1Ap5aYKyT9KBZGro9OBuY32k93Js4Udtno2QcTTqUH1VWdMmhksl18mWSRONqiBfOashCc7Gi11mXBN7z2BqQnq0H9jRLe+6C5jHnBeLpZEQdH8afD5AvR5WJKM4uSDl8nYWg845eAl4=----ATTACHMENT:----NDM1ODYzMTY3OTMyNTYxNSAxMDA3MDM1Nzk5OTA3OTM4IDEwNDIyNzY5NzgwNDQ1MDk=