<?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:----QPMu+9l6lwpHk5vkd3oYD3f8KYZix6y+iFbO8TElKuDJHPQdn9Y0fvpRQp0evdnLmmnDOr+VSoOLSnPdzKkg7TH8bg+9ESAlgVTc3iPZJIFFZ5Wbs6FwepGQtgbvqMRLVZzmykKYGa1hTjx1yY5LnfrFF6F78lYZys9pw3s10NdOHwEn2dSIpdYihym1DCYItN5Honx09zH2HmwhvgjyeEE7HMQvgoKuiNWbGVMFvlEHpeYx/EzLh20gXrRHd3eM2bo03Zgn4PMVEkm5AtTKasUM66CH2HuaisNMGlms3pdLXBOpLLG9RAYSuzLtLsMGWVnmxqST9YUh+M6uVom7UQr8wfEY8upeNXW7bsb/A0R/92IbrrENx2VYgA+xbpSoQVbwx55VY1PU2CMotIHT5ckRE1gpWTacbqaL5wVo5BXHpHMMBp9Xeo4eINPYIzT0XY5mnPjyD9+wWVGSyOFwfLz233RcV9BYhv+RR9beurO2Ak+AaThROnu9WgN0lAp3HN3biHX8qYk1XIrK7ocbIrrgKOqbfWCt93G4TlTakl2PjKhA4LwLuhw377Zg7BvYqUk1GU9HkEIFfCYeZ17CuSbV/NsemxZwVSEwOea30s/xWQ03nuwXT2untN8mvtcaWkD9vfxad0+B/TxTeHHwCgZuN4PvupBVw48vs9AL+J4=----ATTACHMENT:----NTc1ODkxMDk5OTc5NTc3MSA1NTUxMzg5MjYxNTU4MzY2IDU3MTE3MjAzMzY4NTM3NDc=