Class TempFileStorageProvider

java.lang.Object

org.apache.james.mime4j.storage.AbstractStorageProvider

org.apache.james.mime4j.storage.TempFileStorageProvider

All Implemented Interfaces:

StorageProvider

public class TempFileStorageProvider
extends AbstractStorageProvider

A StorageProvider that stores the data in temporary files. The files are stored either in a user-specified directory or the default temporary-file directory (specified by system property java.io.tmpdir).

Example usage:

File directory = new File("/tmp/mime4j");
StorageProvider provider = new TempFileStorageProvider(directory);
DefaultStorageProvider.setInstance(provider);

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	TempFileStorageProvider.TempFileStorage
private static final class	TempFileStorageProvider.TempFileStorageOutputStream

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	DEFAULT_PREFIX
private final File	directory
private final String	prefix
private final String	suffix

Constructor Summary

Constructors

Constructor	Description
TempFileStorageProvider()	Equivalent to using constructor TempFileStorageProvider("m4j", null, null).
TempFileStorageProvider(File directory)	Equivalent to using constructor TempFileStorageProvider("m4j", null, directory).
TempFileStorageProvider(String prefix, String suffix, File directory)	Creates a new TempFileStorageProvider using the given values.

Method Summary

Modifier and Type	Method	Description
StorageOutputStream	createStorageOutputStream()	Creates a StorageOutputStream where data to be stored can be written to.

Methods inherited from class AbstractStorageProvider

store

Methods inherited from class Object

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

Field Details

DEFAULT_PREFIX

private static final String DEFAULT_PREFIX

See Also:

• Constant Field Values

prefix

private final String prefix

suffix

private final String suffix

directory

private final File directory

Constructor Details

TempFileStorageProvider

public TempFileStorageProvider()

Equivalent to using constructor TempFileStorageProvider("m4j", null, null).

TempFileStorageProvider

public TempFileStorageProvider(File directory)

Equivalent to using constructor TempFileStorageProvider("m4j", null, directory).

TempFileStorageProvider

public TempFileStorageProvider(String prefix,
 String suffix,
 File directory)

Creates a new TempFileStorageProvider using the given values.

Parameters:

prefix - prefix for generating the temporary file's name; must be at least three characters long.

suffix - suffix for generating the temporary file's name; may be null to use the suffix ".tmp".

directory - the directory in which the file is to be created, or null if the default temporary-file directory is to be used (specified by the system property java.io.tmpdir).

Throws:

IllegalArgumentException - if the given prefix is less than three characters long or the given directory does not exist and cannot be created (if it is not null).

Method Details

createStorageOutputStream

public StorageOutputStream createStorageOutputStream()
                                              throws IOException

Description copied from interface: StorageProvider

Creates a StorageOutputStream where data to be stored can be written to. Subsequently the user can call toStorage() on that object to get a Storage instance that holds the data that has been written.

Returns:

a StorageOutputStream where data can be written to.

Throws:

IOException - if an I/O error occurs.