loci.poi.poifs.filesystem

Class DirectoryNode

java.lang.Object

loci.poi.poifs.filesystem.EntryNode

loci.poi.poifs.filesystem.DirectoryNode

All Implemented Interfaces:

POIFSViewable, DirectoryEntry, Entry

public class DirectoryNode
extends EntryNode
implements DirectoryEntry, POIFSViewable

Simple implementation of DirectoryEntry

Author:

Marc Johnson (mjohnson at apache dot org)

Field Summary

Fields

Modifier and Type	Field and Description
private Map	_entries
private POIFSFileSystem	_filesystem
private POIFSDocumentPath	_path

Constructor Summary

Constructors

Constructor and Description
DirectoryNode(DirectoryProperty property, POIFSFileSystem filesystem, DirectoryNode parent) create a DirectoryNode.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) boolean	changeName(String oldName, String newName) Change a contained Entry's name
DirectoryEntry	createDirectory(String name) create a new DirectoryEntry
(package private) DocumentEntry	createDocument(POIFSDocument document) create a new DocumentEntry
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
(package private) boolean	deleteEntry(EntryNode entry) Delete an entry
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
POIFSDocumentPath	getPath()
String	getShortDescription() Provides a short description of the object, to be used when a POIFSViewable object has not provided its contents.
ClassID	getStorageClsid() Gets the storage clsid of the directory entry
Object[]	getViewableArray() Get an array of objects, some of which may implement POIFSViewable
Iterator	getViewableIterator() Get an Iterator of objects, some of which may implement POIFSViewable
protected boolean	isDeleteOK() extensions use this method to verify internal rules regarding deletion of the underlying store.
boolean	isDirectoryEntry() is this a DirectoryEntry?
boolean	isEmpty() is this DirectoryEntry empty?
boolean	preferArray() Give viewers a hint as to whether to call getViewableArray or getViewableIterator
void	setStorageClsid(ClassID clsidStorage) Sets the storage clsid for the directory entry

Methods inherited from class loci.poi.poifs.filesystem.EntryNode

delete, getName, getParent, getProperty, isDocumentEntry, isRoot, renameTo

Methods inherited from class java.lang.Object

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

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

delete, getName, getParent, isDocumentEntry, renameTo

Field Detail

_entries

private Map _entries

_filesystem

private POIFSFileSystem _filesystem

_path

private POIFSDocumentPath _path

Constructor Detail

DirectoryNode

DirectoryNode(DirectoryProperty property,
             POIFSFileSystem filesystem,
             DirectoryNode parent)

create a DirectoryNode. This method is not public by design; it is intended strictly for the internal use of this package

Parameters:

property - the DirectoryProperty for this DirectoryEntry

filesystem - the POIFSFileSystem we belong to

parent - the parent of this entry

Method Detail

getPath

public POIFSDocumentPath getPath()

Returns:

this directory's path representation

createDocument

DocumentEntry createDocument(POIFSDocument document)
                       throws IOException

create a new DocumentEntry

Parameters:

document - the new document

Returns:

the new DocumentEntry

Throws:

IOException

changeName

boolean changeName(String oldName,
                 String newName)

Change a contained Entry's name

Parameters:

oldName - the original name

newName - the new name

Returns:

true if the operation succeeded, else false

deleteEntry

boolean deleteEntry(EntryNode entry)

Delete an entry

Parameters:

entry - the EntryNode to be deleted

Returns:

true if the entry was deleted, else false

getEntries

public Iterator getEntries()

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

Specified by:

getEntries in interface DirectoryEntry

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

public boolean isEmpty()

is this DirectoryEntry empty?

Specified by:

isEmpty in interface DirectoryEntry

Returns:

true if this instance contains no Entry instances

getEntryCount

public int getEntryCount()

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

Specified by:

getEntryCount in interface DirectoryEntry

Returns:

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

getEntry

public Entry getEntry(String name)
               throws FileNotFoundException

get a specified Entry by name

Specified by:

getEntry in interface DirectoryEntry

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

public DocumentEntry createDocument(String name,
                           RandomAccessInputStream stream)
                             throws IOException

create a new DocumentEntry

Specified by:

createDocument in interface DirectoryEntry

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

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

create a new DocumentEntry; the data will be provided later

Specified by:

createDocument in interface DirectoryEntry

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

public DirectoryEntry createDirectory(String name)
                               throws IOException

create a new DirectoryEntry

Specified by:

createDirectory in interface DirectoryEntry

Parameters:

name - the name of the new DirectoryEntry

Returns:

the new DirectoryEntry

Throws:

IOException

getStorageClsid

public ClassID getStorageClsid()

Gets the storage clsid of the directory entry

Specified by:

getStorageClsid in interface DirectoryEntry

Returns:

storage Class ID

setStorageClsid

public void setStorageClsid(ClassID clsidStorage)

Sets the storage clsid for the directory entry

Specified by:

setStorageClsid in interface DirectoryEntry

Parameters:

clsidStorage - storage Class ID

isDirectoryEntry

public boolean isDirectoryEntry()

is this a DirectoryEntry?

Specified by:

isDirectoryEntry in interface Entry

Overrides:

isDirectoryEntry in class EntryNode

Returns:

true if the Entry is a DirectoryEntry, else false

isDeleteOK

protected boolean isDeleteOK()

extensions use this method to verify internal rules regarding deletion of the underlying store.

Specified by:

isDeleteOK in class EntryNode

Returns:

true if it's ok to delete the underlying store, else false

getViewableArray

public Object[] getViewableArray()

Get an array of objects, some of which may implement POIFSViewable

Specified by:

getViewableArray in interface POIFSViewable

Returns:

an array of Object; may not be null, but may be empty

getViewableIterator

public Iterator getViewableIterator()

Get an Iterator of objects, some of which may implement POIFSViewable

Specified by:

getViewableIterator in interface POIFSViewable

Returns:

an Iterator; may not be null, but may have an empty back end store

preferArray

public boolean preferArray()

Give viewers a hint as to whether to call getViewableArray or getViewableIterator

Specified by:

preferArray in interface POIFSViewable

Returns:

true if a viewer should call getViewableArray, false if a viewer should call getViewableIterator

getShortDescription

public String getShortDescription()

Provides a short description of the object, to be used when a POIFSViewable object has not provided its contents.

Specified by:

getShortDescription in interface POIFSViewable

Returns:

short description