<?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:----G3rllnEKpaWkTV47lT8prW4CJEzkY8chuS/pA+9OsczuAvy5Mmv+iUExvHjN/Gavl6rgEKRU2IHzizHnmQcV6f9/Ksmng6BOpkCtziTrvpFtKMahHicmzOyFpkb+y4fQoECE4cK4YQM0CemKgwACiVHQKXqiFJivs/cZ+T9mICLxUnFOc3sSUjBMUq0uVcH+fSpCWh0l1RO5lXZLylKjiLAj1kkU7jb80U4b+/QXvgzZRZH25C8b4NLnv71FPb+5NLOZi0MylFxEpXwTcZEr6C+LjmMi/JuN3dOvV7I5KC+6fY4qAafo0pNl+PDxbpglXeg1xZIxabz2/tjea38qgNuWTVCs+V0ckFNHpiDfiyv7+kjd7UKsalDO8vQ0RXvcMIWJOaslLJqhmhzvKj7RUpI/NlHiMd6gZ9kPp0zsD0bZ63YXAMGdO/c06R2EV6RXnNDnd8lyZIJ18WOWq6aGaHMIQbxAfP90SaamT+l9HttGYZcp8HNi1eHzuqeQxPNE2E+PaIrTjMSU53/ii8FEEpY0U7hPJJywsiQLITDQf8r3oUs0HStCvs9GR97n47tGC/m6Ww+bHJ8KtoUoyno7Ae1gUWUujKgXWEUh42WhEcQnCN/VjBQc+9evPHstxT5bfsUEqnIVrNTvkCaN4/xTuD6wLPs+xSDYYpgB4oIIGVk=----ATTACHMENT:----MzYzMjA5NjM5MDkxMzY1MiA1MDUwNzE4ODYxNjk2MTY2IDY0NzY0NTA0NjIwMzg3MTM=