sydapi/src/main/java/com/sunyard/util/BytesUtil.java

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));
    }
}