// This Source Code is in the Public Domain per: http://unlicense.org
package org.litesoft.util;

import java.io.*;
import java.util.*;

public interface StreamAccessor
{
    public boolean isReadable();

    public boolean isWritable();

    /**
     * @return !null
     *
     * @throws IllegalStateException    - if not Readable
     * @throws MissingResourceException - if resource not found
     * @throws IOException              - any other IOException
     */
    public InputStream readOpen()
            throws IllegalStateException, MissingResourceException, IOException;

    /**
     * @return !null
     *
     * @throws UnsupportedOperationException - if not Writable (ie already written)
     * @throws IllegalStateException         - if something required for writing is missing
     * @throws IOException                   - any other IOException
     */
    public OutputStream writeOpen()
            throws UnsupportedOperationException, IllegalStateException, IOException;
}