<?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:----hJbdVS12orMIHNsrvRqQfurU2LllF7o1Vusp1OVJhlBpbc9UgdSNnLR5eiC33Eel+grB2F/Vx8zFdAJ8CHhqoiPX4vBakJFIvSlUUnhjPOjC2jSmPmm8yEfGwFIR67rcCzFgRwPKkTKrj4joQ/DOWddIqCE/VDNLAKIvfk0xmSa92mHKUP5cIQPo0ao5v2J4Gs/Icz1BEm0ZseU/xIoGvrHG/YoK84wWh/LokxsDl12A9w1/am6EOrkWkESGKr/o/DuG/JyIPX1zg9MTDqFmItvNoKm2tHn36bVOVUVbSvS0HNZfRQFbFwOHoIHD46iBcsF/5x7bn6u8QFuBiJ/baGa+1jX2yqBPeDltB4+xDaQ5o9LTS661cRcgj0TGS73qkmAKehpqvlPT1ssiMG+bCTAqPy1MExsivtGtfb3ogBprFVuXD2QlzgYmgaCqJaYZ0cB6GeLf30/UQ2xPhAN3AOlH6+Ny1dYJp8aAdebA0eZbpgmoOZqPmKwUSztPoX75Uc3JIZYrPZyUQmCf7cP5eamCbqfRSbPcfP6u3GPhImfc4YYL0JWyqZHaBhRq4hRYv9CjOmGIAabCb4l6PL5ART/e9pmPXanb0wE9AD/NP1o5kkTrGCdcjJ5USfIPi7bdX7qNpbblvBhJBZtQkM9qzlJyTyDYSxrAXJxZk3yXs3Y=----ATTACHMENT:----MzA4NzQ1NDQ0MDc0MTk4MCA5OTE1NjY0OTIyODMzMjgxIDUzMzc0MjMwNzA5NTE1NTA=