org.sonatype.aether.spi.io
Interface FileProcessor

All Known Implementing Classes:
DefaultFileProcessor, TestFileProcessor

public interface FileProcessor

A utility component to perform file-based operations.

Author:
Benjamin Hanzelmann, Benjamin Bentmann

Nested Class Summary
static interface FileProcessor.ProgressListener
          A listener object that is notified for every progress made while copying files.
 
Method Summary
 long copy(java.io.File source, java.io.File target, FileProcessor.ProgressListener listener)
          Copies the specified source file to the given target file.
 boolean mkdirs(java.io.File directory)
          Creates the directory named by the given abstract pathname, including any necessary but nonexistent parent directories.
 void write(java.io.File file, java.lang.String data)
          Writes the given data to a file.
 

Method Detail

mkdirs

boolean mkdirs(java.io.File directory)
Creates the directory named by the given abstract pathname, including any necessary but nonexistent parent directories. Note that if this operation fails it may have succeeded in creating some of the necessary parent directories.

Parameters:
directory - The directory to create, may be null.
Returns:
true if and only if the directory was created, along with all necessary parent directories; false otherwise

write

void write(java.io.File file,
           java.lang.String data)
           throws java.io.IOException
Writes the given data to a file. UTF-8 is assumed as encoding for the data.

Parameters:
file - The file to write to, must not be null. This file will be overwritten.
data - The data to write, may be null.
Throws:
java.io.IOException - If an I/O error occurs.

copy

long copy(java.io.File source,
          java.io.File target,
          FileProcessor.ProgressListener listener)
          throws java.io.IOException
Copies the specified source file to the given target file. Creates the necessary directories for the target file. In case of an error, the created directories will be left on the file system.

Parameters:
source - The file to copy from, must not be null.
target - The file to copy to, must not be null.
listener - The listener to notify about the copy progress, may be null.
Returns:
The number of copied bytes.
Throws:
java.io.IOException - If an I/O error occurs.


Copyright © 2010 Sonatype, Inc.. All Rights Reserved.