- 在ByteBufferUtils中添加getVarLong、getVarInt、getVarShort读取变长数字功能 - 在ByteBufferUtils中添加putVarLong、putVarInt、putVarShort写入变长数字功能 - 新增Debouncer防抖器类用于防止短时间内重复执行任务 - 更新build.gradle.kts中mybatis-plus-core依赖版本至3.5.15 - 优化FileUtils中文件操作方法,增加Path和File类型的扩展函数 - 添加字节转义字符常量定义和hex字符串转换工具方法
147 lines
4.6 KiB
Kotlin
147 lines
4.6 KiB
Kotlin
/*
|
|
* Copyright 2026 mingliqiye
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
* ProjectName mingli-utils
|
|
* ModuleName mingli-utils.main
|
|
* CurrentFile StreamUtils.kt
|
|
* LastUpdate 2026-01-11 09:41:14
|
|
* UpdateUser MingLiPro
|
|
*/
|
|
@file:JvmName("StreamUtils")
|
|
|
|
package com.mingliqiye.utils.bytes
|
|
|
|
import java.io.IOException
|
|
import java.io.InputStream
|
|
import java.io.OutputStream
|
|
|
|
|
|
/**
|
|
* 从输入流中读取一个变长整数(VarNumber)。
|
|
*
|
|
* 变长整数使用可变长度编码方式,每个字节的最高位表示是否还有后续字节:
|
|
* - 如果最高位为1,则表示还有下一个字节;
|
|
* - 如果最高位为0,则表示当前字节是最后一个字节。
|
|
*
|
|
* @param size 最大允许读取的字节数,默认为8(即Long类型的最大长度)。
|
|
* @return 解码后的长整型数值。
|
|
* @throws IOException 当读取过程中发生IO异常或到达流末尾时抛出。
|
|
*/
|
|
@Throws(IOException::class)
|
|
fun InputStream.readVarNumber(size: Int = 8): Long {
|
|
var numRead = 0
|
|
var result: Long = 0
|
|
var read: Byte
|
|
do {
|
|
read = this.read().let {
|
|
if (it == -1) {
|
|
throw IOException("Reached end of stream")
|
|
}
|
|
it.toByte()
|
|
}
|
|
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
|
numRead++
|
|
if (numRead > size) {
|
|
throw IOException("VarNumber is too big")
|
|
}
|
|
} while ((read.toLong() and 128) != 0L)
|
|
return result
|
|
}
|
|
|
|
/**
|
|
* 从输入流中读取一个变长整数(VarInt),最大长度限制为4个字节。
|
|
*
|
|
* @return 解码后的整型数值。
|
|
* @throws IOException 当读取过程中发生IO异常时抛出。
|
|
*/
|
|
@Throws(IOException::class)
|
|
fun InputStream.readVarInt(): Int = this.readVarNumber(4).toInt()
|
|
|
|
|
|
/**
|
|
* 从输入流中读取一个变长短整数(VarShort),最大长度限制为2个字节。
|
|
*
|
|
* @return 解码后的短整型数值。
|
|
* @throws IOException 当读取过程中发生IO异常时抛出。
|
|
*/
|
|
@Throws(IOException::class)
|
|
fun InputStream.readVarShort(): Short = this.readVarNumber(2).toShort()
|
|
|
|
|
|
/**
|
|
* 从输入流中读取一个变长长整数(VarLong),最大长度默认为8个字节。
|
|
*
|
|
* @return 解码后的长整型数值。
|
|
* @throws IOException 当读取过程中发生IO异常时抛出。
|
|
*/
|
|
@Throws(IOException::class)
|
|
fun InputStream.readVarLong(): Long = this.readVarNumber()
|
|
|
|
/**
|
|
* 将长整型数值编码为变长格式并写入输出流
|
|
*
|
|
* 变长整数使用可变长度编码方式,每个字节的最高位表示是否还有后续字节:
|
|
* - 如果数值还有更多字节,则最高位设为1;
|
|
* - 最后一个字节最高位设为0。
|
|
*
|
|
* @param value 要写入的长整型数值
|
|
* @param size 最大允许写入的字节数,默认为8
|
|
* @throws IOException 当写入过程中发生IO异常时抛出
|
|
*/
|
|
@Throws(IOException::class)
|
|
fun OutputStream.writeVarNumber(value: Long, size: Int = 8) {
|
|
var v = value
|
|
var numWritten = 0
|
|
|
|
while (v >= 0x80 && numWritten < size - 1) {
|
|
this.write((v and 0x7F or 0x80).toInt())
|
|
v = v ushr 7
|
|
numWritten++
|
|
}
|
|
|
|
if (numWritten >= size) {
|
|
throw IOException("VarNumber is too big")
|
|
}
|
|
|
|
this.write(v.toInt())
|
|
}
|
|
|
|
/**
|
|
* 将整型数值编码为变长格式并写入输出流
|
|
*
|
|
* @param value 要写入的整型数值
|
|
* @throws IOException 当写入过程中发生IO异常时抛出
|
|
*/
|
|
@Throws(IOException::class)
|
|
fun OutputStream.writeVarInt(value: Int): Unit = this.writeVarNumber(value.toLong(), 4)
|
|
|
|
/**
|
|
* 将短整型数值编码为变长格式并写入输出流
|
|
*
|
|
* @param value 要写入的短整型数值
|
|
* @throws IOException 当写入过程中发生IO异常时抛出
|
|
*/
|
|
@Throws(IOException::class)
|
|
fun OutputStream.writeVarShort(value: Short): Unit = this.writeVarNumber(value.toLong(), 2)
|
|
|
|
/**
|
|
* 将长整型数值编码为变长格式并写入输出流
|
|
*
|
|
* @param value 要写入的长整型数值
|
|
* @throws IOException 当写入过程中发生IO异常时抛出
|
|
*/
|
|
@Throws(IOException::class)
|
|
fun OutputStream.writeVarLong(value: Long): Unit = this.writeVarNumber(value, 8)
|