cn.hutool.core.util.RadixUtil Maven / Gradle / Ivy
package cn.hutool.core.util;
/**
* 进制转换工具类，可以转换为任意进制
*
* 把一个十进制整数根据自己定义的进制规则进行转换
* from：https://gitee.com/loolly/hutool/pulls/260
*
* 主要应用一下情况：
*
* - 根据ID生成邀请码,并且尽可能的缩短。并且不希望直接猜测出和ID的关联
* - 短连接的生成，根据ID转成短连接，同样不希望被猜测到
* - 数字加密，通过两次不同进制的转换，让有规律的数字看起来没有任何规律
* - ....
*
*
* @author [email protected]
* @since 5.5.8
*/
public class RadixUtil {
/**
* 34进制字符串，不包含 IO 字符
* 对于需要补齐的，自己可以随机填充IO字符
* 26个字母：abcdefghijklmnopqrstuvwxyz
*/
public final static String RADIXS_34 = "0123456789ABCDEFGHJKLMNPQRSTUVWXYZ";
/**
* 打乱后的34进制
*/
public final static String RADIXS_SHUFFLE_34 = "H3UM16TDFPSBZJ90CW28QYRE45AXKNGV7L";
/**
* 59进制字符串,不包含 IOl 字符
*/
public final static String RADIXS_59 = "0123456789abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ";
/**
* 打乱后的59进制
*/
public final static String RADIXS_SHUFFLE_59 = "vh9wGkfK8YmqbsoENP3764SeCX0dVzrgy1HRtpnTaLjJW2xQiZAcBMUFDu5";
/**
* 把一个整型数值转换成自己定义的进制
* 长度即进制
*
* - encode("AB",10) 51转换成2进制，A=0;B=1 。 二进制1010，结果 BABA
* - encode("VIP",21) 21转换成3进制，V=0;I=1;P=2 ，三进制210 ,得到结果PIV
*
*
* @param radixs 自定进制,不要重复，否则转不回来的。
* @param num 要转换的数值
* @return 自定义进制字符串
*/
public static String encode(String radixs, int num) {
//考虑到负数问题
long tmpNum = (num >= 0 ? num : (0x100000000L - (~num + 1)));
return encode(radixs, tmpNum, 32);
}
/**
* 把一个长整型数值转换成自己定义的进制
*
* @param radixs 自定进制,不要重复，否则转不回来的。
* @param num 要转换的数值
* @return 自定义进制字符串
*/
public static String encode(String radixs, long num) {
if (num < 0) {
throw new RuntimeException("暂不支持负数！");
}
return encode(radixs, num, 64);
}
/**
* 把转换后的进制字符还原成int 值
*
* @param radixs 自定进制,需要和encode的保持一致
* @param encodeStr 需要转换成十进制的字符串
* @return int
*/
public static int decodeToInt(String radixs, String encodeStr) {
//还原负数
return (int) decode(radixs, encodeStr);
}
/**
* 把转换后进制的字符还原成long 值
*
* @param radixs 自定进制,需要和encode的保持一致
* @param encodeStr 需要转换成十进制的字符串
* @return long
*/
public static long decode(String radixs, String encodeStr) {
//目标是多少进制
int rl = radixs.length();
long res = 0L;
for (char c : encodeStr.toCharArray()) {
res = res * rl + radixs.indexOf(c);
}
return res;
}
// -------------------------------------------------------------------------------- Private methods
private static String encode(String radixs, long num, int maxLength) {
if (radixs.length() < 2) {
throw new RuntimeException("自定义进制最少两个字符哦！");
}
//目标是多少进制
int rl = radixs.length();
//考虑到负数问题
long tmpNum = num;
//进制的结果，二进制最小进制转换结果是32个字符
//StringBuilder 比较耗时
char[] aa = new char[maxLength];
//因为反需字符串比较耗时
int i = aa.length;
do {
aa[--i] = radixs.charAt((int) (tmpNum % rl));
tmpNum /= rl;
} while (tmpNum > 0);
//去掉前面的字符串，trim比较耗时
return new String(aa, i, aa.length - i);
}
}