小于 4M 可以
This commit is contained in:
cheney
@@ -0,0 +1,174 @@
|
||||
package com.sunyard.util;
|
||||
|
||||
import java.nio.ByteOrder;
|
||||
|
||||
/**
|
||||
* 字节数组转换工具类，提供常见的基本类型与字节数组之间的互转功能。
|
||||
* 默认采用大端字节序（高位在前），也支持通过参数指定字节序。
|
||||
*
|
||||
* @author YourName
|
||||
*/
|
||||
public final class BytesUtil {
|
||||
|
||||
private BytesUtil() {
|
||||
// 私有构造方法，防止实例化
|
||||
}
|
||||
|
||||
// ==================== 无符号 short 转字节数组 ====================
|
||||
|
||||
/**
|
||||
* 将无符号 short 值（以 int 形式传入，范围 0 ~ 65535）转换为大端字节序的字节数组（2字节）。
|
||||
*
|
||||
* @param value 无符号 short 值（0 到 65535）
|
||||
* @return 长度为 2 的字节数组，高位在前
|
||||
* @throws IllegalArgumentException 如果 value 超出 0~65535 范围
|
||||
*/
|
||||
public static byte[] unsignedShortToBytes(int value) {
|
||||
if (value < 0 || value > 0xFFFF) {
|
||||
throw new IllegalArgumentException("Value out of range for unsigned short: " + value);
|
||||
}
|
||||
return new byte[]{
|
||||
(byte) ((value >> 8) & 0xFF),
|
||||
(byte) (value & 0xFF)
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 将无符号 short 值（以 short 类型传入，自动按无符号处理）转换为大端字节序的字节数组（2字节）。
|
||||
* 例如，传入 (short) 0x8001 会得到 { (byte)0x80, (byte)0x01 }。
|
||||
*
|
||||
* @param value short 类型，将按其二进制补码表示直接作为无符号值处理
|
||||
* @return 长度为 2 的字节数组，高位在前
|
||||
*/
|
||||
public static byte[] unsignedShortToBytes(short value) {
|
||||
// 将 short 转为无符号 int
|
||||
int unsignedValue = value & 0xFFFF;
|
||||
return unsignedShortToBytes(unsignedValue);
|
||||
}
|
||||
|
||||
/**
|
||||
* 将无符号 short 值（int 类型）转换为指定字节序的字节数组（2字节）。
|
||||
*
|
||||
* @param value 无符号 short 值（0 到 65535）
|
||||
* @param byteOrder 字节序，ByteOrder.BIG_ENDIAN 或 ByteOrder.LITTLE_ENDIAN
|
||||
* @return 长度为 2 的字节数组
|
||||
* @throws IllegalArgumentException 如果 value 超出范围或 byteOrder 为 null
|
||||
*/
|
||||
public static byte[] unsignedShortToBytes(int value, ByteOrder byteOrder) {
|
||||
if (byteOrder == null) {
|
||||
throw new IllegalArgumentException("ByteOrder must not be null");
|
||||
}
|
||||
byte[] bytes = unsignedShortToBytes(value);
|
||||
if (byteOrder == ByteOrder.LITTLE_ENDIAN) {
|
||||
// 交换高低位
|
||||
byte tmp = bytes[0];
|
||||
bytes[0] = bytes[1];
|
||||
bytes[1] = tmp;
|
||||
}
|
||||
return bytes;
|
||||
}
|
||||
|
||||
/**
|
||||
* 将无符号 short 值（short 类型）转换为指定字节序的字节数组（2字节）。
|
||||
*
|
||||
* @param value short 类型，按无符号处理
|
||||
* @param byteOrder 字节序
|
||||
* @return 长度为 2 的字节数组
|
||||
*/
|
||||
public static byte[] unsignedShortToBytes(short value, ByteOrder byteOrder) {
|
||||
return unsignedShortToBytes(value & 0xFFFF, byteOrder);
|
||||
}
|
||||
|
||||
// ==================== 字节数组转无符号 short ====================
|
||||
|
||||
/**
|
||||
* 从字节数组的起始位置读取 2 字节，按大端序转换为无符号 short 值（返回 int 类型）。
|
||||
*
|
||||
* @param bytes 字节数组
|
||||
* @param offset 起始偏移量
|
||||
* @return 无符号 short 值（0 ~ 65535）
|
||||
* @throws IllegalArgumentException 如果 bytes 为 null 或长度不足
|
||||
*/
|
||||
public static int bytesToUnsignedShort(byte[] bytes, int offset) {
|
||||
if (bytes == null || offset + 2 > bytes.length) {
|
||||
throw new IllegalArgumentException("Invalid byte array or offset");
|
||||
}
|
||||
return ((bytes[offset] & 0xFF) << 8) | (bytes[offset + 1] & 0xFF);
|
||||
}
|
||||
|
||||
/**
|
||||
* 从字节数组的起始位置读取 2 字节，按指定字节序转换为无符号 short 值。
|
||||
*
|
||||
* @param bytes 字节数组
|
||||
* @param offset 起始偏移量
|
||||
* @param byteOrder 字节序
|
||||
* @return 无符号 short 值
|
||||
*/
|
||||
public static int bytesToUnsignedShort(byte[] bytes, int offset, ByteOrder byteOrder) {
|
||||
if (byteOrder == ByteOrder.LITTLE_ENDIAN) {
|
||||
return ((bytes[offset + 1] & 0xFF) << 8) | (bytes[offset] & 0xFF);
|
||||
} else {
|
||||
return bytesToUnsignedShort(bytes, offset);
|
||||
}
|
||||
}
|
||||
|
||||
// ==================== 其他常见转换（扩展） ====================
|
||||
|
||||
/**
|
||||
* 将 int 值转换为大端序的 4 字节数组。
|
||||
*/
|
||||
public static byte[] intToBytes(int value) {
|
||||
return new byte[]{
|
||||
(byte) ((value >> 24) & 0xFF),
|
||||
(byte) ((value >> 16) & 0xFF),
|
||||
(byte) ((value >> 8) & 0xFF),
|
||||
(byte) (value & 0xFF)
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 将大端序的 4 字节数组转换为 int 值。
|
||||
*/
|
||||
public static int bytesToInt(byte[] bytes, int offset) {
|
||||
if (bytes == null || offset + 4 > bytes.length) {
|
||||
throw new IllegalArgumentException("Invalid byte array or offset");
|
||||
}
|
||||
return ((bytes[offset] & 0xFF) << 24)
|
||||
| ((bytes[offset + 1] & 0xFF) << 16)
|
||||
| ((bytes[offset + 2] & 0xFF) << 8)
|
||||
| (bytes[offset + 3] & 0xFF);
|
||||
}
|
||||
|
||||
/**
|
||||
* 将 long 值转换为大端序的 8 字节数组。
|
||||
*/
|
||||
public static byte[] longToBytes(long value) {
|
||||
return new byte[]{
|
||||
(byte) ((value >> 56) & 0xFF),
|
||||
(byte) ((value >> 48) & 0xFF),
|
||||
(byte) ((value >> 40) & 0xFF),
|
||||
(byte) ((value >> 32) & 0xFF),
|
||||
(byte) ((value >> 24) & 0xFF),
|
||||
(byte) ((value >> 16) & 0xFF),
|
||||
(byte) ((value >> 8) & 0xFF),
|
||||
(byte) (value & 0xFF)
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 将大端序的 8 字节数组转换为 long 值。
|
||||
*/
|
||||
public static long bytesToLong(byte[] bytes, int offset) {
|
||||
if (bytes == null || offset + 8 > bytes.length) {
|
||||
throw new IllegalArgumentException("Invalid byte array or offset");
|
||||
}
|
||||
return ((long) (bytes[offset] & 0xFF) << 56)
|
||||
| ((long) (bytes[offset + 1] & 0xFF) << 48)
|
||||
| ((long) (bytes[offset + 2] & 0xFF) << 40)
|
||||
| ((long) (bytes[offset + 3] & 0xFF) << 32)
|
||||
| ((long) (bytes[offset + 4] & 0xFF) << 24)
|
||||
| ((long) (bytes[offset + 5] & 0xFF) << 16)
|
||||
| ((long) (bytes[offset + 6] & 0xFF) << 8)
|
||||
| ((long) (bytes[offset + 7] & 0xFF));
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user