org.apache.poi.poifs.filesystem
Interface Entry

All Known Subinterfaces:
DirectoryEntry, DocumentEntry
All Known Implementing Classes:
EntryNode

public interface Entry

This interface provides access to an object managed by a Filesystem instance. Entry objects are further divided into DocumentEntry and DirectoryEntry instances.

Author:
Marc Johnson (mjohnson at apache dot org)

Method Summary
 boolean delete()
          Delete this Entry.
 java.lang.String getName()
          get the name of the Entry
 DirectoryEntry getParent()
          get this Entry's parent (the DirectoryEntry that owns this Entry).
 boolean isDirectoryEntry()
          is this a DirectoryEntry?
 boolean isDocumentEntry()
          is this a DocumentEntry?
 boolean renameTo(java.lang.String newName)
          Rename this Entry.
 

Method Detail

getName

public java.lang.String getName()
get the name of the Entry
Returns:
name

isDirectoryEntry

public boolean isDirectoryEntry()
is this a DirectoryEntry?
Returns:
true if the Entry is a DirectoryEntry, else false

isDocumentEntry

public boolean isDocumentEntry()
is this a DocumentEntry?
Returns:
true if the Entry is a DocumentEntry, else false

getParent

public DirectoryEntry getParent()
get this Entry's parent (the DirectoryEntry that owns this Entry). All Entry objects, except the root Entry, has a parent.
Returns:
this Entry's parent; null iff this is the root Entry

delete

public boolean delete()
Delete this Entry. This operation should succeed, but there are special circumstances when it will not: If this Entry is the root of the Entry tree, it cannot be deleted, as there is no way to create another one. If this Entry is a directory, it cannot be deleted unless it is empty.
Returns:
true if the Entry was successfully deleted, else false

renameTo

public boolean renameTo(java.lang.String newName)
Rename this Entry. This operation will fail if: There is a sibling Entry (i.e., an Entry whose parent is the same as this Entry's parent) with the same name. This Entry is the root of the Entry tree. Its name is dictated by the Filesystem and many not be changed.
Parameters:
newName - the new name for this Entry
Returns:
true if the operation succeeded, else false


Copyright © 2002 Apache jakarta-poi project. All Rights Reserved.