<?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:----Hyk/blPnDKIsao6WJ5Mrzcs3/biACvelGm/feD9onzUmP1E1JP4U6dMzvo5e06EnhtmaI2ubpVmGZAnTsoAWbUxeSmow/H+H/qk+efVbrbilenqzRqDIoZweUGAqIZ4BcKsFjJoDNHLmERCkaNL315jGDOkIjWtGWeAiP4j5A/aG/RPHqo9MsPUPj1g8EbYUSTwiA6offi9x1keyCIcpK+3ujfvi2O3oajl4F2pF7cftgUgM+CGv+YlWGrmOInbnlPrZun31ySjx2PVxNvdqwKSsecjlR6sayE+N82f8KPR/c0WdOZwCUtZ4pCcx7Z7ZoHGJXjvLQAbrUww0MvVc7/GKb6hkuumGRclKrJTD452N0tr1qVHXiooaNTi8Fyst4jNyre/w+o27QYFdG1wvaW4Iza5tIFdpOAXBfemXKiuMcyWpjjdlxLt9dxuAvbIyMAUc4TF4Sxy1npeP4L3yvoFUc//dkEHaoQN6QCMp/GHOhxsqQiEnfcTY+CnLZ3VGpt0ft8yi9O7/XoRQ9BSZvDbYK4DTcOu7r2dYGvjEd93HZhHwXhNe5z1NWVE0QUKikdxlPv6FpXmIsjKaoQOX4VUC5ntvrndgr0cSLDVjLneoTMB0VvFvVy065h+6BtCG7qf8B0BI39fGtmkyfDC0bpTJRqbuaM4HmxKcweCEt14=----ATTACHMENT:----NzY2ODE2MDkzNDYzNzM3MiA2MDY1NjA3NTMzMTA1NTI5IDMwNDU3MjgyMDc3ODE1NDk=