import java.nio.charset.Charset;
/**
 * 十六進制（簡寫為hex或下標16）在數學中是一種逢16進1的進位制，一般用數字0到9和字母A到F表示（其中:A~F即10~15）。<br>
 * 例如十進制數57，在二進制寫作111001，在16進制寫作39。<br>
 * 像java,c這樣的語言為了區分十六進制和十進制數值,會在十六進制數的前面加上 0x,比如0x20是十進制的32,而不是十進制的20<br>
 *
 * 參考：https://my.oschina.net/xinxingegeya/blog/287476
 *
 * @author Looly
 *
 */
public class HexKit {
  /**
   * 用于建立十六進制字符的輸出的小寫字符數組
   */
  private static final char[] DIGITS_LOWER = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
  /**
   * 用于建立十六進制字符的輸出的大寫字符數組
   */
  private static final char[] DIGITS_UPPER = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' };
  //---------------------------------------------------------------------------------------------------- encode
  /**
   * 將字節數組轉換為十六進制字符數組
   *
   * @param data byte[]
   * @return 十六進制char[]
   */
  public static char[] encodeHex(byte[] data) {
    return encodeHex(data, true);
  }
  /**
   * 將字節數組轉換為十六進制字符數組
   *
   * @param str 字符串
   * @param charset 編碼
   * @return 十六進制char[]
   */
  public static char[] encodeHex(String str, Charset charset) {
    return encodeHex(StrKit.getBytes(str, charset), true);
  }
  /**
   * 將字節數組轉換為十六進制字符數組
   *
   * @param data byte[]
   * @param toLowerCase <code>true</code> 傳換成小寫格式 ， <code>false</code> 傳換成大寫格式
   * @return 十六進制char[]
   */
  public static char[] encodeHex(byte[] data, boolean toLowerCase) {
    return encodeHex(data, toLowerCase ? DIGITS_LOWER : DIGITS_UPPER);
  }
  /**
   * 將字節數組轉換為十六進制字符串
   *
   * @param data byte[]
   * @return 十六進制String
   */
  public static String encodeHexStr(byte[] data) {
    return encodeHexStr(data, true);
  }
  /**
   * 將字節數組轉換為十六進制字符串
   *
   * @param data byte[]
   * @param toLowerCase <code>true</code> 傳換成小寫格式 ， <code>false</code> 傳換成大寫格式
   * @return 十六進制String
   */
  public static String encodeHexStr(byte[] data, boolean toLowerCase) {
    return encodeHexStr(data, toLowerCase ? DIGITS_LOWER : DIGITS_UPPER);
  }
  //---------------------------------------------------------------------------------------------------- decode
  /**
   * 將十六進制字符數組轉換為字符串
   *
   * @param hexStr 十六進制String
   * @param charset 編碼
   * @return 字符串
   */
  public static String decodeHexStr(String hexStr, Charset charset) {
    if(StrKit.isEmpty(hexStr)){
      return hexStr;
    }
    return decodeHexStr(hexStr.toCharArray(), charset);
  }
  /**
   * 將十六進制字符數組轉換為字符串
   *
   * @param hexData 十六進制char[]
   * @param charset 編碼
   * @return 字符串
   */
  public static String decodeHexStr(char[] hexData, Charset charset) {
    return StrKit.str(decodeHex(hexData), charset);
  }
  /**
   * 將十六進制字符數組轉換為字節數組
   *
   * @param hexData 十六進制char[]
   * @return byte[]
   * @throws RuntimeException 如果源十六進制字符數組是一個奇怪的長度，將拋出運行時異常
   */
  public static byte[] decodeHex(char[] hexData) {
    int len = hexData.length;
    if ((len & 0x01) != 0) {
      throw new RuntimeException("Odd number of characters.");
    }
    byte[] out = new byte[len >> 1];
    // two characters form the hex value.
    for (int i = 0, j = 0; j < len; i++) {
      int f = toDigit(hexData[j], j) << 4;
      j++;
      f = f | toDigit(hexData[j], j);
      j++;
      out[i] = (byte) (f & 0xFF);
    }
    return out;
  }
  //---------------------------------------------------------------------------------------- Private method start
  /**
   * 將字節數組轉換為十六進制字符串
   *
   * @param data byte[]
   * @param toDigits 用于控制輸出的char[]
   * @return 十六進制String
   */
  private static String encodeHexStr(byte[] data, char[] toDigits) {
    return new String(encodeHex(data, toDigits));
  }
  /**
   * 將字節數組轉換為十六進制字符數組
   *
   * @param data byte[]
   * @param toDigits 用于控制輸出的char[]
   * @return 十六進制char[]
   */
  private static char[] encodeHex(byte[] data, char[] toDigits) {
    int l = data.length;
    char[] out = new char[l << 1];
    // two characters form the hex value.
    for (int i = 0, j = 0; i < l; i++) {
      out[j++] = toDigits[(0xF0 & data[i]) >>> 4];
      out[j++] = toDigits[0x0F & data[i]];
    }
    return out;
  }
  /**
   * 將十六進制字符轉換成一個整數
   *
   * @param ch 十六進制char
   * @param index 十六進制字符在字符數組中的位置
   * @return 一個整數
   * @throws RuntimeException 當ch不是一個合法的十六進制字符時，拋出運行時異常
   */
  private static int toDigit(char ch, int index) {
    int digit = Character.digit(ch, 16);
    if (digit == -1) {
      throw new RuntimeException("Illegal hexadecimal character " + ch + " at index " + index);
    }
    return digit;
  }
  //---------------------------------------------------------------------------------------- Private method end
  /**
   * 2進制轉16進制
   * @param bString 2進制字符串
   * @return
   */
  public static String binary2Hex(String bString) {
    if (bString == null || bString.equals("") || bString.length() % 8 != 0)
      return null;
    StringBuffer tmp = new StringBuffer();
    int iTmp = 0;
    for (int i = 0; i < bString.length(); i += 4) {
      iTmp = 0;
      for (int j = 0; j < 4; j++) {
        iTmp += Integer.parseInt(bString.substring(i + j, i + j + 1)) << (4 - j - 1);
      }
      tmp.append(Integer.toHexString(iTmp));
    }
    return tmp.toString();
  }
  /**
   * 16進制轉2進制
   * @param hexString
   * @return
   */
  public static String hex2Binary(String hexString) {
    if (hexString == null || hexString.length() % 2 != 0)
      return null;
    String bString = "", tmp;
    for (int i = 0; i < hexString.length(); i++) {
      tmp = "0000" + Integer.toBinaryString(Integer.parseInt(hexString.substring(i, i + 1), 16));
      bString += tmp.substring(tmp.length() - 4);
    }
    return bString;
  }
  /**
   * 將二進制轉換成16進制
   * @param buf
   * @return
   */
  public static String binary2Hex(byte buf[]) {
    StringBuffer sb = new StringBuffer();
    for (int i = 0; i < buf.length; i++) {
      String hex = Integer.toHexString(buf[i] & 0xFF);
      if (hex.length() == 1) {
        hex = '0' + hex;
      }
      sb.append(hex.toUpperCase());
    }
    return sb.toString();
  }
  /**
   * 將16進制轉換為二進制
   * @param hexStr
   * @return
   */
  public static byte[] hex2Byte(String hexStr) {
    if (hexStr.length() < 1)
      return null;
    byte[] result = new byte[hexStr.length() / 2];
    for (int i = 0; i < hexStr.length() / 2; i++) {
      int high = Integer.parseInt(hexStr.substring(i * 2, i * 2 + 1), 16);
      int low = Integer.parseInt(hexStr.substring(i * 2 + 1, i * 2 + 2), 16);
      result[i] = (byte) (high * 16 + low);
    }
    return result;
  }
}