<?php
  /**
   * Copyright (c) 2012 Robin Appelman <icewind@owncloud.com>
   * This file is licensed under the Affero General Public License version 3 or
   * later.
   * See the COPYING-README file.
   */
  
  namespace OC\Files\Storage;
  
  /**
   * Provide a common interface to all different storage options
   *
   * All paths passed to the storage are relative to the storage and should NOT have a leading slash.
   */
  interface Storage extends \OCP\Files\Storage {
  
  	/**
  	 * get a cache instance for the storage
  	 *
  	 * @param string $path

  	 * @param \OC\Files\Storage\Storage (optional) the storage to pass to the cache

  	 * @return \OC\Files\Cache\Cache
  	 */

  	public function getCache($path = '', $storage = null);

  
  	/**
  	 * get a scanner instance for the storage
  	 *
  	 * @param string $path

  	 * @param \OC\Files\Storage\Storage (optional) the storage to pass to the scanner

  	 * @return \OC\Files\Cache\Scanner
  	 */

  	public function getScanner($path = '', $storage = null);

  
  
  	/**
  	 * get the user id of the owner of a file or folder
  	 *
  	 * @param string $path
  	 * @return string
  	 */
  	public function getOwner($path);
  
  	/**

  	 * get a watcher instance for the cache
  	 *
  	 * @param string $path

  	 * @param \OC\Files\Storage\Storage (optional) the storage to pass to the watcher

  	 * @return \OC\Files\Cache\Watcher
  	 */

  	public function getWatcher($path = '', $storage = null);

  
  	/**
  	 * @return \OC\Files\Cache\Storage
  	 */
  	public function getStorageCache();
  
  }