Sample code for 30+ languages & platforms
Java Requires Chilkat v11.0.0+

Find ZIP Entries Matching a Wildcard Pattern Using EntryMatching

See more Zip Examples

This example demonstrates how to use the EntryMatching method to find ZIP entries whose stored paths match a wildcard pattern.

The wildcard character * matches zero or more characters. The comparison is performed against the full stored path within the ZIP archive.

This method is useful for:

  • Finding files having a particular extension
  • Locating files within specific subdirectories
  • Searching ZIP archives without manually iterating through every entry

Suppose the ZIP archive contains:

docs/
docs/readme.txt
docs/manual.pdf
images/logo.png
images/banner.jpg
data/config/settings.json

Notice that the ZIP archive contains an explicit directory entry named docs/. ZIP archives may optionally contain separate directory entries in addition to file entries.

When searching with the pattern docs/*, the first matching entry could therefore be the directory entry docs/ rather than a file contained within that directory.

The example searches for:

  • The first .png file
  • The first entry beneath the docs directory
  • The first JSON file anywhere within the ZIP archive

Chilkat Java Downloads

Chilkat2 Java
import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Zip;
import com.chilkatsoft.chilkat2.ZipEntry;

public class ChilkatExample {

    public static void main(String[] args) {
        boolean success = false;

        // Open an existing ZIP archive.
        Zip zip = new Zip();

        try {
            zip.openZip("example.zip");
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        ZipEntry entry = new ZipEntry();

        // ------------------------------------------------------------
        // Find the first .png file in the ZIP archive.

        try {
            zip.entryMatching("*.png", entry);
            success = true;
        } catch (ChilkatException e) {
            success = false;
        }
        if (success) {
            System.out.println("Found PNG file:");
            System.out.println("  " + entry.getFileName());
            System.out.println("");
        }

        // ------------------------------------------------------------
        // Find the first entry beneath the docs directory.
        //
        // Note: ZIP archives may optionally contain explicit directory
        // entries such as "docs/" in addition to file entries.
        // Therefore, the first matching entry could be the directory
        // itself rather than a file contained within the directory.

        try {
            zip.entryMatching("docs/*", entry);
            success = true;
        } catch (ChilkatException e) {
            success = false;
        }
        if (success) {
            System.out.println("First matching docs entry:");
            System.out.println("  " + entry.getFileName());
            System.out.println("  IsDirectory = " + entry.getIsDirectory());
            System.out.println("");
        }

        // ------------------------------------------------------------
        // Find the first JSON file anywhere in the ZIP archive.

        try {
            zip.entryMatching("*.json", entry);
            success = true;
        } catch (ChilkatException e) {
            success = false;
        }
        if (success) {
            System.out.println("Found JSON file:");
            System.out.println("  " + entry.getFileName());
            System.out.println("");
        }

        // ------------------------------------------------------------
        // The matching is performed against the full stored ZIP path.
        // For example:
        //
        //     docs/readme.txt
        //     images/logo.png
        //     data/config/settings.json
        //
        // The wildcard '*' matches zero or more characters.

        zip.closeZip();

        System.out.println("Done.");
    }
}