public class MD5
extends java.lang.Object
Originally written by Santeri Paavolainen, Helsinki Finland 1996.
(c) Santeri Paavolainen, Helsinki Finland 1996
Many changes Copyright (c) 2002 - 2005 Timothy W Macinta
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.
You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
See http://www.twmacinta.com/myjava/fast_md5.php for more information on this file and the related files.
This was originally a rather straight re-implementation of the reference implementation given in RFC1321 by RSA. It passes the MD5 test suite as defined in RFC1321.
Many optimizations made by Timothy W Macinta. Reduced time to checksum a test file in Java alone to roughly half the time taken compared with java.security.MessageDigest (within an intepretter). Also added an optional native method to reduce the time even further. See http://www.twmacinta.com/myjava/fast_md5.php for further information on the time improvements achieved.
Some bug fixes also made by Timothy W Macinta.
Please note: I (Timothy Macinta) have put this code in the com.twmacinta.util package only because it came without a package. I was not the the original author of the code, although I did optimize it (substantially) and fix some bugs.
This Java class has been derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm and its reference implementation.
This class will attempt to use a native method to quickly compute checksums when the appropriate native library is available. On Linux, this library should be named "MD5.so" and on Windows it should be named "MD5.dll". The code will attempt to locate the library in the following locations in the order given:
If the library is not found, the code will fall back to the default (slower) Java code.
As a side effect of having the code search for the native library, SecurityExceptions might be thrown on JVMs that have a restrictive SecurityManager. The initialization code attempts to silently discard these exceptions and continue, but many SecurityManagers will attempt to notify the user directly of all SecurityExceptions thrown. Consequently, the code has provisions for skipping the search for the native library. Any of these provisions may be used to skip the search as long as they are performed before the first instance of a com.twmacinta.util.MD5 object is constructed (note that the convenience stream objects will implicitly create an MD5 object).
The first option is to set the system property "com.twmacinta.util.MD5.NO_NATIVE_LIB" to "true" or "1". Unfortunately, SecurityManagers may also choose to disallow system property setting, so this won't be of use in all cases.
The second option is to call com.twmacinta.util.MD5.initNativeLibrary(true) before any MD5 objects are constructed.
Modifier and Type | Field and Description |
---|---|
private MD5State |
finals |
private static char[] |
HEX_CHARS |
static int |
length |
private static byte[] |
padding |
private MD5State |
state |
Constructor and Description |
---|
MD5(byte[] data) |
Modifier and Type | Method and Description |
---|---|
private void |
decode(byte[] buffer,
int shift,
int[] out) |
byte[] |
doFinal()
Returns array of bytes (16 bytes) representing hash as of the current
state of this object.
|
private static byte[] |
encode(int[] input,
int len) |
static boolean |
equals(byte[] hash1,
byte[] hash2) |
byte[] |
fingerprint(byte[] data)
Calculates and returns the hash of the contents of the given file.
|
static byte[] |
hash(byte[] data) |
static java.lang.String |
toBase64(byte[] data) |
static java.lang.String |
toHex(byte[] hash)
Returns 32-character hex representation of this objects hash
|
private void |
transform(MD5State state,
byte[] buffer,
int shift,
int[] decode_buf) |
void |
update(byte[] buffer)
Updates hash with given array of bytes
|
void |
update(byte[] buffer,
int offset,
int length) |
private void |
update(MD5State stat,
byte[] buffer,
int offset,
int length)
Updates hash with the bytebuffer given (using at maximum length bytes
from that buffer)
|
public static final int length
private static final char[] HEX_CHARS
private MD5State state
private MD5State finals
private static final byte[] padding
private final void decode(byte[] buffer, int shift, int[] out)
private final void transform(MD5State state, byte[] buffer, int shift, int[] decode_buf)
private final void update(MD5State stat, byte[] buffer, int offset, int length)
stat
- Which state is updatedbuffer
- Array of bytes to be hashedoffset
- Offset to buffer arraylength
- Use at maximum `length' bytes (absolute maximum is
buffer.length)private static final byte[] encode(int[] input, int len)
public final void update(byte[] buffer)
buffer
- Array of bytes to use for updating the hashpublic final void update(byte[] buffer, int offset, int length)
public final byte[] doFinal()
public static final java.lang.String toHex(byte[] hash)
public static final java.lang.String toBase64(byte[] data)
public static byte[] hash(byte[] data)
public final byte[] fingerprint(byte[] data)
public static final boolean equals(byte[] hash1, byte[] hash2)