Package thredds.inventory

Interface MFile

All Superinterfaces:

Comparable<MFile>

All Known Implementing Classes:

GcMFile, MFileOS, MFileOS7, MFileS3, MFileZip

public interface MFile
extends Comparable<MFile>

An abstraction for java.io.File / java.nio.file.Path

Since:

Jun 30, 2009

Method Summary

Modifier and Type	Method	Description
int	compareTo(MFile o)
boolean	exists()	Check if the MFile exists
Object	getAuxInfo()
MFile	getChild(String newFileName)	Get child MFile of this MFile
InputStream	getInputStream()	Get the MFile InputStream
long	getLastModified()	Get time of last modification at the time the MFile object was created
long	getLength()	Size of file in bytes
String	getName()	The name is the farthest element from the root in the directory hierarchy.
MFile	getParent()	Get the parent of this
String	getPath()	Get full path name, replace \\ with /
boolean	isDirectory()
default boolean	isReadable()
default boolean	isZipFile()	Check if this MFile is a zip file
void	setAuxInfo(Object info)
void	writeToStream(OutputStream outputStream)	Write the MFile to an OutputStream
void	writeToStream(OutputStream outputStream, long offset, long maxBytes)	Write the MFile to an OutputStream

Method Detail

getLastModified

long getLastModified()

Get time of last modification at the time the MFile object was created

Returns:

time of last modification in Unix time (msecs since reference), or -1 if unknown

getLength

long getLength()

Size of file in bytes

Returns:

Size of file in bytes or -1 if unknown

isDirectory

boolean isDirectory()

isZipFile

default boolean isZipFile()

Check if this MFile is a zip file

Returns:

true if the MFile is a zip file

isReadable

default boolean isReadable()

getPath

String getPath()

Get full path name, replace \\ with /

Returns:

full path name

getName

String getName()

The name is the farthest element from the root in the directory hierarchy.

Returns:

the file name

getParent

MFile getParent()
         throws IOException

Get the parent of this

Returns:

the parent or null

Throws:

IOException

compareTo

int compareTo(MFile o)

Specified by:

compareTo in interface Comparable<MFile>

getAuxInfo

Object getAuxInfo()

setAuxInfo

void setAuxInfo(Object info)

exists

boolean exists()

Check if the MFile exists

Returns:

true if the MFile exists, else false

getInputStream

InputStream getInputStream()
                    throws FileNotFoundException

Get the MFile InputStream

Returns:

the MFile InputStream

Throws:

FileNotFoundException

writeToStream

void writeToStream(OutputStream outputStream)
            throws IOException

Write the MFile to an OutputStream

Parameters:

outputStream - the OutputStream the MFile contents should be written to

Throws:

IOException

writeToStream

void writeToStream(OutputStream outputStream,
                   long offset,
                   long maxBytes)
            throws IOException

Write the MFile to an OutputStream

Parameters:

outputStream - the OutputStream the MFile contents should be written to

offset - the index of the first byte to write out

maxBytes - the maximum number of bytes to copy

Throws:

IOException

getChild

@Nullable
MFile getChild(String newFileName)

Get child MFile of this MFile

Parameters:

newFileName - the relative file path of the new MFile

Returns:

the new MFile or null if the file can't be resolved