Imported GNU Classpath 0.90
Imported GNU Classpath 0.90
* scripts/makemake.tcl: Set gnu/java/awt/peer/swing to ignore.
* gnu/classpath/jdwp/VMFrame.java (SIZE): New constant.
* java/lang/VMCompiler.java: Use gnu.java.security.hash.MD5.
* java/lang/Math.java: New override file.
* java/lang/Character.java: Merged from Classpath.
(start, end): Now 'int's.
(canonicalName): New field.
(CANONICAL_NAME, NO_SPACES_NAME, CONSTANT_NAME): New constants.
(UnicodeBlock): Added argument.
(of): New overload.
(forName): New method.
Updated unicode blocks.
(sets): Updated.
* sources.am: Regenerated.
* Makefile.in: Likewise.
From-SVN: r111942
This commit is contained in:
@@ -0,0 +1,396 @@
|
||||
/* Base64.java --
|
||||
Copyright (C) 2003, 2006 Free Software Foundation, Inc.
|
||||
|
||||
This file is a part of GNU Classpath.
|
||||
|
||||
GNU Classpath is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or (at
|
||||
your option) any later version.
|
||||
|
||||
GNU Classpath 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
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with GNU Classpath; if not, write to the Free Software
|
||||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
|
||||
USA
|
||||
|
||||
Linking this library statically or dynamically with other modules is
|
||||
making a combined work based on this library. Thus, the terms and
|
||||
conditions of the GNU General Public License cover the whole
|
||||
combination.
|
||||
|
||||
As a special exception, the copyright holders of this library give you
|
||||
permission to link this library with independent modules to produce an
|
||||
executable, regardless of the license terms of these independent
|
||||
modules, and to copy and distribute the resulting executable under
|
||||
terms of your choice, provided that you also meet, for each linked
|
||||
independent module, the terms and conditions of the license of that
|
||||
module. An independent module is a module which is not derived from
|
||||
or based on this library. If you modify this library, you may extend
|
||||
this exception to your version of the library, but you are not
|
||||
obligated to do so. If you do not wish to do so, delete this
|
||||
exception statement from your version. */
|
||||
|
||||
|
||||
package gnu.java.security.util;
|
||||
|
||||
import java.io.PrintWriter;
|
||||
import java.io.UnsupportedEncodingException;
|
||||
|
||||
/**
|
||||
* Most of this implementation is from Robert Harder's public domain Base64
|
||||
* code (version 1.4.1 available from <http://iharder.net/xmlizable>).
|
||||
*/
|
||||
public class Base64
|
||||
{
|
||||
|
||||
// Debugging methods and variables
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
private static final String NAME = "Base64";
|
||||
|
||||
private static final boolean DEBUG = true;
|
||||
|
||||
private static final int debuglevel = 9;
|
||||
|
||||
private static final PrintWriter err = new PrintWriter(System.out, true);
|
||||
|
||||
private static void debug(String s)
|
||||
{
|
||||
err.println(">>> " + NAME + ": " + s);
|
||||
}
|
||||
|
||||
// Constants and variables
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/** Maximum line length (76) of Base64 output. */
|
||||
private static final int MAX_LINE_LENGTH = 76;
|
||||
|
||||
/** The new line character (\n) as one byte. */
|
||||
private static final byte NEW_LINE = (byte) '\n';
|
||||
|
||||
/** The equals sign (=) as a byte. */
|
||||
private static final byte EQUALS_SIGN = (byte) '=';
|
||||
|
||||
private static final byte WHITE_SPACE_ENC = -5; // white space in encoding
|
||||
|
||||
private static final byte EQUALS_SIGN_ENC = -1; // equals sign in encoding
|
||||
|
||||
/** The 64 valid Base64 values. */
|
||||
private static final byte[] ALPHABET = { (byte) 'A', (byte) 'B', (byte) 'C',
|
||||
(byte) 'D', (byte) 'E', (byte) 'F',
|
||||
(byte) 'G', (byte) 'H', (byte) 'I',
|
||||
(byte) 'J', (byte) 'K', (byte) 'L',
|
||||
(byte) 'M', (byte) 'N', (byte) 'O',
|
||||
(byte) 'P', (byte) 'Q', (byte) 'R',
|
||||
(byte) 'S', (byte) 'T', (byte) 'U',
|
||||
(byte) 'V', (byte) 'W', (byte) 'X',
|
||||
(byte) 'Y', (byte) 'Z', (byte) 'a',
|
||||
(byte) 'b', (byte) 'c', (byte) 'd',
|
||||
(byte) 'e', (byte) 'f', (byte) 'g',
|
||||
(byte) 'h', (byte) 'i', (byte) 'j',
|
||||
(byte) 'k', (byte) 'l', (byte) 'm',
|
||||
(byte) 'n', (byte) 'o', (byte) 'p',
|
||||
(byte) 'q', (byte) 'r', (byte) 's',
|
||||
(byte) 't', (byte) 'u', (byte) 'v',
|
||||
(byte) 'w', (byte) 'x', (byte) 'y',
|
||||
(byte) 'z', (byte) '0', (byte) '1',
|
||||
(byte) '2', (byte) '3', (byte) '4',
|
||||
(byte) '5', (byte) '6', (byte) '7',
|
||||
(byte) '8', (byte) '9', (byte) '+',
|
||||
(byte) '/' };
|
||||
|
||||
/**
|
||||
* Translates a Base64 value to either its 6-bit reconstruction value or a
|
||||
* negative number indicating some other meaning.
|
||||
*/
|
||||
private static final byte[] DECODABET = { -9, -9, -9, -9, -9, -9, -9, -9, -9, // Decimal 0 - 8
|
||||
-5, -5, // Whitespace: Tab and Linefeed
|
||||
-9, -9, // Decimal 11 - 12
|
||||
-5, // Whitespace: Carriage Return
|
||||
-9, -9, -9, -9, -9, -9, -9, -9, -9,
|
||||
-9, -9, -9, -9, // Decimal 14 - 26
|
||||
-9, -9, -9, -9, -9, // Decimal 27 - 31
|
||||
-5, // Whitespace: Space
|
||||
-9, -9, -9, -9, -9, -9, -9, -9, -9,
|
||||
-9, // Decimal 33 - 42
|
||||
62, // Plus sign at decimal 43
|
||||
-9, -9, -9, // Decimal 44 - 46
|
||||
63, // Slash at decimal 47
|
||||
52, 53, 54, 55, 56, 57, 58, 59, 60,
|
||||
61, // Numbers zero through nine
|
||||
-9, -9, -9, // Decimal 58 - 60
|
||||
-1, // Equals sign at decimal 61
|
||||
-9, -9, -9, // Decimal 62 - 64
|
||||
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10,
|
||||
11, 12, 13, // Letters 'A' through 'N'
|
||||
14, 15, 16, 17, 18, 19, 20, 21, 22,
|
||||
23, 24, 25, // Letters 'O' through 'Z'
|
||||
-9, -9, -9, -9, -9, -9, // Decimal 91 - 96
|
||||
26, 27, 28, 29, 30, 31, 32, 33, 34,
|
||||
35, 36, 37, 38, // Letters 'a' through 'm'
|
||||
39, 40, 41, 42, 43, 44, 45, 46, 47,
|
||||
48, 49, 50, 51, // Letters 'n' through 'z'
|
||||
-9, -9, -9, -9 // Decimal 123 - 126
|
||||
};
|
||||
|
||||
// Constructor(s)
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/** Trivial private ctor to enfore Singleton pattern. */
|
||||
private Base64()
|
||||
{
|
||||
super();
|
||||
}
|
||||
|
||||
// Class methods
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Encodes a byte array into Base64 notation. Equivalent to calling
|
||||
* <code>encode(source, 0, source.length)</code>.
|
||||
*
|
||||
* @param src the data to convert.
|
||||
*/
|
||||
public static final String encode(final byte[] src)
|
||||
{
|
||||
return encode(src, 0, src.length, true);
|
||||
}
|
||||
|
||||
/**
|
||||
* Encodes a byte array into Base64 notation.
|
||||
*
|
||||
* @param src the data to convert.
|
||||
* @param off offset in array where conversion should begin.
|
||||
* @param len length of data to convert.
|
||||
* @param breakLines break lines at 80 characters or less.
|
||||
*/
|
||||
public static final String encode(final byte[] src, final int off,
|
||||
final int len, final boolean breakLines)
|
||||
{
|
||||
final int len43 = len * 4 / 3;
|
||||
final byte[] outBuff = new byte[len43 // Main 4:3
|
||||
+ ((len % 3) > 0 ? 4 : 0) // Account for padding
|
||||
+ (breakLines ? (len43 / MAX_LINE_LENGTH)
|
||||
: 0)]; // New lines
|
||||
int d = 0;
|
||||
int e = 0;
|
||||
final int len2 = len - 2;
|
||||
int lineLength = 0;
|
||||
for (; d < len2; d += 3, e += 4)
|
||||
{
|
||||
encode3to4(src, d + off, 3, outBuff, e);
|
||||
lineLength += 4;
|
||||
if (breakLines && lineLength == MAX_LINE_LENGTH)
|
||||
{
|
||||
outBuff[e + 4] = NEW_LINE;
|
||||
e++;
|
||||
lineLength = 0;
|
||||
}
|
||||
}
|
||||
|
||||
if (d < len)
|
||||
{ // padding needed
|
||||
encode3to4(src, d + off, len - d, outBuff, e);
|
||||
e += 4;
|
||||
}
|
||||
|
||||
return new String(outBuff, 0, e);
|
||||
}
|
||||
|
||||
/**
|
||||
* Decodes data from Base64 notation.
|
||||
*
|
||||
* @param s the string to decode.
|
||||
* @return the decoded data.
|
||||
*/
|
||||
public static final byte[] decode(final String s)
|
||||
throws UnsupportedEncodingException
|
||||
{
|
||||
final byte[] bytes;
|
||||
bytes = s.getBytes("US-ASCII");
|
||||
return decode(bytes, 0, bytes.length);
|
||||
}
|
||||
|
||||
/**
|
||||
* Decodes Base64 content in byte array format and returns the decoded byte
|
||||
* array.
|
||||
*
|
||||
* @param src the Base64 encoded data.
|
||||
* @param off the offset of where to begin decoding.
|
||||
* @param len the length of characters to decode.
|
||||
* @return the decoded data.
|
||||
* @throws IllegalArgumentException if <code>src</code> contains an illegal
|
||||
* Base-64 character.
|
||||
*/
|
||||
public static byte[] decode(final byte[] src, final int off, final int len)
|
||||
{
|
||||
final int len34 = len * 3 / 4;
|
||||
final byte[] outBuff = new byte[len34]; // Upper limit on size of output
|
||||
int outBuffPosn = 0;
|
||||
final byte[] b4 = new byte[4];
|
||||
int b4Posn = 0;
|
||||
int i;
|
||||
byte sbiCrop, sbiDecode;
|
||||
for (i = off; i < off + len; i++)
|
||||
{
|
||||
sbiCrop = (byte) (src[i] & 0x7F); // Only the low seven bits
|
||||
sbiDecode = DECODABET[sbiCrop];
|
||||
if (sbiDecode >= WHITE_SPACE_ENC)
|
||||
{ // White space, Equals sign or better
|
||||
if (sbiDecode >= EQUALS_SIGN_ENC)
|
||||
{
|
||||
b4[b4Posn++] = sbiCrop;
|
||||
if (b4Posn > 3)
|
||||
{
|
||||
outBuffPosn += decode4to3(b4, 0, outBuff, outBuffPosn);
|
||||
b4Posn = 0;
|
||||
// If that was the equals sign, break out of 'for' loop
|
||||
if (sbiCrop == EQUALS_SIGN)
|
||||
break;
|
||||
} // end if: quartet built
|
||||
} // end if: equals sign or better
|
||||
}
|
||||
else
|
||||
{
|
||||
throw new IllegalArgumentException("Illegal BASE-64 character at #"
|
||||
+ i + ": " + src[i]
|
||||
+ "(decimal)");
|
||||
}
|
||||
}
|
||||
|
||||
final byte[] result = new byte[outBuffPosn];
|
||||
System.arraycopy(outBuff, 0, result, 0, outBuffPosn);
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Encodes up to three bytes of the array <code>src</code> and writes
|
||||
* the resulting four Base64 bytes to <code>dest</code>. The source and
|
||||
* destination arrays can be manipulated anywhere along their length by
|
||||
* specifying <code>sOffset</code> and <code>dOffset</code>.</p>
|
||||
*
|
||||
* <p>This method does not check to make sure the arrays are large enough to
|
||||
* accomodate <code>sOffset + 3</code> for the <code>src</code> array or
|
||||
* <code>dOffset + 4</code> for the <code>dest</code> array. The actual
|
||||
* number of significant bytes in the input array is given by
|
||||
* <code>numBytes</code>.</p>
|
||||
*
|
||||
* @param src the array to convert.
|
||||
* @param sOffset the index where conversion begins.
|
||||
* @param numBytes the number of significant bytes in your array.
|
||||
* @param dest the array to hold the conversion.
|
||||
* @param dOffset the index where output will be put.
|
||||
* @return the <code>destination</code> array.
|
||||
*/
|
||||
private static final byte[] encode3to4(final byte[] src, final int sOffset,
|
||||
final int numBytes, final byte[] dest,
|
||||
final int dOffset)
|
||||
{
|
||||
// 1 2 3
|
||||
// 01234567890123456789012345678901 Bit position
|
||||
// --------000000001111111122222222 Array position from threeBytes
|
||||
// --------| || || || | Six bit groups to index ALPHABET
|
||||
// >>18 >>12 >> 6 >> 0 Right shift necessary
|
||||
// 0x3F 0x3F 0x3F Additional AND
|
||||
|
||||
// Create buffer with zero-padding if there are only one or two
|
||||
// significant bytes passed in the array.
|
||||
// We have to shift left 24 in order to flush out the 1's that appear
|
||||
// when Java treats a value as negative that is cast from a byte to an int.
|
||||
final int inBuff = (numBytes > 0 ? ((src[sOffset] << 24) >>> 8) : 0)
|
||||
| (numBytes > 1 ? ((src[sOffset + 1] << 24) >>> 16) : 0)
|
||||
| (numBytes > 2 ? ((src[sOffset + 2] << 24) >>> 24) : 0);
|
||||
switch (numBytes)
|
||||
{
|
||||
case 3:
|
||||
dest[dOffset] = ALPHABET[(inBuff >>> 18)];
|
||||
dest[dOffset + 1] = ALPHABET[(inBuff >>> 12) & 0x3F];
|
||||
dest[dOffset + 2] = ALPHABET[(inBuff >>> 6) & 0x3F];
|
||||
dest[dOffset + 3] = ALPHABET[(inBuff) & 0x3F];
|
||||
break;
|
||||
case 2:
|
||||
dest[dOffset] = ALPHABET[(inBuff >>> 18)];
|
||||
dest[dOffset + 1] = ALPHABET[(inBuff >>> 12) & 0x3F];
|
||||
dest[dOffset + 2] = ALPHABET[(inBuff >>> 6) & 0x3F];
|
||||
dest[dOffset + 3] = EQUALS_SIGN;
|
||||
break;
|
||||
case 1:
|
||||
dest[dOffset] = ALPHABET[(inBuff >>> 18)];
|
||||
dest[dOffset + 1] = ALPHABET[(inBuff >>> 12) & 0x3F];
|
||||
dest[dOffset + 2] = EQUALS_SIGN;
|
||||
dest[dOffset + 3] = EQUALS_SIGN;
|
||||
break;
|
||||
}
|
||||
return dest;
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Decodes four bytes from array <code>src</code> and writes the
|
||||
* resulting bytes (up to three of them) to <code>dest</code>.</p>
|
||||
*
|
||||
* <p>The source and destination arrays can be manipulated anywhere along
|
||||
* their length by specifying <code>sOffset</code> and <code>dOffset</code>.
|
||||
* </p>
|
||||
*
|
||||
* <p>This method does not check to make sure your arrays are large enough
|
||||
* to accomodate <code>sOffset + 4</code> for the <code>src</code> array or
|
||||
* <code>dOffset + 3</code> for the <code>dest</code> array. This method
|
||||
* returns the actual number of bytes that were converted from the Base64
|
||||
* encoding.</p>
|
||||
*
|
||||
* @param src the array to convert.
|
||||
* @param sOffset the index where conversion begins.
|
||||
* @param dest the array to hold the conversion.
|
||||
* @param dOffset the index where output will be put.
|
||||
* @return the number of decoded bytes converted.
|
||||
*/
|
||||
private static final int decode4to3(final byte[] src, final int sOffset,
|
||||
final byte[] dest, final int dOffset)
|
||||
{
|
||||
if (src[sOffset + 2] == EQUALS_SIGN)
|
||||
{ // Example: Dk==
|
||||
final int outBuff = ((DECODABET[src[sOffset]] & 0xFF) << 18)
|
||||
| ((DECODABET[src[sOffset + 1]] & 0xFF) << 12);
|
||||
dest[dOffset] = (byte) (outBuff >>> 16);
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (src[sOffset + 3] == EQUALS_SIGN)
|
||||
{ // Example: DkL=
|
||||
final int outBuff = ((DECODABET[src[sOffset]] & 0xFF) << 18)
|
||||
| ((DECODABET[src[sOffset + 1]] & 0xFF) << 12)
|
||||
| ((DECODABET[src[sOffset + 2]] & 0xFF) << 6);
|
||||
dest[dOffset] = (byte) (outBuff >>> 16);
|
||||
dest[dOffset + 1] = (byte) (outBuff >>> 8);
|
||||
return 2;
|
||||
}
|
||||
|
||||
try
|
||||
{ // Example: DkLE
|
||||
final int outBuff = ((DECODABET[src[sOffset]] & 0xFF) << 18)
|
||||
| ((DECODABET[src[sOffset + 1]] & 0xFF) << 12)
|
||||
| ((DECODABET[src[sOffset + 2]] & 0xFF) << 6)
|
||||
| ((DECODABET[src[sOffset + 3]] & 0xFF));
|
||||
dest[dOffset] = (byte) (outBuff >> 16);
|
||||
dest[dOffset + 1] = (byte) (outBuff >> 8);
|
||||
dest[dOffset + 2] = (byte) outBuff;
|
||||
return 3;
|
||||
}
|
||||
catch (Exception x)
|
||||
{
|
||||
if (DEBUG && debuglevel > 8)
|
||||
{
|
||||
debug("" + src[sOffset] + ": " + (DECODABET[src[sOffset]]));
|
||||
debug("" + src[sOffset + 1] + ": " + (DECODABET[src[sOffset + 1]]));
|
||||
debug("" + src[sOffset + 2] + ": " + (DECODABET[src[sOffset + 2]]));
|
||||
debug("" + src[sOffset + 3] + ": " + (DECODABET[src[sOffset + 3]]));
|
||||
}
|
||||
return -1;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,64 @@
|
||||
/* DerUtil.java -- Utility methods for DER read/write operations
|
||||
Copyright (C) 2006 Free Software Foundation, Inc.
|
||||
|
||||
This file is part of GNU Classpath.
|
||||
|
||||
GNU Classpath is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2, or (at your option)
|
||||
any later version.
|
||||
|
||||
GNU Classpath 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
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with GNU Classpath; see the file COPYING. If not, write to the
|
||||
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
||||
02110-1301 USA.
|
||||
|
||||
Linking this library statically or dynamically with other modules is
|
||||
making a combined work based on this library. Thus, the terms and
|
||||
conditions of the GNU General Public License cover the whole
|
||||
combination.
|
||||
|
||||
As a special exception, the copyright holders of this library give you
|
||||
permission to link this library with independent modules to produce an
|
||||
executable, regardless of the license terms of these independent
|
||||
modules, and to copy and distribute the resulting executable under
|
||||
terms of your choice, provided that you also meet, for each linked
|
||||
independent module, the terms and conditions of the license of that
|
||||
module. An independent module is a module which is not derived from
|
||||
or based on this library. If you modify this library, you may extend
|
||||
this exception to your version of the library, but you are not
|
||||
obligated to do so. If you do not wish to do so, delete this
|
||||
exception statement from your version. */
|
||||
|
||||
|
||||
package gnu.java.security.util;
|
||||
|
||||
import gnu.java.security.der.DEREncodingException;
|
||||
import gnu.java.security.der.DERValue;
|
||||
|
||||
import java.math.BigInteger;
|
||||
|
||||
/**
|
||||
* Utility methods for DER encoding handling.
|
||||
*/
|
||||
public abstract class DerUtil
|
||||
{
|
||||
public static final void checkIsConstructed(DERValue v, String msg)
|
||||
throws DEREncodingException
|
||||
{
|
||||
if (! v.isConstructed())
|
||||
throw new DEREncodingException(msg);
|
||||
}
|
||||
|
||||
public static final void checkIsBigInteger(DERValue v, String msg)
|
||||
throws DEREncodingException
|
||||
{
|
||||
if (! (v.getValue() instanceof BigInteger))
|
||||
throw new DEREncodingException(msg);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,172 @@
|
||||
/* ExpirableObject.java -- an object that is automatically destroyed.
|
||||
Copyright (C) 2004, 2006 Free Software Foundation, Inc.
|
||||
|
||||
This file is a part of GNU Classpath.
|
||||
|
||||
GNU Classpath is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or (at
|
||||
your option) any later version.
|
||||
|
||||
GNU Classpath 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
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with GNU Classpath; if not, write to the Free Software
|
||||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
|
||||
USA
|
||||
|
||||
Linking this library statically or dynamically with other modules is
|
||||
making a combined work based on this library. Thus, the terms and
|
||||
conditions of the GNU General Public License cover the whole
|
||||
combination.
|
||||
|
||||
As a special exception, the copyright holders of this library give you
|
||||
permission to link this library with independent modules to produce an
|
||||
executable, regardless of the license terms of these independent
|
||||
modules, and to copy and distribute the resulting executable under
|
||||
terms of your choice, provided that you also meet, for each linked
|
||||
independent module, the terms and conditions of the license of that
|
||||
module. An independent module is a module which is not derived from
|
||||
or based on this library. If you modify this library, you may extend
|
||||
this exception to your version of the library, but you are not
|
||||
obligated to do so. If you do not wish to do so, delete this
|
||||
exception statement from your version. */
|
||||
|
||||
|
||||
package gnu.java.security.util;
|
||||
|
||||
import java.util.Timer;
|
||||
import java.util.TimerTask;
|
||||
|
||||
import javax.security.auth.DestroyFailedException;
|
||||
import javax.security.auth.Destroyable;
|
||||
|
||||
/**
|
||||
* The base class for objects with sensitive data that are automatically
|
||||
* destroyed after a timeout elapses. On creation, an object that extends
|
||||
* this class will automatically be added to a {@link Timer} object that,
|
||||
* once a timeout elapses, will automatically call the {@link
|
||||
* Destroyable#destroy()} method.
|
||||
*
|
||||
* <p>Concrete subclasses must implement the {@link doDestroy()} method
|
||||
* instead of {@link Destroyable#destroy()}; the behavior of that method
|
||||
* should match exactly the behavior desired of <code>destroy()</code>.
|
||||
*
|
||||
* <p>Note that if a {@link DestroyFailedException} occurs when the timeout
|
||||
* expires, it will not be reported.
|
||||
*
|
||||
* @see Destroyable
|
||||
*/
|
||||
public abstract class ExpirableObject implements Destroyable
|
||||
{
|
||||
|
||||
// Constants and fields.
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* The default timeout, used in the default constructor.
|
||||
*/
|
||||
public static final long DEFAULT_TIMEOUT = 3600000L;
|
||||
|
||||
/**
|
||||
* The timer that expires instances.
|
||||
*/
|
||||
private static final Timer EXPIRER = new Timer(true);
|
||||
|
||||
/**
|
||||
* A reference to the task that will destroy this object when the timeout
|
||||
* expires.
|
||||
*/
|
||||
private final Destroyer destroyer;
|
||||
|
||||
// Constructors.
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Create a new expirable object that will expire after one hour.
|
||||
*/
|
||||
protected ExpirableObject()
|
||||
{
|
||||
this(DEFAULT_TIMEOUT);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a new expirable object that will expire after the specified
|
||||
* timeout.
|
||||
*
|
||||
* @param delay The delay before expiration.
|
||||
* @throws IllegalArgumentException If <i>delay</i> is negative, or if
|
||||
* <code>delay + System.currentTimeMillis()</code> is negative.
|
||||
*/
|
||||
protected ExpirableObject(final long delay)
|
||||
{
|
||||
destroyer = new Destroyer(this);
|
||||
EXPIRER.schedule(destroyer, delay);
|
||||
}
|
||||
|
||||
// Instance methods.
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Destroys this object. This method calls {@link doDestroy}, then, if
|
||||
* no exception is thrown, cancels the task that would destroy this object
|
||||
* when the timeout is reached.
|
||||
*
|
||||
* @throws DestroyFailedException If this operation fails.
|
||||
*/
|
||||
public final void destroy() throws DestroyFailedException
|
||||
{
|
||||
doDestroy();
|
||||
destroyer.cancel();
|
||||
}
|
||||
|
||||
/**
|
||||
* Subclasses must implement this method instead of the {@link
|
||||
* Destroyable#destroy()} method.
|
||||
*
|
||||
* @throws DestroyFailedException If this operation fails.
|
||||
*/
|
||||
protected abstract void doDestroy() throws DestroyFailedException;
|
||||
|
||||
// Inner classes.
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* The task that destroys the target when the timeout elapses.
|
||||
*/
|
||||
private final class Destroyer extends TimerTask
|
||||
{
|
||||
|
||||
// Fields.
|
||||
// -----------------------------------------------------------------------
|
||||
|
||||
private final ExpirableObject target;
|
||||
|
||||
// Constructor.
|
||||
// -----------------------------------------------------------------------
|
||||
|
||||
Destroyer(final ExpirableObject target)
|
||||
{
|
||||
super();
|
||||
this.target = target;
|
||||
}
|
||||
|
||||
// Instance methods.
|
||||
// -----------------------------------------------------------------------
|
||||
|
||||
public void run()
|
||||
{
|
||||
try
|
||||
{
|
||||
if (!target.isDestroyed())
|
||||
target.doDestroy();
|
||||
}
|
||||
catch (DestroyFailedException dfe)
|
||||
{
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,140 @@
|
||||
/* FormatUtil.java -- Encoding and decoding format utility methods
|
||||
Copyright (C) 2006 Free Software Foundation, Inc.
|
||||
|
||||
This file is part of GNU Classpath.
|
||||
|
||||
GNU Classpath is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2, or (at your option)
|
||||
any later version.
|
||||
|
||||
GNU Classpath 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
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with GNU Classpath; see the file COPYING. If not, write to the
|
||||
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
||||
02110-1301 USA.
|
||||
|
||||
Linking this library statically or dynamically with other modules is
|
||||
making a combined work based on this library. Thus, the terms and
|
||||
conditions of the GNU General Public License cover the whole
|
||||
combination.
|
||||
|
||||
As a special exception, the copyright holders of this library give you
|
||||
permission to link this library with independent modules to produce an
|
||||
executable, regardless of the license terms of these independent
|
||||
modules, and to copy and distribute the resulting executable under
|
||||
terms of your choice, provided that you also meet, for each linked
|
||||
independent module, the terms and conditions of the license of that
|
||||
module. An independent module is a module which is not derived from
|
||||
or based on this library. If you modify this library, you may extend
|
||||
this exception to your version of the library, but you are not
|
||||
obligated to do so. If you do not wish to do so, delete this
|
||||
exception statement from your version. */
|
||||
|
||||
|
||||
package gnu.java.security.util;
|
||||
|
||||
import gnu.java.security.Registry;
|
||||
|
||||
/**
|
||||
* Encoding and decoding format utility methods.
|
||||
*/
|
||||
public class FormatUtil
|
||||
{
|
||||
/** Trivial constructor to enforce Singleton pattern. */
|
||||
private FormatUtil()
|
||||
{
|
||||
super();
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the fully qualified name of the designated encoding ID.
|
||||
*
|
||||
* @param formatID the unique identifier of the encoding format.
|
||||
* @return the fully qualified name of the designated format. Returns
|
||||
* <code>null</code> if no such encoding format is known.
|
||||
*/
|
||||
public static final String getEncodingName(int formatID)
|
||||
{
|
||||
String result = null;
|
||||
switch (formatID)
|
||||
{
|
||||
case Registry.RAW_ENCODING_ID:
|
||||
result = Registry.RAW_ENCODING;
|
||||
break;
|
||||
case Registry.X509_ENCODING_ID:
|
||||
result = Registry.X509_ENCODING;
|
||||
break;
|
||||
case Registry.PKCS8_ENCODING_ID:
|
||||
result = Registry.PKCS8_ENCODING;
|
||||
break;
|
||||
case Registry.ASN1_ENCODING_ID:
|
||||
result = Registry.ASN1_ENCODING;
|
||||
break;
|
||||
}
|
||||
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the short name of the designated encoding ID. This is used by the
|
||||
* JCE Adapters.
|
||||
*
|
||||
* @param formatID the unique identifier of the encoding format.
|
||||
* @return the short name of the designated format. Returns <code>null</code>
|
||||
* if no such encoding format is known.
|
||||
*/
|
||||
public static final String getEncodingShortName(int formatID)
|
||||
{
|
||||
String result = null;
|
||||
switch (formatID)
|
||||
{
|
||||
case Registry.RAW_ENCODING_ID:
|
||||
result = Registry.RAW_ENCODING_SHORT_NAME;
|
||||
break;
|
||||
case Registry.X509_ENCODING_ID:
|
||||
result = Registry.X509_ENCODING_SORT_NAME;
|
||||
break;
|
||||
case Registry.PKCS8_ENCODING_ID:
|
||||
result = Registry.PKCS8_ENCODING_SHORT_NAME;
|
||||
break;
|
||||
case Registry.ASN1_ENCODING_ID:
|
||||
result = Registry.ASN1_ENCODING_SHORT_NAME;
|
||||
break;
|
||||
}
|
||||
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the identifier of the encoding format given its short name.
|
||||
*
|
||||
* @param name the case-insensitive canonical short name of an encoding
|
||||
* format.
|
||||
* @return the identifier of the designated encoding format, or <code>0</code>
|
||||
* if the name does not correspond to any known format.
|
||||
*/
|
||||
public static final int getFormatID(String name)
|
||||
{
|
||||
if (name == null)
|
||||
return 0;
|
||||
|
||||
name = name.trim();
|
||||
if (name.length() == 0)
|
||||
return 0;
|
||||
|
||||
int result = 0;
|
||||
if (name.equalsIgnoreCase(Registry.RAW_ENCODING_SHORT_NAME))
|
||||
result = Registry.RAW_ENCODING_ID;
|
||||
else if (name.equalsIgnoreCase(Registry.X509_ENCODING_SORT_NAME))
|
||||
result = Registry.X509_ENCODING_ID;
|
||||
else if (name.equalsIgnoreCase(Registry.PKCS8_ENCODING_SHORT_NAME))
|
||||
result = Registry.PKCS8_ENCODING_ID;
|
||||
|
||||
return result;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,156 @@
|
||||
/* PRNG.java -- A Utility methods for default source of randomness
|
||||
Copyright (C) 2006 Free Software Foundation, Inc.
|
||||
|
||||
This file is part of GNU Classpath.
|
||||
|
||||
GNU Classpath is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2, or (at your option)
|
||||
any later version.
|
||||
|
||||
GNU Classpath 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
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with GNU Classpath; see the file COPYING. If not, write to the
|
||||
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
||||
02110-1301 USA.
|
||||
|
||||
Linking this library statically or dynamically with other modules is
|
||||
making a combined work based on this library. Thus, the terms and
|
||||
conditions of the GNU General Public License cover the whole
|
||||
combination.
|
||||
|
||||
As a special exception, the copyright holders of this library give you
|
||||
permission to link this library with independent modules to produce an
|
||||
executable, regardless of the license terms of these independent
|
||||
modules, and to copy and distribute the resulting executable under
|
||||
terms of your choice, provided that you also meet, for each linked
|
||||
independent module, the terms and conditions of the license of that
|
||||
module. An independent module is a module which is not derived from
|
||||
or based on this library. If you modify this library, you may extend
|
||||
this exception to your version of the library, but you are not
|
||||
obligated to do so. If you do not wish to do so, delete this
|
||||
exception statement from your version. */
|
||||
|
||||
|
||||
package gnu.java.security.util;
|
||||
|
||||
import java.util.HashMap;
|
||||
|
||||
import gnu.java.security.prng.IRandom;
|
||||
import gnu.java.security.prng.LimitReachedException;
|
||||
import gnu.java.security.prng.MDGenerator;
|
||||
|
||||
/**
|
||||
* A useful hash-based (SHA) pseudo-random number generator used
|
||||
* throughout this library.
|
||||
*
|
||||
* @see MDGenerator
|
||||
*/
|
||||
public class PRNG
|
||||
{
|
||||
// Constans and fields
|
||||
// --------------------------------------------------------------------------
|
||||
|
||||
/** The underlying {@link IRandom}. */
|
||||
private IRandom delegate;
|
||||
|
||||
// Constructor(s)
|
||||
// --------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Private constructor to enforce using the Factory method.
|
||||
*
|
||||
* @param delegate
|
||||
* the undelying {@link IRandom} object used.
|
||||
*/
|
||||
private PRNG(IRandom delegate)
|
||||
{
|
||||
super();
|
||||
|
||||
this.delegate = delegate;
|
||||
}
|
||||
|
||||
// Class methods
|
||||
// --------------------------------------------------------------------------
|
||||
|
||||
public static final PRNG getInstance()
|
||||
{
|
||||
IRandom delegate = new MDGenerator();
|
||||
try
|
||||
{
|
||||
HashMap map = new HashMap();
|
||||
// initialise it with a seed
|
||||
long t = System.currentTimeMillis();
|
||||
byte[] seed = new byte[] {
|
||||
(byte) (t >>> 56), (byte) (t >>> 48),
|
||||
(byte) (t >>> 40), (byte) (t >>> 32),
|
||||
(byte) (t >>> 24), (byte) (t >>> 16),
|
||||
(byte) (t >>> 8), (byte) t};
|
||||
map.put(MDGenerator.SEEED, seed);
|
||||
delegate.init(map); // default is to use SHA-1 hash
|
||||
}
|
||||
catch (Exception x)
|
||||
{
|
||||
throw new ExceptionInInitializerError(x);
|
||||
}
|
||||
|
||||
return new PRNG(delegate);
|
||||
}
|
||||
|
||||
// Instance methods
|
||||
// --------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Completely fills the designated <code>buffer</code> with random data
|
||||
* generated by the underlying delegate.
|
||||
*
|
||||
* @param buffer
|
||||
* the place holder of random bytes generated by the underlying
|
||||
* delegate. On output, the contents of <code>buffer</code> are
|
||||
* replaced with pseudo-random data, iff the <code>buffer</code>
|
||||
* size is not zero.
|
||||
*/
|
||||
public void nextBytes(byte[] buffer)
|
||||
{
|
||||
nextBytes(buffer, 0, buffer.length);
|
||||
}
|
||||
|
||||
/**
|
||||
* Fills the designated <code>buffer</code>, starting from byte at position
|
||||
* <code>offset</code> with, at most, <code>length</code> bytes of random
|
||||
* data generated by the underlying delegate.
|
||||
*
|
||||
* @see IRandom#nextBytes
|
||||
*/
|
||||
public void nextBytes(byte[] buffer, int offset, int length)
|
||||
{
|
||||
try
|
||||
{
|
||||
delegate.nextBytes(buffer, offset, length);
|
||||
}
|
||||
catch (LimitReachedException x) // re-initialise with a seed
|
||||
{
|
||||
try
|
||||
{
|
||||
HashMap map = new HashMap();
|
||||
long t = System.currentTimeMillis();
|
||||
byte[] seed = new byte[] {
|
||||
(byte)(t >>> 56), (byte)(t >>> 48),
|
||||
(byte)(t >>> 40), (byte)(t >>> 32),
|
||||
(byte)(t >>> 24), (byte)(t >>> 16),
|
||||
(byte)(t >>> 8), (byte) t };
|
||||
map.put(MDGenerator.SEEED, seed);
|
||||
delegate.init(map); // default is to use SHA-1 hash
|
||||
delegate.nextBytes(buffer, offset, length);
|
||||
}
|
||||
catch (Exception y)
|
||||
{
|
||||
throw new ExceptionInInitializerError(y);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,417 @@
|
||||
/* Prime2.java --
|
||||
Copyright (C) 2001, 2002, 2003, 2006 Free Software Foundation, Inc.
|
||||
|
||||
This file is a part of GNU Classpath.
|
||||
|
||||
GNU Classpath is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or (at
|
||||
your option) any later version.
|
||||
|
||||
GNU Classpath 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
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with GNU Classpath; if not, write to the Free Software
|
||||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
|
||||
USA
|
||||
|
||||
Linking this library statically or dynamically with other modules is
|
||||
making a combined work based on this library. Thus, the terms and
|
||||
conditions of the GNU General Public License cover the whole
|
||||
combination.
|
||||
|
||||
As a special exception, the copyright holders of this library give you
|
||||
permission to link this library with independent modules to produce an
|
||||
executable, regardless of the license terms of these independent
|
||||
modules, and to copy and distribute the resulting executable under
|
||||
terms of your choice, provided that you also meet, for each linked
|
||||
independent module, the terms and conditions of the license of that
|
||||
module. An independent module is a module which is not derived from
|
||||
or based on this library. If you modify this library, you may extend
|
||||
this exception to your version of the library, but you are not
|
||||
obligated to do so. If you do not wish to do so, delete this
|
||||
exception statement from your version. */
|
||||
|
||||
|
||||
package gnu.java.security.util;
|
||||
|
||||
import java.io.PrintWriter;
|
||||
import java.lang.ref.WeakReference;
|
||||
import java.math.BigInteger;
|
||||
import java.util.Map;
|
||||
import java.util.WeakHashMap;
|
||||
|
||||
/**
|
||||
* <p>A collection of prime number related utilities used in this library.</p>
|
||||
*/
|
||||
public class Prime2
|
||||
{
|
||||
|
||||
// Debugging methods and variables
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
private static final String NAME = "prime";
|
||||
|
||||
private static final boolean DEBUG = false;
|
||||
|
||||
private static final int debuglevel = 5;
|
||||
|
||||
private static final PrintWriter err = new PrintWriter(System.out, true);
|
||||
|
||||
private static void debug(String s)
|
||||
{
|
||||
err.println(">>> " + NAME + ": " + s);
|
||||
}
|
||||
|
||||
// Constants and variables
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
private static final int DEFAULT_CERTAINTY = 20; // XXX is this a good value?
|
||||
|
||||
private static final BigInteger ZERO = BigInteger.ZERO;
|
||||
|
||||
private static final BigInteger ONE = BigInteger.ONE;
|
||||
|
||||
private static final BigInteger TWO = BigInteger.valueOf(2L);
|
||||
|
||||
/**
|
||||
* The first SMALL_PRIME primes: Algorithm P, section 1.3.2, The Art of
|
||||
* Computer Programming, Donald E. Knuth.
|
||||
*/
|
||||
private static final int SMALL_PRIME_COUNT = 1000;
|
||||
|
||||
private static final BigInteger[] SMALL_PRIME = new BigInteger[SMALL_PRIME_COUNT];
|
||||
static
|
||||
{
|
||||
long time = -System.currentTimeMillis();
|
||||
SMALL_PRIME[0] = TWO;
|
||||
int N = 3;
|
||||
int J = 0;
|
||||
int prime;
|
||||
P2: while (true)
|
||||
{
|
||||
SMALL_PRIME[++J] = BigInteger.valueOf(N);
|
||||
if (J >= 999)
|
||||
{
|
||||
break P2;
|
||||
}
|
||||
P4: while (true)
|
||||
{
|
||||
N += 2;
|
||||
P6: for (int K = 1; true; K++)
|
||||
{
|
||||
prime = SMALL_PRIME[K].intValue();
|
||||
if ((N % prime) == 0)
|
||||
{
|
||||
continue P4;
|
||||
}
|
||||
else if ((N / prime) <= prime)
|
||||
{
|
||||
continue P2;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
time += System.currentTimeMillis();
|
||||
if (DEBUG && debuglevel > 8)
|
||||
{
|
||||
StringBuffer sb;
|
||||
for (int i = 0; i < (SMALL_PRIME_COUNT / 10); i++)
|
||||
{
|
||||
sb = new StringBuffer();
|
||||
for (int j = 0; j < 10; j++)
|
||||
{
|
||||
sb.append(String.valueOf(SMALL_PRIME[i * 10 + j])).append(" ");
|
||||
}
|
||||
debug(sb.toString());
|
||||
}
|
||||
}
|
||||
if (DEBUG && debuglevel > 4)
|
||||
{
|
||||
debug("Generating first " + String.valueOf(SMALL_PRIME_COUNT)
|
||||
+ " primes took: " + String.valueOf(time) + " ms.");
|
||||
}
|
||||
}
|
||||
|
||||
private static final Map knownPrimes = new WeakHashMap();
|
||||
|
||||
// Constructor(s)
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/** Trivial constructor to enforce Singleton pattern. */
|
||||
private Prime2()
|
||||
{
|
||||
super();
|
||||
}
|
||||
|
||||
// Class methods
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* <p>Trial division for the first 1000 small primes.</p>
|
||||
*
|
||||
* <p>Returns <code>true</code> if at least one small prime, among the first
|
||||
* 1000 ones, was found to divide the designated number. Retuens <code>false</code>
|
||||
* otherwise.</p>
|
||||
*
|
||||
* @param w the number to test.
|
||||
* @return <code>true</code> if at least one small prime was found to divide
|
||||
* the designated number.
|
||||
*/
|
||||
public static boolean hasSmallPrimeDivisor(BigInteger w)
|
||||
{
|
||||
BigInteger prime;
|
||||
for (int i = 0; i < SMALL_PRIME_COUNT; i++)
|
||||
{
|
||||
prime = SMALL_PRIME[i];
|
||||
if (w.mod(prime).equals(ZERO))
|
||||
{
|
||||
if (DEBUG && debuglevel > 4)
|
||||
{
|
||||
debug(prime.toString(16) + " | " + w.toString(16) + "...");
|
||||
}
|
||||
return true;
|
||||
}
|
||||
}
|
||||
if (DEBUG && debuglevel > 4)
|
||||
{
|
||||
debug(w.toString(16) + " has no small prime divisors...");
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Java port of Colin Plumb primality test (Euler Criterion)
|
||||
* implementation for a base of 2 --from bnlib-1.1 release, function
|
||||
* primeTest() in prime.c. this is his comments.</p>
|
||||
*
|
||||
* <p>"Now, check that bn is prime. If it passes to the base 2, it's prime
|
||||
* beyond all reasonable doubt, and everything else is just gravy, but it
|
||||
* gives people warm fuzzies to do it.</p>
|
||||
*
|
||||
* <p>This starts with verifying Euler's criterion for a base of 2. This is
|
||||
* the fastest pseudoprimality test that I know of, saving a modular squaring
|
||||
* over a Fermat test, as well as being stronger. 7/8 of the time, it's as
|
||||
* strong as a strong pseudoprimality test, too. (The exception being when
|
||||
* <code>bn == 1 mod 8</code> and <code>2</code> is a quartic residue, i.e.
|
||||
* <code>bn</code> is of the form <code>a^2 + (8*b)^2</code>.) The precise
|
||||
* series of tricks used here is not documented anywhere, so here's an
|
||||
* explanation. Euler's criterion states that if <code>p</code> is prime
|
||||
* then <code>a^((p-1)/2)</code> is congruent to <code>Jacobi(a,p)</code>,
|
||||
* modulo <code>p</code>. <code>Jacobi(a, p)</code> is a function which is
|
||||
* <code>+1</code> if a is a square modulo <code>p</code>, and <code>-1</code>
|
||||
* if it is not. For <code>a = 2</code>, this is particularly simple. It's
|
||||
* <code>+1</code> if <code>p == +/-1 (mod 8)</code>, and <code>-1</code> if
|
||||
* <code>m == +/-3 (mod 8)</code>. If <code>p == 3 (mod 4)</code>, then all
|
||||
* a strong test does is compute <code>2^((p-1)/2)</code>. and see if it's
|
||||
* <code>+1</code> or <code>-1</code>. (Euler's criterion says <i>which</i>
|
||||
* it should be.) If <code>p == 5 (mod 8)</code>, then <code>2^((p-1)/2)</code>
|
||||
* is <code>-1</code>, so the initial step in a strong test, looking at
|
||||
* <code>2^((p-1)/4)</code>, is wasted --you're not going to find a
|
||||
* <code>+/-1</code> before then if it <b>is</b> prime, and it shouldn't
|
||||
* have either of those values if it isn't. So don't bother.</p>
|
||||
*
|
||||
* <p>The remaining case is <code>p == 1 (mod 8)</code>. In this case, we
|
||||
* expect <code>2^((p-1)/2) == 1 (mod p)</code>, so we expect that the
|
||||
* square root of this, <code>2^((p-1)/4)</code>, will be <code>+/-1 (mod p)
|
||||
* </code>. Evaluating this saves us a modular squaring 1/4 of the time. If
|
||||
* it's <code>-1</code>, a strong pseudoprimality test would call <code>p</code>
|
||||
* prime as well. Only if the result is <code>+1</code>, indicating that
|
||||
* <code>2</code> is not only a quadratic residue, but a quartic one as well,
|
||||
* does a strong pseudoprimality test verify more things than this test does.
|
||||
* Good enough.</p>
|
||||
*
|
||||
* <p>We could back that down another step, looking at <code>2^((p-1)/8)</code>
|
||||
* if there was a cheap way to determine if <code>2</code> were expected to
|
||||
* be a quartic residue or not. Dirichlet proved that <code>2</code> is a
|
||||
* quadratic residue iff <code>p</code> is of the form <code>a^2 + (8*b^2)</code>.
|
||||
* All primes <code>== 1 (mod 4)</code> can be expressed as <code>a^2 +
|
||||
* (2*b)^2</code>, but I see no cheap way to evaluate this condition."</p>
|
||||
*
|
||||
* @param bn the number to test.
|
||||
* @return <code>true</code> iff the designated number passes Euler criterion
|
||||
* as implemented by Colin Plumb in his <i>bnlib</i> version 1.1.
|
||||
*/
|
||||
public static boolean passEulerCriterion(final BigInteger bn)
|
||||
{
|
||||
BigInteger bn_minus_one = bn.subtract(ONE);
|
||||
BigInteger e = bn_minus_one;
|
||||
// l is the 3 least-significant bits of e
|
||||
int l = e.and(BigInteger.valueOf(7L)).intValue();
|
||||
int j = 1; // Where to start in prime array for strong prime tests
|
||||
BigInteger a;
|
||||
int k;
|
||||
|
||||
if (l != 0)
|
||||
{
|
||||
e = e.shiftRight(1);
|
||||
a = TWO.modPow(e, bn);
|
||||
if (l == 6) // bn == 7 mod 8, expect +1
|
||||
{
|
||||
if (a.bitLength() != 1)
|
||||
{
|
||||
debugBI("Fails Euler criterion #1", bn);
|
||||
return false; // Not prime
|
||||
}
|
||||
k = 1;
|
||||
}
|
||||
else // bn == 3 or 5 mod 8, expect -1 == bn-1
|
||||
{
|
||||
a = a.add(ONE);
|
||||
if (a.compareTo(bn) != 0)
|
||||
{
|
||||
debugBI("Fails Euler criterion #2", bn);
|
||||
return false; // Not prime
|
||||
}
|
||||
k = 1;
|
||||
if ((l & 4) != 0) // bn == 5 mod 8, make odd for strong tests
|
||||
{
|
||||
e = e.shiftRight(1);
|
||||
k = 2;
|
||||
}
|
||||
}
|
||||
}
|
||||
else // bn == 1 mod 8, expect 2^((bn-1)/4) == +/-1 mod bn
|
||||
{
|
||||
e = e.shiftRight(2);
|
||||
a = TWO.modPow(e, bn);
|
||||
if (a.bitLength() == 1)
|
||||
j = 0; // Re-do strong prime test to base 2
|
||||
else
|
||||
{
|
||||
a = a.add(ONE);
|
||||
if (a.compareTo(bn) != 0)
|
||||
{
|
||||
debugBI("Fails Euler criterion #3", bn);
|
||||
return false; // Not prime
|
||||
}
|
||||
}
|
||||
// bnMakeOdd(n) = d * 2^s. Replaces n with d and returns s.
|
||||
k = e.getLowestSetBit();
|
||||
e = e.shiftRight(k);
|
||||
k += 2;
|
||||
}
|
||||
// It's prime! Now go on to confirmation tests
|
||||
|
||||
// Now, e = (bn-1)/2^k is odd. k >= 1, and has a given value with
|
||||
// probability 2^-k, so its expected value is 2. j = 1 in the usual case
|
||||
// when the previous test was as good as a strong prime test, but 1/8 of
|
||||
// the time, j = 0 because the strong prime test to the base 2 needs to
|
||||
// be re-done.
|
||||
for (int i = j; i < 7; i++) // try only the first 7 primes
|
||||
{
|
||||
a = SMALL_PRIME[i];
|
||||
a = a.modPow(e, bn);
|
||||
if (a.bitLength() == 1)
|
||||
continue; // Passed this test
|
||||
|
||||
l = k;
|
||||
while (true)
|
||||
{
|
||||
// a = a.add(ONE);
|
||||
// if (a.compareTo(w) == 0) { // Was result bn-1?
|
||||
if (a.compareTo(bn_minus_one) == 0) // Was result bn-1?
|
||||
break; // Prime
|
||||
|
||||
if (--l == 0) // Reached end, not -1? luck?
|
||||
{
|
||||
debugBI("Fails Euler criterion #4", bn);
|
||||
return false; // Failed, not prime
|
||||
}
|
||||
// This portion is executed, on average, once
|
||||
// a = a.subtract(ONE); // Put a back where it was
|
||||
a = a.modPow(TWO, bn);
|
||||
if (a.bitLength() == 1)
|
||||
{
|
||||
debugBI("Fails Euler criterion #5", bn);
|
||||
return false; // Failed, not prime
|
||||
}
|
||||
}
|
||||
// It worked (to the base primes[i])
|
||||
}
|
||||
debugBI("Passes Euler criterion", bn);
|
||||
return true;
|
||||
}
|
||||
|
||||
public static boolean isProbablePrime(BigInteger w)
|
||||
{
|
||||
return isProbablePrime(w, DEFAULT_CERTAINTY);
|
||||
}
|
||||
|
||||
/**
|
||||
* Wrapper around {@link BigInteger#isProbablePrime(int)} with few pre-checks.
|
||||
*
|
||||
* @param w the integer to test.
|
||||
* @param certainty the certainty with which to compute the test.
|
||||
*/
|
||||
public static boolean isProbablePrime(BigInteger w, int certainty)
|
||||
{
|
||||
// Nonnumbers are not prime.
|
||||
if (w == null)
|
||||
return false;
|
||||
|
||||
// eliminate trivial cases when w == 0 or 1
|
||||
if (w.equals(ZERO) || w.equals(ONE))
|
||||
return false;
|
||||
|
||||
// Test if w is a known small prime.
|
||||
for (int i = 0; i < SMALL_PRIME_COUNT; i++)
|
||||
if (w.equals(SMALL_PRIME[i]))
|
||||
{
|
||||
if (DEBUG && debuglevel > 4)
|
||||
debug(w.toString(16) + " is a small prime");
|
||||
return true;
|
||||
}
|
||||
|
||||
// Check if it's already a known prime
|
||||
WeakReference obj = (WeakReference) knownPrimes.get(w);
|
||||
if (obj != null && w.equals(obj.get()))
|
||||
{
|
||||
if (DEBUG && debuglevel > 4)
|
||||
debug("found in known primes");
|
||||
return true;
|
||||
}
|
||||
|
||||
// trial division with first 1000 primes
|
||||
if (hasSmallPrimeDivisor(w))
|
||||
{
|
||||
if (DEBUG && debuglevel > 4)
|
||||
debug(w.toString(16) + " has a small prime divisor. Rejected...");
|
||||
return false;
|
||||
}
|
||||
|
||||
// Euler's criterion.
|
||||
// if (passEulerCriterion(w)) {
|
||||
// if (DEBUG && debuglevel > 4) {
|
||||
// debug(w.toString(16)+" passes Euler's criterion...");
|
||||
// }
|
||||
// } else {
|
||||
// if (DEBUG && debuglevel > 4) {
|
||||
// debug(w.toString(16)+" fails Euler's criterion. Rejected...");
|
||||
// }
|
||||
// return false;
|
||||
// }
|
||||
//
|
||||
// if (DEBUG && debuglevel > 4)
|
||||
// {
|
||||
// debug(w.toString(16) + " is probable prime. Accepted...");
|
||||
// }
|
||||
|
||||
boolean result = w.isProbablePrime(certainty);
|
||||
if (result && certainty > 0) // store it in the known primes weak hash-map
|
||||
knownPrimes.put(w, new WeakReference(w));
|
||||
|
||||
return result;
|
||||
}
|
||||
|
||||
// helper methods -----------------------------------------------------------
|
||||
|
||||
private static final void debugBI(String msg, BigInteger bn)
|
||||
{
|
||||
if (DEBUG && debuglevel > 4)
|
||||
debug("*** " + msg + ": 0x" + bn.toString(16));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,149 @@
|
||||
/* Sequence.java -- a sequence of integers.
|
||||
Copyright (C) 2004, 2006 Free Software Foundation, Inc.
|
||||
|
||||
This file is a part of GNU Classpath.
|
||||
|
||||
GNU Classpath is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or (at
|
||||
your option) any later version.
|
||||
|
||||
GNU Classpath 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
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with GNU Classpath; if not, write to the Free Software
|
||||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
|
||||
USA
|
||||
|
||||
Linking this library statically or dynamically with other modules is
|
||||
making a combined work based on this library. Thus, the terms and
|
||||
conditions of the GNU General Public License cover the whole
|
||||
combination.
|
||||
|
||||
As a special exception, the copyright holders of this library give you
|
||||
permission to link this library with independent modules to produce an
|
||||
executable, regardless of the license terms of these independent
|
||||
modules, and to copy and distribute the resulting executable under
|
||||
terms of your choice, provided that you also meet, for each linked
|
||||
independent module, the terms and conditions of the license of that
|
||||
module. An independent module is a module which is not derived from
|
||||
or based on this library. If you modify this library, you may extend
|
||||
this exception to your version of the library, but you are not
|
||||
obligated to do so. If you do not wish to do so, delete this
|
||||
exception statement from your version. */
|
||||
|
||||
|
||||
package gnu.java.security.util;
|
||||
|
||||
import java.util.AbstractList;
|
||||
import java.util.LinkedList;
|
||||
|
||||
/**
|
||||
* A monotonic sequence of integers in the finite field 2<sup>32</sup>.
|
||||
*/
|
||||
public final class Sequence extends AbstractList
|
||||
{
|
||||
|
||||
// Field.
|
||||
// ------------------------------------------------------------------------
|
||||
|
||||
private final Integer[] sequence;
|
||||
|
||||
// Constructor.
|
||||
// ------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Create a sequence of integers from 0 to <i>end</i>, with an increment
|
||||
* of 1. If <i>end</i> is less than 0, then the sequence will wrap around
|
||||
* through all positive integers then negative integers until the end
|
||||
* value is reached. Naturally, this will result in an enormous object,
|
||||
* so don't do this.
|
||||
*
|
||||
* @param end The ending value.
|
||||
*/
|
||||
public Sequence(int end)
|
||||
{
|
||||
this(0, end, 1);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a sequence of integers from <i>start</i> to <i>end</i>, with an
|
||||
* increment of 1. If <i>end</i> is less than <i>start</i>, then the sequence
|
||||
* will wrap around until the end value is reached. Naturally, this will
|
||||
* result in an enormous object, so don't do this.
|
||||
*
|
||||
* @param start The starting value.
|
||||
* @param end The ending value.
|
||||
*/
|
||||
public Sequence(int start, int end)
|
||||
{
|
||||
this(start, end, 1);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a sequence of integers from <i>start</i> to <i>end</i>, with an
|
||||
* increment of <i>span</i>. If <i>end</i> is less than <i>start</i>, then
|
||||
* the sequence will wrap around until the end value is reached. Naturally,
|
||||
* this will result in an enormous object, so don't do this.
|
||||
*
|
||||
* <p><i>span</i> can be negative, resulting in a decresing sequence.
|
||||
*
|
||||
* <p>If <i>span</i> is 0, then the sequence will contain {<i>start</i>,
|
||||
* <i>end</i>} if <i>start</i> != <i>end</i>, or just the singleton
|
||||
* <i>start</i> if <i>start</i> == <i>end</i>.
|
||||
*
|
||||
* @param start The starting value.
|
||||
* @param end The ending value.
|
||||
* @param span The increment value.
|
||||
*/
|
||||
public Sequence(int start, int end, int span)
|
||||
{
|
||||
if (span == 0)
|
||||
{
|
||||
if (start != end)
|
||||
{
|
||||
sequence = new Integer[] { new Integer(start), new Integer(end) };
|
||||
}
|
||||
else
|
||||
{
|
||||
sequence = new Integer[] { new Integer(start) };
|
||||
}
|
||||
}
|
||||
else
|
||||
{
|
||||
LinkedList l = new LinkedList();
|
||||
for (int i = start; i != end; i += span)
|
||||
{
|
||||
l.add(new Integer(i));
|
||||
}
|
||||
l.add(new Integer(end));
|
||||
sequence = (Integer[]) l.toArray(new Integer[l.size()]);
|
||||
}
|
||||
}
|
||||
|
||||
// Instance methods.
|
||||
// ------------------------------------------------------------------------
|
||||
|
||||
public Object get(int index)
|
||||
{
|
||||
if (index < 0 || index >= size())
|
||||
{
|
||||
throw new IndexOutOfBoundsException("index=" + index + ", size="
|
||||
+ size());
|
||||
}
|
||||
return sequence[index];
|
||||
}
|
||||
|
||||
public int size()
|
||||
{
|
||||
return sequence.length;
|
||||
}
|
||||
|
||||
public Object[] toArray()
|
||||
{
|
||||
return (Object[]) sequence.clone();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,171 @@
|
||||
/* SimpleList.java -- simple way to make tuples.
|
||||
Copyright (C) 2004, 2006 Free Software Foundation, Inc.
|
||||
|
||||
This file is a part of GNU Classpath.
|
||||
|
||||
GNU Classpath is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or (at
|
||||
your option) any later version.
|
||||
|
||||
GNU Classpath 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
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with GNU Classpath; if not, write to the Free Software
|
||||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
|
||||
USA
|
||||
|
||||
Linking this library statically or dynamically with other modules is
|
||||
making a combined work based on this library. Thus, the terms and
|
||||
conditions of the GNU General Public License cover the whole
|
||||
combination.
|
||||
|
||||
As a special exception, the copyright holders of this library give you
|
||||
permission to link this library with independent modules to produce an
|
||||
executable, regardless of the license terms of these independent
|
||||
modules, and to copy and distribute the resulting executable under
|
||||
terms of your choice, provided that you also meet, for each linked
|
||||
independent module, the terms and conditions of the license of that
|
||||
module. An independent module is a module which is not derived from
|
||||
or based on this library. If you modify this library, you may extend
|
||||
this exception to your version of the library, but you are not
|
||||
obligated to do so. If you do not wish to do so, delete this
|
||||
exception statement from your version. */
|
||||
|
||||
|
||||
package gnu.java.security.util;
|
||||
|
||||
import java.util.AbstractList;
|
||||
import java.util.Collection;
|
||||
import java.util.Iterator;
|
||||
|
||||
/**
|
||||
* A simple way to create immutable n-tuples. This class can be created with
|
||||
* up to four elements specified via one of the constructors, or with a
|
||||
* collection of arbitrary size.
|
||||
*/
|
||||
public final class SimpleList extends AbstractList
|
||||
{
|
||||
|
||||
// Fields.
|
||||
// ------------------------------------------------------------------------
|
||||
|
||||
private final Object[] elements;
|
||||
|
||||
// Constructors.
|
||||
// ------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Create a singleton list.
|
||||
*
|
||||
* @param e1 The first element.
|
||||
*/
|
||||
public SimpleList(final Object element)
|
||||
{
|
||||
elements = new Object[1];
|
||||
elements[0] = element;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create an ordered pair (2-tuple).
|
||||
*
|
||||
* @param e1 The first element.
|
||||
* @param e2 The second element.
|
||||
*/
|
||||
public SimpleList(final Object e1, final Object e2)
|
||||
{
|
||||
elements = new Object[2];
|
||||
elements[0] = e1;
|
||||
elements[1] = e2;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a 3-tuple.
|
||||
*
|
||||
* @param e1 The first element.
|
||||
* @param e2 The second element.
|
||||
* @param e3 The third element.
|
||||
*/
|
||||
public SimpleList(final Object e1, final Object e2, final Object e3)
|
||||
{
|
||||
elements = new Object[3];
|
||||
elements[0] = e1;
|
||||
elements[1] = e2;
|
||||
elements[2] = e3;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a 4-tuple.
|
||||
*
|
||||
* @param e1 The first element.
|
||||
* @param e2 The second element.
|
||||
* @param e3 The third element.
|
||||
* @param e4 The fourth element.
|
||||
*/
|
||||
public SimpleList(final Object e1, final Object e2, final Object e3,
|
||||
final Object e4)
|
||||
{
|
||||
elements = new Object[4];
|
||||
elements[0] = e1;
|
||||
elements[1] = e2;
|
||||
elements[2] = e3;
|
||||
elements[3] = e4;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create the empty list.
|
||||
*/
|
||||
public SimpleList()
|
||||
{
|
||||
elements = null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create an n-tuple of arbitrary size. Even if the supplied collection has
|
||||
* no natural order, the created n-tuple will have the order that the
|
||||
* elements are returned by the collection's iterator.
|
||||
*
|
||||
* @param c The collection.
|
||||
*/
|
||||
public SimpleList(Collection c)
|
||||
{
|
||||
elements = new Object[c.size()];
|
||||
int i = 0;
|
||||
for (Iterator it = c.iterator(); it.hasNext() && i < elements.length;)
|
||||
{
|
||||
elements[i++] = it.next();
|
||||
}
|
||||
}
|
||||
|
||||
// Instance methods.
|
||||
// ------------------------------------------------------------------------
|
||||
|
||||
public int size()
|
||||
{
|
||||
if (elements == null)
|
||||
return 0;
|
||||
return elements.length;
|
||||
}
|
||||
|
||||
public Object get(int index)
|
||||
{
|
||||
if (elements == null)
|
||||
{
|
||||
throw new IndexOutOfBoundsException("list is empty");
|
||||
}
|
||||
if (index < 0 || index >= elements.length)
|
||||
{
|
||||
throw new IndexOutOfBoundsException("index=" + index + ", size="
|
||||
+ size());
|
||||
}
|
||||
return elements[index];
|
||||
}
|
||||
|
||||
public String toString()
|
||||
{
|
||||
return SimpleList.class.getName() + "(" + size() + ") " + super.toString();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,692 @@
|
||||
/* Util.java -- various utility routines.
|
||||
Copyright (C) 2001, 2002, 2003, 2006 Free Software Foundation, Inc.
|
||||
|
||||
This file is a part of GNU Classpath.
|
||||
|
||||
GNU Classpath is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or (at
|
||||
your option) any later version.
|
||||
|
||||
GNU Classpath 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
|
||||
General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with GNU Classpath; if not, write to the Free Software
|
||||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
|
||||
USA
|
||||
|
||||
Linking this library statically or dynamically with other modules is
|
||||
making a combined work based on this library. Thus, the terms and
|
||||
conditions of the GNU General Public License cover the whole
|
||||
combination.
|
||||
|
||||
As a special exception, the copyright holders of this library give you
|
||||
permission to link this library with independent modules to produce an
|
||||
executable, regardless of the license terms of these independent
|
||||
modules, and to copy and distribute the resulting executable under
|
||||
terms of your choice, provided that you also meet, for each linked
|
||||
independent module, the terms and conditions of the license of that
|
||||
module. An independent module is a module which is not derived from
|
||||
or based on this library. If you modify this library, you may extend
|
||||
this exception to your version of the library, but you are not
|
||||
obligated to do so. If you do not wish to do so, delete this
|
||||
exception statement from your version. */
|
||||
|
||||
|
||||
package gnu.java.security.util;
|
||||
|
||||
import java.math.BigInteger;
|
||||
|
||||
/**
|
||||
* <p>A collection of utility methods used throughout this project.</p>
|
||||
*
|
||||
* @version $Revision: 1.1 $
|
||||
*/
|
||||
public class Util
|
||||
{
|
||||
|
||||
// Constants and variables
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
// Hex charset
|
||||
private static final char[] HEX_DIGITS = "0123456789ABCDEF".toCharArray();
|
||||
|
||||
// Base-64 charset
|
||||
private static final String BASE64_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz./";
|
||||
|
||||
private static final char[] BASE64_CHARSET = BASE64_CHARS.toCharArray();
|
||||
|
||||
// Constructor(s)
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/** Trivial constructor to enforce Singleton pattern. */
|
||||
private Util()
|
||||
{
|
||||
super();
|
||||
}
|
||||
|
||||
// Class methods
|
||||
// -------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* <p>Returns a string of hexadecimal digits from a byte array. Each byte is
|
||||
* converted to 2 hex symbols; zero(es) included.</p>
|
||||
*
|
||||
* <p>This method calls the method with same name and three arguments as:</p>
|
||||
*
|
||||
* <pre>
|
||||
* toString(ba, 0, ba.length);
|
||||
* </pre>
|
||||
*
|
||||
* @param ba the byte array to convert.
|
||||
* @return a string of hexadecimal characters (two for each byte)
|
||||
* representing the designated input byte array.
|
||||
*/
|
||||
public static String toString(byte[] ba)
|
||||
{
|
||||
return toString(ba, 0, ba.length);
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a string of hexadecimal digits from a byte array, starting at
|
||||
* <code>offset</code> and consisting of <code>length</code> bytes. Each byte
|
||||
* is converted to 2 hex symbols; zero(es) included.</p>
|
||||
*
|
||||
* @param ba the byte array to convert.
|
||||
* @param offset the index from which to start considering the bytes to
|
||||
* convert.
|
||||
* @param length the count of bytes, starting from the designated offset to
|
||||
* convert.
|
||||
* @return a string of hexadecimal characters (two for each byte)
|
||||
* representing the designated input byte sub-array.
|
||||
*/
|
||||
public static final String toString(byte[] ba, int offset, int length)
|
||||
{
|
||||
char[] buf = new char[length * 2];
|
||||
for (int i = 0, j = 0, k; i < length;)
|
||||
{
|
||||
k = ba[offset + i++];
|
||||
buf[j++] = HEX_DIGITS[(k >>> 4) & 0x0F];
|
||||
buf[j++] = HEX_DIGITS[k & 0x0F];
|
||||
}
|
||||
return new String(buf);
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a string of hexadecimal digits from a byte array. Each byte is
|
||||
* converted to 2 hex symbols; zero(es) included. The argument is
|
||||
* treated as a large little-endian integer and is returned as a
|
||||
* large big-endian integer.</p>
|
||||
*
|
||||
* <p>This method calls the method with same name and three arguments as:</p>
|
||||
*
|
||||
* <pre>
|
||||
* toReversedString(ba, 0, ba.length);
|
||||
* </pre>
|
||||
*
|
||||
* @param ba the byte array to convert.
|
||||
* @return a string of hexadecimal characters (two for each byte)
|
||||
* representing the designated input byte array.
|
||||
*/
|
||||
public static String toReversedString(byte[] ba)
|
||||
{
|
||||
return toReversedString(ba, 0, ba.length);
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a string of hexadecimal digits from a byte array, starting at
|
||||
* <code>offset</code> and consisting of <code>length</code> bytes. Each byte
|
||||
* is converted to 2 hex symbols; zero(es) included.</p>
|
||||
*
|
||||
* <p>The byte array is treated as a large little-endian integer, and
|
||||
* is returned as a large big-endian integer.</p>
|
||||
*
|
||||
* @param ba the byte array to convert.
|
||||
* @param offset the index from which to start considering the bytes to
|
||||
* convert.
|
||||
* @param length the count of bytes, starting from the designated offset to
|
||||
* convert.
|
||||
* @return a string of hexadecimal characters (two for each byte)
|
||||
* representing the designated input byte sub-array.
|
||||
*/
|
||||
public static final String toReversedString(byte[] ba, int offset, int length)
|
||||
{
|
||||
char[] buf = new char[length * 2];
|
||||
for (int i = offset + length - 1, j = 0, k; i >= offset;)
|
||||
{
|
||||
k = ba[offset + i--];
|
||||
buf[j++] = HEX_DIGITS[(k >>> 4) & 0x0F];
|
||||
buf[j++] = HEX_DIGITS[k & 0x0F];
|
||||
}
|
||||
return new String(buf);
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a byte array from a string of hexadecimal digits.</p>
|
||||
*
|
||||
* @param s a string of hexadecimal ASCII characters
|
||||
* @return the decoded byte array from the input hexadecimal string.
|
||||
*/
|
||||
public static byte[] toBytesFromString(String s)
|
||||
{
|
||||
int limit = s.length();
|
||||
byte[] result = new byte[((limit + 1) / 2)];
|
||||
int i = 0, j = 0;
|
||||
if ((limit % 2) == 1)
|
||||
{
|
||||
result[j++] = (byte) fromDigit(s.charAt(i++));
|
||||
}
|
||||
while (i < limit)
|
||||
{
|
||||
result[j] = (byte) (fromDigit(s.charAt(i++)) << 4);
|
||||
result[j++] |= (byte) fromDigit(s.charAt(i++));
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a byte array from a string of hexadecimal digits, interpreting
|
||||
* them as a large big-endian integer and returning it as a large
|
||||
* little-endian integer.</p>
|
||||
*
|
||||
* @param s a string of hexadecimal ASCII characters
|
||||
* @return the decoded byte array from the input hexadecimal string.
|
||||
*/
|
||||
public static byte[] toReversedBytesFromString(String s)
|
||||
{
|
||||
int limit = s.length();
|
||||
byte[] result = new byte[((limit + 1) / 2)];
|
||||
int i = 0;
|
||||
if ((limit % 2) == 1)
|
||||
{
|
||||
result[i++] = (byte) fromDigit(s.charAt(--limit));
|
||||
}
|
||||
while (limit > 0)
|
||||
{
|
||||
result[i] = (byte) fromDigit(s.charAt(--limit));
|
||||
result[i++] |= (byte) (fromDigit(s.charAt(--limit)) << 4);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a number from <code>0</code> to <code>15</code> corresponding
|
||||
* to the designated hexadecimal digit.</p>
|
||||
*
|
||||
* @param c a hexadecimal ASCII symbol.
|
||||
*/
|
||||
public static int fromDigit(char c)
|
||||
{
|
||||
if (c >= '0' && c <= '9')
|
||||
{
|
||||
return c - '0';
|
||||
}
|
||||
else if (c >= 'A' && c <= 'F')
|
||||
{
|
||||
return c - 'A' + 10;
|
||||
}
|
||||
else if (c >= 'a' && c <= 'f')
|
||||
{
|
||||
return c - 'a' + 10;
|
||||
}
|
||||
else
|
||||
throw new IllegalArgumentException("Invalid hexadecimal digit: " + c);
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a string of 8 hexadecimal digits (most significant digit first)
|
||||
* corresponding to the unsigned integer <code>n</code>.</p>
|
||||
*
|
||||
* @param n the unsigned integer to convert.
|
||||
* @return a hexadecimal string 8-character long.
|
||||
*/
|
||||
public static String toString(int n)
|
||||
{
|
||||
char[] buf = new char[8];
|
||||
for (int i = 7; i >= 0; i--)
|
||||
{
|
||||
buf[i] = HEX_DIGITS[n & 0x0F];
|
||||
n >>>= 4;
|
||||
}
|
||||
return new String(buf);
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a string of hexadecimal digits from an integer array. Each int
|
||||
* is converted to 4 hex symbols.</p>
|
||||
*/
|
||||
public static String toString(int[] ia)
|
||||
{
|
||||
int length = ia.length;
|
||||
char[] buf = new char[length * 8];
|
||||
for (int i = 0, j = 0, k; i < length; i++)
|
||||
{
|
||||
k = ia[i];
|
||||
buf[j++] = HEX_DIGITS[(k >>> 28) & 0x0F];
|
||||
buf[j++] = HEX_DIGITS[(k >>> 24) & 0x0F];
|
||||
buf[j++] = HEX_DIGITS[(k >>> 20) & 0x0F];
|
||||
buf[j++] = HEX_DIGITS[(k >>> 16) & 0x0F];
|
||||
buf[j++] = HEX_DIGITS[(k >>> 12) & 0x0F];
|
||||
buf[j++] = HEX_DIGITS[(k >>> 8) & 0x0F];
|
||||
buf[j++] = HEX_DIGITS[(k >>> 4) & 0x0F];
|
||||
buf[j++] = HEX_DIGITS[k & 0x0F];
|
||||
}
|
||||
return new String(buf);
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a string of 16 hexadecimal digits (most significant digit first)
|
||||
* corresponding to the unsigned long <code>n</code>.</p>
|
||||
*
|
||||
* @param n the unsigned long to convert.
|
||||
* @return a hexadecimal string 16-character long.
|
||||
*/
|
||||
public static String toString(long n)
|
||||
{
|
||||
char[] b = new char[16];
|
||||
for (int i = 15; i >= 0; i--)
|
||||
{
|
||||
b[i] = HEX_DIGITS[(int) (n & 0x0FL)];
|
||||
n >>>= 4;
|
||||
}
|
||||
return new String(b);
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Similar to the <code>toString()</code> method except that the Unicode
|
||||
* escape character is inserted before every pair of bytes. Useful to
|
||||
* externalise byte arrays that will be constructed later from such strings;
|
||||
* eg. s-box values.</p>
|
||||
*
|
||||
* @throws ArrayIndexOutOfBoundsException if the length is odd.
|
||||
*/
|
||||
public static String toUnicodeString(byte[] ba)
|
||||
{
|
||||
return toUnicodeString(ba, 0, ba.length);
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Similar to the <code>toString()</code> method except that the Unicode
|
||||
* escape character is inserted before every pair of bytes. Useful to
|
||||
* externalise byte arrays that will be constructed later from such strings;
|
||||
* eg. s-box values.</p>
|
||||
*
|
||||
* @throws ArrayIndexOutOfBoundsException if the length is odd.
|
||||
*/
|
||||
public static final String toUnicodeString(byte[] ba, int offset, int length)
|
||||
{
|
||||
StringBuffer sb = new StringBuffer();
|
||||
int i = 0;
|
||||
int j = 0;
|
||||
int k;
|
||||
sb.append('\n').append("\"");
|
||||
while (i < length)
|
||||
{
|
||||
sb.append("\\u");
|
||||
|
||||
k = ba[offset + i++];
|
||||
sb.append(HEX_DIGITS[(k >>> 4) & 0x0F]);
|
||||
sb.append(HEX_DIGITS[k & 0x0F]);
|
||||
|
||||
k = ba[offset + i++];
|
||||
sb.append(HEX_DIGITS[(k >>> 4) & 0x0F]);
|
||||
sb.append(HEX_DIGITS[k & 0x0F]);
|
||||
|
||||
if ((++j % 8) == 0)
|
||||
{
|
||||
sb.append("\"+").append('\n').append("\"");
|
||||
}
|
||||
}
|
||||
sb.append("\"").append('\n');
|
||||
return sb.toString();
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Similar to the <code>toString()</code> method except that the Unicode
|
||||
* escape character is inserted before every pair of bytes. Useful to
|
||||
* externalise integer arrays that will be constructed later from such
|
||||
* strings; eg. s-box values.</p>
|
||||
*
|
||||
* @throws ArrayIndexOutOfBoundsException if the length is not a multiple of 4.
|
||||
*/
|
||||
public static String toUnicodeString(int[] ia)
|
||||
{
|
||||
StringBuffer sb = new StringBuffer();
|
||||
int i = 0;
|
||||
int j = 0;
|
||||
int k;
|
||||
sb.append('\n').append("\"");
|
||||
while (i < ia.length)
|
||||
{
|
||||
k = ia[i++];
|
||||
sb.append("\\u");
|
||||
sb.append(HEX_DIGITS[(k >>> 28) & 0x0F]);
|
||||
sb.append(HEX_DIGITS[(k >>> 24) & 0x0F]);
|
||||
sb.append(HEX_DIGITS[(k >>> 20) & 0x0F]);
|
||||
sb.append(HEX_DIGITS[(k >>> 16) & 0x0F]);
|
||||
sb.append("\\u");
|
||||
sb.append(HEX_DIGITS[(k >>> 12) & 0x0F]);
|
||||
sb.append(HEX_DIGITS[(k >>> 8) & 0x0F]);
|
||||
sb.append(HEX_DIGITS[(k >>> 4) & 0x0F]);
|
||||
sb.append(HEX_DIGITS[k & 0x0F]);
|
||||
|
||||
if ((++j % 4) == 0)
|
||||
{
|
||||
sb.append("\"+").append('\n').append("\"");
|
||||
}
|
||||
}
|
||||
sb.append("\"").append('\n');
|
||||
return sb.toString();
|
||||
}
|
||||
|
||||
public static byte[] toBytesFromUnicode(String s)
|
||||
{
|
||||
int limit = s.length() * 2;
|
||||
byte[] result = new byte[limit];
|
||||
char c;
|
||||
for (int i = 0; i < limit; i++)
|
||||
{
|
||||
c = s.charAt(i >>> 1);
|
||||
result[i] = (byte) (((i & 1) == 0) ? c >>> 8 : c);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Dumps a byte array as a string, in a format that is easy to read for
|
||||
* debugging. The string <code>m</code> is prepended to the start of each
|
||||
* line.</p>
|
||||
*
|
||||
* <p>If <code>offset</code> and <code>length</code> are omitted, the whole
|
||||
* array is used. If <code>m</code> is omitted, nothing is prepended to each
|
||||
* line.</p>
|
||||
*
|
||||
* @param data the byte array to be dumped.
|
||||
* @param offset the offset within <i>data</i> to start from.
|
||||
* @param length the number of bytes to dump.
|
||||
* @param m a string to be prepended to each line.
|
||||
* @return a string containing the result.
|
||||
*/
|
||||
public static String dumpString(byte[] data, int offset, int length, String m)
|
||||
{
|
||||
if (data == null)
|
||||
{
|
||||
return m + "null\n";
|
||||
}
|
||||
StringBuffer sb = new StringBuffer(length * 3);
|
||||
if (length > 32)
|
||||
{
|
||||
sb.append(m).append("Hexadecimal dump of ").append(length).append(
|
||||
" bytes...\n");
|
||||
}
|
||||
// each line will list 32 bytes in 4 groups of 8 each
|
||||
int end = offset + length;
|
||||
String s;
|
||||
int l = Integer.toString(length).length();
|
||||
if (l < 4)
|
||||
{
|
||||
l = 4;
|
||||
}
|
||||
for (; offset < end; offset += 32)
|
||||
{
|
||||
if (length > 32)
|
||||
{
|
||||
s = " " + offset;
|
||||
sb.append(m).append(s.substring(s.length() - l)).append(": ");
|
||||
}
|
||||
int i = 0;
|
||||
for (; i < 32 && offset + i + 7 < end; i += 8)
|
||||
{
|
||||
sb.append(toString(data, offset + i, 8)).append(' ');
|
||||
}
|
||||
if (i < 32)
|
||||
{
|
||||
for (; i < 32 && offset + i < end; i++)
|
||||
{
|
||||
sb.append(byteToString(data[offset + i]));
|
||||
}
|
||||
}
|
||||
sb.append('\n');
|
||||
}
|
||||
return sb.toString();
|
||||
}
|
||||
|
||||
public static String dumpString(byte[] data)
|
||||
{
|
||||
return (data == null) ? "null\n" : dumpString(data, 0, data.length, "");
|
||||
}
|
||||
|
||||
public static String dumpString(byte[] data, String m)
|
||||
{
|
||||
return (data == null) ? "null\n" : dumpString(data, 0, data.length, m);
|
||||
}
|
||||
|
||||
public static String dumpString(byte[] data, int offset, int length)
|
||||
{
|
||||
return dumpString(data, offset, length, "");
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a string of 2 hexadecimal digits (most significant digit first)
|
||||
* corresponding to the lowest 8 bits of <code>n</code>.</p>
|
||||
*
|
||||
* @param n the byte value to convert.
|
||||
* @return a string of 2 hex characters representing the input.
|
||||
*/
|
||||
public static String byteToString(int n)
|
||||
{
|
||||
char[] buf = { HEX_DIGITS[(n >>> 4) & 0x0F], HEX_DIGITS[n & 0x0F] };
|
||||
return new String(buf);
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Converts a designated byte array to a Base-64 representation, with the
|
||||
* exceptions that (a) leading 0-byte(s) are ignored, and (b) the character
|
||||
* '.' (dot) shall be used instead of "+' (plus).</p>
|
||||
*
|
||||
* <p>Used by SASL password file manipulation primitives.</p>
|
||||
*
|
||||
* @param buffer an arbitrary sequence of bytes to represent in Base-64.
|
||||
* @return unpadded (without the '=' character(s)) Base-64 representation of
|
||||
* the input.
|
||||
*/
|
||||
public static final String toBase64(byte[] buffer)
|
||||
{
|
||||
int len = buffer.length, pos = len % 3;
|
||||
byte b0 = 0, b1 = 0, b2 = 0;
|
||||
switch (pos)
|
||||
{
|
||||
case 1:
|
||||
b2 = buffer[0];
|
||||
break;
|
||||
case 2:
|
||||
b1 = buffer[0];
|
||||
b2 = buffer[1];
|
||||
break;
|
||||
}
|
||||
StringBuffer sb = new StringBuffer();
|
||||
int c;
|
||||
boolean notleading = false;
|
||||
do
|
||||
{
|
||||
c = (b0 & 0xFC) >>> 2;
|
||||
if (notleading || c != 0)
|
||||
{
|
||||
sb.append(BASE64_CHARSET[c]);
|
||||
notleading = true;
|
||||
}
|
||||
c = ((b0 & 0x03) << 4) | ((b1 & 0xF0) >>> 4);
|
||||
if (notleading || c != 0)
|
||||
{
|
||||
sb.append(BASE64_CHARSET[c]);
|
||||
notleading = true;
|
||||
}
|
||||
c = ((b1 & 0x0F) << 2) | ((b2 & 0xC0) >>> 6);
|
||||
if (notleading || c != 0)
|
||||
{
|
||||
sb.append(BASE64_CHARSET[c]);
|
||||
notleading = true;
|
||||
}
|
||||
c = b2 & 0x3F;
|
||||
if (notleading || c != 0)
|
||||
{
|
||||
sb.append(BASE64_CHARSET[c]);
|
||||
notleading = true;
|
||||
}
|
||||
if (pos >= len)
|
||||
{
|
||||
break;
|
||||
}
|
||||
else
|
||||
{
|
||||
try
|
||||
{
|
||||
b0 = buffer[pos++];
|
||||
b1 = buffer[pos++];
|
||||
b2 = buffer[pos++];
|
||||
}
|
||||
catch (ArrayIndexOutOfBoundsException x)
|
||||
{
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
while (true);
|
||||
|
||||
if (notleading)
|
||||
{
|
||||
return sb.toString();
|
||||
}
|
||||
return "0";
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>The inverse function of the above.</p>
|
||||
*
|
||||
* <p>Converts a string representing the encoding of some bytes in Base-64
|
||||
* to their original form.</p>
|
||||
*
|
||||
* @param str the Base-64 encoded representation of some byte(s).
|
||||
* @return the bytes represented by the <code>str</code>.
|
||||
* @throws NumberFormatException if <code>str</code> is <code>null</code>, or
|
||||
* <code>str</code> contains an illegal Base-64 character.
|
||||
* @see #toBase64(byte[])
|
||||
*/
|
||||
public static final byte[] fromBase64(String str)
|
||||
{
|
||||
int len = str.length();
|
||||
if (len == 0)
|
||||
{
|
||||
throw new NumberFormatException("Empty string");
|
||||
}
|
||||
byte[] a = new byte[len + 1];
|
||||
int i, j;
|
||||
for (i = 0; i < len; i++)
|
||||
{
|
||||
try
|
||||
{
|
||||
a[i] = (byte) BASE64_CHARS.indexOf(str.charAt(i));
|
||||
}
|
||||
catch (ArrayIndexOutOfBoundsException x)
|
||||
{
|
||||
throw new NumberFormatException("Illegal character at #" + i);
|
||||
}
|
||||
}
|
||||
i = len - 1;
|
||||
j = len;
|
||||
try
|
||||
{
|
||||
while (true)
|
||||
{
|
||||
a[j] = a[i];
|
||||
if (--i < 0)
|
||||
{
|
||||
break;
|
||||
}
|
||||
a[j] |= (a[i] & 0x03) << 6;
|
||||
j--;
|
||||
a[j] = (byte) ((a[i] & 0x3C) >>> 2);
|
||||
if (--i < 0)
|
||||
{
|
||||
break;
|
||||
}
|
||||
a[j] |= (a[i] & 0x0F) << 4;
|
||||
j--;
|
||||
a[j] = (byte) ((a[i] & 0x30) >>> 4);
|
||||
if (--i < 0)
|
||||
{
|
||||
break;
|
||||
}
|
||||
a[j] |= (a[i] << 2);
|
||||
j--;
|
||||
a[j] = 0;
|
||||
if (--i < 0)
|
||||
{
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
catch (Exception ignored)
|
||||
{
|
||||
}
|
||||
|
||||
try
|
||||
{ // ignore leading 0-bytes
|
||||
while (a[j] == 0)
|
||||
{
|
||||
j++;
|
||||
}
|
||||
}
|
||||
catch (Exception x)
|
||||
{
|
||||
return new byte[1]; // one 0-byte
|
||||
}
|
||||
byte[] result = new byte[len - j + 1];
|
||||
System.arraycopy(a, j, result, 0, len - j + 1);
|
||||
return result;
|
||||
}
|
||||
|
||||
// BigInteger utilities ----------------------------------------------------
|
||||
|
||||
/**
|
||||
* <p>Treats the input as the MSB representation of a number, and discards
|
||||
* leading zero elements. For efficiency, the input is simply returned if no
|
||||
* leading zeroes are found.</p>
|
||||
*
|
||||
* @param n the {@link BigInteger} to trim.
|
||||
* @return the byte array representation of the designated {@link BigInteger}
|
||||
* with no leading 0-bytes.
|
||||
*/
|
||||
public static final byte[] trim(BigInteger n)
|
||||
{
|
||||
byte[] in = n.toByteArray();
|
||||
if (in.length == 0 || in[0] != 0)
|
||||
{
|
||||
return in;
|
||||
}
|
||||
int len = in.length;
|
||||
int i = 1;
|
||||
while (in[i] == 0 && i < len)
|
||||
{
|
||||
++i;
|
||||
}
|
||||
byte[] result = new byte[len - i];
|
||||
System.arraycopy(in, i, result, 0, len - i);
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* <p>Returns a hexadecimal dump of the trimmed bytes of a {@link BigInteger}.
|
||||
* </p>
|
||||
*
|
||||
* @param x the {@link BigInteger} to display.
|
||||
* @return the string representation of the designated {@link BigInteger}.
|
||||
*/
|
||||
public static final String dump(BigInteger x)
|
||||
{
|
||||
return dumpString(trim(x));
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user