de.unkrig.commons.file.filetransformation

Class DirectoryTransformer

java.lang.Object

de.unkrig.commons.file.filetransformation.DirectoryTransformer

All Implemented Interfaces:

FileTransformer

public class DirectoryTransformer
extends java.lang.Object
implements FileTransformer

See Also:

transform(String, File, File, de.unkrig.commons.file.filetransformation.FileTransformer.Mode)

Nested Class Summary

Nested classes/interfaces inherited from interface de.unkrig.commons.file.filetransformation.FileTransformer

FileTransformer.Mode

Field Summary

Fields

Modifier and Type	Field and Description
static java.text.Collator	DEFAULT_MEMBER_NAME_COMPARATOR Sorts ascendingly by name (for the default locale).

Fields inherited from interface de.unkrig.commons.file.filetransformation.FileTransformer

NOT_IDENTICAL, THROW_NOT_IDENTICAL

Constructor Summary

Constructors

Constructor and Description
DirectoryTransformer(FileTransformer regularFileTransformer, java.util.Comparator<java.lang.Object> directoryMemberNameComparator, FileTransformer directoryMemberTransformer, FileTransformations.DirectoryCombiner directoryCombiner, boolean saveSpace, boolean keepOriginals, ExceptionHandler<java.io.IOException> exceptionHandler)

Method Summary

Modifier and Type	Method and Description
java.lang.String	toString()
void	transform(java.lang.String path, java.io.File in, java.io.File out, FileTransformer.Mode mode) If in is not a directory, then the regularFileTransformer is invoked.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MEMBER_NAME_COMPARATOR

public static final java.text.Collator DEFAULT_MEMBER_NAME_COMPARATOR

Sorts ascendingly by name (for the default locale).

A good default value for the memberNameComparator parameter of DirectoryTransformer(FileTransformer, Comparator, FileTransformer, FileTransformations.DirectoryCombiner, boolean, boolean, ExceptionHandler).

See Also:

DirectoryTransformer(FileTransformer, Comparator, FileTransformer, FileTransformations.DirectoryCombiner, boolean, boolean, ExceptionHandler)

Constructor Detail

DirectoryTransformer

public DirectoryTransformer(FileTransformer regularFileTransformer,
                            @Nullable
                            java.util.Comparator<java.lang.Object> directoryMemberNameComparator,
                            FileTransformer directoryMemberTransformer,
                            FileTransformations.DirectoryCombiner directoryCombiner,
                            boolean saveSpace,
                            boolean keepOriginals,
                            ExceptionHandler<java.io.IOException> exceptionHandler)

Parameters:

directoryMemberNameComparator - The comparator used to sort a directory's members; a null value means to NOT sort the members, i.e. leave them in their 'natural' order as File.list() returns them

See Also:

FileTransformer.transform(String, File, File, Mode), DEFAULT_MEMBER_NAME_COMPARATOR

Method Detail

transform

public void transform(java.lang.String path,
                      java.io.File in,
                      java.io.File out,
                      FileTransformer.Mode mode)
               throws java.io.IOException

If in is not a directory, then the regularFileTransformer is invoked.

Otherwise, out is taken as a directory (created if missing), and directoryMemberTransformer.transform() is called for each member of in. If that throws an IOException or a RuntimeException, then that exception is caught, and exceptionHandler.handle() is called. If that method completes normally (i.e. it doesn't throw an exception), then processing continues with the next member of directory in.

Specified by:

transform in interface FileTransformer

Parameters:

path - A text designating the input file; typically, but not necessarily identical with in.getPath()

in - The input file to read

out - The output file to create; irrelevant iff mode == FileTransformer.Mode.CHECK

Throws:

java.io.IOException

See Also:

FileTransformer.NOT_IDENTICAL, FileTransformer.Mode.TRANSFORM, FileTransformer.Mode.CHECK, FileTransformer.Mode.CHECK_AND_TRANSFORM

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object