Author: thomas.diesler(a)jboss.com Date: 2008-04-04 05:22:10 -0400 (Fri, 04 Apr 2008) New Revision: 6223 Added: common/trunk/src/main/java/org/jboss/wsf/common/utils/ common/trunk/src/main/java/org/jboss/wsf/common/utils/UUIDGenerator.java Log: Add common utils Copied: common/trunk/src/main/java/org/jboss/wsf/common/utils/UUIDGenerator.java (from rev 6221, stack/native/trunk/src/main/java/org/jboss/ws/core/utils/UUIDGenerator.java) =================================================================== --- common/trunk/src/main/java/org/jboss/wsf/common/utils/UUIDGenerator.java (rev 0) +++ common/trunk/src/main/java/org/jboss/wsf/common/utils/UUIDGenerator.java 2008-04-04 09:22:10 UTC (rev 6223) @@ -0,0 +1,121 @@ +/* +* JBoss, Home of Professional Open Source +* Copyright 2005, JBoss Inc., and individual contributors as indicated +* by the @authors tag. See the copyright.txt in the distribution for a +* full listing of individual contributors. +* +* This is free software; you can redistribute it and/or modify it +* under the terms of the GNU Lesser 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 software 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 +* Lesser General Public License for more details. +* +* You should have received a copy of the GNU Lesser General Public +* License along with this software; if not, write to the Free +* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA +* 02110-1301 USA, or see the FSF site: http://www.fsf.org. +*/ +package org.jboss.wsf.common.utils; + +import java.security.SecureRandom; + +/** + * Generates the string form of IETF variant UUIDs. + * + * See <a href="http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-05... + * the latest IETF draft</a> for more information about UUID generation. + * + * Currently only pseudo random (type 4) UUIDs are supported. + * + * @author <a href="mailto:jason@stacksmash.com">Jason T. Greene</a> + */ +public class UUIDGenerator +{ + private static SecureRandom rand; + + private static String bytesToHex(byte[] buffer, int offset, int length) + { + long value = 0; + for (int i = 0, countDown = 8 * length; i < length; i++) + { + value |= (buffer[offset + i] & 0xffL) << (countDown -= 8); + } + + return Long.toHexString(value); + } + + /** + * Generates a pseudo random UUID and returns it in byte array form. + * + * @return a UUID byte array in network order + */ + public static byte[] generateRandomUUIDBytes() + { + if (rand == null) + rand = new SecureRandom(); + + byte[] buffer = new byte[16]; + rand.nextBytes(buffer); + + // Set version to 3 (Random) + buffer[6] = (byte) ((buffer[6] & 0x0f) | 0x40); + // Set variant to 2 (IETF) + buffer[8] = (byte) ((buffer[8] & 0x3f) | 0x80); + + return buffer; + } + + /** + * Generates a pseudo random UUID and returns it the IETF specified + * String form. See {@link #convertToString(byte[])} for a description + * of the format. + * + * @return a UUID in IETF string form. + */ + public static String generateRandomUUIDString() + { + return convertToString(generateRandomUUIDBytes()); + } + + /** + * Converts a UUID in byte array form to the IETF string format. + * + * <p>The BNF follows: + * <pre> + * UUID = <time_low> "-" <time_mid> "-" + * <time_high_and_version> "-" + * <variant_and_sequence> "-" + * <node> + * time_low = 4*<hexOctet> + * time_mid = 2*<hexOctet> + * time_high_and_version = 2*<hexOctet> + * variant_and_sequence = 2*<hexOctet> + * node = 6*<hexOctet> + * hexOctet = <hexDigit><hexDigit> + * hexDigit = + * "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" + * | "a" | "b" | "c" | "d" | "e" | "f" + * | "A" | "B" | "C" | "D" | "E" | "F" + * </pre> + * + * @param uuid a 16 byte + * @return the IETF string form of the passed UUID + */ + public static String convertToString(byte[] uuid) + { + if (uuid.length != 16) + throw new IllegalArgumentException("A UUID must be 16 bytes!"); + + String string = bytesToHex(uuid, 0, 4) + "-" + + bytesToHex(uuid, 4, 2) + "-" + + bytesToHex(uuid, 6, 2) + "-" + + bytesToHex(uuid, 8, 2) + "-" + + bytesToHex(uuid, 10, 6); + + return string; + } +} \ No newline at end of file