git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@271947 13f79535-47bb-0310-9956-ffa450edef68master
| @@ -1,488 +0,0 @@ | |||
| /* | |||
| * Copyright (C) The Apache Software Foundation. All rights reserved. | |||
| * | |||
| * This software is published under the terms of the Apache Software License | |||
| * version 1.1, a copy of which has been included with this distribution in | |||
| * the LICENSE.txt file. | |||
| */ | |||
| package org.apache.aut.tar; | |||
| import java.io.IOException; | |||
| import java.io.InputStream; | |||
| import java.io.OutputStream; | |||
| /** | |||
| * The TarBuffer class implements the tar archive concept of a buffered input | |||
| * stream. This concept goes back to the days of blocked tape drives and special | |||
| * io devices. In the Java universe, the only real function that this class | |||
| * performs is to ensure that files have the correct "block" size, or other tars | |||
| * will complain. <p> | |||
| * | |||
| * You should never have a need to access this class directly. TarBuffers are | |||
| * created by Tar IO Streams. | |||
| * | |||
| * @author <a href="mailto:time@ice.com">Timothy Gerard Endres</a> | |||
| * @author <a href="mailto:peter@apache.org">Peter Donald</a> | |||
| */ | |||
| class TarBuffer | |||
| { | |||
| public final static int DEFAULT_RCDSIZE = ( 512 ); | |||
| public final static int DEFAULT_BLKSIZE = ( DEFAULT_RCDSIZE * 20 ); | |||
| private byte[] m_blockBuffer; | |||
| private int m_blockSize; | |||
| private int m_currBlkIdx; | |||
| private int m_currRecIdx; | |||
| private boolean m_debug; | |||
| private InputStream m_input; | |||
| private OutputStream m_output; | |||
| private int m_recordSize; | |||
| private int m_recsPerBlock; | |||
| public TarBuffer( final InputStream input ) | |||
| { | |||
| this( input, TarBuffer.DEFAULT_BLKSIZE ); | |||
| } | |||
| public TarBuffer( final InputStream input, final int blockSize ) | |||
| { | |||
| this( input, blockSize, TarBuffer.DEFAULT_RCDSIZE ); | |||
| } | |||
| public TarBuffer( final InputStream input, | |||
| final int blockSize, | |||
| final int recordSize ) | |||
| { | |||
| m_input = input; | |||
| initialize( blockSize, recordSize ); | |||
| } | |||
| public TarBuffer( final OutputStream output ) | |||
| { | |||
| this( output, TarBuffer.DEFAULT_BLKSIZE ); | |||
| } | |||
| public TarBuffer( final OutputStream output, final int blockSize ) | |||
| { | |||
| this( output, blockSize, TarBuffer.DEFAULT_RCDSIZE ); | |||
| } | |||
| public TarBuffer( final OutputStream output, | |||
| final int blockSize, | |||
| final int recordSize ) | |||
| { | |||
| m_output = output; | |||
| initialize( blockSize, recordSize ); | |||
| } | |||
| /** | |||
| * Set the debugging flag for the buffer. | |||
| * | |||
| * @param debug If true, print debugging output. | |||
| */ | |||
| public void setDebug( final boolean debug ) | |||
| { | |||
| m_debug = debug; | |||
| } | |||
| /** | |||
| * Get the TAR Buffer's block size. Blocks consist of multiple records. | |||
| * | |||
| * @return The BlockSize value | |||
| */ | |||
| public int getBlockSize() | |||
| { | |||
| return m_blockSize; | |||
| } | |||
| /** | |||
| * Get the current block number, zero based. | |||
| * | |||
| * @return The current zero based block number. | |||
| */ | |||
| public int getCurrentBlockNum() | |||
| { | |||
| return m_currBlkIdx; | |||
| } | |||
| /** | |||
| * Get the current record number, within the current block, zero based. | |||
| * Thus, current offset = (currentBlockNum * recsPerBlk) + currentRecNum. | |||
| * | |||
| * @return The current zero based record number. | |||
| */ | |||
| public int getCurrentRecordNum() | |||
| { | |||
| return m_currRecIdx - 1; | |||
| } | |||
| /** | |||
| * Get the TAR Buffer's record size. | |||
| * | |||
| * @return The RecordSize value | |||
| */ | |||
| public int getRecordSize() | |||
| { | |||
| return m_recordSize; | |||
| } | |||
| /** | |||
| * Determine if an archive record indicate End of Archive. End of archive is | |||
| * indicated by a record that consists entirely of null bytes. | |||
| * | |||
| * @param record The record data to check. | |||
| * @return The EOFRecord value | |||
| */ | |||
| public boolean isEOFRecord( final byte[] record ) | |||
| { | |||
| final int size = getRecordSize(); | |||
| for( int i = 0; i < size; ++i ) | |||
| { | |||
| if( record[ i ] != 0 ) | |||
| { | |||
| return false; | |||
| } | |||
| } | |||
| return true; | |||
| } | |||
| /** | |||
| * Close the TarBuffer. If this is an output buffer, also flush the current | |||
| * block before closing. | |||
| */ | |||
| public void close() | |||
| throws IOException | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| debug( "TarBuffer.closeBuffer()." ); | |||
| } | |||
| if( null != m_output ) | |||
| { | |||
| flushBlock(); | |||
| if( m_output != System.out && m_output != System.err ) | |||
| { | |||
| m_output.close(); | |||
| m_output = null; | |||
| } | |||
| } | |||
| else if( m_input != null ) | |||
| { | |||
| if( m_input != System.in ) | |||
| { | |||
| m_input.close(); | |||
| m_input = null; | |||
| } | |||
| } | |||
| } | |||
| /** | |||
| * Read a record from the input stream and return the data. | |||
| * | |||
| * @return The record data. | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public byte[] readRecord() | |||
| throws IOException | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| final String message = "ReadRecord: recIdx = " + m_currRecIdx + | |||
| " blkIdx = " + m_currBlkIdx; | |||
| debug( message ); | |||
| } | |||
| if( null == m_input ) | |||
| { | |||
| final String message = "reading from an output buffer"; | |||
| throw new IOException( message ); | |||
| } | |||
| if( m_currRecIdx >= m_recsPerBlock ) | |||
| { | |||
| if( !readBlock() ) | |||
| { | |||
| return null; | |||
| } | |||
| } | |||
| final byte[] result = new byte[ m_recordSize ]; | |||
| System.arraycopy( m_blockBuffer, | |||
| ( m_currRecIdx * m_recordSize ), | |||
| result, | |||
| 0, | |||
| m_recordSize ); | |||
| m_currRecIdx++; | |||
| return result; | |||
| } | |||
| /** | |||
| * Skip over a record on the input stream. | |||
| */ | |||
| public void skipRecord() | |||
| throws IOException | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| final String message = "SkipRecord: recIdx = " + m_currRecIdx + | |||
| " blkIdx = " + m_currBlkIdx; | |||
| debug( message ); | |||
| } | |||
| if( null == m_input ) | |||
| { | |||
| final String message = "reading (via skip) from an output buffer"; | |||
| throw new IOException( message ); | |||
| } | |||
| if( m_currRecIdx >= m_recsPerBlock ) | |||
| { | |||
| if( !readBlock() ) | |||
| { | |||
| return;// UNDONE | |||
| } | |||
| } | |||
| m_currRecIdx++; | |||
| } | |||
| /** | |||
| * Write an archive record to the archive. | |||
| * | |||
| * @param record The record data to write to the archive. | |||
| */ | |||
| public void writeRecord( final byte[] record ) | |||
| throws IOException | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| final String message = "WriteRecord: recIdx = " + m_currRecIdx + | |||
| " blkIdx = " + m_currBlkIdx; | |||
| debug( message ); | |||
| } | |||
| if( null == m_output ) | |||
| { | |||
| final String message = "writing to an input buffer"; | |||
| throw new IOException( message ); | |||
| } | |||
| if( record.length != m_recordSize ) | |||
| { | |||
| final String message = "record to write has length '" + | |||
| record.length + "' which is not the record size of '" + | |||
| m_recordSize + "'"; | |||
| throw new IOException( message ); | |||
| } | |||
| if( m_currRecIdx >= m_recsPerBlock ) | |||
| { | |||
| writeBlock(); | |||
| } | |||
| System.arraycopy( record, | |||
| 0, | |||
| m_blockBuffer, | |||
| ( m_currRecIdx * m_recordSize ), | |||
| m_recordSize ); | |||
| m_currRecIdx++; | |||
| } | |||
| /** | |||
| * Write an archive record to the archive, where the record may be inside of | |||
| * a larger array buffer. The buffer must be "offset plus record size" long. | |||
| * | |||
| * @param buffer The buffer containing the record data to write. | |||
| * @param offset The offset of the record data within buf. | |||
| */ | |||
| public void writeRecord( final byte[] buffer, final int offset ) | |||
| throws IOException | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| final String message = "WriteRecord: recIdx = " + m_currRecIdx + | |||
| " blkIdx = " + m_currBlkIdx; | |||
| debug( message ); | |||
| } | |||
| if( null == m_output ) | |||
| { | |||
| final String message = "writing to an input buffer"; | |||
| throw new IOException( message ); | |||
| } | |||
| if( ( offset + m_recordSize ) > buffer.length ) | |||
| { | |||
| final String message = "record has length '" + buffer.length + | |||
| "' with offset '" + offset + "' which is less than the record size of '" + | |||
| m_recordSize + "'"; | |||
| throw new IOException( message ); | |||
| } | |||
| if( m_currRecIdx >= m_recsPerBlock ) | |||
| { | |||
| writeBlock(); | |||
| } | |||
| System.arraycopy( buffer, | |||
| offset, | |||
| m_blockBuffer, | |||
| ( m_currRecIdx * m_recordSize ), | |||
| m_recordSize ); | |||
| m_currRecIdx++; | |||
| } | |||
| /** | |||
| * Flush the current data block if it has any data in it. | |||
| */ | |||
| private void flushBlock() | |||
| throws IOException | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| final String message = "TarBuffer.flushBlock() called."; | |||
| debug( message ); | |||
| } | |||
| if( m_output == null ) | |||
| { | |||
| final String message = "writing to an input buffer"; | |||
| throw new IOException( message ); | |||
| } | |||
| if( m_currRecIdx > 0 ) | |||
| { | |||
| writeBlock(); | |||
| } | |||
| } | |||
| /** | |||
| * Initialization common to all constructors. | |||
| */ | |||
| private void initialize( final int blockSize, final int recordSize ) | |||
| { | |||
| m_debug = false; | |||
| m_blockSize = blockSize; | |||
| m_recordSize = recordSize; | |||
| m_recsPerBlock = ( m_blockSize / m_recordSize ); | |||
| m_blockBuffer = new byte[ m_blockSize ]; | |||
| if( null != m_input ) | |||
| { | |||
| m_currBlkIdx = -1; | |||
| m_currRecIdx = m_recsPerBlock; | |||
| } | |||
| else | |||
| { | |||
| m_currBlkIdx = 0; | |||
| m_currRecIdx = 0; | |||
| } | |||
| } | |||
| /** | |||
| * @return false if End-Of-File, else true | |||
| */ | |||
| private boolean readBlock() | |||
| throws IOException | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| final String message = "ReadBlock: blkIdx = " + m_currBlkIdx; | |||
| debug( message ); | |||
| } | |||
| if( null == m_input ) | |||
| { | |||
| final String message = "reading from an output buffer"; | |||
| throw new IOException( message ); | |||
| } | |||
| m_currRecIdx = 0; | |||
| int offset = 0; | |||
| int bytesNeeded = m_blockSize; | |||
| while( bytesNeeded > 0 ) | |||
| { | |||
| final long numBytes = m_input.read( m_blockBuffer, offset, bytesNeeded ); | |||
| // | |||
| // NOTE | |||
| // We have fit EOF, and the block is not full! | |||
| // | |||
| // This is a broken archive. It does not follow the standard | |||
| // blocking algorithm. However, because we are generous, and | |||
| // it requires little effort, we will simply ignore the error | |||
| // and continue as if the entire block were read. This does | |||
| // not appear to break anything upstream. We used to return | |||
| // false in this case. | |||
| // | |||
| // Thanks to 'Yohann.Roussel@alcatel.fr' for this fix. | |||
| // | |||
| if( numBytes == -1 ) | |||
| { | |||
| break; | |||
| } | |||
| offset += numBytes; | |||
| bytesNeeded -= numBytes; | |||
| if( numBytes != m_blockSize ) | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| System.err.println( "ReadBlock: INCOMPLETE READ " | |||
| + numBytes + " of " + m_blockSize | |||
| + " bytes read." ); | |||
| } | |||
| } | |||
| } | |||
| m_currBlkIdx++; | |||
| return true; | |||
| } | |||
| /** | |||
| * Write a TarBuffer block to the archive. | |||
| * | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| private void writeBlock() | |||
| throws IOException | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| final String message = "WriteBlock: blkIdx = " + m_currBlkIdx; | |||
| debug( message ); | |||
| } | |||
| if( null == m_output ) | |||
| { | |||
| final String message = "writing to an input buffer"; | |||
| throw new IOException( message ); | |||
| } | |||
| m_output.write( m_blockBuffer, 0, m_blockSize ); | |||
| m_output.flush(); | |||
| m_currRecIdx = 0; | |||
| m_currBlkIdx++; | |||
| } | |||
| protected void debug( final String message ) | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| System.err.println( message ); | |||
| } | |||
| } | |||
| } | |||
| @@ -1,133 +0,0 @@ | |||
| /* | |||
| * Copyright (C) The Apache Software Foundation. All rights reserved. | |||
| * | |||
| * This software is published under the terms of the Apache Software License | |||
| * version 1.1, a copy of which has been included with this distribution in | |||
| * the LICENSE.txt file. | |||
| */ | |||
| package org.apache.aut.tar; | |||
| /** | |||
| * This interface contains all the definitions used in the package. | |||
| * | |||
| * @author <a href="mailto:time@ice.com">Timothy Gerard Endres</a> | |||
| * @author <a href="mailto:stefano@apache.org">Stefano Mazzocchi</a> | |||
| */ | |||
| interface TarConstants | |||
| { | |||
| /** | |||
| * The length of the mode field in a header buffer. | |||
| */ | |||
| int MODELEN = 8; | |||
| /** | |||
| * The length of the user id field in a header buffer. | |||
| */ | |||
| int UIDLEN = 8; | |||
| /** | |||
| * The length of the group id field in a header buffer. | |||
| */ | |||
| int GIDLEN = 8; | |||
| /** | |||
| * The length of the checksum field in a header buffer. | |||
| */ | |||
| int CHKSUMLEN = 8; | |||
| /** | |||
| * The length of the size field in a header buffer. | |||
| */ | |||
| int SIZELEN = 12; | |||
| /** | |||
| * The length of the magic field in a header buffer. | |||
| */ | |||
| int MAGICLEN = 8; | |||
| /** | |||
| * The length of the modification time field in a header buffer. | |||
| */ | |||
| int MODTIMELEN = 12; | |||
| /** | |||
| * The length of the user name field in a header buffer. | |||
| */ | |||
| int UNAMELEN = 32; | |||
| /** | |||
| * The length of the group name field in a header buffer. | |||
| */ | |||
| int GNAMELEN = 32; | |||
| /** | |||
| * The length of the devices field in a header buffer. | |||
| */ | |||
| int DEVLEN = 8; | |||
| /** | |||
| * LF_ constants represent the "link flag" of an entry, or more commonly, | |||
| * the "entry type". This is the "old way" of indicating a normal file. | |||
| */ | |||
| byte LF_OLDNORM = 0; | |||
| /** | |||
| * Normal file type. | |||
| */ | |||
| byte LF_NORMAL = (byte)'0'; | |||
| /** | |||
| * Link file type. | |||
| */ | |||
| byte LF_LINK = (byte)'1'; | |||
| /** | |||
| * Symbolic link file type. | |||
| */ | |||
| byte LF_SYMLINK = (byte)'2'; | |||
| /** | |||
| * Character device file type. | |||
| */ | |||
| byte LF_CHR = (byte)'3'; | |||
| /** | |||
| * Block device file type. | |||
| */ | |||
| byte LF_BLK = (byte)'4'; | |||
| /** | |||
| * Directory file type. | |||
| */ | |||
| byte LF_DIR = (byte)'5'; | |||
| /** | |||
| * FIFO (pipe) file type. | |||
| */ | |||
| byte LF_FIFO = (byte)'6'; | |||
| /** | |||
| * Contiguous file type. | |||
| */ | |||
| byte LF_CONTIG = (byte)'7'; | |||
| /** | |||
| * The magic tag representing a POSIX tar archive. | |||
| */ | |||
| String TMAGIC = "ustar"; | |||
| /** | |||
| * The magic tag representing a GNU tar archive. | |||
| */ | |||
| String GNU_TMAGIC = "ustar "; | |||
| /** | |||
| * The namr of the GNU tar entry which contains a long name. | |||
| */ | |||
| String GNU_LONGLINK = "././@LongLink"; | |||
| /** | |||
| * Identifies the *next* file on the tape as having a long name. | |||
| */ | |||
| byte LF_GNUTYPE_LONGNAME = (byte)'L'; | |||
| } | |||
| @@ -1,627 +0,0 @@ | |||
| /* | |||
| * Copyright (C) The Apache Software Foundation. All rights reserved. | |||
| * | |||
| * This software is published under the terms of the Apache Software License | |||
| * version 1.1, a copy of which has been included with this distribution in | |||
| * the LICENSE.txt file. | |||
| */ | |||
| package org.apache.aut.tar; | |||
| import java.io.File; | |||
| import java.util.Date; | |||
| import java.util.Locale; | |||
| /** | |||
| * This class represents an entry in a Tar archive. It consists of the entry's | |||
| * header, as well as the entry's File. Entries can be instantiated in one of | |||
| * three ways, depending on how they are to be used. <p> | |||
| * | |||
| * TarEntries that are created from the header bytes read from an archive are | |||
| * instantiated with the TarEntry( byte[] ) constructor. These entries will be | |||
| * used when extracting from or listing the contents of an archive. These | |||
| * entries have their header filled in using the header bytes. They also set the | |||
| * File to null, since they reference an archive entry not a file. <p> | |||
| * | |||
| * TarEntries that are created from Files that are to be written into an archive | |||
| * are instantiated with the TarEntry( File ) constructor. These entries have | |||
| * their header filled in using the File's information. They also keep a | |||
| * reference to the File for convenience when writing entries. <p> | |||
| * | |||
| * Finally, TarEntries can be constructed from nothing but a name. This allows | |||
| * the programmer to construct the entry by hand, for instance when only an | |||
| * InputStream is available for writing to the archive, and the header | |||
| * information is constructed from other information. In this case the header | |||
| * fields are set to defaults and the File is set to null. <p> | |||
| * | |||
| * The C structure for a Tar Entry's header is: <pre> | |||
| * struct header { | |||
| * char name[NAMSIZ]; | |||
| * char mode[8]; | |||
| * char uid[8]; | |||
| * char gid[8]; | |||
| * char size[12]; | |||
| * char mtime[12]; | |||
| * char chksum[8]; | |||
| * char linkflag; | |||
| * char linkname[NAMSIZ]; | |||
| * char magic[8]; | |||
| * char uname[TUNMLEN]; | |||
| * char gname[TGNMLEN]; | |||
| * char devmajor[8]; | |||
| * char devminor[8]; | |||
| * } header; | |||
| * </pre> | |||
| * | |||
| * @author <a href="mailto:time@ice.com">Timothy Gerard Endres</a> | |||
| * @author <a href="mailto:stefano@apache.org">Stefano Mazzocchi</a> | |||
| * @author <a href="mailto:peter@apache.org">Peter Donald</a> | |||
| */ | |||
| public class TarEntry | |||
| { | |||
| /** | |||
| * The length of the name field in a header buffer. | |||
| */ | |||
| public final static int NAMELEN = 100; | |||
| /** | |||
| * The entry's modification time. | |||
| */ | |||
| private int m_checkSum; | |||
| /** | |||
| * The entry's group name. | |||
| */ | |||
| private int m_devMajor; | |||
| /** | |||
| * The entry's major device number. | |||
| */ | |||
| private int m_devMinor; | |||
| /** | |||
| * The entry's minor device number. | |||
| */ | |||
| private File m_file; | |||
| /** | |||
| * The entry's user id. | |||
| */ | |||
| private int m_groupId; | |||
| /** | |||
| * The entry's user name. | |||
| */ | |||
| private StringBuffer m_groupName; | |||
| /** | |||
| * The entry's checksum. | |||
| */ | |||
| private byte m_linkFlag; | |||
| /** | |||
| * The entry's link flag. | |||
| */ | |||
| private StringBuffer m_linkName; | |||
| /** | |||
| * The entry's link name. | |||
| */ | |||
| private StringBuffer m_magic; | |||
| /** | |||
| * The entry's size. | |||
| */ | |||
| private long m_modTime; | |||
| /** | |||
| * The entry's name. | |||
| */ | |||
| private int m_mode; | |||
| private StringBuffer m_name; | |||
| /** | |||
| * The entry's group id. | |||
| */ | |||
| private long m_size; | |||
| /** | |||
| * The entry's permission mode. | |||
| */ | |||
| private int m_userID; | |||
| /** | |||
| * The entry's magic tag. | |||
| */ | |||
| private StringBuffer m_userName; | |||
| /** | |||
| * Construct an entry with only a name. This allows the programmer to | |||
| * construct the entry's header "by hand". File is set to null. | |||
| */ | |||
| public TarEntry( final String name ) | |||
| { | |||
| this(); | |||
| final boolean isDir = name.endsWith( "/" ); | |||
| m_name = new StringBuffer( name ); | |||
| m_mode = isDir ? 040755 : 0100644; | |||
| m_linkFlag = isDir ? TarConstants.LF_DIR : TarConstants.LF_NORMAL; | |||
| m_modTime = ( new Date() ).getTime() / 1000; | |||
| m_linkName = new StringBuffer( "" ); | |||
| m_userName = new StringBuffer( "" ); | |||
| m_groupName = new StringBuffer( "" ); | |||
| } | |||
| /** | |||
| * Construct an entry with a name an a link flag. | |||
| * | |||
| * @param name Description of Parameter | |||
| * @param linkFlag Description of Parameter | |||
| */ | |||
| public TarEntry( final String name, final byte linkFlag ) | |||
| { | |||
| this( name ); | |||
| m_linkFlag = linkFlag; | |||
| } | |||
| /** | |||
| * Construct an entry for a file. File is set to file, and the header is | |||
| * constructed from information from the file. | |||
| * | |||
| * @param file The file that the entry represents. | |||
| */ | |||
| public TarEntry( final File file ) | |||
| { | |||
| this(); | |||
| m_file = file; | |||
| String name = file.getPath(); | |||
| // Strip off drive letters! | |||
| final String osName = | |||
| System.getProperty( "os.name" ).toLowerCase( Locale.US ); | |||
| if( -1 != osName.indexOf( "netware" ) ) | |||
| { | |||
| if( name.length() > 2 ) | |||
| { | |||
| final char ch1 = name.charAt( 0 ); | |||
| final char ch2 = name.charAt( 1 ); | |||
| if( ch2 == ':' && | |||
| ( ( ch1 >= 'a' && ch1 <= 'z' ) || | |||
| ( ch1 >= 'A' && ch1 <= 'Z' ) ) ) | |||
| { | |||
| name = name.substring( 2 ); | |||
| } | |||
| } | |||
| } | |||
| else if( -1 != osName.indexOf( "netware" ) ) | |||
| { | |||
| final int colon = name.indexOf( ':' ); | |||
| if( colon != -1 ) | |||
| { | |||
| name = name.substring( colon + 1 ); | |||
| } | |||
| } | |||
| name = name.replace( File.separatorChar, '/' ); | |||
| // No absolute pathnames | |||
| // Windows (and Posix?) paths can start with "\\NetworkDrive\", | |||
| // so we loop on starting /'s. | |||
| while( name.startsWith( "/" ) ) | |||
| { | |||
| name = name.substring( 1 ); | |||
| } | |||
| m_linkName = new StringBuffer( "" ); | |||
| m_name = new StringBuffer( name ); | |||
| if( file.isDirectory() ) | |||
| { | |||
| m_mode = 040755; | |||
| m_linkFlag = TarConstants.LF_DIR; | |||
| if( m_name.charAt( m_name.length() - 1 ) != '/' ) | |||
| { | |||
| m_name.append( "/" ); | |||
| } | |||
| } | |||
| else | |||
| { | |||
| m_mode = 0100644; | |||
| m_linkFlag = TarConstants.LF_NORMAL; | |||
| } | |||
| m_size = file.length(); | |||
| m_modTime = file.lastModified() / 1000; | |||
| m_checkSum = 0; | |||
| m_devMajor = 0; | |||
| m_devMinor = 0; | |||
| } | |||
| /** | |||
| * Construct an entry from an archive's header bytes. File is set to null. | |||
| * | |||
| * @param header The header bytes from a tar archive entry. | |||
| */ | |||
| public TarEntry( final byte[] header ) | |||
| { | |||
| this(); | |||
| parseTarHeader( header ); | |||
| } | |||
| /** | |||
| * Construct an empty entry and prepares the header values. | |||
| */ | |||
| private TarEntry() | |||
| { | |||
| m_magic = new StringBuffer( TarConstants.TMAGIC ); | |||
| m_name = new StringBuffer(); | |||
| m_linkName = new StringBuffer(); | |||
| String user = System.getProperty( "user.name", "" ); | |||
| if( user.length() > 31 ) | |||
| { | |||
| user = user.substring( 0, 31 ); | |||
| } | |||
| m_userName = new StringBuffer( user ); | |||
| m_groupName = new StringBuffer( "" ); | |||
| } | |||
| /** | |||
| * Set this entry's group id. | |||
| * | |||
| * @param groupId This entry's new group id. | |||
| */ | |||
| public void setGroupId( final int groupId ) | |||
| { | |||
| m_groupId = groupId; | |||
| } | |||
| /** | |||
| * Set this entry's group name. | |||
| * | |||
| * @param groupName This entry's new group name. | |||
| */ | |||
| public void setGroupName( final String groupName ) | |||
| { | |||
| m_groupName = new StringBuffer( groupName ); | |||
| } | |||
| /** | |||
| * Set this entry's modification time. The parameter passed to this method | |||
| * is in "Java time". | |||
| * | |||
| * @param time This entry's new modification time. | |||
| */ | |||
| public void setModTime( final long time ) | |||
| { | |||
| m_modTime = time / 1000; | |||
| } | |||
| /** | |||
| * Set this entry's modification time. | |||
| * | |||
| * @param time This entry's new modification time. | |||
| */ | |||
| public void setModTime( final Date time ) | |||
| { | |||
| m_modTime = time.getTime() / 1000; | |||
| } | |||
| /** | |||
| * Set the mode for this entry | |||
| * | |||
| * @param mode The new Mode value | |||
| */ | |||
| public void setMode( final int mode ) | |||
| { | |||
| m_mode = mode; | |||
| } | |||
| /** | |||
| * Set this entry's name. | |||
| * | |||
| * @param name This entry's new name. | |||
| */ | |||
| public void setName( final String name ) | |||
| { | |||
| m_name = new StringBuffer( name ); | |||
| } | |||
| /** | |||
| * Set this entry's file size. | |||
| * | |||
| * @param size This entry's new file size. | |||
| */ | |||
| public void setSize( final long size ) | |||
| { | |||
| m_size = size; | |||
| } | |||
| /** | |||
| * Set this entry's user id. | |||
| * | |||
| * @param userId This entry's new user id. | |||
| */ | |||
| public void setUserId( final int userId ) | |||
| { | |||
| m_userID = userId; | |||
| } | |||
| /** | |||
| * Set this entry's user name. | |||
| * | |||
| * @param userName This entry's new user name. | |||
| */ | |||
| public void setUserName( final String userName ) | |||
| { | |||
| m_userName = new StringBuffer( userName ); | |||
| } | |||
| /** | |||
| * If this entry represents a file, and the file is a directory, return an | |||
| * array of TarEntries for this entry's children. | |||
| * | |||
| * @return An array of TarEntry's for this entry's children. | |||
| */ | |||
| public TarEntry[] getDirectoryEntries() | |||
| { | |||
| if( null == m_file || !m_file.isDirectory() ) | |||
| { | |||
| return new TarEntry[ 0 ]; | |||
| } | |||
| final String[] list = m_file.list(); | |||
| final TarEntry[] result = new TarEntry[ list.length ]; | |||
| for( int i = 0; i < list.length; ++i ) | |||
| { | |||
| result[ i ] = new TarEntry( new File( m_file, list[ i ] ) ); | |||
| } | |||
| return result; | |||
| } | |||
| /** | |||
| * Get this entry's file. | |||
| * | |||
| * @return This entry's file. | |||
| */ | |||
| public File getFile() | |||
| { | |||
| return m_file; | |||
| } | |||
| /** | |||
| * Get this entry's group id. | |||
| * | |||
| * @return This entry's group id. | |||
| */ | |||
| public int getGroupId() | |||
| { | |||
| return m_groupId; | |||
| } | |||
| /** | |||
| * Get this entry's group name. | |||
| * | |||
| * @return This entry's group name. | |||
| */ | |||
| public String getGroupName() | |||
| { | |||
| return m_groupName.toString(); | |||
| } | |||
| /** | |||
| * Set this entry's modification time. | |||
| * | |||
| * @return The ModTime value | |||
| */ | |||
| public Date getModTime() | |||
| { | |||
| return new Date( m_modTime * 1000 ); | |||
| } | |||
| /** | |||
| * Get this entry's mode. | |||
| * | |||
| * @return This entry's mode. | |||
| */ | |||
| public int getMode() | |||
| { | |||
| return m_mode; | |||
| } | |||
| /** | |||
| * Get this entry's name. | |||
| * | |||
| * @return This entry's name. | |||
| */ | |||
| public String getName() | |||
| { | |||
| return m_name.toString(); | |||
| } | |||
| /** | |||
| * Get this entry's file size. | |||
| * | |||
| * @return This entry's file size. | |||
| */ | |||
| public long getSize() | |||
| { | |||
| return m_size; | |||
| } | |||
| /** | |||
| * Get this entry's checksum. | |||
| * | |||
| * @return This entry's checksum. | |||
| */ | |||
| public int getCheckSum() | |||
| { | |||
| return m_checkSum; | |||
| } | |||
| /** | |||
| * Get this entry's user id. | |||
| * | |||
| * @return This entry's user id. | |||
| */ | |||
| public int getUserId() | |||
| { | |||
| return m_userID; | |||
| } | |||
| /** | |||
| * Get this entry's user name. | |||
| * | |||
| * @return This entry's user name. | |||
| */ | |||
| public String getUserName() | |||
| { | |||
| return m_userName.toString(); | |||
| } | |||
| /** | |||
| * Determine if the given entry is a descendant of this entry. Descendancy | |||
| * is determined by the name of the descendant starting with this entry's | |||
| * name. | |||
| * | |||
| * @param desc Entry to be checked as a descendent of | |||
| * @return True if entry is a descendant of | |||
| */ | |||
| public boolean isDescendent( final TarEntry desc ) | |||
| { | |||
| return desc.getName().startsWith( getName() ); | |||
| } | |||
| /** | |||
| * Return whether or not this entry represents a directory. | |||
| * | |||
| * @return True if this entry is a directory. | |||
| */ | |||
| public boolean isDirectory() | |||
| { | |||
| if( m_file != null ) | |||
| { | |||
| return m_file.isDirectory(); | |||
| } | |||
| if( m_linkFlag == TarConstants.LF_DIR ) | |||
| { | |||
| return true; | |||
| } | |||
| if( getName().endsWith( "/" ) ) | |||
| { | |||
| return true; | |||
| } | |||
| return false; | |||
| } | |||
| /** | |||
| * Indicate if this entry is a GNU long name block | |||
| * | |||
| * @return true if this is a long name extension provided by GNU tar | |||
| */ | |||
| public boolean isGNULongNameEntry() | |||
| { | |||
| return m_linkFlag == TarConstants.LF_GNUTYPE_LONGNAME && | |||
| m_name.toString().equals( TarConstants.GNU_LONGLINK ); | |||
| } | |||
| /** | |||
| * Determine if the two entries are equal. Equality is determined by the | |||
| * header names being equal. | |||
| * | |||
| * @param other Entry to be checked for equality. | |||
| * @return True if the entries are equal. | |||
| */ | |||
| public boolean equals( final TarEntry other ) | |||
| { | |||
| return getName().equals( other.getName() ); | |||
| } | |||
| /** | |||
| * Parse an entry's header information from a header buffer. | |||
| * | |||
| * @param header The tar entry header buffer to get information from. | |||
| */ | |||
| private void parseTarHeader( final byte[] header ) | |||
| { | |||
| int offset = 0; | |||
| m_name = TarUtils.parseName( header, offset, NAMELEN ); | |||
| offset += NAMELEN; | |||
| m_mode = (int)TarUtils.parseOctal( header, offset, TarConstants.MODELEN ); | |||
| offset += TarConstants.MODELEN; | |||
| m_userID = (int)TarUtils.parseOctal( header, offset, TarConstants.UIDLEN ); | |||
| offset += TarConstants.UIDLEN; | |||
| m_groupId = (int)TarUtils.parseOctal( header, offset, TarConstants.GIDLEN ); | |||
| offset += TarConstants.GIDLEN; | |||
| m_size = TarUtils.parseOctal( header, offset, TarConstants.SIZELEN ); | |||
| offset += TarConstants.SIZELEN; | |||
| m_modTime = TarUtils.parseOctal( header, offset, TarConstants.MODTIMELEN ); | |||
| offset += TarConstants.MODTIMELEN; | |||
| m_checkSum = (int)TarUtils.parseOctal( header, offset, TarConstants.CHKSUMLEN ); | |||
| offset += TarConstants.CHKSUMLEN; | |||
| m_linkFlag = header[ offset++ ]; | |||
| m_linkName = TarUtils.parseName( header, offset, NAMELEN ); | |||
| offset += NAMELEN; | |||
| m_magic = TarUtils.parseName( header, offset, TarConstants.MAGICLEN ); | |||
| offset += TarConstants.MAGICLEN; | |||
| m_userName = TarUtils.parseName( header, offset, TarConstants.UNAMELEN ); | |||
| offset += TarConstants.UNAMELEN; | |||
| m_groupName = TarUtils.parseName( header, offset, TarConstants.GNAMELEN ); | |||
| offset += TarConstants.GNAMELEN; | |||
| m_devMajor = (int)TarUtils.parseOctal( header, offset, TarConstants.DEVLEN ); | |||
| offset += TarConstants.DEVLEN; | |||
| m_devMinor = (int)TarUtils.parseOctal( header, offset, TarConstants.DEVLEN ); | |||
| } | |||
| /** | |||
| * Write an entry's header information to a header buffer. | |||
| * | |||
| * @param buffer The tar entry header buffer to fill in. | |||
| */ | |||
| public void writeEntryHeader( final byte[] buffer ) | |||
| { | |||
| int offset = 0; | |||
| offset = TarUtils.getNameBytes( m_name, buffer, offset, NAMELEN ); | |||
| offset = TarUtils.getOctalBytes( m_mode, buffer, offset, TarConstants.MODELEN ); | |||
| offset = TarUtils.getOctalBytes( m_userID, buffer, offset, TarConstants.UIDLEN ); | |||
| offset = TarUtils.getOctalBytes( m_groupId, buffer, offset, TarConstants.GIDLEN ); | |||
| offset = TarUtils.getLongOctalBytes( m_size, buffer, offset, TarConstants.SIZELEN ); | |||
| offset = TarUtils.getLongOctalBytes( m_modTime, buffer, offset, TarConstants.MODTIMELEN ); | |||
| final int checkSumOffset = offset; | |||
| for( int i = 0; i < TarConstants.CHKSUMLEN; ++i ) | |||
| { | |||
| buffer[ offset++ ] = (byte)' '; | |||
| } | |||
| buffer[ offset++ ] = m_linkFlag; | |||
| offset = TarUtils.getNameBytes( m_linkName, buffer, offset, NAMELEN ); | |||
| offset = TarUtils.getNameBytes( m_magic, buffer, offset, TarConstants.MAGICLEN ); | |||
| offset = TarUtils.getNameBytes( m_userName, buffer, offset, TarConstants.UNAMELEN ); | |||
| offset = TarUtils.getNameBytes( m_groupName, buffer, offset, TarConstants.GNAMELEN ); | |||
| offset = TarUtils.getOctalBytes( m_devMajor, buffer, offset, TarConstants.DEVLEN ); | |||
| offset = TarUtils.getOctalBytes( m_devMinor, buffer, offset, TarConstants.DEVLEN ); | |||
| while( offset < buffer.length ) | |||
| { | |||
| buffer[ offset++ ] = 0; | |||
| } | |||
| final long checkSum = TarUtils.computeCheckSum( buffer ); | |||
| TarUtils.getCheckSumOctalBytes( checkSum, buffer, checkSumOffset, TarConstants.CHKSUMLEN ); | |||
| } | |||
| } | |||
| @@ -1,419 +0,0 @@ | |||
| /* | |||
| * Copyright (C) The Apache Software Foundation. All rights reserved. | |||
| * | |||
| * This software is published under the terms of the Apache Software License | |||
| * version 1.1, a copy of which has been included with this distribution in | |||
| * the LICENSE.txt file. | |||
| */ | |||
| package org.apache.aut.tar; | |||
| import java.io.FilterInputStream; | |||
| import java.io.IOException; | |||
| import java.io.InputStream; | |||
| import java.io.OutputStream; | |||
| /** | |||
| * The TarInputStream reads a UNIX tar archive as an InputStream. methods are | |||
| * provided to position at each successive entry in the archive, and the read | |||
| * each entry as a normal input stream using read(). | |||
| * | |||
| * @author <a href="mailto:time@ice.com">Timothy Gerard Endres</a> | |||
| * @author <a href="mailto:stefano@apache.org">Stefano Mazzocchi</a> | |||
| * @author <a href="mailto:peter@apache.org">Peter Donald</a> | |||
| */ | |||
| public class TarInputStream | |||
| extends FilterInputStream | |||
| { | |||
| private TarBuffer m_buffer; | |||
| private TarEntry m_currEntry; | |||
| private boolean m_debug; | |||
| private int m_entryOffset; | |||
| private int m_entrySize; | |||
| private boolean m_hasHitEOF; | |||
| private byte[] m_oneBuf; | |||
| private byte[] m_readBuf; | |||
| public TarInputStream( final InputStream input ) | |||
| { | |||
| this( input, TarBuffer.DEFAULT_BLKSIZE, TarBuffer.DEFAULT_RCDSIZE ); | |||
| } | |||
| public TarInputStream( final InputStream input, final int blockSize ) | |||
| { | |||
| this( input, blockSize, TarBuffer.DEFAULT_RCDSIZE ); | |||
| } | |||
| public TarInputStream( final InputStream input, | |||
| final int blockSize, | |||
| final int recordSize ) | |||
| { | |||
| super( input ); | |||
| m_buffer = new TarBuffer( input, blockSize, recordSize ); | |||
| m_oneBuf = new byte[ 1 ]; | |||
| } | |||
| /** | |||
| * Sets the debugging flag. | |||
| * | |||
| * @param debug The new Debug value | |||
| */ | |||
| public void setDebug( final boolean debug ) | |||
| { | |||
| m_debug = debug; | |||
| m_buffer.setDebug( debug ); | |||
| } | |||
| /** | |||
| * Get the next entry in this tar archive. This will skip over any remaining | |||
| * data in the current entry, if there is one, and place the input stream at | |||
| * the header of the next entry, and read the header and instantiate a new | |||
| * TarEntry from the header bytes and return that entry. If there are no | |||
| * more entries in the archive, null will be returned to indicate that the | |||
| * end of the archive has been reached. | |||
| * | |||
| * @return The next TarEntry in the archive, or null. | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public TarEntry getNextEntry() | |||
| throws IOException | |||
| { | |||
| if( m_hasHitEOF ) | |||
| { | |||
| return null; | |||
| } | |||
| if( m_currEntry != null ) | |||
| { | |||
| final int numToSkip = m_entrySize - m_entryOffset; | |||
| if( m_debug ) | |||
| { | |||
| final String message = "TarInputStream: SKIP currENTRY '" + | |||
| m_currEntry.getName() + "' SZ " + m_entrySize + | |||
| " OFF " + m_entryOffset + " skipping " + numToSkip + " bytes"; | |||
| debug( message ); | |||
| } | |||
| if( numToSkip > 0 ) | |||
| { | |||
| skip( numToSkip ); | |||
| } | |||
| m_readBuf = null; | |||
| } | |||
| final byte[] headerBuf = m_buffer.readRecord(); | |||
| if( headerBuf == null ) | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| debug( "READ NULL RECORD" ); | |||
| } | |||
| m_hasHitEOF = true; | |||
| } | |||
| else if( m_buffer.isEOFRecord( headerBuf ) ) | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| debug( "READ EOF RECORD" ); | |||
| } | |||
| m_hasHitEOF = true; | |||
| } | |||
| if( m_hasHitEOF ) | |||
| { | |||
| m_currEntry = null; | |||
| } | |||
| else | |||
| { | |||
| m_currEntry = new TarEntry( headerBuf ); | |||
| if( !( headerBuf[ 257 ] == 'u' && headerBuf[ 258 ] == 's' && | |||
| headerBuf[ 259 ] == 't' && headerBuf[ 260 ] == 'a' && | |||
| headerBuf[ 261 ] == 'r' ) ) | |||
| { | |||
| //Must be v7Format | |||
| } | |||
| if( m_debug ) | |||
| { | |||
| final String message = "TarInputStream: SET CURRENTRY '" + | |||
| m_currEntry.getName() + "' size = " + m_currEntry.getSize(); | |||
| debug( message ); | |||
| } | |||
| m_entryOffset = 0; | |||
| // REVIEW How do we resolve this discrepancy?! | |||
| m_entrySize = (int)m_currEntry.getSize(); | |||
| } | |||
| if( null != m_currEntry && m_currEntry.isGNULongNameEntry() ) | |||
| { | |||
| // read in the name | |||
| final StringBuffer longName = new StringBuffer(); | |||
| final byte[] buffer = new byte[ 256 ]; | |||
| int length = 0; | |||
| while( ( length = read( buffer ) ) >= 0 ) | |||
| { | |||
| final String str = new String( buffer, 0, length ); | |||
| longName.append( str ); | |||
| } | |||
| getNextEntry(); | |||
| m_currEntry.setName( longName.toString() ); | |||
| } | |||
| return m_currEntry; | |||
| } | |||
| /** | |||
| * Get the record size being used by this stream's TarBuffer. | |||
| * | |||
| * @return The TarBuffer record size. | |||
| */ | |||
| public int getRecordSize() | |||
| { | |||
| return m_buffer.getRecordSize(); | |||
| } | |||
| /** | |||
| * Get the available data that can be read from the current entry in the | |||
| * archive. This does not indicate how much data is left in the entire | |||
| * archive, only in the current entry. This value is determined from the | |||
| * entry's size header field and the amount of data already read from the | |||
| * current entry. | |||
| * | |||
| * @return The number of available bytes for the current entry. | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public int available() | |||
| throws IOException | |||
| { | |||
| return m_entrySize - m_entryOffset; | |||
| } | |||
| /** | |||
| * Closes this stream. Calls the TarBuffer's close() method. | |||
| */ | |||
| public void close() | |||
| throws IOException | |||
| { | |||
| m_buffer.close(); | |||
| } | |||
| /** | |||
| * Copies the contents of the current tar archive entry directly into an | |||
| * output stream. | |||
| * | |||
| * @param output The OutputStream into which to write the entry's data. | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public void copyEntryContents( final OutputStream output ) | |||
| throws IOException | |||
| { | |||
| final byte[] buffer = new byte[ 32 * 1024 ]; | |||
| while( true ) | |||
| { | |||
| final int numRead = read( buffer, 0, buffer.length ); | |||
| if( numRead == -1 ) | |||
| { | |||
| break; | |||
| } | |||
| output.write( buffer, 0, numRead ); | |||
| } | |||
| } | |||
| /** | |||
| * Since we do not support marking just yet, we do nothing. | |||
| * | |||
| * @param markLimit The limit to mark. | |||
| */ | |||
| public void mark( int markLimit ) | |||
| { | |||
| } | |||
| /** | |||
| * Since we do not support marking just yet, we return false. | |||
| * | |||
| * @return False. | |||
| */ | |||
| public boolean markSupported() | |||
| { | |||
| return false; | |||
| } | |||
| /** | |||
| * Reads a byte from the current tar archive entry. This method simply calls | |||
| * read( byte[], int, int ). | |||
| * | |||
| * @return The byte read, or -1 at EOF. | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public int read() | |||
| throws IOException | |||
| { | |||
| final int num = read( m_oneBuf, 0, 1 ); | |||
| if( num == -1 ) | |||
| { | |||
| return num; | |||
| } | |||
| else | |||
| { | |||
| return (int)m_oneBuf[ 0 ]; | |||
| } | |||
| } | |||
| /** | |||
| * Reads bytes from the current tar archive entry. This method simply calls | |||
| * read( byte[], int, int ). | |||
| * | |||
| * @param buffer The buffer into which to place bytes read. | |||
| * @return The number of bytes read, or -1 at EOF. | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public int read( final byte[] buffer ) | |||
| throws IOException | |||
| { | |||
| return read( buffer, 0, buffer.length ); | |||
| } | |||
| /** | |||
| * Reads bytes from the current tar archive entry. This method is aware of | |||
| * the boundaries of the current entry in the archive and will deal with | |||
| * them as if they were this stream's start and EOF. | |||
| * | |||
| * @param buffer The buffer into which to place bytes read. | |||
| * @param offset The offset at which to place bytes read. | |||
| * @param count The number of bytes to read. | |||
| * @return The number of bytes read, or -1 at EOF. | |||
| */ | |||
| public int read( final byte[] buffer, | |||
| final int offset, | |||
| final int count ) | |||
| throws IOException | |||
| { | |||
| int position = offset; | |||
| int numToRead = count; | |||
| int totalRead = 0; | |||
| if( m_entryOffset >= m_entrySize ) | |||
| { | |||
| return -1; | |||
| } | |||
| if( ( numToRead + m_entryOffset ) > m_entrySize ) | |||
| { | |||
| numToRead = ( m_entrySize - m_entryOffset ); | |||
| } | |||
| if( null != m_readBuf ) | |||
| { | |||
| final int size = | |||
| ( numToRead > m_readBuf.length ) ? m_readBuf.length : numToRead; | |||
| System.arraycopy( m_readBuf, 0, buffer, position, size ); | |||
| if( size >= m_readBuf.length ) | |||
| { | |||
| m_readBuf = null; | |||
| } | |||
| else | |||
| { | |||
| final int newLength = m_readBuf.length - size; | |||
| final byte[] newBuffer = new byte[ newLength ]; | |||
| System.arraycopy( m_readBuf, size, newBuffer, 0, newLength ); | |||
| m_readBuf = newBuffer; | |||
| } | |||
| totalRead += size; | |||
| numToRead -= size; | |||
| position += size; | |||
| } | |||
| while( numToRead > 0 ) | |||
| { | |||
| final byte[] rec = m_buffer.readRecord(); | |||
| if( null == rec ) | |||
| { | |||
| // Unexpected EOF! | |||
| final String message = | |||
| "unexpected EOF with " + numToRead + " bytes unread"; | |||
| throw new IOException( message ); | |||
| } | |||
| int size = numToRead; | |||
| final int recordLength = rec.length; | |||
| if( recordLength > size ) | |||
| { | |||
| System.arraycopy( rec, 0, buffer, position, size ); | |||
| m_readBuf = new byte[ recordLength - size ]; | |||
| System.arraycopy( rec, size, m_readBuf, 0, recordLength - size ); | |||
| } | |||
| else | |||
| { | |||
| size = recordLength; | |||
| System.arraycopy( rec, 0, buffer, position, recordLength ); | |||
| } | |||
| totalRead += size; | |||
| numToRead -= size; | |||
| position += size; | |||
| } | |||
| m_entryOffset += totalRead; | |||
| return totalRead; | |||
| } | |||
| /** | |||
| * Since we do not support marking just yet, we do nothing. | |||
| */ | |||
| public void reset() | |||
| { | |||
| } | |||
| /** | |||
| * Skip bytes in the input buffer. This skips bytes in the current entry's | |||
| * data, not the entire archive, and will stop at the end of the current | |||
| * entry's data if the number to skip extends beyond that point. | |||
| * | |||
| * @param numToSkip The number of bytes to skip. | |||
| */ | |||
| public void skip( final int numToSkip ) | |||
| throws IOException | |||
| { | |||
| // REVIEW | |||
| // This is horribly inefficient, but it ensures that we | |||
| // properly skip over bytes via the TarBuffer... | |||
| // | |||
| final byte[] skipBuf = new byte[ 8 * 1024 ]; | |||
| int num = numToSkip; | |||
| while( num > 0 ) | |||
| { | |||
| final int count = ( num > skipBuf.length ) ? skipBuf.length : num; | |||
| final int numRead = read( skipBuf, 0, count ); | |||
| if( numRead == -1 ) | |||
| { | |||
| break; | |||
| } | |||
| num -= numRead; | |||
| } | |||
| } | |||
| protected void debug( final String message ) | |||
| { | |||
| if( m_debug ) | |||
| { | |||
| System.err.println( message ); | |||
| } | |||
| } | |||
| } | |||
| @@ -1,329 +0,0 @@ | |||
| /* | |||
| * Copyright (C) The Apache Software Foundation. All rights reserved. | |||
| * | |||
| * This software is published under the terms of the Apache Software License | |||
| * version 1.1, a copy of which has been included with this distribution in | |||
| * the LICENSE.txt file. | |||
| */ | |||
| package org.apache.aut.tar; | |||
| import java.io.FilterOutputStream; | |||
| import java.io.IOException; | |||
| import java.io.OutputStream; | |||
| /** | |||
| * The TarOutputStream writes a UNIX tar archive as an OutputStream. Methods are | |||
| * provided to put entries, and then write their contents by writing to this | |||
| * stream using write(). | |||
| * | |||
| * @author Timothy Gerard Endres <a href="mailto:time@ice.com">time@ice.com</a> | |||
| * @author <a href="mailto:peter@apache.org">Peter Donald</a> | |||
| */ | |||
| public class TarOutputStream | |||
| extends FilterOutputStream | |||
| { | |||
| public final static int LONGFILE_ERROR = 0; | |||
| public final static int LONGFILE_TRUNCATE = 1; | |||
| public final static int LONGFILE_GNU = 2; | |||
| private int m_longFileMode = LONGFILE_ERROR; | |||
| private byte[] m_assemBuf; | |||
| private int m_assemLen; | |||
| private TarBuffer m_buffer; | |||
| private int m_currBytes; | |||
| private int m_currSize; | |||
| private byte[] m_oneBuf; | |||
| private byte[] m_recordBuf; | |||
| public TarOutputStream( final OutputStream output ) | |||
| { | |||
| this( output, TarBuffer.DEFAULT_BLKSIZE, TarBuffer.DEFAULT_RCDSIZE ); | |||
| } | |||
| public TarOutputStream( final OutputStream output, final int blockSize ) | |||
| { | |||
| this( output, blockSize, TarBuffer.DEFAULT_RCDSIZE ); | |||
| } | |||
| public TarOutputStream( final OutputStream output, | |||
| final int blockSize, | |||
| final int recordSize ) | |||
| { | |||
| super( output ); | |||
| m_buffer = new TarBuffer( output, blockSize, recordSize ); | |||
| m_assemLen = 0; | |||
| m_assemBuf = new byte[ recordSize ]; | |||
| m_recordBuf = new byte[ recordSize ]; | |||
| m_oneBuf = new byte[ 1 ]; | |||
| } | |||
| /** | |||
| * Sets the debugging flag in this stream's TarBuffer. | |||
| * | |||
| * @param debug The new BufferDebug value | |||
| */ | |||
| public void setBufferDebug( boolean debug ) | |||
| { | |||
| m_buffer.setDebug( debug ); | |||
| } | |||
| public void setLongFileMode( final int longFileMode ) | |||
| { | |||
| m_longFileMode = longFileMode; | |||
| } | |||
| /** | |||
| * Get the record size being used by this stream's TarBuffer. | |||
| * | |||
| * @return The TarBuffer record size. | |||
| */ | |||
| public int getRecordSize() | |||
| { | |||
| return m_buffer.getRecordSize(); | |||
| } | |||
| /** | |||
| * Ends the TAR archive and closes the underlying OutputStream. This means | |||
| * that finish() is called followed by calling the TarBuffer's close(). | |||
| * | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public void close() | |||
| throws IOException | |||
| { | |||
| finish(); | |||
| m_buffer.close(); | |||
| } | |||
| /** | |||
| * Close an entry. This method MUST be called for all file entries that | |||
| * contain data. The reason is that we must buffer data written to the | |||
| * stream in order to satisfy the buffer's record based writes. Thus, there | |||
| * may be data fragments still being assembled that must be written to the | |||
| * output stream before this entry is closed and the next entry written. | |||
| * | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public void closeEntry() | |||
| throws IOException | |||
| { | |||
| if( m_assemLen > 0 ) | |||
| { | |||
| for( int i = m_assemLen; i < m_assemBuf.length; ++i ) | |||
| { | |||
| m_assemBuf[ i ] = 0; | |||
| } | |||
| m_buffer.writeRecord( m_assemBuf ); | |||
| m_currBytes += m_assemLen; | |||
| m_assemLen = 0; | |||
| } | |||
| if( m_currBytes < m_currSize ) | |||
| { | |||
| final String message = "entry closed at '" + m_currBytes + | |||
| "' before the '" + m_currSize + | |||
| "' bytes specified in the header were written"; | |||
| throw new IOException( message ); | |||
| } | |||
| } | |||
| /** | |||
| * Ends the TAR archive without closing the underlying OutputStream. The | |||
| * result is that the EOF record of nulls is written. | |||
| * | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public void finish() | |||
| throws IOException | |||
| { | |||
| writeEOFRecord(); | |||
| } | |||
| /** | |||
| * Put an entry on the output stream. This writes the entry's header record | |||
| * and positions the output stream for writing the contents of the entry. | |||
| * Once this method is called, the stream is ready for calls to write() to | |||
| * write the entry's contents. Once the contents are written, closeEntry() | |||
| * <B>MUST</B> be called to ensure that all buffered data is completely | |||
| * written to the output stream. | |||
| * | |||
| * @param entry The TarEntry to be written to the archive. | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public void putNextEntry( final TarEntry entry ) | |||
| throws IOException | |||
| { | |||
| if( entry.getName().length() >= TarEntry.NAMELEN ) | |||
| { | |||
| if( m_longFileMode == LONGFILE_GNU ) | |||
| { | |||
| // create a TarEntry for the LongLink, the contents | |||
| // of which are the entry's name | |||
| final TarEntry longLinkEntry = | |||
| new TarEntry( TarConstants.GNU_LONGLINK, | |||
| TarConstants.LF_GNUTYPE_LONGNAME ); | |||
| longLinkEntry.setSize( entry.getName().length() + 1 ); | |||
| putNextEntry( longLinkEntry ); | |||
| write( entry.getName().getBytes() ); | |||
| write( 0 ); | |||
| closeEntry(); | |||
| } | |||
| else if( m_longFileMode != LONGFILE_TRUNCATE ) | |||
| { | |||
| final String message = "file name '" + entry.getName() + | |||
| "' is too long ( > " + TarEntry.NAMELEN + " bytes)"; | |||
| throw new IOException( message ); | |||
| } | |||
| } | |||
| entry.writeEntryHeader( m_recordBuf ); | |||
| m_buffer.writeRecord( m_recordBuf ); | |||
| m_currBytes = 0; | |||
| if( entry.isDirectory() ) | |||
| { | |||
| m_currSize = 0; | |||
| } | |||
| else | |||
| { | |||
| m_currSize = (int)entry.getSize(); | |||
| } | |||
| } | |||
| /** | |||
| * Writes a byte to the current tar archive entry. This method simply calls | |||
| * read( byte[], int, int ). | |||
| * | |||
| * @param data The byte written. | |||
| * @exception IOException Description of Exception | |||
| */ | |||
| public void write( final int data ) | |||
| throws IOException | |||
| { | |||
| m_oneBuf[ 0 ] = (byte)data; | |||
| write( m_oneBuf, 0, 1 ); | |||
| } | |||
| /** | |||
| * Writes bytes to the current tar archive entry. This method simply calls | |||
| * write( byte[], int, int ). | |||
| * | |||
| * @param buffer The buffer to write to the archive. | |||
| */ | |||
| public void write( final byte[] buffer ) | |||
| throws IOException | |||
| { | |||
| write( buffer, 0, buffer.length ); | |||
| } | |||
| /** | |||
| * Writes bytes to the current tar archive entry. This method is aware of | |||
| * the current entry and will throw an exception if you attempt to write | |||
| * bytes past the length specified for the current entry. The method is also | |||
| * (painfully) aware of the record buffering required by TarBuffer, and | |||
| * manages buffers that are not a multiple of recordsize in length, | |||
| * including assembling records from small buffers. | |||
| * | |||
| * @param buffer The buffer to write to the archive. | |||
| * @param offset The offset in the buffer from which to get bytes. | |||
| * @param count The number of bytes to write. | |||
| */ | |||
| public void write( final byte[] buffer, | |||
| final int offset, | |||
| final int count ) | |||
| throws IOException | |||
| { | |||
| int position = offset; | |||
| int numToWrite = count; | |||
| if( ( m_currBytes + numToWrite ) > m_currSize ) | |||
| { | |||
| final String message = "request to write '" + numToWrite + | |||
| "' bytes exceeds size in header of '" + m_currSize + "' bytes"; | |||
| throw new IOException( message ); | |||
| // | |||
| // We have to deal with assembly!!! | |||
| // The programmer can be writing little 32 byte chunks for all | |||
| // we know, and we must assemble complete records for writing. | |||
| // REVIEW Maybe this should be in TarBuffer? Could that help to | |||
| // eliminate some of the buffer copying. | |||
| // | |||
| } | |||
| if( m_assemLen > 0 ) | |||
| { | |||
| if( ( m_assemLen + numToWrite ) >= m_recordBuf.length ) | |||
| { | |||
| final int length = m_recordBuf.length - m_assemLen; | |||
| System.arraycopy( m_assemBuf, 0, m_recordBuf, 0, | |||
| m_assemLen ); | |||
| System.arraycopy( buffer, position, m_recordBuf, | |||
| m_assemLen, length ); | |||
| m_buffer.writeRecord( m_recordBuf ); | |||
| m_currBytes += m_recordBuf.length; | |||
| position += length; | |||
| numToWrite -= length; | |||
| m_assemLen = 0; | |||
| } | |||
| else | |||
| { | |||
| System.arraycopy( buffer, position, m_assemBuf, m_assemLen, | |||
| numToWrite ); | |||
| position += numToWrite; | |||
| m_assemLen += numToWrite; | |||
| numToWrite -= numToWrite; | |||
| } | |||
| } | |||
| // | |||
| // When we get here we have EITHER: | |||
| // o An empty "assemble" buffer. | |||
| // o No bytes to write (numToWrite == 0) | |||
| // | |||
| while( numToWrite > 0 ) | |||
| { | |||
| if( numToWrite < m_recordBuf.length ) | |||
| { | |||
| System.arraycopy( buffer, position, m_assemBuf, m_assemLen, | |||
| numToWrite ); | |||
| m_assemLen += numToWrite; | |||
| break; | |||
| } | |||
| m_buffer.writeRecord( buffer, position ); | |||
| int num = m_recordBuf.length; | |||
| m_currBytes += num; | |||
| numToWrite -= num; | |||
| position += num; | |||
| } | |||
| } | |||
| /** | |||
| * Write an EOF (end of archive) record to the tar archive. An EOF record | |||
| * consists of a record of all zeros. | |||
| */ | |||
| private void writeEOFRecord() | |||
| throws IOException | |||
| { | |||
| for( int i = 0; i < m_recordBuf.length; ++i ) | |||
| { | |||
| m_recordBuf[ i ] = 0; | |||
| } | |||
| m_buffer.writeRecord( m_recordBuf ); | |||
| } | |||
| } | |||
| @@ -1,224 +0,0 @@ | |||
| /* | |||
| * Copyright (C) The Apache Software Foundation. All rights reserved. | |||
| * | |||
| * This software is published under the terms of the Apache Software License | |||
| * version 1.1, a copy of which has been included with this distribution in | |||
| * the LICENSE.txt file. | |||
| */ | |||
| package org.apache.aut.tar; | |||
| /** | |||
| * This class provides static utility methods to work with byte streams. | |||
| * | |||
| * @author <a href="mailto:time@ice.com">Timothy Gerard Endres</a> | |||
| * @author <a href="mailto:stefano@apache.org">Stefano Mazzocchi</a> | |||
| */ | |||
| class TarUtils | |||
| { | |||
| /** | |||
| * Parse the checksum octal integer from a header buffer. | |||
| * | |||
| * @param offset The offset into the buffer from which to parse. | |||
| * @param length The number of header bytes to parse. | |||
| * @param value Description of Parameter | |||
| * @param buf Description of Parameter | |||
| * @return The integer value of the entry's checksum. | |||
| */ | |||
| public static int getCheckSumOctalBytes( final long value, | |||
| final byte[] buf, | |||
| final int offset, | |||
| final int length ) | |||
| { | |||
| getOctalBytes( value, buf, offset, length ); | |||
| buf[ offset + length - 1 ] = (byte)' '; | |||
| buf[ offset + length - 2 ] = 0; | |||
| return offset + length; | |||
| } | |||
| /** | |||
| * Parse an octal long integer from a header buffer. | |||
| * | |||
| * @param offset The offset into the buffer from which to parse. | |||
| * @param length The number of header bytes to parse. | |||
| * @param value Description of Parameter | |||
| * @param buf Description of Parameter | |||
| * @return The long value of the octal bytes. | |||
| */ | |||
| public static int getLongOctalBytes( final long value, | |||
| final byte[] buf, | |||
| final int offset, | |||
| final int length ) | |||
| { | |||
| byte[] temp = new byte[ length + 1 ]; | |||
| getOctalBytes( value, temp, 0, length + 1 ); | |||
| System.arraycopy( temp, 0, buf, offset, length ); | |||
| return offset + length; | |||
| } | |||
| /** | |||
| * Determine the number of bytes in an entry name. | |||
| * | |||
| * @param offset The offset into the buffer from which to parse. | |||
| * @param length The number of header bytes to parse. | |||
| * @param name Description of Parameter | |||
| * @param buf Description of Parameter | |||
| * @return The number of bytes in a header's entry name. | |||
| */ | |||
| public static int getNameBytes( final StringBuffer name, | |||
| final byte[] buffer, | |||
| final int offset, | |||
| final int length ) | |||
| { | |||
| int i; | |||
| for( i = 0; i < length && i < name.length(); ++i ) | |||
| { | |||
| buffer[ offset + i ] = (byte)name.charAt( i ); | |||
| } | |||
| for( ; i < length; ++i ) | |||
| { | |||
| buffer[ offset + i ] = 0; | |||
| } | |||
| return offset + length; | |||
| } | |||
| /** | |||
| * Parse an octal integer from a header buffer. | |||
| * | |||
| * @param offset The offset into the buffer from which to parse. | |||
| * @param length The number of header bytes to parse. | |||
| * @return The integer value of the octal bytes. | |||
| */ | |||
| public static int getOctalBytes( final long value, | |||
| final byte[] buffer, | |||
| final int offset, | |||
| final int length ) | |||
| { | |||
| int idx = length - 1; | |||
| buffer[ offset + idx ] = 0; | |||
| --idx; | |||
| buffer[ offset + idx ] = (byte)' '; | |||
| --idx; | |||
| if( value == 0 ) | |||
| { | |||
| buffer[ offset + idx ] = (byte)'0'; | |||
| --idx; | |||
| } | |||
| else | |||
| { | |||
| long val = value; | |||
| while( idx >= 0 && val > 0 ) | |||
| { | |||
| buffer[ offset + idx ] = (byte)( (byte)'0' + (byte)( val & 7 ) ); | |||
| val = val >> 3; | |||
| idx--; | |||
| } | |||
| } | |||
| while( idx >= 0 ) | |||
| { | |||
| buffer[ offset + idx ] = (byte)' '; | |||
| idx--; | |||
| } | |||
| return offset + length; | |||
| } | |||
| /** | |||
| * Compute the checksum of a tar entry header. | |||
| * | |||
| * @param buf The tar entry's header buffer. | |||
| * @return The computed checksum. | |||
| */ | |||
| public static long computeCheckSum( final byte[] buffer ) | |||
| { | |||
| long sum = 0; | |||
| for( int i = 0; i < buffer.length; ++i ) | |||
| { | |||
| sum += 255 & buffer[ i ]; | |||
| } | |||
| return sum; | |||
| } | |||
| /** | |||
| * Parse an entry name from a header buffer. | |||
| * | |||
| * @param header The header buffer from which to parse. | |||
| * @param offset The offset into the buffer from which to parse. | |||
| * @param length The number of header bytes to parse. | |||
| * @return The header's entry name. | |||
| */ | |||
| public static StringBuffer parseName( final byte[] header, | |||
| final int offset, | |||
| final int length ) | |||
| { | |||
| StringBuffer result = new StringBuffer( length ); | |||
| int end = offset + length; | |||
| for( int i = offset; i < end; ++i ) | |||
| { | |||
| if( header[ i ] == 0 ) | |||
| { | |||
| break; | |||
| } | |||
| result.append( (char)header[ i ] ); | |||
| } | |||
| return result; | |||
| } | |||
| /** | |||
| * Parse an octal string from a header buffer. This is used for the file | |||
| * permission mode value. | |||
| * | |||
| * @param header The header buffer from which to parse. | |||
| * @param offset The offset into the buffer from which to parse. | |||
| * @param length The number of header bytes to parse. | |||
| * @return The long value of the octal string. | |||
| */ | |||
| public static long parseOctal( final byte[] header, | |||
| final int offset, | |||
| final int length ) | |||
| { | |||
| long result = 0; | |||
| boolean stillPadding = true; | |||
| int end = offset + length; | |||
| for( int i = offset; i < end; ++i ) | |||
| { | |||
| if( header[ i ] == 0 ) | |||
| { | |||
| break; | |||
| } | |||
| if( header[ i ] == (byte)' ' || header[ i ] == '0' ) | |||
| { | |||
| if( stillPadding ) | |||
| { | |||
| continue; | |||
| } | |||
| if( header[ i ] == (byte)' ' ) | |||
| { | |||
| break; | |||
| } | |||
| } | |||
| stillPadding = false; | |||
| result = ( result << 3 ) + ( header[ i ] - '0' ); | |||
| } | |||
| return result; | |||
| } | |||
| } | |||
| @@ -13,12 +13,10 @@ import java.io.FileOutputStream; | |||
| import java.io.IOException; | |||
| import java.util.ArrayList; | |||
| import java.util.Iterator; | |||
| import org.apache.aut.tar.TarEntry; | |||
| import org.apache.aut.tar.TarOutputStream; | |||
| import org.apache.avalon.excalibur.io.IOUtil; | |||
| import org.apache.avalon.excalibur.tar.TarEntry; | |||
| import org.apache.avalon.excalibur.tar.TarOutputStream; | |||
| import org.apache.myrmidon.api.TaskException; | |||
| import org.apache.myrmidon.api.AbstractTask; | |||
| import org.apache.myrmidon.api.TaskContext; | |||
| import org.apache.tools.todo.taskdefs.MatchingTask; | |||
| import org.apache.tools.todo.types.ScannerUtil; | |||
| import org.apache.tools.todo.types.SourceFileScanner; | |||
| @@ -10,11 +10,10 @@ package org.apache.tools.todo.taskdefs.archive; | |||
| import java.io.File; | |||
| import java.io.FileInputStream; | |||
| import java.io.IOException; | |||
| import org.apache.aut.tar.TarEntry; | |||
| import org.apache.aut.tar.TarInputStream; | |||
| import org.apache.avalon.excalibur.io.IOUtil; | |||
| import org.apache.avalon.excalibur.tar.TarEntry; | |||
| import org.apache.avalon.excalibur.tar.TarInputStream; | |||
| import org.apache.myrmidon.api.TaskException; | |||
| import org.apache.tools.todo.taskdefs.archive.Expand; | |||
| /** | |||
| * Untar a file. Heavily based on the Expand task. | |||