org.jboss.vfs

Class TempFileProvider

java.lang.Object

org.jboss.vfs.TempFileProvider

All Implemented Interfaces:

Closeable, AutoCloseable

public final class TempFileProvider
extends Object
implements Closeable

A provider for temporary physical files and directories.

Author:

David M. Lloyd, Ales Justin

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Close this provider and delete any temp files associated with it.
static TempFileProvider	create(String providerType, ScheduledExecutorService executor) Create a temporary file provider for a given type.
static TempFileProvider	create(String providerType, ScheduledExecutorService executor, boolean cleanExisting) Create a temporary file provider for a given type.
TempDir	createTempDir(String originalName) Create a temp directory, into which temporary files may be placed.
protected void	finalize()

Methods inherited from class java.lang.Object

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

Method Detail

create

public static TempFileProvider create(String providerType,
                      ScheduledExecutorService executor)
                               throws IOException

Create a temporary file provider for a given type.

This is the same as calling create(final String providerType, final ScheduledExecutorService executor, false)

Parameters:

providerType - the provider type string (used as a prefix in the temp file dir name)

executor - the executor

Returns:

the new provider

Throws:

IOException - if an I/O error occurs

create

public static TempFileProvider create(String providerType,
                      ScheduledExecutorService executor,
                      boolean cleanExisting)
                               throws IOException

Create a temporary file provider for a given type.

Parameters:

providerType - The provider type string (used as a prefix in the temp file dir name)

executor - Executor which will be used to manage temp file provider tasks (like cleaning up/deleting the temp files when needed)

cleanExisting - If this is true, then existing temp content (if any) for the providerType will be deleted and the implementation ensures that when this method returns, the returned TempFileProvider can be used and the previously existing content (if any) for this providerType will not be present under the root directory represented by the returned TempFileProvider

Returns:

The new provider

Throws:

IOException - if an I/O error occurs

createTempDir

public TempDir createTempDir(String originalName)
                      throws IOException

Create a temp directory, into which temporary files may be placed.

Parameters:

originalName - the original file name

Returns:

the temp directory

Throws:

IOException - for any error

close

public void close()
           throws IOException

Close this provider and delete any temp files associated with it.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

finalize

protected void finalize()

Overrides:

finalize in class Object