2 * Licensed to the Apache Software Foundation (ASF) under one or more
3 * contributor license agreements. See the NOTICE file distributed with
4 * this work for additional information regarding copyright ownership.
5 * The ASF licenses this file to You under the Apache License, Version 2.0
6 * (the "License"); you may not use this file except in compliance with
7 * the License. You may obtain a copy of the License at
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
19 package org.apache.tools.zip;
21 import java.util.zip.ZipException;
24 * General format of extra field data.
26 * <p>Extra fields usually appear twice per file, once in the local
27 * file data and once in the central directory. Usually they are the
28 * same, but they don't have to be. {@link
29 * java.util.zip.ZipOutputStream java.util.zip.ZipOutputStream} will
30 * only use the local file data in both places.</p>
33 public interface ZipExtraField {
37 * @return the header id
40 ZipShort getHeaderId();
43 * Length of the extra field in the local file data - without
44 * Header-ID or length specifier.
45 * @return the length of the field in the local file data
48 ZipShort getLocalFileDataLength();
51 * Length of the extra field in the central directory - without
52 * Header-ID or length specifier.
53 * @return the length of the field in the central directory
56 ZipShort getCentralDirectoryLength();
59 * The actual data to put into local file data - without Header-ID
60 * or length specifier.
64 byte[] getLocalFileDataData();
67 * The actual data to put central directory - without Header-ID or
72 byte[] getCentralDirectoryData();
75 * Populate data from this array as if it was in local file data.
76 * @param data an array of bytes
77 * @param offset the start offset
78 * @param length the number of bytes in the array from offset
81 * @throws ZipException on error
83 void parseFromLocalFileData(byte[] data, int offset, int length)