de.must.io

Class MustFile

java.lang.Object

java.io.File

de.must.io.MustFile

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<java.io.File>

public class MustFile
extends java.io.File

File with exact test of canWrite for directories. (File.canWrite returns true even if false in some cases.)

See Also:

Serialized Form

Field Summary

Fields inherited from class java.io.File

pathSeparator, pathSeparatorChar, separator, separatorChar

Constructor Summary

Constructors

Constructor and Description
MustFile(java.io.File file)
MustFile(java.io.File parent, java.lang.String child)
MustFile(java.lang.String pathname)
MustFile(java.lang.String parent, java.lang.String child)
MustFile(java.net.URI uri)

Method Summary

Modifier and Type	Method and Description
boolean	canWrite()
java.lang.String	chooseSuitableCharset(java.lang.String[] charsetOptions) Returns a suitable charset name to read the file, trying in the order of charsetOptions.
static boolean	isImageExtension(java.lang.String extension)
boolean	isSuitable(java.lang.String charsetName) Returns true if the specified charset is suitable to read the file (doesn't throw any CharacterCodingException) Performance hint: this method will read the entire file to ensure there is no exception at all

Methods inherited from class java.io.File

canExecute, canRead, compareTo, createNewFile, createTempFile, createTempFile, delete, deleteOnExit, equals, exists, getAbsoluteFile, getAbsolutePath, getCanonicalFile, getCanonicalPath, getFreeSpace, getName, getParent, getParentFile, getPath, getTotalSpace, getUsableSpace, hashCode, isAbsolute, isDirectory, isFile, isHidden, lastModified, length, list, list, listFiles, listFiles, listFiles, listRoots, mkdir, mkdirs, renameTo, setExecutable, setExecutable, setLastModified, setReadable, setReadable, setReadOnly, setWritable, setWritable, toPath, toString, toURI, toURL

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MustFile

public MustFile(java.io.File file)

MustFile

public MustFile(java.lang.String pathname)

MustFile

public MustFile(java.net.URI uri)

MustFile

public MustFile(java.lang.String parent,
                java.lang.String child)

MustFile

public MustFile(java.io.File parent,
                java.lang.String child)

Method Detail

isImageExtension

public static boolean isImageExtension(java.lang.String extension)

canWrite

public boolean canWrite()

Overrides:

canWrite in class java.io.File

chooseSuitableCharset

public java.lang.String chooseSuitableCharset(java.lang.String[] charsetOptions)

Returns a suitable charset name to read the file, trying in the order of charsetOptions. Performance hint: this method will read the entire file to ensure there is no exception at all

Parameters:

charsetOptions - the names of the charsets to be tested

Returns:

a suitable charset name to read the file

isSuitable

public boolean isSuitable(java.lang.String charsetName)
                   throws java.io.IOException

Returns true if the specified charset is suitable to read the file (doesn't throw any CharacterCodingException) Performance hint: this method will read the entire file to ensure there is no exception at all

Parameters:

charsetName - the name of the charset to be tested

Returns:

true if the specified charset is suitable to read the file

Throws:

java.io.IOException