org.cloudfoundry.tools.io.zip.ZipArchive.java Source code

Introduction

Here is the source code for org.cloudfoundry.tools.io.zip.ZipArchive.java

Source

/*
 * Copyright 2010-2012 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.cloudfoundry.tools.io.zip;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.zip.ZipEntry;
import java.util.zip.ZipInputStream;

import org.cloudfoundry.tools.io.File;
import org.cloudfoundry.tools.io.Folder;
import org.cloudfoundry.tools.io.NoCloseInputStream;
import org.cloudfoundry.tools.io.Resources;
import org.cloudfoundry.tools.io.exception.ResourceException;
import org.cloudfoundry.tools.io.store.FolderStore;
import org.cloudfoundry.tools.io.store.StoredFolder;
import org.cloudfoundry.tools.io.zip.ZipResourceStore.ZipFolderStore;
import org.springframework.util.Assert;

/**
 * Adapter class that can be used present a zip file as a {@link Folder}. This class can also be used to
 * {@link #unpack(File, Folder) unpack} zip files into an existing folder and {@link #compress(Resources) compress}
 * resources into a zip archive.
 * 
 * @author Phillip Webb
 */
public class ZipArchive extends StoredFolder {

    private final ZipFolderStore store;

    /**
     * Create a new {@link ZipArchive} instance from the specified zip file.
     * 
     * @param zipFile the zip file
     */
    public ZipArchive(File zipFile) {
        this.store = new ZipFolderStore(zipFile);
    }

    @Override
    protected FolderStore getStore() {
        return this.store;
    }

    /**
     * Unzip the specified zip file into a folder.
     * 
     * @param file the file to unzip (this must reference a zip file)
     * @param destination the destination folder
     * @see #unpack(InputStream, Folder)
     */
    public static void unpack(File file, Folder destination) {
        Assert.notNull(file, "File must not be null");
        Assert.notNull(destination, "Destination must not be null");
        unpack(file.getContent().asInputStream(), destination);
    }

    /**
     * Unzip the specified input stream into a folder.
     * 
     * @param inputStream the input stream to unzip (this must contain zip contents)
     * @param destination the destination folder
     * @see #unpack(File, Folder)
     */
    public static void unpack(InputStream inputStream, Folder destination) {
        Assert.notNull(inputStream, "InputStream must not be null");
        Assert.notNull(destination, "Destination must not be null");
        destination.createIfMissing();
        ZipInputStream zip = new ZipInputStream(new BufferedInputStream(inputStream));
        try {
            InputStream noCloseZip = new NoCloseInputStream(zip);
            ZipEntry entry = zip.getNextEntry();
            while (entry != null) {
                if (entry.isDirectory()) {
                    destination.getFolder(entry.getName()).createIfMissing();
                } else {
                    destination.getFile(entry.getName()).getContent().write(noCloseZip);
                }
                entry = zip.getNextEntry();
            }
        } catch (IOException e) {
            throw new ResourceException(e);
        } finally {
            try {
                zip.close();
            } catch (IOException e) {
            }
        }
    }

    /**
     * Create a {@link InputStream} containing a zip representation of the given folder.
     * 
     * @param folder the folder to compress
     * @return the zipped input stream
     */
    public static InputStream compress(Folder folder) {
        return compress(folder, null);
    }

    /**
     * Create a {@link InputStream} containing a zip representation of the given folder.
     * 
     * @param folder the folder to compress
     * @param prefix an optional entry prefix. This allows a entries to be nested within a folder if required
     * @return the zipped input stream
     */
    public static InputStream compress(Folder folder, String prefix) {
        return compress(folder.find(), prefix);
    }

    /**
     * Create a {@link InputStream} containing a zip representation of the given resources.
     * 
     * @param resources resources to compress
     * @return the zipped input stream
     */
    public static InputStream compress(Resources<?> resources) {
        return compress(resources, null);
    }

    /**
     * Create a {@link InputStream} containing a zip representation of the given resources.
     * 
     * @param resources resources to compress
     * @param prefix an optional entry prefix. This allows a entries to be nested within a folder if required
     * @return the zipped input stream
     */
    public static InputStream compress(Resources<?> resources, String prefix) {
        return new ZipResourcesStream(resources, prefix);
    }

}