Categories:
Audio (13)
Biotech (29)
Bytecode (36)
Database (77)
Framework (7)
Game (7)
General (507)
Graphics (53)
I/O (35)
IDE (2)
JAR Tools (101)
JavaBeans (21)
JDBC (121)
JDK (426)
JSP (20)
Logging (108)
Mail (58)
Messaging (8)
Network (84)
PDF (97)
Report (7)
Scripting (84)
Security (32)
Server (121)
Servlet (26)
SOAP (24)
Testing (54)
Web (15)
XML (309)
Collections:
Other Resources:
commons-io-2.6-sources.jar - Apache Commons IO
commons-io-2.6-sources.jar is the source JAR file for Apache Commons IO 2.6, which is a library of utilities to assist with developing IO functionality.
JAR File Size and Download Location:
JAR name: commons-io-2.6-sources.jar Target JDK version: 1.7 Dependency: None File size: 280,834 bytes Release date: 15-Oct-2017 Download: Apache Commons IO Website
✍: FYIcenter.com
⏎ org/apache/commons/io/filefilter/MagicNumberFileFilter.java
/* * 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.io.filefilter; import java.io.File; import java.io.IOException; import java.io.RandomAccessFile; import java.io.Serializable; import java.nio.charset.Charset; import java.util.Arrays; /** * <p> * File filter for matching files containing a "magic number". A magic number * is a unique series of bytes common to all files of a specific file format. * For instance, all Java class files begin with the bytes * <code>0xCAFEBABE</code>. * </p> * * <pre> * File dir = new File("."); * MagicNumberFileFilter javaClassFileFilter = * MagicNumberFileFilter(new byte[] {(byte) 0xCA, (byte) 0xFE, * (byte) 0xBA, (byte) 0xBE}); * String[] javaClassFiles = dir.list(javaClassFileFilter); * for (String javaClassFile : javaClassFiles) { * System.out.println(javaClassFile); * } * </pre> * * <p> * Sometimes, such as in the case of TAR files, the * magic number will be offset by a certain number of bytes in the file. In the * case of TAR archive files, this offset is 257 bytes. * </p> * * <pre> * File dir = new File("."); * MagicNumberFileFilter tarFileFilter = * MagicNumberFileFilter("ustar", 257); * String[] tarFiles = dir.list(tarFileFilter); * for (String tarFile : tarFiles) { * System.out.println(tarFile); * } * </pre> * * @since 2.0 * @see FileFilterUtils#magicNumberFileFilter(byte[]) * @see FileFilterUtils#magicNumberFileFilter(String) * @see FileFilterUtils#magicNumberFileFilter(byte[], long) * @see FileFilterUtils#magicNumberFileFilter(String, long) */ public class MagicNumberFileFilter extends AbstractFileFilter implements Serializable { /** * The serialization version unique identifier. */ private static final long serialVersionUID = -547733176983104172L; /** * The magic number to compare against the file's bytes at the provided * offset. */ private final byte[] magicNumbers; /** * The offset (in bytes) within the files that the magic number's bytes * should appear. */ private final long byteOffset; /** * <p> * Constructs a new MagicNumberFileFilter and associates it with the magic * number to test for in files. This constructor assumes a starting offset * of <code>0</code>. * </p> * * <p> * It is important to note that <em>the array is not cloned</em> and that * any changes to the magic number array after construction will affect the * behavior of this file filter. * </p> * * <pre> * MagicNumberFileFilter javaClassFileFilter = * MagicNumberFileFilter(new byte[] {(byte) 0xCA, (byte) 0xFE, * (byte) 0xBA, (byte) 0xBE}); * </pre> * * @param magicNumber the magic number to look for in the file. * * @throws IllegalArgumentException if <code>magicNumber</code> is * {@code null}, or contains no bytes. */ public MagicNumberFileFilter(final byte[] magicNumber) { this(magicNumber, 0); } /** * <p> * Constructs a new MagicNumberFileFilter and associates it with the magic * number to test for in files. This constructor assumes a starting offset * of <code>0</code>. * </p> * * Example usage: * <pre> * {@code * MagicNumberFileFilter xmlFileFilter = * MagicNumberFileFilter("<?xml"); * } * </pre> * * @param magicNumber the magic number to look for in the file. * The string is converted to bytes using the platform default charset. * * @throws IllegalArgumentException if <code>magicNumber</code> is * {@code null} or the empty String. */ public MagicNumberFileFilter(final String magicNumber) { this(magicNumber, 0); } /** * <p> * Constructs a new MagicNumberFileFilter and associates it with the magic * number to test for in files and the byte offset location in the file to * to look for that magic number. * </p> * * <pre> * MagicNumberFileFilter tarFileFilter = * MagicNumberFileFilter("ustar", 257); * </pre> * * @param magicNumber the magic number to look for in the file. * The string is converted to bytes using the platform default charset. * @param offset the byte offset in the file to start comparing bytes. * * @throws IllegalArgumentException if <code>magicNumber</code> is * {@code null} or the empty String, or <code>offset</code> is * a negative number. */ public MagicNumberFileFilter(final String magicNumber, final long offset) { if (magicNumber == null) { throw new IllegalArgumentException("The magic number cannot be null"); } if (magicNumber.isEmpty()) { throw new IllegalArgumentException("The magic number must contain at least one byte"); } if (offset < 0) { throw new IllegalArgumentException("The offset cannot be negative"); } this.magicNumbers = magicNumber.getBytes(Charset.defaultCharset()); // explicitly uses the platform default // charset this.byteOffset = offset; } /** * <p> * Constructs a new MagicNumberFileFilter and associates it with the magic * number to test for in files and the byte offset location in the file to * to look for that magic number. * </p> * * <pre> * MagicNumberFileFilter tarFileFilter = * MagicNumberFileFilter(new byte[] {0x75, 0x73, 0x74, 0x61, 0x72}, 257); * </pre> * * <pre> * MagicNumberFileFilter javaClassFileFilter = * MagicNumberFileFilter(new byte[] {0xCA, 0xFE, 0xBA, 0xBE}, 0); * </pre> * * @param magicNumber the magic number to look for in the file. * @param offset the byte offset in the file to start comparing bytes. * * @throws IllegalArgumentException if <code>magicNumber</code> is * {@code null}, or contains no bytes, or <code>offset</code> * is a negative number. */ public MagicNumberFileFilter(final byte[] magicNumber, final long offset) { if (magicNumber == null) { throw new IllegalArgumentException("The magic number cannot be null"); } if (magicNumber.length == 0) { throw new IllegalArgumentException("The magic number must contain at least one byte"); } if (offset < 0) { throw new IllegalArgumentException("The offset cannot be negative"); } this.magicNumbers = new byte[magicNumber.length]; System.arraycopy(magicNumber, 0, this.magicNumbers, 0, magicNumber.length); this.byteOffset = offset; } /** * <p> * Accepts the provided file if the file contains the file filter's magic * number at the specified offset. * </p> * * <p> * If any {@link IOException}s occur while reading the file, the file will * be rejected. * </p> * * @param file the file to accept or reject. * * @return {@code true} if the file contains the filter's magic number * at the specified offset, {@code false} otherwise. */ @Override public boolean accept(final File file) { if (file != null && file.isFile() && file.canRead()) { try { try (RandomAccessFile randomAccessFile = new RandomAccessFile(file, "r")) { final byte[] fileBytes = new byte[this.magicNumbers.length]; randomAccessFile.seek(byteOffset); final int read = randomAccessFile.read(fileBytes); if (read != magicNumbers.length) { return false; } return Arrays.equals(this.magicNumbers, fileBytes); } } catch (final IOException ioe) { // Do nothing, fall through and do not accept file } } return false; } /** * Returns a String representation of the file filter, which includes the * magic number bytes and byte offset. * * @return a String representation of the file filter. */ @Override public String toString() { final StringBuilder builder = new StringBuilder(super.toString()); builder.append("("); builder.append(new String(magicNumbers, Charset.defaultCharset()));// TODO perhaps use hex if value is not // printable builder.append(","); builder.append(this.byteOffset); builder.append(")"); return builder.toString(); } }
⏎ org/apache/commons/io/filefilter/MagicNumberFileFilter.java
Or download all of them as a single archive file:
File name: commons-io-2.6-sources.jar File size: 280834 bytes Release date: 2017-10-05 Download
⇒ Download and Install commons-io-2.5-bin.zip
2020-12-09, 55421👍, 1💬
Popular Posts:
JDK 11 jdk.jlink.jmod is the JMOD file for JDK 11 JLink tool, which can be invoked by the "jlink" co...
JRE 8 deploy.jar is the JAR file for JRE 8 Java Control Panel and other deploy tools. JRE (Java Runt...
What Is log4j-1.2.15.jar? I got the JAR file from apache-log4j-1.2.15.zip. log4j-1.2.15.jar is the v...
What JAR files are required to run dom\Writer.java provided in the Apache Xerces package? 3 JAR file...
JDK 17 java.base.jmod is the JMOD file for JDK 17 Base module. JDK 17 Base module compiled class fil...