Package thredds.filesystem

Class MFileOS

java.lang.Object

thredds.filesystem.MFileOS

All Implemented Interfaces:

Comparable<MFile>, MFile

@ThreadSafe
public class MFileOS
extends Object
implements MFile

Implements thredds.inventory.MFile using regular OS files.

Since:

Jun 30, 2009

Constructor Summary

Constructors

Constructor	Description
MFileOS(File file)
MFileOS(String filename)

Method Summary

Modifier and Type	Method	Description
int	compareTo(MFile o)
boolean	exists()	Check if the MFile exists
Object	getAuxInfo()
MFileOS	getChild(String newFilename)	Get child MFile of this MFile
static MFileOS	getExistingFile(String filename)	Make MFileOS if file exists, otherwise return null
File	getFile()
FileInputStream	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()
boolean	isReadable()
void	setAuxInfo(Object auxInfo)
String	toString()
void	writeToStream(OutputStream outputStream)	Write the MFile to an OutputStream
void	writeToStream(OutputStream outputStream, long offset, long maxBytes)	Write the MFile to an OutputStream

Methods inherited from class java.lang.Object

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

Methods inherited from interface thredds.inventory.MFile

isZipFile

Constructor Detail

MFileOS

public MFileOS(File file)

MFileOS

public MFileOS(String filename)

Method Detail

getExistingFile

@Nullable
public static MFileOS getExistingFile(String filename)

Make MFileOS if file exists, otherwise return null

Parameters:

filename - name of the existing file.

Returns:

MFileOS or null

getLastModified

public long getLastModified()

Description copied from interface: MFile

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

Specified by:

getLastModified in interface MFile

Returns:

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

getLength

public long getLength()

Description copied from interface: MFile

Size of file in bytes

Specified by:

getLength in interface MFile

Returns:

Size of file in bytes or -1 if unknown

isDirectory

public boolean isDirectory()

Specified by:

isDirectory in interface MFile

isReadable

public boolean isReadable()

Specified by:

isReadable in interface MFile

getPath

public String getPath()

Description copied from interface: MFile

Get full path name, replace \\ with /

Specified by:

getPath in interface MFile

Returns:

full path name

getName

public String getName()

Description copied from interface: MFile

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

Specified by:

getName in interface MFile

Returns:

the file name

getParent

@Nullable
public MFile getParent()

Description copied from interface: MFile

Get the parent of this

Specified by:

getParent in interface MFile

Returns:

the parent or null

compareTo

public int compareTo(MFile o)

Specified by:

compareTo in interface Comparable<MFile>

Specified by:

compareTo in interface MFile

getAuxInfo

public Object getAuxInfo()

Specified by:

getAuxInfo in interface MFile

setAuxInfo

public void setAuxInfo(Object auxInfo)

Specified by:

setAuxInfo in interface MFile

toString

public String toString()

Overrides:

toString in class Object

exists

public boolean exists()

Description copied from interface: MFile

Check if the MFile exists

Specified by:

exists in interface MFile

Returns:

true if the MFile exists, else false

getInputStream

public FileInputStream getInputStream()
                               throws FileNotFoundException

Description copied from interface: MFile

Get the MFile InputStream

Specified by:

getInputStream in interface MFile

Returns:

the MFile InputStream

Throws:

FileNotFoundException

writeToStream

public void writeToStream(OutputStream outputStream)
                   throws IOException

Description copied from interface: MFile

Write the MFile to an OutputStream

Specified by:

writeToStream in interface MFile

Parameters:

outputStream - the OutputStream the MFile contents should be written to

Throws:

IOException

writeToStream

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

Description copied from interface: MFile

Write the MFile to an OutputStream

Specified by:

writeToStream in interface MFile

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

getFile

public File getFile()

getChild

public MFileOS getChild(String newFilename)

Description copied from interface: MFile

Get child MFile of this MFile

Specified by:

getChild in interface MFile

Parameters:

newFilename - the relative file path of the new MFile

Returns:

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