jdk/src/share/classes/sun/jkernel/ByteArrayToFromHexDigits.java
changeset 3111 fefdeafb7ab9
child 5506 202f599c92aa
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/jdk/src/share/classes/sun/jkernel/ByteArrayToFromHexDigits.java	Fri Jun 12 14:56:32 2009 -0400
@@ -0,0 +1,138 @@
+/*
+ * Copyright 2008 - 2009 Sun Microsystems, Inc.  All Rights Reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Sun designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Sun in the LICENSE file that accompanied this code.
+ *
+ * This code 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
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ * CA 95054 USA or visit www.sun.com if you need additional information or
+ * have any questions.
+ */
+
+package sun.jkernel;
+
+/**
+ * TODO: The JRE and deploy build code (SplitJRE) can be made a bit smarter
+ * then cryto hashcode byte arrays can be used directly, eliminating the need
+ * for this class altogether. So just leave this alone until it can be removed.
+ * TODO: Change "Digits" to "String" for uniformity and more intuitive names.
+ * A lightweight class to provide convert between hex digits and
+ * <code>byte[]</code>.
+ *<p>
+ * TODO: Try to get this built without the -source 1.3 -target -1.3 options,
+ * which prevent use of java.text.Format, assuming this wouldn't bloat the
+ * JK rt.jar. Also, there still might be equivalent code hiding in the JDK
+ * already, but preliminary searches havn't found it.
+ */
+
+public final class ByteArrayToFromHexDigits {
+
+    private static final char [] chars = new char[]
+        {'0','1','2','3','4','5','6','7','8','9', 'A','B','C','D','E','F'};
+
+    private static final boolean debug = false;
+
+    /**
+     * Converts the <code>byte[] b</code> into a <code>String</code> of
+     * hex digits representing the integer values of all the bytes.
+     *
+     * @param b byte array to be converted
+     * @return String representing <code>b</code> in hexadecimal
+     * @throws IllegalArgumentException if <code>b</code> is null or zero length
+     */
+    public static String bytesToHexString(byte[] b) {
+        if (debug ) {
+            System.out.print("I: ");
+            for(int i=0;i<b.length;i++) {
+                System.out.format("%02X",b[i]);
+            }
+            System.out.println();
+        }
+        if ((b == null) || (b.length == 0)) {
+            throw new IllegalArgumentException("argument null or zero length");
+        }
+        StringBuffer buff = new StringBuffer(b.length * 2);
+        for (int i = 0; i < b.length; i++ ) {
+            buff.insert(i*2,chars[(b[i] >> 4) & 0xf]);
+            buff.insert(i*2+1,chars[b[i] & 0xf]);
+        }
+        if (debug ) {
+            System.out.println("O: " + buff.toString());
+        }
+        return buff.toString();
+    }
+
+    // Convert one hex character to a 4 bit byte value
+
+    private static byte hexCharToByte(char c) throws IllegalArgumentException {
+        if ((c < '0') ||
+            ( ((c < 'A') && (c > 'F')) && ((c < 'a') && (c > 'f'))) ) {
+
+            throw new IllegalArgumentException("not a hex digit");
+        }
+
+        if (c > '9') {
+            if (c > 'F') {
+                return (byte) ((c - 'a' + 10) & 0xf);
+            } else {
+                return (byte) ((c - 'A' + 10) & 0xf);
+            }
+        } else {
+            return (byte) ((c - '0') & 0xf);
+        }
+
+    }
+
+    /**
+     * Converts the <code>String d</code> assumed to contain a sequence
+     * of hexadecimal digit characters into a <code>byte[]</code>.
+     *
+     * @param d String to be converted
+     * @return  byte array representing the hex string
+     * @throws IllegalArgumentException if <code>d</code> is odd length,
+     *     contains a character outside the ranges of 0-9, a-f, and A-F,
+     *     or is zero length or null
+     */
+
+    public static byte[] hexStringToBytes(String d) throws IllegalArgumentException {
+        if (d == null) {
+            throw new IllegalArgumentException(
+                "parameter cannot be null");
+        }
+
+        if (d.length() == 0) {
+            throw new IllegalArgumentException(
+                "parameter cannot be zero length");
+        }
+
+        if ((d.length() & 1) != 0) {
+            throw new IllegalArgumentException(
+                "odd length string");
+        }
+
+        byte[] b = new byte[d.length() / 2];
+
+        // TODO Might be code in the JK initial bundle to do this better (i.e.
+        // method that tests for a hex char?)
+
+        for (int i=0;i<d.length();i+=2) {
+            b[i/2] =  (byte) (( (byte) (hexCharToByte(d.charAt(i))) << 4) +
+                (byte) hexCharToByte(d.charAt(i+1)));
+        }
+        return b;
+    }
+}