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 * If this extra field is added as the very first extra field of the
25 * archive, Solaris will consider it an executable jar file.
29 public final class JarMarker implements ZipExtraField {
31 private static final ZipShort ID = new ZipShort(0xCAFE);
32 private static final ZipShort NULL = new ZipShort(0);
33 private static final byte[] NO_BYTES = new byte[0];
34 private static final JarMarker DEFAULT = new JarMarker();
36 /** No-arg constructor */
42 * Since JarMarker is stateless we can always use the same instance.
43 * @return the DEFAULT jarmaker.
45 public static JarMarker getInstance() {
51 * @return the header id
53 public ZipShort getHeaderId() {
58 * Length of the extra field in the local file data - without
59 * Header-ID or length specifier.
62 public ZipShort getLocalFileDataLength() {
67 * Length of the extra field in the central directory - without
68 * Header-ID or length specifier.
71 public ZipShort getCentralDirectoryLength() {
76 * The actual data to put into local file data - without Header-ID
77 * or length specifier.
81 public byte[] getLocalFileDataData() {
86 * The actual data to put central directory - without Header-ID or
90 public byte[] getCentralDirectoryData() {
95 * Populate data from this array as if it was in local file data.
96 * @param data an array of bytes
97 * @param offset the start offset
98 * @param length the number of bytes in the array from offset
100 * @throws ZipException on error
102 public void parseFromLocalFileData(byte[] data, int offset, int length)
103 throws ZipException {
105 throw new ZipException("JarMarker doesn't expect any data");