org.apache.commons.compress.archivers.sevenz.SevenZArchiveEntry Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of commons-compress Show documentation
Show all versions of commons-compress Show documentation
Apache Commons Compress defines an API for working with
compression and archive formats. These include bzip2, gzip, pack200,
LZMA, XZ, Snappy, traditional Unix Compress, DEFLATE, DEFLATE64, LZ4,
Brotli, Zstandard and ar, cpio, jar, tar, zip, dump, 7z, arj.
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.apache.commons.compress.archivers.sevenz;
import java.util.Calendar;
import java.util.Collections;
import java.util.Date;
import java.util.LinkedList;
import java.util.TimeZone;
import org.apache.commons.compress.archivers.ArchiveEntry;
/**
* An entry in a 7z archive.
*
* @NotThreadSafe
* @since 1.6
*/
public class SevenZArchiveEntry implements ArchiveEntry {
private String name;
private boolean hasStream;
private boolean isDirectory;
private boolean isAntiItem;
private boolean hasCreationDate;
private boolean hasLastModifiedDate;
private boolean hasAccessDate;
private long creationDate;
private long lastModifiedDate;
private long accessDate;
private boolean hasWindowsAttributes;
private int windowsAttributes;
private boolean hasCrc;
private long crc, compressedCrc;
private long size, compressedSize;
private Iterable contentMethods;
public SevenZArchiveEntry() {
}
/**
* Get this entry's name.
*
* @return This entry's name.
*/
@Override
public String getName() {
return name;
}
/**
* Set this entry's name.
*
* @param name This entry's new name.
*/
public void setName(final String name) {
this.name = name;
}
/**
* Whether there is any content associated with this entry.
* @return whether there is any content associated with this entry.
*/
public boolean hasStream() {
return hasStream;
}
/**
* Sets whether there is any content associated with this entry.
* @param hasStream whether there is any content associated with this entry.
*/
public void setHasStream(final boolean hasStream) {
this.hasStream = hasStream;
}
/**
* Return whether or not this entry represents a directory.
*
* @return True if this entry is a directory.
*/
@Override
public boolean isDirectory() {
return isDirectory;
}
/**
* Sets whether or not this entry represents a directory.
*
* @param isDirectory True if this entry is a directory.
*/
public void setDirectory(final boolean isDirectory) {
this.isDirectory = isDirectory;
}
/**
* Indicates whether this is an "anti-item" used in differential backups,
* meaning it should delete the same file from a previous backup.
* @return true if it is an anti-item, false otherwise
*/
public boolean isAntiItem() {
return isAntiItem;
}
/**
* Sets whether this is an "anti-item" used in differential backups,
* meaning it should delete the same file from a previous backup.
* @param isAntiItem true if it is an anti-item, false otherwise
*/
public void setAntiItem(final boolean isAntiItem) {
this.isAntiItem = isAntiItem;
}
/**
* Returns whether this entry has got a creation date at all.
* @return whether the entry has got a creation date
*/
public boolean getHasCreationDate() {
return hasCreationDate;
}
/**
* Sets whether this entry has got a creation date at all.
* @param hasCreationDate whether the entry has got a creation date
*/
public void setHasCreationDate(final boolean hasCreationDate) {
this.hasCreationDate = hasCreationDate;
}
/**
* Gets the creation date.
* @throws UnsupportedOperationException if the entry hasn't got a
* creation date.
* @return the creation date
*/
public Date getCreationDate() {
if (hasCreationDate) {
return ntfsTimeToJavaTime(creationDate);
}
throw new UnsupportedOperationException(
"The entry doesn't have this timestamp");
}
/**
* Sets the creation date using NTFS time (100 nanosecond units
* since 1 January 1601)
* @param ntfsCreationDate the creation date
*/
public void setCreationDate(final long ntfsCreationDate) {
this.creationDate = ntfsCreationDate;
}
/**
* Sets the creation date,
* @param creationDate the creation date
*/
public void setCreationDate(final Date creationDate) {
hasCreationDate = creationDate != null;
if (hasCreationDate) {
this.creationDate = javaTimeToNtfsTime(creationDate);
}
}
/**
* Returns whether this entry has got a last modified date at all.
* @return whether this entry has got a last modified date at all
*/
public boolean getHasLastModifiedDate() {
return hasLastModifiedDate;
}
/**
* Sets whether this entry has got a last modified date at all.
* @param hasLastModifiedDate whether this entry has got a last
* modified date at all
*/
public void setHasLastModifiedDate(final boolean hasLastModifiedDate) {
this.hasLastModifiedDate = hasLastModifiedDate;
}
/**
* Gets the last modified date.
* @throws UnsupportedOperationException if the entry hasn't got a
* last modified date.
* @return the last modified date
*/
@Override
public Date getLastModifiedDate() {
if (hasLastModifiedDate) {
return ntfsTimeToJavaTime(lastModifiedDate);
}
throw new UnsupportedOperationException(
"The entry doesn't have this timestamp");
}
/**
* Sets the last modified date using NTFS time (100 nanosecond
* units since 1 January 1601)
* @param ntfsLastModifiedDate the last modified date
*/
public void setLastModifiedDate(final long ntfsLastModifiedDate) {
this.lastModifiedDate = ntfsLastModifiedDate;
}
/**
* Sets the last modified date,
* @param lastModifiedDate the last modified date
*/
public void setLastModifiedDate(final Date lastModifiedDate) {
hasLastModifiedDate = lastModifiedDate != null;
if (hasLastModifiedDate) {
this.lastModifiedDate = javaTimeToNtfsTime(lastModifiedDate);
}
}
/**
* Returns whether this entry has got an access date at all.
* @return whether this entry has got an access date at all.
*/
public boolean getHasAccessDate() {
return hasAccessDate;
}
/**
* Sets whether this entry has got an access date at all.
* @param hasAcessDate whether this entry has got an access date at all.
*/
public void setHasAccessDate(final boolean hasAcessDate) {
this.hasAccessDate = hasAcessDate;
}
/**
* Gets the access date.
* @throws UnsupportedOperationException if the entry hasn't got a
* access date.
* @return the access date
*/
public Date getAccessDate() {
if (hasAccessDate) {
return ntfsTimeToJavaTime(accessDate);
}
throw new UnsupportedOperationException(
"The entry doesn't have this timestamp");
}
/**
* Sets the access date using NTFS time (100 nanosecond units
* since 1 January 1601)
* @param ntfsAccessDate the access date
*/
public void setAccessDate(final long ntfsAccessDate) {
this.accessDate = ntfsAccessDate;
}
/**
* Sets the access date,
* @param accessDate the access date
*/
public void setAccessDate(final Date accessDate) {
hasAccessDate = accessDate != null;
if (hasAccessDate) {
this.accessDate = javaTimeToNtfsTime(accessDate);
}
}
/**
* Returns whether this entry has windows attributes.
* @return whether this entry has windows attributes.
*/
public boolean getHasWindowsAttributes() {
return hasWindowsAttributes;
}
/**
* Sets whether this entry has windows attributes.
* @param hasWindowsAttributes whether this entry has windows attributes.
*/
public void setHasWindowsAttributes(final boolean hasWindowsAttributes) {
this.hasWindowsAttributes = hasWindowsAttributes;
}
/**
* Gets the windows attributes.
* @return the windows attributes
*/
public int getWindowsAttributes() {
return windowsAttributes;
}
/**
* Sets the windows attributes.
* @param windowsAttributes the windows attributes
*/
public void setWindowsAttributes(final int windowsAttributes) {
this.windowsAttributes = windowsAttributes;
}
/**
* Returns whether this entry has got a crc.
*
* In general entries without streams don't have a CRC either.
* @return whether this entry has got a crc.
*/
public boolean getHasCrc() {
return hasCrc;
}
/**
* Sets whether this entry has got a crc.
* @param hasCrc whether this entry has got a crc.
*/
public void setHasCrc(final boolean hasCrc) {
this.hasCrc = hasCrc;
}
/**
* Gets the CRC.
* @deprecated use getCrcValue instead.
* @return the CRC
*/
@Deprecated
public int getCrc() {
return (int) crc;
}
/**
* Sets the CRC.
* @deprecated use setCrcValue instead.
* @param crc the CRC
*/
@Deprecated
public void setCrc(final int crc) {
this.crc = crc;
}
/**
* Gets the CRC.
* @since Compress 1.7
* @return the CRC
*/
public long getCrcValue() {
return crc;
}
/**
* Sets the CRC.
* @since Compress 1.7
* @param crc the CRC
*/
public void setCrcValue(final long crc) {
this.crc = crc;
}
/**
* Gets the compressed CRC.
* @deprecated use getCompressedCrcValue instead.
* @return the compressed CRC
*/
@Deprecated
int getCompressedCrc() {
return (int) compressedCrc;
}
/**
* Sets the compressed CRC.
* @deprecated use setCompressedCrcValue instead.
* @param crc the CRC
*/
@Deprecated
void setCompressedCrc(final int crc) {
this.compressedCrc = crc;
}
/**
* Gets the compressed CRC.
* @since Compress 1.7
* @return the CRC
*/
long getCompressedCrcValue() {
return compressedCrc;
}
/**
* Sets the compressed CRC.
* @since Compress 1.7
* @param crc the CRC
*/
void setCompressedCrcValue(final long crc) {
this.compressedCrc = crc;
}
/**
* Get this entry's file size.
*
* @return This entry's file size.
*/
@Override
public long getSize() {
return size;
}
/**
* Set this entry's file size.
*
* @param size This entry's new file size.
*/
public void setSize(final long size) {
this.size = size;
}
/**
* Get this entry's compressed file size.
*
* @return This entry's compressed file size.
*/
long getCompressedSize() {
return compressedSize;
}
/**
* Set this entry's compressed file size.
*
* @param size This entry's new compressed file size.
*/
void setCompressedSize(final long size) {
this.compressedSize = size;
}
/**
* Sets the (compression) methods to use for entry's content - the
* default is LZMA2.
*
* Currently only {@link SevenZMethod#COPY}, {@link
* SevenZMethod#LZMA2}, {@link SevenZMethod#BZIP2} and {@link
* SevenZMethod#DEFLATE} are supported when writing archives.
*
* The methods will be consulted in iteration order to create
* the final output.
*
* @param methods the methods to use for the content
* @since 1.8
*/
public void setContentMethods(final Iterable methods) {
if (methods != null) {
final LinkedList l = new LinkedList<>();
for (final SevenZMethodConfiguration m : methods) {
l.addLast(m);
}
contentMethods = Collections.unmodifiableList(l);
} else {
contentMethods = null;
}
}
/**
* Gets the (compression) methods to use for entry's content - the
* default is LZMA2.
*
* Currently only {@link SevenZMethod#COPY}, {@link
* SevenZMethod#LZMA2}, {@link SevenZMethod#BZIP2} and {@link
* SevenZMethod#DEFLATE} are supported when writing archives.
*
* The methods will be consulted in iteration order to create
* the final output.
*
* @since 1.8
* @return the methods to use for the content
*/
public Iterable getContentMethods() {
return contentMethods;
}
/**
* Converts NTFS time (100 nanosecond units since 1 January 1601)
* to Java time.
* @param ntfsTime the NTFS time in 100 nanosecond units
* @return the Java time
*/
public static Date ntfsTimeToJavaTime(final long ntfsTime) {
final Calendar ntfsEpoch = Calendar.getInstance();
ntfsEpoch.setTimeZone(TimeZone.getTimeZone("GMT+0"));
ntfsEpoch.set(1601, 0, 1, 0, 0, 0);
ntfsEpoch.set(Calendar.MILLISECOND, 0);
final long realTime = ntfsEpoch.getTimeInMillis() + (ntfsTime / (10*1000));
return new Date(realTime);
}
/**
* Converts Java time to NTFS time.
* @param date the Java time
* @return the NTFS time
*/
public static long javaTimeToNtfsTime(final Date date) {
final Calendar ntfsEpoch = Calendar.getInstance();
ntfsEpoch.setTimeZone(TimeZone.getTimeZone("GMT+0"));
ntfsEpoch.set(1601, 0, 1, 0, 0, 0);
ntfsEpoch.set(Calendar.MILLISECOND, 0);
return ((date.getTime() - ntfsEpoch.getTimeInMillis())* 1000 * 10);
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy