/*
 * Copyright (C)2009 - SSHJ Contributors
 *
 * Licensed under the Apache License, Version 2.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.apache.org/licenses/LICENSE-2.0
 *
 * 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 net.schmizz.sshj.xfer;

import java.io.IOException;
import java.io.OutputStream;

public interface LocalDestFile {

    long getLength();

    OutputStream getOutputStream()
            throws IOException;
    
    OutputStream getOutputStream(boolean append)
            throws IOException;

    /** @return A child file/directory of this directory with given {@code name}. */
    LocalDestFile getChild(String name);

    /**
     * Allows caller to express intent that caller expects to write to file with {@code filename}. Based on this
     * information, an implementation may return an alternate file to write to, which should be respected by the
     * caller.
     */
    LocalDestFile getTargetFile(String filename)
            throws IOException;

    /**
     * Allows caller to express intent that caller expects to write to directory with {@code dirname}. Based on this
     * information, an implementation may return an alternate directory to write to, which should be respected by the
     * caller.
     */
    LocalDestFile getTargetDirectory(String dirname)
            throws IOException;

    /**
     * Set the permissions for the underlying file.
     *
     * @param perms permissions e.g. 0644
     *
     * @throws IOException
     */
    void setPermissions(int perms)
            throws IOException;

    /**
     * Set the last access time for the underlying file.
     *
     * @param t time in seconds since Unix epoch
     *
     * @throws IOException
     */
    void setLastAccessedTime(long t)
            throws IOException;

    /**
     * Set the last modified time for the underlying file.
     *
     * @param t time in seconds since Unix epoch
     *
     * @throws IOException
     */
    void setLastModifiedTime(long t)
            throws IOException;

}
