loci.poi.poifs.filesystem

Interface DirectoryEntry

All Superinterfaces:

Entry

All Known Implementing Classes:

DirectoryNode

public interface DirectoryEntry
extends Entry

This interface defines methods specific to Directory objects managed by a Filesystem instance.

Author:

Marc Johnson (mjohnson at apache dot org)

Method Summary

Methods

Modifier and Type	Method and Description
DirectoryEntry	createDirectory(String name) create a new DirectoryEntry
DocumentEntry	createDocument(String name, int size, POIFSWriterListener writer) create a new DocumentEntry; the data will be provided later
DocumentEntry	createDocument(String name, RandomAccessInputStream stream) create a new DocumentEntry
Iterator	getEntries() get an iterator of the Entry instances contained directly in this instance (in other words, children only; no grandchildren etc.)
Entry	getEntry(String name) get a specified Entry by name
int	getEntryCount() find out how many Entry instances are contained directly within this DirectoryEntry
ClassID	getStorageClsid() Gets the storage clsid of the directory entry
boolean	isEmpty() is this DirectoryEntry empty?
void	setStorageClsid(ClassID clsidStorage) Sets the storage clsid for the directory entry

Methods inherited from interface loci.poi.poifs.filesystem.Entry

delete, getName, getParent, isDirectoryEntry, isDocumentEntry, renameTo

Method Detail

getEntries

Iterator getEntries()

get an iterator of the Entry instances contained directly in this instance (in other words, children only; no grandchildren etc.)

Returns:

iterator; never null, but hasNext() may return false immediately (i.e., this DirectoryEntry is empty). All objects retrieved by next() are guaranteed to be implementations of Entry.

isEmpty

boolean isEmpty()

is this DirectoryEntry empty?

Returns:

true if this instance contains no Entry instances

getEntryCount

int getEntryCount()

find out how many Entry instances are contained directly within this DirectoryEntry

Returns:

number of immediately (no grandchildren etc.) contained Entry instances

getEntry

Entry getEntry(String name)
               throws FileNotFoundException

get a specified Entry by name

Parameters:

name - the name of the Entry to obtain.

Returns:

the specified Entry, if it is directly contained in this DirectoryEntry

Throws:

FileNotFoundException - if no Entry with the specified name exists in this DirectoryEntry

createDocument

DocumentEntry createDocument(String name,
                           RandomAccessInputStream stream)
                             throws IOException

create a new DocumentEntry

Parameters:

name - the name of the new DocumentEntry

stream - the InputStream from which to create the new DocumentEntry

Returns:

the new DocumentEntry

Throws:

IOException

createDocument

DocumentEntry createDocument(String name,
                           int size,
                           POIFSWriterListener writer)
                             throws IOException

create a new DocumentEntry; the data will be provided later

Parameters:

name - the name of the new DocumentEntry

size - the size of the new DocumentEntry

writer - the writer of the new DocumentEntry

Returns:

the new DocumentEntry

Throws:

IOException

createDirectory

DirectoryEntry createDirectory(String name)
                               throws IOException

create a new DirectoryEntry

Parameters:

name - the name of the new DirectoryEntry

Returns:

the new DirectoryEntry

Throws:

IOException

getStorageClsid

ClassID getStorageClsid()

Gets the storage clsid of the directory entry

Returns:

storage Class ID

setStorageClsid

void setStorageClsid(ClassID clsidStorage)

Sets the storage clsid for the directory entry

Parameters:

clsidStorage - storage Class ID