Class DecoratedFileObject

    • Constructor Detail

      • DecoratedFileObject

        public DecoratedFileObject​(FileObject decoratedFileObject)
    • Method Detail

      • canRenameTo

        public boolean canRenameTo​(FileObject newfile)
        Description copied from interface: FileObject
        Queries the file if it is possible to rename it to newfile.
        Specified by:
        canRenameTo in interface FileObject
        Parameters:
        newfile - the new file(-name)
        Returns:
        true it this is the case
      • close

        public void close()
                   throws FileSystemException
        Description copied from interface: FileObject
        Closes this file, and its content. This method is a hint to the implementation that it can release any resources associated with the file.

        The file object can continue to be used after this method is called.

        Specified by:
        close in interface FileObject
        Throws:
        FileSystemException - On error closing the file.
        See Also:
        FileContent.close()
      • copyFrom

        public void copyFrom​(FileObject srcFile,
                             FileSelector selector)
                      throws FileSystemException
        Description copied from interface: FileObject
        Copies another file, and all its descendents, to this file.

        If this file does not exist, it is created. Its parent folder is also created, if necessary. If this file does exist, it is deleted first.

        This method is not transactional. If it fails and throws an exception, this file will potentially only be partially copied.

        Specified by:
        copyFrom in interface FileObject
        Parameters:
        srcFile - The source file to copy.
        selector - The selector to use to select which files to copy.
        Throws:
        FileSystemException - If this file is read-only, or if the source file does not exist, or on error copying the file.
      • createFile

        public void createFile()
                        throws FileSystemException
        Description copied from interface: FileObject
        Creates this file, if it does not exist. Also creates any ancestor folders which do not exist. This method does nothing if the file already exists and is a file.
        Specified by:
        createFile in interface FileObject
        Throws:
        FileSystemException - If the file already exists with the wrong type, or the parent folder is read-only, or on error creating this file or one of its ancestors.
      • createFolder

        public void createFolder()
                          throws FileSystemException
        Description copied from interface: FileObject
        Creates this folder, if it does not exist. Also creates any ancestor folders which do not exist. This method does nothing if the folder already exists.
        Specified by:
        createFolder in interface FileObject
        Throws:
        FileSystemException - If the folder already exists with the wrong type, or the parent folder is read-only, or on error creating this folder or one of its ancestors.
      • delete

        public boolean delete()
                       throws FileSystemException
        Description copied from interface: FileObject
        Deletes this file. Does nothing if this file does not exist of if it is a folder that has children. Does not delete any descendents of this file, use FileObject.delete(FileSelector) for that.
        Specified by:
        delete in interface FileObject
        Returns:
        true if this object has been deleted
        Throws:
        FileSystemException - If this file is a non-empty folder, or if this file is read-only, or on error deleteing this file.
      • delete

        public int delete​(FileSelector selector)
                   throws FileSystemException
        Description copied from interface: FileObject
        Deletes all descendents of this file that match a selector. Does nothing if this file does not exist.

        This method is not transactional. If it fails and throws an exception, this file will potentially only be partially deleted.

        Specified by:
        delete in interface FileObject
        Parameters:
        selector - The selector to use to select which files to delete.
        Returns:
        the number of deleted objects
        Throws:
        FileSystemException - If this file or one of its descendents is read-only, or on error deleting this file or one of its descendents.
      • findFiles

        public void findFiles​(FileSelector selector,
                              boolean depthwise,
                              java.util.List selected)
                       throws FileSystemException
        Description copied from interface: FileObject
        Finds the set of matching descendents of this file.
        Specified by:
        findFiles in interface FileObject
        Parameters:
        selector - the selector used to determine if the file should be selected
        depthwise - controls the ordering in the list. e.g. deepest first
        selected - container for selected files. list needs not to be empty.
        Throws:
        FileSystemException
      • findFiles

        public FileObject[] findFiles​(FileSelector selector)
                               throws FileSystemException
        Description copied from interface: FileObject
        Finds the set of matching descendents of this file, in depthwise order.
        Specified by:
        findFiles in interface FileObject
        Parameters:
        selector - The selector to use to select matching files.
        Returns:
        The matching files. The files are returned in depthwise order (that is, a child appears in the list before its parent).
        Throws:
        FileSystemException
      • getChild

        public FileObject getChild​(java.lang.String name)
                            throws FileSystemException
        Description copied from interface: FileObject
        Returns a child of this file. Note that this method returns null when the child does not exist. This differs from FileObject.resolveFile( String, NameScope) which never returns null.
        Specified by:
        getChild in interface FileObject
        Parameters:
        name - The name of the child.
        Returns:
        The child, or null if there is no such child.
        Throws:
        FileSystemException - If this file does not exist, or is not a folder, or on error determining this file's children.
      • getChildren

        public FileObject[] getChildren()
                                 throws FileSystemException
        Description copied from interface: FileObject
        Lists the children of this file.
        Specified by:
        getChildren in interface FileObject
        Returns:
        An array containing the children of this file. The array is unordered. If the file does not have any children, a zero-length array is returned. This method never returns null.
        Throws:
        FileSystemException - If this file does not exist, or is not a folder, or on error listing this file's children.
      • getContent

        public FileContent getContent()
                               throws FileSystemException
        Description copied from interface: FileObject
        Returns this file's content. The FileContent returned by this method can be used to read and write the content of the file.

        This method can be called if the file does not exist, and the returned FileContent can be used to create the file by writing its content.

        Specified by:
        getContent in interface FileObject
        Returns:
        This file's content.
        Throws:
        FileSystemException - On error getting this file's content.
      • getFileSystem

        public FileSystem getFileSystem()
        Description copied from interface: FileObject
        Returns the file system that contains this file.
        Specified by:
        getFileSystem in interface FileObject
        Returns:
        The file system.
      • moveTo

        public void moveTo​(FileObject destFile)
                    throws FileSystemException
        Description copied from interface: FileObject
        Move this file.

        If the destFile exists, it is deleted first

        Specified by:
        moveTo in interface FileObject
        Parameters:
        destFile - the New filename.
        Throws:
        FileSystemException - If this file is read-only, or if the source file does not exist, or on error copying the file.
      • resolveFile

        public FileObject resolveFile​(java.lang.String name,
                                      NameScope scope)
                               throws FileSystemException
        Description copied from interface: FileObject
        Finds a file, relative to this file. Refer to NameScope for a description of how names are resolved in the different scopes.
        Specified by:
        resolveFile in interface FileObject
        Parameters:
        name - The name to resolve.
        Returns:
        The file.
        Throws:
        FileSystemException - On error parsing the path, or on error finding the file.
      • resolveFile

        public FileObject resolveFile​(java.lang.String path)
                               throws FileSystemException
        Description copied from interface: FileObject
        Finds a file, relative to this file. Equivalent to calling resolveFile( path, NameScope.FILE_SYSTEM ).
        Specified by:
        resolveFile in interface FileObject
        Parameters:
        path - The path of the file to locate. Can either be a relative path or an absolute path.
        Returns:
        The file.
        Throws:
        FileSystemException - On error parsing the path, or on error finding the file.
      • getDecoratedFileObject

        public FileObject getDecoratedFileObject()
      • isAttached

        public boolean isAttached()
        Description copied from interface: FileObject
        check if the fileObject is attaced
        Specified by:
        isAttached in interface FileObject
      • isContentOpen

        public boolean isContentOpen()
        Description copied from interface: FileObject
        check if someone reads/write to this file
        Specified by:
        isContentOpen in interface FileObject
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object