    001/*
    002 *  Licensed to the Apache Software Foundation (ASF) under one or more
    003 *  contributor license agreements.  See the NOTICE file distributed with
    004 *  this work for additional information regarding copyright ownership.
    005 *  The ASF licenses this file to You under the Apache License, Version 2.0
    006 *  (the "License"); you may not use this file except in compliance with
    007 *  the License.  You may obtain a copy of the License at
    008 *
    009 *      http://www.apache.org/licenses/LICENSE-2.0
    010 *
    011 *  Unless required by applicable law or agreed to in writing, software
    012 *  distributed under the License is distributed on an "AS IS" BASIS,
    013 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    014 *  See the License for the specific language governing permissions and
    015 *  limitations under the License.
    016 *
    017 */
    018package org.apache.commons.compress.archivers.zip;
    019
    020import org.apache.commons.compress.parallel.InputStreamSupplier;
    021
    022import java.io.InputStream;
    023
    024/**
    025 * A Thread-safe representation of a ZipArchiveEntry that is used to add entries to parallel archives.
    026 *
    027 * @since 1.10
    028 */
    029public class ZipArchiveEntryRequest {
    030    /*
    031     The zipArchiveEntry is not thread safe, and cannot be safely accessed by the getters of this class.
    032     It is safely accessible during the construction part of this class and also after the
    033     thread pools have been shut down.
    034     */
    035    private final ZipArchiveEntry zipArchiveEntry;
    036    private final InputStreamSupplier payloadSupplier;
    037    private final int method;
    038
    039
    040    private ZipArchiveEntryRequest(final ZipArchiveEntry zipArchiveEntry, final InputStreamSupplier payloadSupplier) {
    041        // this constructor has "safe" access to all member variables on zipArchiveEntry
    042        this.zipArchiveEntry = zipArchiveEntry;
    043        this.payloadSupplier = payloadSupplier;
    044        this.method = zipArchiveEntry.getMethod();
    045    }
    046
    047    /**
    048     * Create a ZipArchiveEntryRequest
    049     * @param zipArchiveEntry The entry to use
    050     * @param payloadSupplier The payload that will be added to the zip entry.
    051     * @return The newly created request
    052     */
    053    public static ZipArchiveEntryRequest createZipArchiveEntryRequest(final ZipArchiveEntry zipArchiveEntry, final InputStreamSupplier payloadSupplier) {
    054        return new ZipArchiveEntryRequest(zipArchiveEntry, payloadSupplier);
    055    }
    056
    057    /**
    058     * The paylaod that will be added to this zip entry
    059     * @return The input stream.
    060     */
    061    public InputStream getPayloadStream() {
    062        return payloadSupplier.get();
    063    }
    064
    065    /**
    066     * The compression method to use
    067     * @return The compression method to use
    068     */
    069    public int getMethod(){
    070       return method;
    071    }
    072
    073
    074    /**
    075     * Gets the underlying entry. Do not use this methods from threads that did not create the instance itself !
    076     * @return the zipeArchiveEntry that is basis for this request
    077     */
    078    ZipArchiveEntry getZipArchiveEntry() {
    079        return zipArchiveEntry;
    080    }
    081}