de.schlichtherle.truezip.file.package.html Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of truezip-file Show documentation

This module provides the TFile* classes for simple, uniform, transparent, thread-safe, read/write access to archive files as if they were virtual directories in a file system path. This module also provides Swing GUI classes for viewing file trees and choosing entries in archive files.

There is a newer version: 7.7.10

Show newest version





    Package Summary
    
        
            Provides uniform, transparent, thread-safe,
            read/write access to archive files as if they were just plain
            directories in a file system path by means of the
            TFile* classes and their dependent classes.
        
        
            This is the primary API for JSE 6 compliant TrueZIP applications:
            Like the API of the module TrueZIP Path, this API is a facade for
            the module TrueZIP Kernel.
            In contrast to the TrueZIP Path API however, this API is limited
            to access the platform file system and any archive files within
            the platform file system.
            In contrast to the TrueZIP Kernel API, both APIs are designed to be
            easy to learn and convenient to use while providing a great level
            of flexibility.
            Because all virtual file system state is managed by the TrueZIP
            Kernel module, this module can concurrently access the same file
            systems than the TrueZIP Path module.
        
        
            For example, an application could access an entry within an archive
            file using a {@code TFile} like this:
        
        
    File file = new TFile("archive.tar.gz/README.TXT");
    Writer out = new TFileWriter(file);
    try {
        // Write archive entry contents here.
        ...
    } finally {
        out.close();
    }
        
        
            This example presumes that the JARs of the file system driver
            modules TrueZIP Driver File and TrueZIP Driver TAR are present
            on the run time class path.
        
        
            Mind that a TFile is a File, so you can
            use it polymorphically.
            However, you cannot use it with a plain
            File(In|Out)putStream or a plain
            File(Reader|Writer) to access prospective archive
            entries because these classes were not designed for this task.
            You have to use a TFile(In|Out)putStream or a
            TFile(Reader|Writer) instead.