/**
* Copyright (c) 2012, Thilo Planz. All rights reserved.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package v7db.files.spi;
import java.io.IOException;
import java.io.InputStream;
import java.util.Map;
/**
* The interface to store contents.
*
* <p>
* Implementations need to provide the following features:
* <ul>
* <li>Storing content given as an InputStream, returning the SHA digest to
* later retrieve it.
* <li>Retrieving stored content by its SHA digest.
* <li>Retrieving means "producing an InputStream to read the contents" and
* "providing information about content length".
* <li>Retrieving parts of contents as referenced by "content pointer"
* documents.
* </ul>
*
*
* @see https://github.com/thiloplanz/v7files/wiki/StorageFormat
*
*/
public interface ContentStorage {
/**
* will close the InputStream before returning
*/
ContentSHA storeContent(InputStream data) throws IOException;
/**
* store "out-of-band" content.
*
* @throws UnsupportedOperationException
* if the specified scheme is unknown
*/
ContentPointer storeContent(Map<String, Object> storageScheme)
throws IOException;
/**
* @return null, if no such content was stored
*/
Content getContent(byte[] sha) throws IOException;
/**
* @return null, if no such content was stored (or the pointer is null)
*/
Content getContent(ContentPointer pointer) throws IOException;
/**
*
* @throws UnsupportedOperationException
* if the specified scheme is unknown
*/
Content getContent(Map<String, Object> storageScheme) throws IOException;
}