Creates a File from the given absolute file path in the file namespace. If the specified path is not a valid accessible path, an exception will be thrown.

The passed path should use the forward slash '/' as the path separator and begin with a leading slash. However, if a leading slash is not provided, or the backslash character is used as the separator, these problems will be fixed. The normalized value will then be returned by getFullPath().

Creates a File given a root directory and a relative path.

Copy a file. Directories cannot be copied. This method cannot be used from storefront requests.

Create file.

Indicates if the file exists.

Return the full file path denoted by this File. This value will be the same regardless of which constructor was used to create this File.

Returns the name of the file or directory denoted by this object. This is just the last name in the pathname's name sequence. If the pathname's name sequence is empty, then the empty string is returned.

Returns the portion of the path relative to the root directory.

Returns a File representing a directory for the specified root directory type. If the root directory type is CATALOGS or LIBRARIES, then an additional argument representing the specific catalog or library must be provided. Otherwise, no additional arguments are needed.

Returns the root directory type, e.g. "IMPEX" represented by this File.

Assumes this instance is a gzip file. Unzipping it will explode the contents in the directory passed in (root).

GZip this instance into a new gzip file. If you're zipping a file, then a single entry, the instance, is included in the output gzip file. Note that a new File is created. GZipping directories is not suppported. This file is never modified.

Indicates that this file is a directory.

Indicates if this file is a file.

Return the time, in milliseconds, that this file was last modified.

Return the length of the file in bytes.

Returns an array of strings naming the files and directories in the directory denoted by this object.

If this object does not denote a directory, then this method returns null. Otherwise an array of strings is returned, one for each file or directory in the directory. Names denoting the directory itself and the directory's parent directory are not included in the result. Each string is a file name rather than a complete path.

There is no guarantee that the name strings in the resulting array will appear in any specific order; they are not, in particular, guaranteed to appear in alphabetical order.

Returns an array of File objects in the directory denoted by this File.

If this File does not denote a directory, then this method returns null. Otherwise an array of File objects is returned, one for each file or directory in the directory. Files denoting the directory itself and the directory's parent directory are not included in the result.

There is no guarantee that the files in the resulting array will appear in any specific order; they are not, in particular, guaranteed to appear in alphabetical order. Example usage:

// Assume "foo" is an accessible directory.
var this_directory : dw.io.File = new File("foo");

// Find all files in directory foo, one level "down".
// listFiles() will not traverse subdirectories.
var folder : dw.util.List = this_directory.listFiles();
var first_element : dw.io.File = folder[0];

function modification_comparison(lhs : File, rhs : File)
{
  return lhs.lastModified() < rhs.lastModified();
}

function lexigraphic_comparison(lhs: File, rhs : File)
{
  return lhs.getName() < rhs.getName();
}

var time_ordered_folder : dw.util.ArrayList = folder.sort(modification_comparison);
var alphabetic_folder : dw.util.ArrayList = folder.sort(lexigraphic_comparison);


Returns an array of File objects denoting the files and directories in the directory denoted by this object that satisfy the specified filter. The behavior of this method is the same as that of the listFiles() method, except that the files in the returned array must satisfy the filter. The filter is a Javascript function which accepts one argument, a File, and returns true or false depending on whether the file meets the filter conditions. If the given filter is null then all files are accepted. Otherwise, a file satisfies the filter if and only if the filter returns true. Example usage:

// Assume "foo" is an accessible directory.
var this_directory : dw.io.File = new File("foo");

function longer_than_3(candidate : dw.io.File)
{
  return candidate.getName().length > 3;
}

// Find all files in directory foo, one level "down",
// such that the filename is longer than 3 characters.
var folder_long_names : dw.util.List = this_directory.listFiles(longer_than_3);


Returns an MD5 hash of the content of the file of this instance.

Creates a directory.

Creates a directory, including, its parent directories, as needed.

Deletes the file or directory denoted by this object. If this File represents a directory, then the directory must be empty in order to be deleted.

Rename file.

Assumes this instance is a zip file. Unzipping it will explode the contents in the directory passed in (root).

Zip this instance into a new zip file. If you're zipping a directory, the directory itself and all its children files to any level (any number of subdirectories) are included in the zip file. The directory will be the only entry in the archive (single root). If you're zipping a file, then a single entry, the instance, is included in the output zip file. Note that a new File is created. This file is never modified.