/**
 *
 * Copyright
 * 2009-2015 Jayway Products AB
 * 2016-2017 Föreningen Sambruk
 *
 * Licensed under AGPL, Version 3.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.gnu.org/licenses/agpl.txt
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package se.streamsource.streamflow.web.infrastructure.attachment;

import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.nio.ByteBuffer;

import org.qi4j.api.io.Input;

import se.streamsource.streamflow.util.Visitor;

/**
 * Store for the binary part of an attachment
 */
public interface AttachmentStore
{
   /**
    * Read the binary data and save, and return a URL
    * pointing to the file.
    *
    * @param input of binary data for the file
    * @return id for the file
    */
   String storeAttachment( Input<ByteBuffer, IOException> input) throws IOException;

   Input<ByteBuffer, IOException> attachment(String id) throws FileNotFoundException;

   void attachment(String id, Visitor<InputStream, IOException> visitor) throws IOException;

   Input<String, IOException> text(String id) throws FileNotFoundException;

   void deleteAttachment(String id) throws IOException;

   long getAttachmentSize(String id) throws IOException;
}