Package org.docx4j.org.apache.poi.poifs.filesystem

Class DirectoryNode

java.lang.Object
org.docx4j.org.apache.poi.poifs.filesystem.EntryNode
org.docx4j.org.apache.poi.poifs.filesystem.DirectoryNode
All Implemented Interfaces:
Iterable<Entry>, POIFSViewable, DirectoryEntry, Entry
public class DirectoryNode extends EntryNode implements DirectoryEntry, POIFSViewable, Iterable<Entry>
Simple implementation of DirectoryEntry

  • Field Details

  • Constructor Details

    • DirectoryNode

      DirectoryNode(DirectoryProperty property, OPOIFSFileSystem 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 OPOIFSFileSystem we belong to
      parent - the parent of this entry

    • DirectoryNode

      DirectoryNode(DirectoryProperty property, NPOIFSFileSystem nfilesystem, 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
      nfilesystem - the NPOIFSFileSystem we belong to
      parent - the parent of this entry

    • DirectoryNode

      private DirectoryNode(DirectoryProperty property, DirectoryNode parent, OPOIFSFileSystem ofilesystem, NPOIFSFileSystem nfilesystem)

  • Method Details

    • getPath

      public POIFSDocumentPath getPath()
      Returns:
      this directory's path representation

    • getFileSystem

      public NPOIFSFileSystem getFileSystem()
      Returns:
      the filesystem that this belongs to

    • getOFileSystem

      public OPOIFSFileSystem getOFileSystem()
      If this is OPOIFS based, return the NPOIFSFileSystem that this belong to, otherwise Null if NPOIFS based
      Returns:
      the filesystem that this belongs to

    • getNFileSystem

      public NPOIFSFileSystem getNFileSystem()
      If this is NPOIFS based, return the NPOIFSFileSystem that this belong to, otherwise Null if OPOIFS based
      Returns:
      the filesystem that this belongs to

    • createDocumentInputStream

      public DocumentInputStream createDocumentInputStream(String documentName) throws IOException
      open a document in the directory's entry's list of entries
      Parameters:
      documentName - the name of the document to be opened
      Returns:
      a newly opened DocumentInputStream
      Throws:
      IOException - if the document does not exist or the name is that of a DirectoryEntry

    • createDocumentInputStream

      public DocumentInputStream createDocumentInputStream(Entry document) throws IOException
      open a document in the directory's entry's list of entries
      Parameters:
      document - the document to be opened
      Returns:
      a newly opened DocumentInputStream or NDocumentInputStream
      Throws:
      IOException - if the document does not exist or the name is that of a DirectoryEntry

    • createDocument

      DocumentEntry createDocument(OPOIFSDocument document) throws IOException
      create a new DocumentEntry
      Parameters:
      document - the new document
      Returns:
      the new DocumentEntry
      Throws:
      IOException

    • createDocument

      DocumentEntry createDocument(NPOIFSDocument 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<Entry> 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.

    • getEntryNames

      public Set<String> getEntryNames()
      get the names of all the Entries contained directly in this instance (in other words, names of children only; no grandchildren etc).
      Specified by:
      getEntryNames in interface DirectoryEntry
      Returns:
      the names of all the entries that may be retrieved with getEntry(String), which may be empty (if this DirectoryEntry is empty)

    • 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

    • hasEntry

      public boolean hasEntry(String name)
      Description copied from interface: DirectoryEntry
      Checks if entry with specified name present
      Specified by:
      hasEntry in interface DirectoryEntry

    • 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, InputStream 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<Object> 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

    • iterator

      public Iterator<Entry> iterator()
      Returns an Iterator over all the entries
      Specified by:
      iterator in interface Iterable<Entry>