io.arivera.oss.embedded.rabbitmq.apache.commons.io

Class FileUtils

java.lang.Object

io.arivera.oss.embedded.rabbitmq.apache.commons.io.FileUtils

public class FileUtils
extends Object

General file manipulation utilities.

Facilities are provided in the following areas:

• writing to a file
• reading from a file
• make a directory including parent directories
• copying files and directories
• deleting files and directories
• converting to and from a URL
• listing files and directories by filter and extension
• comparing file content
• file last changed date
• calculating a checksum

Note that a specific charset should be specified whenever possible. Relying on the platform default means that the code is Locale-dependent. Only use the default if the files are known to always use the platform default.

Origin of code: Excalibur, Alexandria, Commons-Utils

Version:

$Id$

Constructor Summary

Constructors

Constructor and Description
FileUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static void	closeQuietly(InputStream input)
static void	closeQuietly(OutputStream output)
static int	copy(InputStream input, OutputStream output)
static void	copyInputStreamToFile(InputStream source, File destination) Copies bytes from an InputStream source to a file destination.
static long	copyLarge(InputStream input, OutputStream output)
static void	copyURLToFile(URL source, File destination, int connectionTimeout, int readTimeout) Copies bytes from the URL source to a file destination.
static void	copyUrlToFile(URL source, File destination, int connectionTimeout, int readTimeout, Proxy proxy) Copies bytes from the URL source to a file destination.
static FileOutputStream	openOutputStream(File file)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FileUtils

public FileUtils()

Method Detail

copyURLToFile

public static void copyURLToFile(URL source,
                 File destination,
                 int connectionTimeout,
                 int readTimeout)
                          throws IOException

Copies bytes from the URL source to a file destination. The directories up to destination will be created if they don't already exist. destination will be overwritten if it already exists.

Parameters:

source - the URL to copy bytes from, must not be null

destination - the non-directory File to write bytes to (possibly overwriting), must not be null

connectionTimeout - the number of milliseconds until this method will timeout if no connection could be established to the source

readTimeout - the number of milliseconds until this method will timeout if no data could be read from the source

Throws:

IOException - if source URL cannot be opened

IOException - if destination is a directory

IOException - if destination cannot be written

IOException - if destination needs creating but can't be

IOException - if an IO error occurs during copying

Since:

2.0

copyUrlToFile

public static void copyUrlToFile(URL source,
                 File destination,
                 int connectionTimeout,
                 int readTimeout,
                 Proxy proxy)
                          throws IOException

Copies bytes from the URL source to a file destination. The directories up to destination will be created if they don't already exist. destination will be overwritten if it already exists.

Parameters:

source - the URL to copy bytes from, must not be null

destination - the non-directory File to write bytes to (possibly overwriting), must not be null

connectionTimeout - the number of milliseconds until this method will timeout if no connection could be established to the source

readTimeout - the number of milliseconds until this method will timeout if no data could be read from the source

proxy - the proxy to use to open connection

Throws:

IOException - if source URL cannot be opened

IOException - if destination is a directory

IOException - if destination cannot be written

IOException - if destination needs creating but can't be

IOException - if an IO error occurs during copying

copyInputStreamToFile

public static void copyInputStreamToFile(InputStream source,
                         File destination)
                                  throws IOException

Copies bytes from an InputStream source to a file destination. The directories up to destination will be created if they don't already exist. destination will be overwritten if it already exists.

Parameters:

source - the InputStream to copy bytes from, must not be null

destination - the non-directory File to write bytes to (possibly overwriting), must not be null

Throws:

IOException - if destination is a directory

IOException - if destination cannot be written

IOException - if destination needs creating but can't be

IOException - if an IO error occurs during copying

Since:

2.0

openOutputStream

public static FileOutputStream openOutputStream(File file)
                                         throws IOException

Throws:

IOException

copy

public static int copy(InputStream input,
       OutputStream output)
                throws IOException

Throws:

IOException

copyLarge

public static long copyLarge(InputStream input,
             OutputStream output)
                      throws IOException

Throws:

IOException

closeQuietly

public static void closeQuietly(OutputStream output)

closeQuietly

public static void closeQuietly(InputStream input)