/*
* 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.Iterator;
import java.util.LinkedList;
import java.util.Objects;
import java.util.TimeZone;
import org.apache.commons.compress.archivers.ArchiveEntry;
An entry in a 7z archive.
@NotThreadSafe Since: 1.6
/**
* 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<? extends SevenZMethodConfiguration> contentMethods;
public SevenZArchiveEntry() {
}
Get this entry's name.
This method returns the raw name as it is stored inside of the archive.
Returns: This entry's name.
/**
* Get this entry's name.
*
* <p>This method returns the raw name as it is stored inside of the archive.</p>
*
* @return This entry's name.
*/
@Override
public String getName() {
return name;
}
Set this entry's name.
Params: - name – This entry's new 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.
Returns: whether there is any content associated with this entry.
/**
* 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.
Params: - hasStream – whether there is any content associated with this entry.
/**
* 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.
Returns: True if this entry is a directory.
/**
* 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.
Params: - isDirectory – True if this entry is a directory.
/**
* 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.
Returns: true if it is an anti-item, false otherwise
/**
* 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.
Params: - isAntiItem – true if it is an anti-item, false otherwise
/**
* 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.
Returns: whether the entry has got a creation date
/**
* 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.
Params: - hasCreationDate – whether the entry has got a creation date
/**
* 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.
Returns: the creation date
/**
* 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)
Params: - ntfsCreationDate – the creation date
/**
* 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,
Params: - creationDate – the creation date
/**
* 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.
Returns: whether this entry has got a last modified date at all
/**
* 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.
Params: - hasLastModifiedDate – whether this entry has got a last
modified date at all
/**
* 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.
Returns: the last modified date
/**
* 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)
Params: - ntfsLastModifiedDate – the last modified date
/**
* 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,
Params: - lastModifiedDate – the last modified date
/**
* 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.
Returns: whether this entry has got an access date at all.
/**
* 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.
Params: - hasAcessDate – whether this entry has got an access date at all.
/**
* 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.
Returns: the access date
/**
* 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)
Params: - ntfsAccessDate – the access date
/**
* 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,
Params: - accessDate – the access date
/**
* 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.
Returns: whether this entry has windows attributes.
/**
* 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.
Params: - hasWindowsAttributes – whether this entry has windows attributes.
/**
* 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.
Returns: the windows attributes
/**
* Gets the windows attributes.
* @return the windows attributes
*/
public int getWindowsAttributes() {
return windowsAttributes;
}
Sets the windows attributes.
Params: - windowsAttributes – the windows attributes
/**
* 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.
Returns: whether this entry has got a crc.
/**
* Returns whether this entry has got a crc.
*
* <p>In general entries without streams don't have a CRC either.</p>
* @return whether this entry has got a crc.
*/
public boolean getHasCrc() {
return hasCrc;
}
Sets whether this entry has got a crc.
Params: - hasCrc – whether this entry has got a crc.
/**
* 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. Returns: the CRC
/**
* Gets the CRC.
* @deprecated use getCrcValue instead.
* @return the CRC
*/
@Deprecated
public int getCrc() {
return (int) crc;
}
Sets the CRC.
Params: - crc – the CRC
Deprecated: use setCrcValue instead.
/**
* 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 Returns: the CRC
/**
* Gets the CRC.
* @since Compress 1.7
* @return the CRC
*/
public long getCrcValue() {
return crc;
}
Sets the CRC.
Params: - crc – the CRC
Since: Compress 1.7
/**
* 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. Returns: the compressed CRC
/**
* Gets the compressed CRC.
* @deprecated use getCompressedCrcValue instead.
* @return the compressed CRC
*/
@Deprecated
int getCompressedCrc() {
return (int) compressedCrc;
}
Sets the compressed CRC.
Params: - crc – the CRC
Deprecated: use setCompressedCrcValue instead.
/**
* 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 Returns: the CRC
/**
* Gets the compressed CRC.
* @since Compress 1.7
* @return the CRC
*/
long getCompressedCrcValue() {
return compressedCrc;
}
Sets the compressed CRC.
Params: - crc – the CRC
Since: Compress 1.7
/**
* 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.
Returns: This entry's file size.
/**
* Get this entry's file size.
*
* @return This entry's file size.
*/
@Override
public long getSize() {
return size;
}
Set this entry's file size.
Params: - size – This entry's new file 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.
Returns: This entry's compressed file 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.
Params: - size – This entry's new compressed file size.
/**
* 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 SevenZMethod.COPY
, SevenZMethod.LZMA2
, SevenZMethod.BZIP2
and SevenZMethod.DEFLATE
are supported when writing archives.
The methods will be consulted in iteration order to create
the final output.
Params: - methods – the methods to use for the content
Since: 1.8
/**
* Sets the (compression) methods to use for entry's content - the
* default is LZMA2.
*
* <p>Currently only {@link SevenZMethod#COPY}, {@link
* SevenZMethod#LZMA2}, {@link SevenZMethod#BZIP2} and {@link
* SevenZMethod#DEFLATE} are supported when writing archives.</p>
*
* <p>The methods will be consulted in iteration order to create
* the final output.</p>
*
* @param methods the methods to use for the content
* @since 1.8
*/
public void setContentMethods(final Iterable<? extends SevenZMethodConfiguration> methods) {
if (methods != null) {
final LinkedList<SevenZMethodConfiguration> 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 SevenZMethod.COPY
, SevenZMethod.LZMA2
, SevenZMethod.BZIP2
and SevenZMethod.DEFLATE
are supported when writing archives.
The methods will be consulted in iteration order to create
the final output.
Since: 1.8 Returns: the methods to use for the content
/**
* Gets the (compression) methods to use for entry's content - the
* default is LZMA2.
*
* <p>Currently only {@link SevenZMethod#COPY}, {@link
* SevenZMethod#LZMA2}, {@link SevenZMethod#BZIP2} and {@link
* SevenZMethod#DEFLATE} are supported when writing archives.</p>
*
* <p>The methods will be consulted in iteration order to create
* the final output.</p>
*
* @since 1.8
* @return the methods to use for the content
*/
public Iterable<? extends SevenZMethodConfiguration> getContentMethods() {
return contentMethods;
}
@Override
public int hashCode() {
final String n = getName();
return n == null ? 0 : n.hashCode();
}
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj == null || getClass() != obj.getClass()) {
return false;
}
final SevenZArchiveEntry other = (SevenZArchiveEntry) obj;
return
Objects.equals(name, other.name) &&
hasStream == other.hasStream &&
isDirectory == other.isDirectory &&
isAntiItem == other.isAntiItem &&
hasCreationDate == other.hasCreationDate &&
hasLastModifiedDate == other.hasLastModifiedDate &&
hasAccessDate == other.hasAccessDate &&
creationDate == other.creationDate &&
lastModifiedDate == other.lastModifiedDate &&
accessDate == other.accessDate &&
hasWindowsAttributes == other.hasWindowsAttributes &&
windowsAttributes == other.windowsAttributes &&
hasCrc == other.hasCrc &&
crc == other.crc &&
compressedCrc == other.compressedCrc &&
size == other.size &&
compressedSize == other.compressedSize &&
equalSevenZMethods(contentMethods, other.contentMethods);
}
Converts NTFS time (100 nanosecond units since 1 January 1601)
to Java time.
Params: - ntfsTime – the NTFS time in 100 nanosecond units
Returns: the Java time
/**
* 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.
Params: - date – the Java time
Returns: the NTFS time
/**
* 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);
}
private boolean equalSevenZMethods(Iterable<? extends SevenZMethodConfiguration> c1,
Iterable<? extends SevenZMethodConfiguration> c2) {
if (c1 == null) {
return c2 == null;
}
if (c2 == null) {
return false;
}
Iterator<? extends SevenZMethodConfiguration> i1 = c1.iterator();
Iterator<? extends SevenZMethodConfiguration> i2 = c2.iterator();
while (i1.hasNext()) {
if (!i2.hasNext()) {
return false;
}
if (!i1.next().equals(i2.next())) {
return false;
}
}
if (i2.hasNext()) {
return false;
}
return true;
}
}